1. 为什么在腾讯云上跑 OpenClaw 总卡在模型接入这一步
OpenClaw 是一个可以本地部署、带记忆和插件扩展能力的 AI 智能体框架，能通过自然语言让你完成文件管理、信息检索、内容处理和流程自动化。它依赖 Node.js 运行，既可以放在云端服务器长期在线，也能在本地设备上离线跑。适合谁？想自己搭一个可控智能体、又不想被单一模型厂商绑死的开发者和小团队。
但我在腾讯云轻量服务器上部署时，真正卡住的不是安装，而是模型接入。OpenClaw 本身装起来很快，npm install -g openclaw一条命令就完事，可一旦要接大模型，问题就来了：百炼 Coding Plan 的 Key 填哪里、Base URL 写什么、模型名用哪个，官方文档给的位置和实际配置文件经常对不上。更麻烦的是，如果你同时想用多个模型通道，每个通道一套 Key、一套地址，配置散落在不同文件里，改一次要翻半天。
这篇就聚焦腾讯云轻量服务器这条链路，把 Node.js 环境初始化、OpenClaw 安装、百炼 Coding Plan 的 API Key 与 Base URL 填写位置讲清楚，再给一个 TaoToken 统一 Key 通道的配置示例，最后用一次真实对话请求验证部署是否成功。全程命令可直接复制，7 分钟能跑通。
先说清楚一个概念：OpenClaw 的模型配置本质上是告诉它「去哪里请求、用什么身份、调哪个模型」。这三件事分别对应 Base URL、API Key、Model ID。很多人部署失败，不是 OpenClaw 坏了，而是这三件套里有一个填错了位置。下面按顺序来。
2. 腾讯云轻量服务器准备与 Node.js 22 环境初始化
腾讯云轻量应用服务器的选购不复杂，但有几个参数直接影响 OpenClaw 能不能跑起来。实例规格建议 2 核 2GB 内存起步，系统盘 40GB 以上，系统选 Ubuntu 22.04 或 Debian 12 都行。安全组要放行 18789 端口，这是 OpenClaw Web 控制台的默认端口。登录方式用 Web 终端或 SSH 工具都可以。
买好实例后，第一件事是更新系统并装基础依赖。Ubuntu/Debian 系执行：
sudo apt update && sudo apt upgrade -y sudo apt install -y curl git build-essentialCentOS/Alibaba Cloud Linux 系则用：
sudo yum update -y sudo yum install -y curl git接下来装 Node.js 22。OpenClaw 要求 Node.js 22.x 及以上，版本低了会在启动时报错。推荐用 NodeSource 源安装，比手动解压 tar.xz 更省事，也方便后续升级：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs装完验证版本：
node -v npm -v正常应该输出 v22.x.x 和对应的 npm 版本号。如果提示node: command not found，说明 PATH 没生效，执行hash -r或重新登录终端即可。
然后配置 npm 镜像，国内服务器直连官方源会慢到怀疑人生：
npm config set registry https://registry.npmmirror.com这一步做完，环境就绪。我试过在 1 核 1GB 的实例上装，npm 安装阶段直接 OOM 被杀进程，所以内存别省，2GB 是底线。另外腾讯云轻量服务器的防火墙和安全组是两层，安全组放行了不代表系统防火墙放行，Ubuntu 上还要确认 ufw 状态：
sudo ufw status sudo ufw allow 18789/tcp如果 ufw 没启用，可以跳过这步，但安全组一定要放行 18789，否则后面 Web 控制台打不开，你会以为是 OpenClaw 的问题，其实是网络层被拦了。
3. 安装 OpenClaw 并写入百炼 Coding Plan 配置
环境好了，装 OpenClaw 就一条命令：
npm install -g openclaw装完执行初始化：
openclaw onboard按提示走：同意协议、选择快速启动、模型配置这一步可以先跳过（我们手动写配置文件更可控）、启用全部通道。初始化完成后，OpenClaw 会在用户目录下生成配置文件夹。
配置文件路径要记牢：
- Linux/macOS：
~/.openclaw/config.json - Windows：
C:\Users\用户名\.openclaw\config.json
百炼 Coding Plan 的接入，核心是把 API Key、Base URL、Model ID 三件套填对。先到百炼控制台的密钥管理里创建 API Key，复制保存好。然后编辑~/.openclaw/config.json，在 model 段写入：
{ "model": { "type": "openai", "api_key": "你的百炼APIKey", "base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1", "model_name": "qwen-plus", "max_tokens": 2048, "temperature": 0.7, "timeout": 60, "reasoning": false } }这里几个点容易踩坑。type写openai是因为百炼提供 OpenAI 兼容接口，不是让你去连 OpenAI。base_url必须带/v1结尾，少一段会报 404。model_name用百炼支持的模型 ID，比如qwen-plus、qwen-turbo，写错了会返回 model not found。reasoning设 false 是为了避免部分模型返回空内容。
如果你想像我一样，用一个统一 Key 通道管理多个模型来源，可以在 TaoToken 的 API Keys 页面生成一个 Key，然后把 base_url 指向统一入口：
{ "model": { "type": "openai", "api_key": "你的TaoTokenKey", "base_url": "https://taotoken.net/api/v1", "model_name": "claude-sonnet-4-5", "max_tokens": 4096, "temperature": 0.7, "timeout": 60, "reasoning": false } }这样切换模型时只改model_name，Key 和地址不用动。TaoToken 的接入文档里有完整的模型 ID 列表，配置前对一下就行。改完配置重启网关：
openclaw gateway restart重启后看日志确认没有报错：
openclaw logs --follow日志里出现 gateway started 且没有 model 相关 error，说明配置被正确加载了。
4. 启动服务并用一次对话请求验证部署
配置写好后，设置公网访问并启动：
openclaw config set gateway.host 0.0.0.0 openclaw config set gateway.port 18789 openclaw gateway start浏览器打开http://服务器公网IP:18789，能看到 Web 控制台就说明服务起来了。但控制台能打开不代表模型能通，必须发一次真实请求验证。
在控制台对话框输入一句测试指令，比如「帮我总结一下 OpenClaw 的核心能力」。如果模型配置正确，几秒内会返回一段通顺的中文。如果返回空、报错或一直转圈，就是模型通道有问题。
也可以用命令行直接验证，绕过 Web UI：
curl http://127.0.0.1:18789/api/chat \ -H "Content-Type: application/json" \ -d '{"message":"你好，请回复一句话确认模型连通"}'正常返回类似：
{ "reply": "模型连通正常，我是 OpenClaw。", "model": "qwen-plus", "usage": {"prompt_tokens": 12, "completion_tokens": 18} }看到reply字段有内容，且model是你配置的模型名，就说明整条链路通了：腾讯云服务器 → OpenClaw 网关 → 模型 API → 返回结果。这一步过了，部署才算真正成功。
如果想让服务开机自启，Ubuntu 下用 systemd 更规范：
sudo tee /etc/systemd/system/openclaw.service <<EOF [Unit] Description=OpenClaw Gateway After=network.target [Service] Type=simple User=$USER ExecStart=/usr/bin/openclaw gateway start Restart=on-failure [Install] WantedBy=multi-user.target EOF sudo systemctl daemon-reload sudo systemctl enable openclaw sudo systemctl start openclaw这样服务器重启后 OpenClaw 会自动拉起，不用每次手动敲命令。
5. 部署中真实报错对照与排查
部署过程里我遇到过几个典型报错，对照着排查能省不少时间。
401 Unauthorized：API Key 错了或没生效。检查config.json里api_key有没有多余空格，百炼的 Key 是否已实名认证、额度是否充足。如果是 TaoToken 的 Key，确认在 API Keys 页面没有删除。
local proxy failed / connection refused：Base URL 写错或网络不通。百炼的地址是https://dashscope.aliyuncs.com/compatible-mode/v1，TaoToken 是https://taotoken.net/api/v1，结尾的/v1不能少。服务器上执行curl -I https://taotoken.net/api/v1看能否返回 200。
reading choices 报错 / 返回为空：模型返回结构不符合预期。在配置里加"reasoning": false，并把max_tokens调小到 1024 试试。部分模型在流式返回时字段名不同，OpenClaw 解析会失败。
OAuth 相关报错：如果你用的是需要 OAuth 的通道，检查 token 是否过期。OpenClaw 的 OAuth 配置在~/.openclaw/auth.json，删掉重新走一遍授权流程即可。
端口被占用：
lsof -i:18789 kill -9 进程IDopenclaw: command not found：npm 全局路径没进 PATH。执行npm config get prefix看路径，把它加到~/.bashrc的 PATH 里，然后source ~/.bashrc。
服务启动后自动退出：多半是内存不足。openclaw logs看是不是 OOM，腾讯云实例升到 2GB 以上，或加 swap：
sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile排查时记住一个顺序：先看日志openclaw logs --follow，再用 curl 单独测模型接口，最后才怀疑 OpenClaw 本身。大部分问题都在 Key、地址、模型名这三件套上。
6. 后续怎么用：Skills 扩展与统一 Key 通道
部署通了只是开始。OpenClaw 的能力靠 Skills 扩展，装技能管理工具：
npm install -g clawhub clawhub install tavily-search clawhub install summarize clawhub install agent-browser装完重启网关加载：
openclaw gateway restart openclaw skill list技能生效后，你就能让 OpenClaw 联网搜索、做内容摘要、操作浏览器。这些技能本身不依赖特定模型，但模型越强，任务完成度越高。
如果你打算长期跑编码类或 Agent 类任务，建议把模型通道统一到 TaoToken 的 Coding Plan 上，一个 Key 覆盖多个模型，切换时只改model_name，不用反复改配置。接入文档里有完整的 Base URL 和模型 ID 对照，配置前扫一眼能避免拼写错误。验证模型是否可用时，可以直接在模型对话页面发一条测试消息，比在服务器上 curl 更直观。
最后留一个实用习惯：每次改完config.json，先openclaw gateway restart，再openclaw logs --follow看启动日志，确认没有 error 再去 Web 控制台发请求。这个顺序能让你在 30 秒内定位是配置问题还是网络问题，比盲目重启服务器高效得多。
