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.jsonWindowsC:\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_nameKey 和地址不用动。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 UIcurl 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] DescriptionOpenClaw Gateway Afternetwork.target [Service] Typesimple User$USER ExecStart/usr/bin/openclaw gateway start Restarton-failure [Install] WantedBymulti-user.target EOF sudo systemctl daemon-reload sudo systemctl enable openclaw sudo systemctl start openclaw这样服务器重启后 OpenClaw 会自动拉起不用每次手动敲命令。5. 部署中真实报错对照与排查部署过程里我遇到过几个典型报错对照着排查能省不少时间。401 UnauthorizedAPI Key 错了或没生效。检查config.json里api_key有没有多余空格百炼的 Key 是否已实名认证、额度是否充足。如果是 TaoToken 的 Key确认在 API Keys 页面没有删除。local proxy failed / connection refusedBase URL 写错或网络不通。百炼的地址是https://dashscope.aliyuncs.com/compatible-mode/v1TaoToken 是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 foundnpm 全局路径没进 PATH。执行npm config get prefix看路径把它加到~/.bashrc的 PATH 里然后source ~/.bashrc。服务启动后自动退出多半是内存不足。openclaw logs看是不是 OOM腾讯云实例升到 2GB 以上或加 swapsudo 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 秒内定位是配置问题还是网络问题比盲目重启服务器高效得多。