1. 为什么我要把 OpenClaw 装到三种环境里
OpenClaw 是一个基于 Node.js 的 AI 智能体运行框架，它能对接云端大模型，也能挂本地模型，通过一个网关进程对外提供对话、工具调用和 Web Dashboard。适合谁？适合想在自己电脑上跑一个可控 Agent、又不想被单一模型厂商锁死的开发者。我最初只在 macOS 上跑，后来发现团队里有人用 Windows、有人要把常驻任务丢到云服务器，于是把三个平台的部署流程都走了一遍。
真正让我头疼的不是安装本身，而是模型接入这一层。OpenClaw 默认要你填各家厂商的 API Key，换一个模型就得改一次配置，多环境同步时特别乱。后来我统一走 TaoToken 的 API 通道，一个 Key 覆盖多种模型，config.toml 和 settings.json 里只维护一份凭证，Windows、macOS、云服务器三边配置完全一致。这篇就把 Node.js 环境准备、分平台安装、统一 Key 配置、连通性验证和踩坑排查一次讲清楚，命令都可以直接复制。
2. TaoToken 前置准备：拿到统一 Key 和接入地址
在动手装 OpenClaw 之前，先把模型通道准备好，否则配置向导走到一半会卡在填 Key 的环节。TaoToken 的定位是统一 API 通道，你注册后在控制台创建一个 API Key，之后 OpenClaw 里所有模型请求都走这个 Key，不用为每个厂商单独申请。
具体动作分三步。第一，打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 注册账号。第二，进入控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console 创建 API Key，建议命名成 openclaw-prod 之类方便识别。第三，记下两个东西：API Base 地址 https://taotoken.net/api（这个不加 UTM 参数，直接用于程序请求），以及刚生成的 Key 字符串。
注意：Key 只在创建时完整显示一次，复制后先存到密码管理器，后面三个平台都要用同一个。
如果你还没想好接哪个模型，可以先去模型对话页 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=model_chat 试几条请求，确认通道正常再往下走。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc，里面列了兼容 OpenAI 协议的调用方式，OpenClaw 的 openai provider 可以直接套用。
3. Node.js 环境准备：三平台统一到 22.x LTS
OpenClaw 对 Node.js 版本敏感，官方要求 22.x LTS。我试过用 20.x 跑，安装能过但网关启动时报模块解析错误，所以别省这一步。
macOS 和 Windows 都去 Node.js 官网下 22.x LTS 安装包。Windows 装 .msi 时记得勾选「Add to PATH」，否则 CMD 里找不到 node。装完验证：
node --version npm --version输出 v22.x.x 和对应 npm 版本号就算成功。云服务器（Linux）我更推荐用 nvm 管理，升级和切换都方便：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22 node --version如果服务器拉取脚本慢，可以先用系统包管理器装一个基础 Node，再用 nvm 覆盖。Ubuntu 下apt update && apt upgrade -y先更新系统，CentOS 用yum update -y，然后开放 22（SSH）和 18789（OpenClaw 网关）端口，18789 是后面 Dashboard 和网关通信要用的。
4. 分平台安装 OpenClaw 与统一 Key 配置
三个平台安装命令一致，都用 npmmirror 源加速：
npm install -g openclaw@latest --registry=https://registry.npmmirror.com openclaw --versionWindows 必须以管理员身份打开 PowerShell 再执行，否则全局安装会因权限失败。如果报 EPERM，执行npm config set prefix "C:\Users\你的用户名\AppData\Roaming\npm"重设路径后重试。macOS 和 Linux 普通用户即可，Linux 上如果提示权限不足，加 sudo 或配置 npm 全局目录。
安装完跑配置向导：
openclaw onboard --install-daemon向导里模型服务商那一步，选 OpenAI 兼容类型，然后填 TaoToken 的地址和 Key。如果你更想直接改配置文件，OpenClaw 的主配置在~/.openclaw/openclaw.json（Windows 是C:\Users\你的用户名\.openclaw\openclaw.json），模型段落这样写：
{ "model": { "provider": "openai", "name": "gpt-4o-mini", "apiBase": "https://taotoken.net/api", "apiKey": "你的_TaoToken_Key" } }有些版本用 config.toml 管理网关参数，骨架如下：
[gateway] host = "127.0.0.1" port = 18789 [model] provider = "openai" api_base = "https://taotoken.net/api" api_key = "${TAOTOKEN_API_KEY}"我更推荐用环境变量注入 Key，避免明文写进文件。macOS/Linux 在~/.bashrc或~/.zshrc里加：
export TAOTOKEN_API_KEY="你的_TaoToken_Key" export OPENAI_API_BASE="https://taotoken.net/api"Windows 用系统环境变量界面新建TAOTOKEN_API_KEY，或者在 PowerShell 里setx TAOTOKEN_API_KEY "你的Key"，重开终端生效。这样三台机器的配置文件可以完全一样，只靠环境变量区分。
5. 验证连通性：分平台检查动作与成功结果
配置写完别急着开 Dashboard，先验证网关和模型通道。
启动网关：
openclaw gateway run这个窗口要保持打开，关掉网关就停了。另开一个终端查状态：
openclaw status正常输出里 Gateway 应该是 reachable，端口 18789 在监听。如果显示ECONNREFUSED 127.0.0.1:18789，说明网关没起来，回到上一步看报错。
接着验证模型通道。用 curl 直接打 TaoToken 的接口，确认 Key 和地址没问题：
curl https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"ping"}]}'返回带 choices 的 JSON 就说明通道通了。然后在 OpenClaw 里发一条测试消息，或者打开 Dashboard：
openclaw dashboard本地访问 http://127.0.0.1:18789，云服务器访问 http://服务器IP:18789（确认 18789 端口已放行）。Dashboard 能加载出对话界面、发消息有回复，整条链路就算打通了。
6. 本篇常见错排查
Windows 向导按回车没反应。这是交互界面逻辑，不是卡死。用方向键把光标移到目标选项，按空格打勾（选项前出现 [x]），再按回车提交。直接回车不会选中。
Gateway 服务启动失败，提示 Scheduled Task missing。Windows 计划任务适配有问题，别用服务方式。直接openclaw gateway run前台跑，窗口别关。要常驻的话用任务计划程序手动配一个开机启动项。
Dashboard 提示已打开但浏览器没反应。手动复制提示里的 URL（形如 http://127.0.0.1:18789/#token=xxx）粘到浏览器地址栏。那个 token 是访问凭证，别丢。
云服务器外网访问不了 Dashboard。检查安全组和防火墙是否放行 18789，另外确认网关 host 不是只绑 127.0.0.1。生产环境建议前面挂 Nginx 做反向代理并加认证，别把网关裸暴露。
模型请求 401 或 404。401 多半是 Key 没读到，检查环境变量是否在当前 shell 生效（echo $TAOTOKEN_API_KEY）；404 检查 apiBase 是不是写成了带 /v1 的完整路径，OpenClaw 的 openai provider 通常自己拼 /v1，填 https://taotoken.net/api 即可。
换模型后不生效。改完 openclaw.json 要重启网关，前台跑的 Ctrl+C 再openclaw gateway run。
7. 后续怎么用：按场景选对入口
三平台跑通之后，日常使用分几种情况。只是验证模型通不通、临时对话，用模型对话页 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=model_chat 最快，不用动本地配置。要把 OpenClaw 接进长期编码流程、跑 Agent 常驻任务，建议看 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan，配额和并发更适合持续调用。Key 管理和新建、吊销在 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys，多环境建议一个环境一个 Key，方便排查和回收。接入细节和协议兼容性以文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc 为准，遇到字段对不上先翻文档再改配置。
如果你用 Claude Code 这类工具，Anthropic 兼容入口在 https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claude_code，配置思路和上面一致，把 base 地址和 Key 换成 TaoToken 的即可。三台机器共用一份配置模板、靠环境变量区分 Key，是我目前觉得最省心的做法，升级 OpenClaw 时也不用逐台改文件。
