集成skills教程｜TaoToken统一Key接入)
1. 先搞清楚 OpenClaw 到底能帮你做什么OpenClaw社区里也常被叫 Clawdbot是一个开源的 AI 智能体框架你可以把它理解成一个“能动手的聊天助手”普通对话模型只能回你文字而 OpenClaw 能调用工具去读写文件、整理目录、定时跑任务、抓取信息再汇总。它本身不绑定某一家模型你给它一个兼容 OpenAI 协议的 API 地址和 Key它就能跑起来。适合谁适合想给自己搭一个私有自动化助手、又不想从零写 Agent 框架的新手和小团队。新手最容易卡住的地方其实不是 OpenClaw 本身而是三件事服务器环境、端口放行、模型 Key 怎么填。我见过太多人容器起来了浏览器却打不开面板最后发现是防火墙没放行 18789。这篇就按“云服务器 本地”两条路径把部署到 skills 调用的完整闭环走一遍全程命令可直接复制。先说结论性的路径差异方便你选部署方式适合场景优点注意点云服务器想 7×24 挂着、外网随时访问不占本地资源关机也在跑要放行端口、注意安全组本地部署只想本机用、数据不出门零网络配置最省心电脑关机服务就停模型接入这块我建议统一用一个兼容 OpenAI 协议的入口来管 Key这样云上和本地可以共用同一套配置换模型只改一个 Model ID。下面会给出具体可复制的配置片段。2. 部署前把 TaoToken 的 Key 和地址准备好不管你走云服务器还是本地OpenClaw 都需要一个模型服务地址。这里用 TaoToken 作为统一入口它的好处是兼容 OpenAI 的/v1/chat/completions协议OpenClaw 这类框架基本都能直接对接不用为每个模型单独改代码。你需要准备三样东西我把它叫“三件套”后面所有配置都围绕它Base URLhttps://taotoken.net/apiAPI Key在控制台创建形如sk-开头的一串Model ID填你要用的模型标识比如对话类或代码类模型名创建 Key 的入口在这里登录后进控制台新建即可控制台地址https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite如果你还没决定用哪个模型可以先在模型对话页面试一下确认能正常返回再写进配置模型对话体验https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteKey 的管理和查看在 API Keys 页面建议给 OpenClaw 单独建一个 Key方便以后按用途区分和吊销API Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite这里有个新手常犯的错把 Base URL 写成带/v1或带具体路径的地址。OpenClaw 的配置项通常只需要根地址框架自己会拼/v1/chat/completions。如果你填成https://taotoken.net/api/v1有些版本会拼成/v1/v1/...直接 404。所以统一填https://taotoken.net/api最稳。另外提醒一句Key 不要写进会提交到 Git 的文件里。云服务器上建议放在config目录并限制权限本地就放项目目录下的.env或配置文件别截图发群里。3. 云服务器与本地两套可复制配置这一节是核心给你两份能直接抄的配置。先讲云服务器再讲本地最后给一个统一的模型配置片段。3.1 云服务器Docker 起 OpenClaw假设你已经有一台 2 核 2G 起步的服务器系统用 Ubuntu 22.04 或 Alibaba Cloud Linux 3 都行。先装 Dockercurl -fsSL https://get.docker.com | bash systemctl start docker systemctl enable docker docker --version然后建工作目录并拉镜像mkdir -p /opt/openclaw/config /opt/openclaw/data cd /opt/openclaw docker pull openclaw/openclaw:2026-stable启动容器注意端口映射和挂载路径要和后面配置一致docker run -d \ --name openclaw \ -p 18789:18789 \ -v /opt/openclaw/config:/app/config \ -v /opt/openclaw/data:/app/data \ --restartalways \ openclaw/openclaw:2026-stable确认在跑docker ps | grep openclaw3.2 本地部署一条命令起服务本地更简单装好 Docker Desktop 后执行同样的镜像只是端口映射到本机docker run -d \ --name openclaw \ -p 18789:18789 \ -v ~/openclaw/config:/app/config \ -v ~/openclaw/data:/app/data \ --restartalways \ openclaw/openclaw:2026-stable本地访问就是http://127.0.0.1:18789不需要放行任何防火墙。3.3 统一模型配置片段JSONOpenClaw 的模型配置一般放在config目录下的配置文件里。下面这份 JSON 你可以直接改 Key 和 Model ID 后使用路径对应容器里的/app/config/model.json{ provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的Key填这里, model: 你的ModelID, timeout: 60, max_tokens: 2048 }如果你用的是 TOML 风格的配置部分版本支持等价写法是[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的Key填这里 model 你的ModelID timeout 60写完配置后重启容器让它生效docker restart openclaw这里再强调一次三件套的对应关系缺一不可Base URL 填https://taotoken.net/apiKey 填你创建的sk-串Model ID 填具体模型名。三个里错一个请求就会失败报错形态还不一样下一节会讲怎么对号入座。4. 验证请求与 skills 挂载成功配置写完别急着高兴先验证模型通不通再验证 skills 能不能调。4.1 验证模型连通最直接的办法是进容器里跑一次初始化或自检命令docker exec -it openclaw openclaw init如果配置正确它会读取model.json并尝试连接模型服务返回成功即说明三件套没问题。你也可以直接看日志docker logs -f openclaw日志里出现类似model connected或成功返回的响应就说明链路通了。如果卡住或报错先别动 skills回到第 5 节排查。4.2 挂载 skillsOpenClaw 的能力扩展靠 skills。常用的一批可以这样装docker exec -it openclaw openclaw skills install file-manager docker exec -it openclaw openclaw skills install summary docker exec -it openclaw openclaw skills install scheduler docker exec -it openclaw openclaw skills install weather装完重启docker restart openclaw查看已安装的 skills 列表确认挂载成功docker exec -it openclaw openclaw skills list列表里能看到你装的几个名字就说明 skills 挂载完成。4.3 打开面板做一次真实调用浏览器访问http://你的服务器IP:18789本地就是http://127.0.0.1:18789。首次进入会生成配对码或 Token保存好。进后台后在对话里让它做一件具体的事比如“帮我列出当前目录下的文件”如果它调用了 file-manager 并返回结果整个闭环就跑通了。这一步是检验成果的关键模型通了、skills 挂了、面板能对话三者同时成立才算成功。5. 常见报错逐条排查新手遇到的报错其实就那么几类我按真实报错信息给你对照。401 UnauthorizedKey 错了或没生效。检查api_key是不是完整的sk-串有没有多余空格配置改完有没有docker restart openclaw。还有一种情况是 Key 被吊销了去 API Keys 页面确认状态。local proxy failed / connection refusedBase URL 写错或网络不通。确认填的是https://taotoken.net/api不要带/v1。云服务器上可以先curl一下确认能出网。reading choices 相关报错通常是返回结构不符合预期多半是 Model ID 填错或者 Base URL 拼出了重复路径。回到配置把 Model ID 换成确认可用的模型名。OAuth / 鉴权跳转类报错说明请求被当成了需要网页登录的流程一般是地址填成了控制台地址而不是 API 地址。Base URL 必须是https://taotoken.net/api不是网页地址。端口占用 / 容器起不来先删旧容器再起docker rm -f openclaw然后重新执行第 3 节的docker run命令。面板打不开90% 是防火墙没放行 18789。云服务器要去安全组或防火墙加一条入方向 TCP 18789 规则授权对象0.0.0.0/0。本地则检查端口有没有被别的程序占用。Docker 安装失败换国内镜像源重装yum install -y yum-utils yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo yum install -y docker-ce docker-ce-cli containerd.io systemctl start docker排查顺序建议固定成先看容器在不在跑再看日志报什么再对号入座上面的条目。别一上来就重装多数问题改一行配置就好。6. 长期跑 Agent 就用 Coding Plan 统一管 Key如果你只是偶尔用用按上面的配置就够了。但如果你打算让 OpenClaw 长期挂着跑定时任务、自动化流程Key 的额度和模型切换会变成日常问题。这时候建议用 Coding Plan 来统一管理把对话、代码、Agent 调用都收敛到一个入口换模型不用改 OpenClaw 的配置只改 Model ID 就行。长期编码和 Agent 场景的入口在这里Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite接入文档里有各框架的对接示例OpenClaw 这类兼容 OpenAI 协议的工具照着改 Base URL 和 Key 即可接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite最后给你一个我实测下来最省事的习惯把三件套写进一个.env文件配置里用变量引用这样云上和本地共用一份换 Key 只改一处。OpenClaw 跑起来之后先让它做一件小事验证再逐步加 skills别一上来就装一堆出问题不好定位。
