1. 先搞清楚 OpenClaw 到底装的是什么OpenClaw前身 Clawdbot中间还叫过 Moltbot是一个本地优先的开源 AI 助理框架。它和普通聊天机器人的区别在于聊天机器人只负责“说”OpenClaw 还能“做”——读写文件、整理日程、跑自动化任务、通过 IM 工具接收指令。你可以把它理解成一个常驻在你机器或服务器上的数字员工背后接哪个大模型由你决定。它适合谁三类人一是想在自己电脑上快速验证 AI 助理能力的开发者二是需要 7×24 小时在线、随时响应任务的轻量团队三是想把模型调用统一到一个入口、不想在多个平台之间来回切 Key 的人。前两类决定你部署在哪第三类决定你怎么配模型通道。部署方式只有两条路。本地部署适合短期测试不用服务器费用但设备关机服务就停服务器部署适合长期运行公网可访问稳定性高。两条路的安装命令、config.toml 骨架、验证方式我会分别给全你照着复制就行。整篇的目标是让你 4 分钟内跑通第一次对话而不是读完一堆概念还在原地。需要提前说清楚一个关键点OpenClaw 本身不绑定任何一家模型厂商它通过配置文件里的 provider 字段决定调用谁。所以“装完能不能用”这件事一半取决于安装一半取决于模型通道配得对不对。下面第 2 节先把通道这件事解决掉再进安装。2. 装之前先把模型通道配好TaoToken 统一 Key很多人装 OpenClaw 卡住不是因为安装命令错而是模型通道没通——Key 填了但调不通或者要在好几个平台分别申请、分别记额度。我的做法是先用一个统一入口把通道打通再回头装 OpenClaw这样安装完立刻能验证不用来回排查。TaoToken 在这里扮演的角色就是统一 Key / API 通道你拿到一个 Key配一个 base_urlOpenClaw 就能通过它调用后端模型不用在 config 里为每家厂商写一套凭证。对 OpenClaw 这种要频繁切换模型的框架来说少一层配置就少一类报错。具体操作分三步。第一步打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。第二步进控制台创建 API Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建后立刻复制保存页面通常只完整显示一次。第三步如果你不确定该用哪个模型可以先到模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 试一句确认通道是通的再往 OpenClaw 里填。Key 的管理入口在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 后面如果 Key 泄露或要轮换从这里操作。API 的基础地址是 https://taotoken.net/api 注意这个地址不带任何查询参数配置时原样填入即可。提示Key 只显示一次这件事不是吓唬人。我见过太多人创建完随手关页面回头只能重新建一个。复制后先粘到本地记事本确认长度完整再继续。通道准备好之后OpenClaw 的 config.toml 里模型这一段就有明确写法了第 3 节会给完整骨架。如果你后面打算长期跑编码类或 Agent 类任务可以顺带了解 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 它针对的就是这类高频调用场景这里先不展开。3. 可复制配置本地与服务器两套命令 config.toml 骨架这一节是全文的核心命令和配置都能直接复制。先给本地部署再给服务器部署最后统一给 config.toml 骨架。3.1 本地部署Windows / Mac 通用思路本地部署的前提是 Node.js 22.x 和 Git。Windows 用管理员模式打开 PowerShellMac 用终端。先验证环境node --version # 需要 v22.0.0 git --version版本不够就先升级 Node别跳过这步低版本会在安装阶段直接报错。环境 OK 后执行安装# Mac / Linux curl -fsSL https://openclaw.ai/install-local.sh | bash # Windows PowerShell管理员 iwr -useb https://openclaw.ai/install-local.ps1 | iex安装完成后验证openclaw --version能输出版本号就说明主程序装好了。接着装技能管理 CLI后面装技能要用npm install -g clawhub clawhub --version3.2 服务器部署阿里云轻量应用服务器为例服务器部署推荐直接用预置镜像省掉手动装依赖。选购时注意三点内存必须 2GiB 及以上低于这个数服务起不来镜像选 OpenClaw 专属镜像地域按你的访问需求选海外及港澳台地域联网搜索功能更完整。实例跑起来后用 SSH 连上去做一次环境预检ssh root你的服务器公网IP # 预检系统版本、内存、端口占用、外网连通性 curl -fsSL https://openclaw.ai/script/precheck.sh | bash预检输出里如果有 (×)先修完再往下走。预检通过后放行默认 Web 端口 18789然后在应用详情页把前面拿到的 TaoToken Key 写进配置。服务器上设置开机自启systemctl enable openclaw-gateway systemctl is-enabled openclaw-gateway # 输出 enabled 即成功3.3 config.toml 骨架关键OpenClaw 的模型通道写在配置文件里。本地路径通常是~/.openclaw/config.toml服务器同理。下面这份骨架把 TaoToken 作为统一通道接进去你只需要替换 Key# ~/.openclaw/config.toml [gateway] port 18789 host 0.0.0.0 [models] # 默认使用的模型标识按你实际要调的模型填 default your-model-name [models.providers.taotoken] # 统一通道一个 Key 走通后端模型 base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 # 如通道要求指定协议类型按文档填 openai 兼容格式 type openai [skills] # 技能目录clawhub 安装的技能会落在这里 dir ~/.openclaw/skills [log] level info几个参数说明一下。base_url必须原样填https://taotoken.net/api不要自己加斜杠或路径。api_key就是第 2 节保存的那串。default填你要用的模型标识不确定就先到模型对话页试通再填。type字段如果通道文档写的是 OpenAI 兼容就填openai这是最常见的对接方式。注意config.toml 对缩进和引号敏感。改完先别急着启动用openclaw config validate校验一遍能省掉大量“启动即报错”的时间。4. 启动验证三条命令确认真的跑通了配置写完启动服务。本地前台启动方便看日志openclaw gateway服务器上建议后台启动关掉终端也不影响nohup openclaw gateway ~/.openclaw/logs/start.log 21 启动后打开控制台openclaw dashboard浏览器会自动跳到 Web 控制台。接下来做三步验证缺一不可。第一步基础交互。在对话框输入一句普通问候比如“你好测试一下”。能正常回复说明自然语言解析和模型通道都通了。如果这里就报错八成是 Key 或 base_url 的问题回到第 3.3 节核对。第二步文件处理。输入“在当前目录创建一个名为 test.txt 的文件内容为 hello openclaw”。返回创建成功说明自动化执行链路正常。这一步验证的是 OpenClaw 区别于普通聊天机器人的核心能力。第三步模型通道确认。输入“你当前使用的是哪个模型通道”。如果它能正确反映你配置的通道信息说明 TaoToken 这一段接对了。到这一步整个部署就算真正跑通而不只是“服务起来了”。验证通过后可以顺手装一个基础技能包试试技能生态clawhub search basic-utils clawhub install basic-utils装完再让 OpenClaw 调一次技能里的功能确认技能加载路径没问题。常用命令我列个表方便你后面查命令作用openclaw status查看服务运行状态openclaw gateway restart改配置后重启生效openclaw logs --follow实时看日志排障openclaw config validate校验配置文件语法clawhub install 技能名安装技能5. 本篇常见报错排查部署过程中最容易撞上的几类问题我按出现频率排一下每条都给动作。服务启动失败提示配置不足。基本是内存低于 2GiB。本地看任务管理器服务器看实例规格。低于这个数没有绕过的办法只能加内存或换实例。API Key 无效或连接超时。先确认 Key 复制完整没有多余空格再确认base_url是https://taotoken.net/api没被改成别的地址。如果 Key 是对的还超时检查服务器出网是否正常curl -I https://taotoken.net/api看能不能通。端口 18789 被占用。本地排查# Mac / Linux lsof -i:18789 # Windows netstat -ano | findstr 18789找到进程 ID 后终止再重新启动服务。服务器上还要确认防火墙已放行该端口。控制台打不开提示无法访问。先确认服务在跑openclaw status再看是不是本地防火墙拦了。服务器场景额外确认安全组放行了 18789。clawhub 命令找不到。说明 CLI 没装成功或环境变量没刷新。重装一次npm install -g clawhub然后source ~/.bashrcMac 是~/.zshrc刷新再试。改了 config.toml 但没生效。配置文件不会热加载必须openclaw gateway restart。改之前先openclaw config validate语法错的话重启也会失败。如果上面都排完还是不通接入相关的细节可以对照文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 逐项核对尤其是 base_url 和鉴权头的写法。Key 本身的问题则到 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 重新生成一个再试排除 Key 失效的可能。6. 跑通之后怎么继续用第一次跑通只是起点。接下来按你的实际场景往下走如果主要是验证模型效果、试不同模型的表现直接到模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 切换着试比在 config 里反复改快得多。如果 OpenClaw 要长期承担编码或 Agent 类任务调用频率高建议看一下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 把额度这件事提前规划好别跑到一半断掉。技能别贪多。ClawHub 上技能数量很大但盲目装会拖慢启动、引发冲突。我的习惯是只装当前场景真正用得到的装之前先clawhub show 技能名看清楚它做什么确认匹配再装。配置文件记得定期备份本地拷到云盘服务器上cp ~/.openclaw/config.toml ~/.openclaw/config.toml.bak一条命令的事出问题时能救命。最后提醒一句Key 和服务器密码不要外泄不用的端口及时关掉。OpenClaw 能读写文件、执行任务权限不小安全这块别省。
