OpenClaw 全平台安装部署教程：Windows/macOS/云服务器接入 TaoToken 统一 Key 配置指南

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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号。第二进入控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsole 创建 API Key建议命名成 openclaw-prod 之类方便识别。第三记下两个东西API Base 地址 https://taotoken.net/api这个不加 UTM 参数直接用于程序请求以及刚生成的 Key 字符串。注意Key 只在创建时完整显示一次复制后先存到密码管理器后面三个平台都要用同一个。如果你还没想好接哪个模型可以先去模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chat 试几条请求确认通道正常再往下走。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdoc里面列了兼容 OpenAI 协议的调用方式OpenClaw 的 openai provider 可以直接套用。3. Node.js 环境准备三平台统一到 22.x LTSOpenClaw 对 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然后开放 22SSH和 18789OpenClaw 网关端口18789 是后面 Dashboard 和网关通信要用的。4. 分平台安装 OpenClaw 与统一 Key 配置三个平台安装命令一致都用 npmmirror 源加速npm install -g openclawlatest --registryhttps://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.jsonWindows 是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_BASEhttps://taotoken.net/apiWindows 用系统环境变量界面新建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 里发一条测试消息或者打开 Dashboardopenclaw 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/#tokenxxx粘到浏览器地址栏。那个 token 是访问凭证别丢。云服务器外网访问不了 Dashboard。检查安全组和防火墙是否放行 18789另外确认网关 host 不是只绑 127.0.0.1。生产环境建议前面挂 Nginx 做反向代理并加认证别把网关裸暴露。模型请求 401 或 404。401 多半是 Key 没读到检查环境变量是否在当前 shell 生效echo $TAOTOKEN_API_KEY404 检查 apiBase 是不是写成了带 /v1 的完整路径OpenClaw 的 openai provider 通常自己拼 /v1填 https://taotoken.net/api 即可。换模型后不生效。改完 openclaw.json 要重启网关前台跑的 CtrlC 再openclaw gateway run。7. 后续怎么用按场景选对入口三平台跑通之后日常使用分几种情况。只是验证模型通不通、临时对话用模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chat 最快不用动本地配置。要把 OpenClaw 接进长期编码流程、跑 Agent 常驻任务建议看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_plan配额和并发更适合持续调用。Key 管理和新建、吊销在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keys多环境建议一个环境一个 Key方便排查和回收。接入细节和协议兼容性以文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdoc 为准遇到字段对不上先翻文档再改配置。如果你用 Claude Code 这类工具Anthropic 兼容入口在 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code配置思路和上面一致把 base 地址和 Key 换成 TaoToken 的即可。三台机器共用一份配置模板、靠环境变量区分 Key是我目前觉得最省心的做法升级 OpenClaw 时也不用逐台改文件。