1. OpenClaw 是什么为什么值得花 5 分钟部署OpenClaw早期叫 Clawdbot是一个可以本地部署的 AI 智能体框架它能通过自然语言指令完成文件管理、信息检索、内容处理、流程自动化这类实际操作并且带记忆能力和插件扩展机制。简单说它不是单纯的聊天窗口而是一个能动手干活的助手你告诉它整理某个目录、抓取某个网页摘要、按模板生成一批文件它会真的去执行。适合谁适合想把 AI 从问答工具变成执行工具的开发者、运维、内容创作者以及愿意在自己电脑或云主机上跑一套可控智能体的技术爱好者。它依赖 Node.js 运行支持云端服务器长期在线也支持 MacOS、Linux、Windows 本地离线运行数据优先落在本地可控性比较好。部署这件事听起来吓人但实际拆开就是四步装 Node、装 OpenClaw、初始化、启动网关。真正容易卡住的地方不在安装而在模型接入——也就是让 OpenClaw 能调用一个大模型来理解你的指令。这一步如果按传统方式你得去各家平台注册、实名、拿 Key、改配置来回折腾。这篇的做法是部署照常走模型接入统一走 TaoToken 的 Key 和 API 通道一个 Key 覆盖多种模型省掉多平台切换的麻烦。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册后到控制台生成 Key 即可。下面按云主机和本地三平台分别给出可复制命令最后用一次真实对话请求验证整条链路是否打通。全程不需要额外背景知识命令能直接粘贴。2. 部署前的环境准备与 TaoToken Key 获取先说通用依赖三个平台要求一致操作系统 Windows 11、macOS 12 及以上、LinuxUbuntu/Debian/CentOS 都行运行环境 Node.js 22.x 及以上工具是终端或 PowerShell 加一个文本编辑器网络能正常访问外部即可。先做环境检查打开终端输入node -v npm -v能输出版本号就说明环境可用提示 command not found 就先装 Node.js。云主机建议 1 核 2GB 内存起步系统盘 40GB 以上安全组放行 18789 端口Web 控制台默认端口。接下来是这篇的重点差异模型通道。传统做法是每个模型平台单独申请 KeyOpenClaw 配置里写死某一家的地址和密钥换模型就得改配置。用 TaoToken 的话你只需要一个统一 Key 和一个 Base URL模型 ID 在配置里切换即可。获取步骤打开 https://taotoken.net/api 对应的控制台入口注册登录后进入 API Keys 页面deep linkhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 点创建新 Key复制保存好。这个 Key 后面要写进 OpenClaw 的配置文件别弄丢。想先确认模型能不能正常对话可以去模型对话页面试一条deep linkhttps://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 确认通道可用再往下配能省不少排障时间。这里有个概念要讲清楚避免后面配置时懵OpenClaw 的模型配置里base_url指的是 API 请求的根地址api_key是身份凭证model_name是你要调用的具体模型 ID。三者缺一不可。用统一通道的好处是base_url固定你只改model_name就能换模型不用重新申请凭证。如果你打算长期跑编码类或 Agent 类任务可以了解下 Coding Plandeep linkhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 按需选择即可这里不展开。3. 云主机与三平台本地部署可复制配置这一节是全文操作密度最高的部分按云主机、macOS、Linux、Windows 四块给命令每块都能直接复制。云主机以 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浏览器打开http://服务器公网IP:18789就能看到控制台。开机自启可以追加一行到 rc.localecho /usr/bin/openclaw gateway start | sudo tee -a /etc/rc.local sudo chmod x /etc/rc.localmacOS 本地部署先装 Homebrew 再装 Node/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh) brew install node npm config set registry https://registry.npmmirror.com npm install -g openclaw openclaw onboard openclaw gateway start访问地址http://127.0.0.1:18789。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 startWindows 11 以管理员身份打开 PowerShellSet-ExecutionPolicy RemoteSigned -Scope CurrentUser winget install OpenJS.NodeJS --version 22.0.0 npm config set registry https://registry.npmmirror.com npm install -g openclaw openclaw onboard openclaw gateway start访问地址同样是http://127.0.0.1:18789。部署完成后关键一步是写模型配置。配置文件路径macOS/Linux 是~/.openclaw/config.jsonWindows 是C:\Users\用户名\.openclaw\config.json。用 TaoToken 统一通道的配置片段如下把api_key换成你刚才复制的 Keymodel_name换成你要用的模型 ID{ model: { type: openai, api_key: 你的TaoToken Key, base_url: https://taotoken.net/api, model_name: 你的模型ID, max_tokens: 2048, temperature: 0.7, timeout: 60, reasoning: false } }注意base_url写https://taotoken.net/api不要带多余路径。改完重启网关生效openclaw gateway restart如果你用的是 Cline MCP 或 Codex 这类工具配合 OpenClaw配置三件套逻辑一样Base URL 填https://taotoken.net/apiKey 填你的 TaoToken KeyModel ID 填具体模型名。三者对齐请求才能落到正确的模型上。4. 验证请求一次对话确认部署与接入都生效配置写完不代表通了必须做一次真实请求验证。这一步很多人跳过结果后面出问题不知道是部署挂了还是模型没接上。验证分两层先确认网关活着再确认模型能回话。第一层检查服务状态openclaw gateway status看到 running 或类似状态就说明网关正常。如果没起来先看日志openclaw logs --follow第二层发一次对话请求。打开浏览器进http://127.0.0.1:18789云主机换成公网 IP在控制台输入一句简单指令比如你好请用一句话介绍你自己。正常情况你会看到模型返回内容说明部署和模型接入整条链路都通了。如果不想开浏览器也可以用命令行直接测模型通道是否可用先单独验证 TaoToken 的 API 能不能返回curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer 你的TaoToken Key \ -d { model: 你的模型ID, messages: [{role: user, content: 你好}] }返回 JSON 里带choices字段和内容就说明 Key、Base URL、模型 ID 三件套是对的。这一步能快速区分问题出在 OpenClaw 还是出在模型通道如果 curl 通但 OpenClaw 不回问题在 OpenClaw 配置如果 curl 就不通问题在 Key 或模型 ID。实测下来最常见的成功结果是控制台里模型正常回复日志里能看到请求记录。到这一步你的 OpenClaw 就已经是一个能接收自然语言指令并调用模型执行的智能体了。接下来可以装 Skills 扩展能力比如联网搜索、浏览器操作、内容摘要npm install -g clawhub clawhub install tavily-search clawhub install summarize openclaw gateway restart装完重启网关加载用openclaw skill list查看已装技能。5. 本篇常见报错排查对照部署和接入过程中报错基本集中在几类这里按真实错误信息对照给解法。openclaw: command not found全局安装没生效或 PATH 没刷新。重新执行npm install -g openclaw然后关掉终端重开。Linux/macOS 如果提示权限不足用sudo npm install -g openclaw。401 UnauthorizedKey 不对或没带上。检查配置文件里api_key是否复制完整有没有多余空格确认base_url是https://taotoken.net/api确认 Key 没有过期或被删。用上面那条 curl 单独测一次能快速定位。local proxy failed或连接被拒通常是base_url写错比如多写了/v1或结尾斜杠或者网络到不了。把base_url改回https://taotoken.net/api再试。reading choices报错或返回体解析失败说明请求发出去了但返回结构不对多半是model_name填了一个通道不支持的模型 ID。去模型对话页面确认可用模型名填对再重启。OAuth 相关报错如果你在别的工具里配过 OAuth 流程注意 OpenClaw 这里用的是 Key 认证不需要走 OAuth。把配置里的认证方式统一成api_key即可别混用。服务启动后自动关闭内存不足。云主机建议 2GB 以上本地关掉占资源的程序然后openclaw logs看具体错误。无法访问 Web 控制台先openclaw gateway status确认服务在跑云主机检查安全组是否放行 18789本地确认访问的是http://127.0.0.1:18789还不行就openclaw gateway restart。端口被占用Linux/macOS 查进程lsof -i:18789 kill -9 进程IDWindows 查进程netstat -ano | findstr 18789 taskkill /F /PID 进程IDAI 回复为空在 model 配置里确认reasoning: false重启服务。响应超时就把timeout从 30 调到 60max_tokens从 2048 降到 1024 再试。技能装了不生效openclaw gateway restart重启网关再用openclaw skill list确认状态。clawhub命令不可用就重装npm install -g clawhub。6. 把 Key 和通道固定下来后续只换模型部署这件事真正花时间的从来不是敲命令而是模型接入反复折腾。把 TaoToken 的 Key 和 Base URL 固定进配置文件后你后面想换模型只改model_name一个字段重启网关就行不用重新注册、重新拿 Key、重新改地址。这是统一通道最实际的价值。如果你还在选模型阶段可以先去模型对话页面把几个候选模型各试一句确认哪个响应风格和速度合你意再写进 OpenClaw 配置。想深入看接入细节和参数说明接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Key 管理和新建在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。长期跑编码或 Agent 任务的话Coding Plan 页面在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 按自己的用量节奏选就行。最后留一个我踩过的坑配置文件改完一定要openclaw gateway restart光保存不重启是不生效的很多人卡在这里以为配置写错了其实只是没重载。