1. OpenClaw 部署前必须搞清楚的几件事OpenClaw原 Clawdbot社区里也有人叫它 Moltbot是一个开源的 AI 智能体平台核心能力是把大模型接到你的服务器上让它能读写文件、执行命令、调用工具最终替你完成一整套自动化任务。你可以把它理解成一个「住在服务器里的 AI 助理」——你给它一句话它自己拆解步骤、调用工具、把活干完。适合谁用个人开发者想搭一个专属助手、小团队想跑自动化流程、学生想练手 AI Agent都能用得上。但真正动手时大部分人卡在同一个地方模型接入。OpenClaw 本身只是个「壳」它需要一个大模型 API 才能思考。传统做法是去各家模型厂商分别注册、分别拿 Key、分别配环境变量一旦你想换模型或者同时用几个模型配置就会乱成一团。这篇教程的思路是用 TaoToken 统一 Key 通道把模型接入这一步收敛成一个 Base URL 一个 Key 一个 Model ID剩下的部署流程照常走。我试过在阿里云轻量服务器上从零跑一遍全程大概 25 到 30 分钟其中大部分时间花在等依赖安装。下面把每一步都拆开命令可以直接复制。你不需要懂 Docker 原理也不需要理解反向代理跟着敲就行。遇到报错先别慌第 5 节专门列了常见错误对照表。先说清楚整体路径准备一台阿里云轻量应用服务器2 核 2G 起步→ 装基础依赖 → 拉取 OpenClaw → 写配置文件这里接入 TaoToken→ 启动服务 → 用 curl 验证模型通道 → 打开 Web 界面跑第一个任务。每一步都有验证点做完一步确认一步不要跳步。2. TaoToken 统一 Key 前置准备与阿里云环境搭建2.1 为什么用 TaoToken 统一 KeyOpenClaw 的配置文件里有一个models段落你要在里面填模型提供方的地址和密钥。如果你直接用某一家厂商的 API将来想换模型就得改配置、换 Key、重启服务。TaoToken 的做法是提供一个统一的 API 入口你只需要在它那里生成一个 Key然后在 OpenClaw 里把 Base URL 指向https://taotoken.net/apiModel ID 填你想用的模型名即可。换模型时只改 Model ID 一个字段Key 和地址都不用动。对小白来说这省掉了「注册多个平台、管理多个 Key、记多个地址」的麻烦。你可以在 TaoToken 控制台里看到所有可用模型也能直接用它提供的模型对话页面先测一下模型通不通再去配 OpenClaw。2.2 阿里云轻量服务器选购与初始化打开阿里云轻量应用服务器购买页地域建议选香港或海外弗吉尼亚、新加坡都行原因是内地地域的联网搜索类功能受限而 OpenClaw 的很多工具调用依赖外网访问。镜像选「系统镜像」里的 Ubuntu 22.04不要选应用镜像我们要自己装这样配置可控。规格选 2vCPU 2GB 内存起步低于 2GB 会在启动时被 OOM Kill。带宽 3M 够用磁盘 40G 足够。购买完成后在控制台「防火墙」里放通两个端口22SSH和 18789OpenClaw Web 界面。18789 是 OpenClaw 默认的 Web 端口不放通你打不开页面。然后用 SSH 登录服务器ssh root你的服务器公网IP登录后先更新系统包这一步别省不然后面装依赖容易报版本冲突apt update apt upgrade -y2.3 安装基础依赖OpenClaw 运行需要 Node.js 20 以上、Git、curl。用 NodeSource 源装 Node 20curl -fsSL https://deb.nodesource.com/setup_20.x | bash - apt install -y nodejs git curl验证版本node -v # 应输出 v20.x.x npm -v # 应输出 10.x.x如果node -v输出的是 v18 或更低说明系统自带的旧版本没被覆盖执行apt remove -y nodejs后重新跑上面的安装命令。这一步是后面所有操作的地基版本不对会在npm install阶段报一堆 engine 错误。2.4 获取 TaoToken Key浏览器打开 TaoToken 控制台https://taotoken.net/console注册登录后进入 API Keys 页面点「创建新 Key」复制生成的字符串。这个 Key 只显示一次先存到本地记事本。同时记下你要用的 Model ID比如claude-sonnet-4-5或gpt-4o具体以控制台模型列表为准。注意Key 等同于你的账户凭证不要提交到 Git 仓库不要发到群里。建议在控制台设置用量上限避免意外消耗。3. OpenClaw 可复制配置文件与 TaoToken 接入3.1 拉取 OpenClaw 源码cd /opt git clone https://github.com/openclaw/openclaw.git cd openclaw npm installnpm install会跑 2 到 5 分钟取决于网络。如果卡在某个包不动先执行npm config set registry https://registry.npmmirror.com换国内镜像再重试。安装完成后目录里会出现node_modules和package.json。3.2 写配置文件OpenClaw 读取项目根目录下的config.json。新建这个文件nano /opt/openclaw/config.json把下面这段完整粘进去注意把sk-你的TaoToken密钥替换成你刚才复制的 Keymodel字段填你要用的 Model ID{ server: { port: 18789, host: 0.0.0.0 }, models: { default: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-5 } }, agent: { name: my-assistant, maxSteps: 20, workspace: /opt/openclaw/workspace }, tools: { shell: true, file: true, web: true } }几个字段解释一下provider填openai-compatible是因为 TaoToken 的 API 兼容 OpenAI 格式OpenClaw 能直接识别baseUrl必须是https://taotoken.net/api不要加多余的路径maxSteps控制单次任务最多执行多少步20 对新手够用调太大会让任务跑很久workspace是智能体读写文件的目录提前建好mkdir -p /opt/openclaw/workspace保存退出nano 里按 CtrlO 回车再 CtrlX。3.3 用 systemd 托管服务直接npm start关掉 SSH 就断了用 systemd 让它后台常驻。新建服务文件nano /etc/systemd/system/openclaw.service内容[Unit] DescriptionOpenClaw AI Agent Afternetwork.target [Service] Typesimple WorkingDirectory/opt/openclaw ExecStart/usr/bin/npm start Restartalways RestartSec5 EnvironmentNODE_ENVproduction [Install] WantedBymulti-user.target启用并启动systemctl daemon-reload systemctl enable openclaw systemctl start openclaw systemctl status openclaw看到active (running)就说明进程起来了。如果显示failed用journalctl -u openclaw -n 50看最近 50 行日志错误基本都在里面。4. 验证请求与跑通第一个智能体任务4.1 先验证 TaoToken 通道在配 OpenClaw 之前先用 curl 确认 Key 和地址是通的这样能把「模型通道问题」和「OpenClaw 配置问题」分开排查curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 回复两个字通了}] }正常返回是一段 JSONchoices[0].message.content里能看到模型回复。如果返回 401说明 Key 错了或没带Bearer前缀如果返回 404检查 baseUrl 是不是多写了/v1TaoToken 的地址到/api为止OpenClaw 和 curl 都会自动补/v1。4.2 验证 OpenClaw 服务curl http://localhost:18789/health返回{status:ok}说明 Web 服务正常。然后在浏览器打开http://你的服务器公网IP:18789应该能看到 OpenClaw 的对话界面。如果打不开先检查阿里云防火墙 18789 是否放通再检查服务器内部ufw status如果 ufw 开着就ufw allow 18789。4.3 跑第一个任务在 Web 界面输入框里输入在当前目录创建一个 hello.txt内容写「OpenClaw 部署成功」然后读取这个文件并告诉我内容。点发送。你会看到 OpenClaw 开始「思考」它先调用 shell 工具执行echo再调用 file 工具读取最后把结果返回给你。整个过程在界面上是分步展示的你能看到它每一步调用了什么工具、传了什么参数。这就是 AI 智能体跟普通聊天机器人的区别——它真的动手干活了。如果任务卡住不动看journalctl -u openclaw -f的实时日志通常是模型返回格式解析失败检查 Model ID 是否拼写正确。5. 部署常见报错排查对照这一节按真实报错整理遇到问题直接对号入座。401 Unauthorized出现在 curl 验证或 OpenClaw 日志里。原因九成是 Key 错误。检查三点Key 有没有复制完整前后不能有空格、请求头是不是Authorization: Bearer sk-xxxBearer 后面有一个空格、Key 有没有在 TaoToken 控制台被禁用。如果 Key 没问题还是 401去控制台确认账户余额或额度是否用完。local proxy failed / ECONNREFUSEDOpenClaw 启动时报这个说明它连不上baseUrl。先curl https://taotoken.net/api看能不能通如果服务器本身访问不了外网检查阿里云安全组出方向规则。如果 curl 通但 OpenClaw 报错检查 config.json 里 baseUrl 有没有写错特别注意不要写成https://taotoken.net/api/末尾斜杠有时会导致路径拼接错误。reading choices of undefined模型返回的 JSON 结构跟 OpenClaw 预期不符。常见原因是 Model ID 填了一个不存在的模型TaoToken 返回了错误对象而不是正常的 choices 数组。去 TaoToken 控制台的模型列表核对准确的 Model ID注意大小写和连字符。OAuth / token expired如果你在配置里误填了需要 OAuth 的 provider会出现这个。OpenClaw 接 TaoToken 时 provider 必须是openai-compatible不要填anthropic或google否则它会走 OAuth 流程而 TaoToken 用的是 Bearer Key。端口 18789 被占用systemctl status openclaw显示Address already in use。执行lsof -i:18789找到占用进程kill -9 进程号干掉再重启服务。如果是之前手动npm start没关干净也会占端口。npm install 卡住或报 engine 错误Node 版本不对。node -v必须是 v20 以上。如果系统里有多个 Node用which node确认路径确保 systemd 里ExecStart指向的 npm 是同一个版本。Web 界面能打开但发消息没反应打开浏览器开发者工具的 Network 面板看发出去的请求返回什么。如果是 500看服务端日志如果是超时多半是模型通道慢去 TaoToken 控制台看该模型的响应延迟。6. 后续使用与 Key 管理建议跑通第一个任务之后你可以把 OpenClaw 接到更多场景让它定时读某个目录下的文件做汇总、让它调用 web 工具查资料再写报告、或者把它当成一个能执行命令的运维助手。这些都不需要改模型配置只要在对话里描述任务就行。关于 Key 管理几个实用习惯在 TaoToken 控制台给 Key 设置备注名比如「openclaw-阿里云」将来多个项目用不同 Key 时好区分定期轮换 Key旧 Key 在控制台禁用不要把 Key 写进会提交到 Git 的文件config.json 加到.gitignore里。如果你后面想换模型只改 config.json 里的model字段然后systemctl restart openclaw即可Base URL 和 Key 都不用动。这就是统一 Key 通道的价值——模型可以随便换接入层保持稳定。需要看更多模型和接入方式可以去 TaoToken 的模型对话页面直接试https://taotoken.net/models或者翻接入文档https://taotoken.net/doc确认最新的 Base URL 和参数格式。长期跑编码类或 Agent 类任务的话Coding Planhttps://taotoken.net/coding-plan在用量上会更划算具体以控制台说明为准。