1. OpenClaw 部署前必须想清楚的三件事OpenClaw曾用名 Clawdbot是一个可以本地部署的 AI 智能体框架它能通过自然语言指令完成文件管理、信息检索、内容处理、流程自动化等实际操作并通过 Skills 插件机制不断扩展能力。它依赖 Node.js 运行支持云主机长期在线也支持 Mac、Linux、Win11 本地离线运行数据优先存储在本地可控性比较强。适合谁适合想把大模型能力落到自己机器上、又不想被单一厂商绑死的开发者和小团队。但很多人第一次部署 OpenClaw 时卡住的不是安装命令而是模型 API 这一环官方示例里写的是某一家云厂商的接口换一家就要改配置、换 Key、对字段四个平台各改一遍非常折腾。我试过把 settings 里的接口地址统一改到一个兼容 OpenAI 协议的通道上后面 Mac、Linux、Win11、云主机就只用维护一份配置省事很多。这篇就把这套流程完整走一遍重点演示怎么把 OpenClaw 的 settings 改到 TaoToken 统一 Key/API 通道四个平台都给可复制的配置片段和连通性验证命令。先说清楚 OpenClaw 的配置文件在哪这是后面所有改动的落点平台配置文件路径macOS~/.openclaw/config.jsonLinux~/.openclaw/config.jsonWin11C:\Users\你的用户名\.openclaw\config.json云主机Linux/root/.openclaw/config.jsonOpenClaw 的模型配置块叫model里面最关键的三个字段是base_url、api_key、model_name。只要你的 API 通道兼容 OpenAI 的/v1/chat/completions协议这三个字段填对OpenClaw 就能正常调用。TaoToken 的 API 地址是https://taotoken.net/apiKey 在控制台生成模型 ID 按你实际要用的填。下面每个平台我都会给出完整的model片段你直接替换路径里的文件内容即可。还有一件事要提前确认Node.js 版本必须 22.x 及以上。低版本会在openclaw onboard阶段报奇怪的语法错误很多人以为是安装包坏了其实是 Node 太旧。检查命令就两行node -v npm -v输出版本号说明环境可用提示command not found就先装 Node。这一步在四个平台都一样后面不再重复。2. TaoToken 前置准备拿到 Base URL、Key 和 Model ID在改任何配置文件之前先把三样东西准备好否则你会在配置里反复试错。这三样是Base URL、API Key、Model ID。Base URL 固定是https://taotoken.net/api注意结尾不要多加/v1OpenClaw 内部会自己拼/v1/chat/completions你多写一层反而会 404。API Key 需要到控制台生成地址是https://taotoken.net/console登录后在 API Keys 页面新建一个复制出来保存好页面关掉就看不到了。Model ID 取决于你要调用的模型填模型在通道里的准确名称不要自己简写。如果你只是先验证连通性不想一上来就配 OpenClaw可以先用模型对话页面发一条消息确认 Key 本身是有效的https://taotoken.net/models。这一步能帮你把「Key 无效」和「OpenClaw 配置错」两类问题分开省很多排查时间。对于长期跑编码任务或者 Agent 场景的用户可以了解一下 Coding Plan它把按 token 计费换成了按次跑长任务时成本更可控https://taotoken.net/coding-plan。接入文档在https://taotoken.net/doc里面有各语言 SDK 的调用示例遇到字段疑问可以对照。把这三样记在一个临时文本里Base URL: https://taotoken.net/api API Key: sk-你的Key Model ID: 你实际要用的模型名接下来四个平台的部署差别只在安装方式和配置文件路径模型配置块是完全一致的。所以你可以先在一台机器上把model块调通再复制到其他平台只改路径。3. 四平台可复制配置把 settings 改到 TaoToken这一节是全文的核心四个平台我都给出从安装到改配置的完整命令。你可以只挑自己用的平台看但建议把model块单独存一份后面复用。3.1 云主机Linux部署与配置以 Alibaba Cloud Linux 3 为例先更新系统并装依赖sudo yum update -y sudo yum install -y curl git装 Node.js 22curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz | sudo tar -xJ -C /usr/local sudo ln -s /usr/local/node-v22.0.0-linux-x64/bin/node /usr/bin/node sudo ln -s /usr/local/node-v22.0.0-linux-x64/bin/npm /usr/bin/npm配置 npm 镜像并安装 OpenClawnpm config set registry https://registry.npmmirror.com npm install -g openclaw初始化按提示同意协议、选择快速启动、暂时跳过模型配置、启用全部通道openclaw onboard设置公网访问并启动openclaw config set gateway.host 0.0.0.0 openclaw config set gateway.port 18789 openclaw gateway start现在改模型配置。编辑/root/.openclaw/config.json把model块替换成下面这段{ model: { type: openai, base_url: https://taotoken.net/api, api_key: sk-你的Key, model_name: 你实际要用的模型名, max_tokens: 2048, temperature: 0.7, timeout: 60, reasoning: false } }注意type填openai因为 TaoToken 走的是 OpenAI 兼容协议不要填成别的厂商类型。改完重启openclaw gateway restart云主机记得在安全组放行 18789 端口否则浏览器打不开 Web 控制台。3.2 macOS 部署与配置用 Homebrew 装 Node/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh) brew install node装 OpenClaw 并初始化npm config set registry https://registry.npmmirror.com npm install -g openclaw openclaw onboard openclaw gateway start配置文件在~/.openclaw/config.jsonmodel块和上面云主机完全一样直接复制。改完openclaw gateway restart浏览器访问http://127.0.0.1:18789。3.3 LinuxUbuntu/Debian部署与配置sudo apt update sudo apt install -y curl git nodejs npm sudo npm install -g n sudo n stable npm config set registry https://registry.npmmirror.com npm install -g openclaw openclaw onboard openclaw gateway start配置文件同样在~/.openclaw/config.jsonmodel块不变。如果你是用 root 跑的路径就是/root/.openclaw/config.json。3.4 Win11 部署与配置以管理员身份打开 PowerShell先放开脚本执行策略Set-ExecutionPolicy RemoteSigned -Scope CurrentUser装 Node 22winget install OpenJS.NodeJS --version 22.0.0装 OpenClaw 并初始化npm config set registry https://registry.npmmirror.com npm install -g openclaw openclaw onboard openclaw gateway start配置文件在C:\Users\你的用户名\.openclaw\config.json。用记事本或 VS Code 打开把model块替换成和上面一致的内容。注意 Windows 路径里的反斜杠在 JSON 里要转义但这里你只改model块不涉及路径字段所以直接粘贴即可。改完重启openclaw gateway restart浏览器访问http://127.0.0.1:18789。四个平台配置块一致这是统一通道最大的好处以后换模型只改model_name一个字段不用四个平台各查一遍文档。4. 验证请求确认 OpenClaw 真的调通了 TaoToken配置改完不代表调通必须做一次端到端验证。分两步先验 Key 本身再验 OpenClaw 调用链。第一步用 curl 直接打 TaoToken 的接口确认 Key 和 Base URL 没问题curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的Key \ -d { model: 你实际要用的模型名, messages: [{role: user, content: 只回复两个字通了}] }如果返回 JSON 里choices[0].message.content是「通了」说明 Key、Base URL、Model ID 三样都对。这一步失败问题一定在 Key 或模型名跟 OpenClaw 无关。第二步在 OpenClaw 里发一条指令。打开 Web 控制台输入「帮我列出当前目录的文件」观察是否正常返回。如果 curl 通了但 OpenClaw 不通多半是配置文件格式问题用下面命令检查配置是否被正确解析openclaw config get model它会打印当前生效的model块。如果打印出来是空的或者字段缺失说明你的 JSON 有语法错误比如多了逗号、少了引号。JSON 对格式很严格建议用编辑器自带的 JSON 校验功能过一遍。第三步看日志确认请求真的发出去了openclaw logs --follow正常调用时日志里会出现向https://taotoken.net/api/v1/chat/completions发请求的记录以及返回的状态码。看到 200 就说明链路完全通了。如果看到 401往下看第五节。验证通过后你可以顺手装几个 Skills 扩展能力npm install -g clawhub clawhub install tavily-search clawhub install summarize openclaw gateway restart装完重启网关技能才会加载。用openclaw skill list查看已安装技能。5. 常见报错排查清单401、local proxy failed、reading choices这一节按真实报错来你遇到哪个查哪个。401 Unauthorized。这是最常见的。原因有三个Key 复制时带了空格或换行Key 已经失效或被删Authorization头没带上。先重新复制一次 Key确保前后没有空白字符。然后在 curl 里单独测一次如果 curl 也 401就是 Key 本身的问题去控制台重新生成一个。注意配置文件里api_key字段的值不要加Bearer前缀OpenClaw 会自己加你加了就变成Bearer Bearer sk-xxx直接 401。local proxy failed / connection refused。这个报错说明 OpenClaw 根本没连出去通常是base_url写错了。检查是不是写成了https://taotoken.net/api/v1多了一层/v1。正确写法是https://taotoken.net/api。另外确认机器能正常访问外网云主机如果没配好网络出口也会报这个。reading choices 相关报错。典型信息是cannot read property choices of undefined或者reading choices。这说明接口返回的结构里没有choices字段通常是返回了一个错误对象。原因可能是模型名写错了通道找不到对应模型返回了错误 JSON。解决方法是先用 curl 单独测一次看返回体里error字段写了什么。如果是model not found就去核对 Model ID 的准确拼写。OAuth 相关报错。如果你看到OAuth字样说明配置里type字段填错了填成了需要 OAuth 的厂商类型。TaoToken 走的是 API Key 模式type必须填openai。改完重启即可。响应超时。把timeout从 30 调到 60max_tokens从 2048 降到 1024 试试。长回复容易超时降低单次生成长度能缓解。端口被占用。Linux/macOS 用lsof -i:18789找到进程 ID 后kill -9Windows 用netstat -ano | findstr 18789找到 PID 后taskkill /F /PID 进程ID。技能装了不生效。Skills 安装后必须openclaw gateway restart才会加载只装不重启等于没装。用openclaw skill status 技能名确认状态。配置文件写不进去。检查当前用户对~/.openclaw/目录有没有写权限权限不够就sudo chown改一下或者用openclaw onboard --reset重新初始化。排查的核心思路就一条先用 curl 把 Key 和接口验通再回头查 OpenClaw 配置。这样能把问题范围缩小一半。6. 把统一通道用起来后续维护与接入入口四个平台都配好之后日常维护其实很轻。换模型只改model_name换 Key 只改api_key通道地址基本不动。因为四个平台共用同一份model块你可以在本地维护一个模板文件新机器部署时直接复制不用重新查文档。如果你后面要接 Claude Code 或者做 Agent 类长期任务接入方式也是同一套 Base URL 和 Key配置入口在https://taotoken.net/claude-code里面有对应的环境变量写法。核心还是那三件套Base URL 填https://taotoken.net/apiKey 填控制台生成的Model ID 填实际模型名。三样对齐任何兼容 OpenAI 协议的工具都能接上。需要生成新 Key 或者管理已有 Key去https://taotoken.net/api-keys。接入文档在https://taotoken.net/doc遇到字段不确定的地方对照一下。想先验证模型效果再决定用哪个去https://taotoken.net/models直接对话测试。长期跑编码和 Agent 任务的话https://taotoken.net/coding-plan的按次计费更划算。最后留一个实用习惯每次改完配置先跑一遍openclaw config get model确认生效再发一条测试指令最后看openclaw logs --follow确认请求打到正确的地址。这三步花不了一分钟但能帮你避开绝大多数「改了没生效」的坑。配置这东西验证一次比猜十次强。