★ FEATURED ARTICLE 1. 为什么零基础在腾讯云装 OpenClaw 总卡在第一步OpenClaw曾用名 Clawdbot是一个可以本地部署、带记忆和 Skills 插件机制的 AI 智能体框架。它能听懂自然语言指令帮你做文件管理、信息检索、内容处理、流程自动化这些实际动作而不是只会在对话框里聊天。适合谁适合想在腾讯云轻量服务器上跑一个长期在线、数据自己可控的智能体但又没有 Node.js 经验的开发者。我见过太多人第一次装 OpenClaw 的路径是这样的买好腾讯云轻量服务器SSH 登进去敲npm install -g openclaw然后终端甩出一句npm: command not found人就懵了。问题不在 OpenClaw在于腾讯云的公共镜像默认不带 Node.js而 OpenClaw 的运行底座就是 Node.js 22.x 及以上。你跳过环境直接装框架等于没打地基就砌墙。第二个高频卡点是模型接入。OpenClaw 本身不带大模型它需要对接一个 API 才能完成理解和生成。很多人卡在阿里云百炼的 Key 配置上或者把 endpoint 写死在某个厂商地址换模型就得改一遍配置。这篇的做法是环境用腾讯云轻量服务器从零搭模型通道统一改到 TaoToken 的 Key/API 通道settings 里只维护一份 endpoint后面换模型不用动框架代码。第三个卡点是 Skills 加载。OpenClaw 的能力靠 Skills 扩展但装完技能不重启网关技能就是不生效很多人以为装失败了。下面我会把这三段拆成可复制的命令和配置你跟着敲就行。先把整体路径说清楚腾讯云轻量服务器选 Ubuntu 22.04 或 Debian 12 镜像装 Node.js 22装 OpenClaw跑openclaw onboard初始化装 clawhub 和常用 Skills然后把 settings 里的模型 endpoint 指向 TaoToken最后用一次对话请求验证连通性。全程不需要你懂 Node.js 语法只需要会复制粘贴命令、会改一个 JSON 文件。有一点提前说腾讯云轻量服务器的安全组要放行 18789 端口这是 OpenClaw Web 控制台的默认端口。不放行服务起来了你也打不开页面会误以为部署失败。这个坑后面排障章节还会展开。2. TaoToken 前置统一 Key 与 API 通道怎么准备在动手改 settings 之前先把 TaoToken 这一侧的准备工作做完否则你配置写到一半发现没有 Key还得回头补。TaoToken 在这里扮演的角色是「统一模型通道」。OpenClaw 的 settings 里有一段模型配置原本你可能要填某个厂商的 base_url、api_key、model_name。如果直接绑死某一家以后想换模型就得改配置、重启服务。把 endpoint 改到 TaoToken 之后你维护的是一份统一的 Key 和 API 地址模型 ID 在请求里指定切换成本低很多。你需要准备三样东西我把它叫「三件套」Base URL、API Key、Model ID。这三件套在 OpenClaw 的 settings 里对应base_url、api_key、model_name三个字段缺一个都跑不通。Base URL 用https://taotoken.net/api注意这个地址不带任何查询参数直接填进配置。API Key 需要你去控制台生成入口在 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。生成后复制保存好这个 Key 只显示一次丢了就重新生成。Model ID 是你实际要调用的模型标识。如果你不确定填哪个可以先到模型对话页面试一下https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 在页面上选一个模型发一句话确认能返回结果再把对应的模型 ID 抄到配置里。这样能避免「配置写对了但模型名不存在」这种低级错误。如果你打算长期跑编码类或 Agent 类任务可以了解一下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。它的定位是给长期编码和 Agent 场景用的套餐比按次调用更适合高频使用。不过第一次部署验证连通性用普通 Key 就够了不用一上来就上套餐。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各语言的调用示例和参数说明。你配置 OpenClaw 时如果对某个字段拿不准翻一下文档比瞎试快。这里强调一个原则OpenClaw 的 settings 里模型相关的字段只保留一份endpoint 指向 TaoTokenKey 用 TaoToken 生成的。不要一边填阿里云百炼的 Key一边又填 TaoToken 的地址那样请求会 401。要么全走百炼要么全走 TaoToken这篇走后者。准备好这三件套之后再回到腾讯云服务器上继续。顺序很重要先有 Key 再改配置改完立刻能验证不用来回切换页面。3. 腾讯云轻量服务器可复制配置Node.js OpenClaw settings这一节是全文的核心操作区命令和配置都可以直接复制。我按「系统准备 → Node.js → OpenClaw → Skills → settings 改 endpoint」的顺序走你从上往下执行即可。3.1 系统更新与基础依赖SSH 登录腾讯云轻量服务器后先更新系统并装基础工具。Ubuntu/Debian 用下面这组sudo apt update sudo apt upgrade -y sudo apt install -y curl git xz-utils如果你选的是 CentOS 系镜像把apt换成yumsudo yum update -y sudo yum install -y curl git xz3.2 安装 Node.js 22OpenClaw 要求 Node.js 22.x 及以上。用官方二进制包安装最稳不依赖系统包管理器的版本curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz | sudo tar -xJ -C /usr/local sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/node /usr/bin/node sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/npm /usr/bin/npm验证一下node -v npm -v能打印出v22.0.0和对应的 npm 版本号说明环境就绪。如果提示command not found检查软链接路径是不是写错了。3.3 配置 npm 镜像并安装 OpenClaw国内服务器直连 npm 官方源可能很慢先切镜像npm config set registry https://registry.npmmirror.com然后全局安装 OpenClawnpm install -g openclaw安装完成后执行初始化openclaw onboard按提示走同意协议、选择快速启动、模型配置这一步先跳过我们后面手动改 settings、启用全部通道。初始化会在用户目录下生成配置文件夹。3.4 设置公网访问与启动服务腾讯云轻量服务器要让外部访问 Web 控制台需要把网关监听地址设为0.0.0.0openclaw config set gateway.host 0.0.0.0 openclaw config set gateway.port 18789 openclaw gateway start启动后检查状态openclaw gateway status看到 running 就对了。别忘了去腾讯云控制台的安全组里放行 18789 端口协议 TCP来源可以先用你的公网 IP 限制验证通了再放开。3.5 安装 Skills 技能Skills 是 OpenClaw 的能力扩展。先装技能管理工具 clawhubnpm install -g clawhub然后按需安装常用技能clawhub install tavily-search clawhub install agent-browser clawhub install summarize clawhub install skill-vetter装完查看列表openclaw skill list关键一步技能装完必须重启网关才会加载openclaw gateway restart很多人装完技能发现不生效就是漏了这步重启。3.6 把 settings 的 endpoint 改到 TaoToken这是本篇的重点。OpenClaw 的配置文件路径Linux/macOS~/.openclaw/config.jsonWindowsC:\Users\用户名\.openclaw\config.json用编辑器打开找到model段改成下面这样。注意 JSON 里不要留注释字段名和值都要用双引号{ model: { type: openai, base_url: https://taotoken.net/api, api_key: 你的TaoToken API Key, model_name: 你的Model ID, max_tokens: 2048, temperature: 0.7, timeout: 60, reasoning: false } }三个字段对应关系再确认一遍base_url填https://taotoken.net/apiapi_key填你在控制台生成的 Keymodel_name填你要调用的模型 ID。type保持openai是因为 TaoToken 的接口兼容 OpenAI 格式OpenClaw 用这个类型就能对接。改完保存重启网关openclaw gateway restart到这里配置部分就完成了。下一节验证请求。4. 验证请求一次对话确认连通性与返回结果配置写完不代表通了必须发一次真实请求看返回。这一步能帮你区分「配置写错」和「网络不通」两类问题。4.1 用 Web 控制台发第一句话浏览器打开http://你的腾讯云公网IP:18789进入对话页面输入一句简单的指令比如「你好帮我列一下当前目录下的文件」。如果模型通道配对了你会看到它返回一段自然语言回复并且可能触发文件列表这个动作。如果页面打不开先别怀疑模型配置那是网关或安全组的问题去第 5 节排障。4.2 用命令行直接验证模型通道Web 页面能打开但对话没反应说明问题在模型通道。这时用命令行直接打一次请求把变量隔离出来curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的TaoToken API Key \ -H Content-Type: application/json \ -d { model: 你的Model ID, messages: [{role: user, content: 回复两个字通了}] }如果返回 JSON 里choices[0].message.content有内容说明 Key、Base URL、Model ID 三件套都是对的问题在 OpenClaw 的 settings 或网关。如果这里就报错对照第 5 节的错误码排查。4.3 看 OpenClaw 日志确认请求链路OpenClaw 的日志能告诉你请求有没有发出去、发到哪、返回了什么openclaw logs --follow保持这个终端开着回到 Web 控制台再发一句话观察日志里有没有出现请求记录。如果日志里完全没有模型请求说明 settings 没被加载检查配置文件路径和 JSON 格式。如果日志里有请求但报错错误信息会直接指向原因。4.4 成功结果长什么样一次成功的验证你会看到三个信号同时出现Web 控制台返回了有意义的回复openclaw logs里能看到请求和响应记录命令行 curl 也能拿到choices字段。三个都通说明从腾讯云服务器到 TaoToken 的整条链路是活的。到这一步OpenClaw 已经能正常对话了。接下来你可以继续装更多 Skills或者把模型 ID 换成更适合你任务的模型settings 里的 endpoint 不用动。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来你遇到哪条对哪条。5.1 401 Unauthorized最常见。原因通常是 Key 填错、Key 前后有空格、或者 Key 已经失效。检查config.json里api_key的值确认没有多余空格和换行。如果刚生成就报 401去控制台重新生成一个再试。还有一种情况是你把百炼的 Key 填到了 TaoToken 的地址上两边不匹配也会 401。5.2 local proxy failed这个报错说明 OpenClaw 尝试走本地代理但失败了。检查你的 settings 里有没有残留的 proxy 配置字段有就删掉。同时确认服务器本身能正常访问外网用curl -I https://taotoken.net/api测一下连通性。如果服务器网络本身有问题先解决网络再谈模型。5.3 reading choices 相关报错类似cannot read property choices of undefined这种说明返回的 JSON 结构里没有choices字段。原因一般是base_url写错了比如漏了/api或者多写了/v1。TaoToken 的 Base URL 就是https://taotoken.net/apiOpenClaw 会自己拼接路径你不要手动加/v1/chat/completions。另外model_name填了一个不存在的模型 ID也可能返回非标准结构去模型对话页面确认模型 ID 拼写。5.4 OAuth 相关报错如果你在配置里看到 OAuth 字样说明 settings 里混入了需要 OAuth 授权的模型类型配置。OpenClaw 对接 TaoToken 用的是 API Key 方式不需要 OAuth。检查model.type是不是被改成了别的值保持openai即可。如果之前配过其他厂商的 OAuth 字段一并清理掉。5.5 服务起不来或端口占用openclaw gateway start没反应先看状态openclaw gateway status端口被占用的话Linux 下查lsof -i:18789 kill -9 进程IDWindows 下netstat -ano | findstr 18789 taskkill /F /PID 进程ID5.6 技能装了不生效回到第 3.5 节确认执行了openclaw gateway restart。技能加载是在网关重启时完成的不重启就不生效。用openclaw skill list确认技能在列表里再用openclaw skill status 技能名看状态。5.7 权限不足Linux/macOS 下全局安装报权限错误加sudosudo npm install -g openclawWindows 下如果 PowerShell 禁止运行脚本执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser配置文件写不进去检查当前用户对~/.openclaw/目录有没有读写权限必要时重新初始化openclaw onboard --reset排障的核心思路是分层先确认网关活着再确认 Web 能打开再确认模型通道通最后确认 Skills 加载。一层一层往下查比一上来就改配置高效得多。6. 把 OpenClaw 长期跑在腾讯云上的几个实用建议部署通了只是开始长期跑还有几个细节值得注意。开机自启这块Linux 下可以把启动命令写进 rc.localecho /usr/bin/openclaw gateway start | sudo tee -a /etc/rc.local sudo chmod x /etc/rc.local更规范的做法是写 systemd service但 rc.local 对零基础足够用。模型通道方面settings 里的 endpoint 指向 TaoToken 之后你换模型只需要改model_name一个字段不用动base_url和api_key。这是统一通道的价值。如果你后面要跑编码类或 Agent 类的高频任务可以去看看 Coding Plan 是否合适https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。安全上18789 端口不要对全网开放。腾讯云安全组里把来源限制成你自己的 IP验证阶段可以临时放开稳定后收紧。API Key 不要提交到任何公开仓库配置文件权限设成只有当前用户可读。日志排查养成习惯openclaw logs --follow常开着出问题第一时间能看到请求链路。Skills 按需装不要一次装一堆用不上的每个技能都会占资源也会增加排查复杂度。最后接入文档放在手边https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。字段拿不准的时候翻文档比在群里问快。Key 管理在 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 需要轮换或新增时去那里操作。整套流程走下来从腾讯云空服务器到 OpenClaw 能对话熟练之后确实很快。真正花时间的不是敲命令而是排障时定位问题在哪一层。把第 5 节的分层思路记住后面遇到新报错也能自己推。
阅读完成 · 觉得有帮助？
