1. 为什么要在腾讯云上跑 OpenClaw
OpenClaw(曾用名 Clawdbot)是一个可以自己部署的 AI Agent 框架,核心能力是让模型不只是聊天,而是能真正动手:读写文件、联网搜索、调用浏览器、做内容摘要、跑自动化流程。它靠 Node.js 运行,支持云端服务器长期在线,也支持本地离线跑,数据默认落在自己机器上,可控性比纯 SaaS 强不少。
适合谁?一类是想在云端挂一个 7×24 小时在线的 Agent、随时用手机或浏览器下指令的开发者;另一类是想把大模型 API Key 统一管理、不想在多个项目里到处粘贴密钥的人。我这次选腾讯云轻量应用服务器,原因是开箱即用、按量便宜、公网 IP 直接给,2 分钟内能跑通一个可访问的 Web 控制台。
整篇的路线是:腾讯云环境准备 → Node.js 依赖 → TaoToken 统一 Key 接入 → 大模型 API Key 写进 config.toml → Skill 集成 → 启动自检。命令都能直接复制,遇到报错我在第 5 节集中排。
2. 前置准备:TaoToken 统一 Key 与腾讯云环境
2.1 为什么用 TaoToken 而不是每个模型单独配 Key
OpenClaw 的模型配置支持多种 provider,但如果你同时想用不同厂商的模型做对比,或者 Skill 里要调不同能力,一个个去各平台申请 Key、记额度、改配置会很碎。TaoToken 的思路是提供一个统一的 API 入口,你拿一个 Key,就能在 OpenClaw 里通过改base_url和model_name切换后端模型,配置骨架不用大改。
对 OpenClaw 这种需要频繁切换模型试效果的场景,这点很实用。你可以在模型对话页面先验证 Key 能不能正常出结果,再写进配置文件。
- 官网入口:https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
- API 地址(写进配置用这个,不带参数):https://taotoken.net/api
- 拿 Key 的地方:https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
- 接入文档:https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
注意:API 地址填
https://taotoken.net/api,不要带任何查询参数,否则部分客户端会拼接出错。
2.2 腾讯云轻量服务器配置
在腾讯云控制台买一台轻量应用服务器,配置参考:
| 项目 | 建议值 | 说明 |
|---|---|---|
| 镜像 | Ubuntu 22.04 LTS | 依赖安装最顺 |
| 规格 | 2 核 2GB 起 | 1GB 内存跑 Agent 容易 OOM |
| 系统盘 | 40GB 以上 | 装 Node 和 Skill 够用 |
| 防火墙 | 放行 18789 | OpenClaw Web 控制台默认端口 |
| 登录 | SSH 密钥或密码 | 后面用 SSH 操作 |
买完在「防火墙」里加一条规则:TCP 18789,来源0.0.0.0/0(测试阶段先全开,稳定后建议限制来源 IP)。
2.3 登录服务器并检查环境
用 SSH 连上服务器,先看系统版本和内存:
cat /etc/os-release free -hfree -h里 available 低于 800MB 的话,建议升配,不然后面启动网关会莫名退出。
3. 可复制配置:Node.js、OpenClaw 与 config.toml
3.1 安装 Node.js 22 与基础工具
OpenClaw 要求 Node.js 22.x 及以上。Ubuntu 用 NodeSource 源装最省事:
sudo apt update sudo apt install -y curl git curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs node -v npm -vnode -v输出v22.x.x就对了。如果提示command not found,说明上一步没装成功,重跑 NodeSource 那两行。
3.2 配置 npm 镜像并安装 OpenClaw
国内服务器直连 npm 官方源会慢,先换镜像:
npm config set registry https://registry.npmmirror.com npm install -g openclaw openclaw --versionopenclaw --version能打印版本号,说明全局安装成功。
3.3 初始化并设置公网访问
openclaw onboard按提示走:同意协议 → 选择快速启动 → 模型配置先跳过(下一步手写)→ 启用需要的通道。初始化完成后设置监听地址和端口:
openclaw config set gateway.host 0.0.0.0 openclaw config set gateway.port 18789gateway.host设成0.0.0.0才能从公网访问,只设127.0.0.1的话外网打不开。
3.4 写入 config.toml 模型骨架
OpenClaw 的模型配置写在config.toml里。路径一般是:
- Linux/macOS:
~/.openclaw/config.toml - Windows:
C:\Users\用户名\.openclaw\config.toml
先确认文件位置:
ls -la ~/.openclaw/用编辑器打开config.toml,写入下面这段骨架。把你的TaoToken密钥换成你在 api-keys 页面拿到的 Key:
[model] provider = "openai-compatible" base_url = "https://taotoken.net/api" api_key = "你的TaoToken密钥" model_name = "gpt-4o-mini" max_tokens = 2048 temperature = 0.7 timeout = 60 reasoning = false几个参数的作用:
| 参数 | 作用 | 建议 |
|---|---|---|
provider | 协议类型 | 统一用 openai-compatible |
base_url | API 入口 | 固定https://taotoken.net/api |
model_name | 调用的模型 | 按需换,先小模型验证 |
timeout | 超时秒数 | 云端建议 60 |
reasoning | 推理链开关 | 回复为空时设 false |
注意:
base_url结尾不要加/v1或斜杠,OpenClaw 会自己拼路径,多写反而 404。
改完重启网关让配置生效:
openclaw gateway restart4. 验证请求与 Skill 集成
4.1 启动服务并做一次自检
openclaw gateway start openclaw gateway statusstatus显示 running 就说明网关起来了。然后看日志确认模型配置被加载:
openclaw logs --follow日志里出现模型初始化的记录、没有api_key invalid之类的报错,就说明 Key 接对了。浏览器打开:
http://你的服务器公网IP:18789能进 Web 控制台,输入一句「你好,帮我列一下当前目录文件」,模型能返回结果,说明整条链路通了。
4.2 安装 Skill 管理工具
Skill 是 OpenClaw 的功能扩展模块,搜索、浏览器操作、摘要、文件管理都靠它。先装管理工具:
npm install -g clawhub clawhub --version4.3 安装常用 Skill
clawhub install tavily-search clawhub install agent-browser clawhub install summarize clawhub install skill-vetter通用格式就是clawhub install <技能名>。装完查看列表:
openclaw skill list4.4 启动 Skill 并验证生效
openclaw skill start tavily-search openclaw skill status tavily-searchstatus显示 enabled 后,重启网关加载:
openclaw gateway restart回到 Web 控制台,输入「用搜索查一下今天的天气」,如果返回的是实时搜索结果而不是模型编的内容,说明 Skill 已经挂上了。
4.5 完整启动自检流程
把上面串成一条可复现的检查链,每次改完配置跑一遍:
node -v openclaw --version openclaw gateway status openclaw skill list openclaw logs --follow五项依次通过:Node 版本对、OpenClaw 装好、网关在跑、Skill 列表非空、日志无报错,就算部署完成。
5. 本篇常见错排查
5.1 openclaw: command not found
全局安装没进 PATH。先确认:
npm root -g看输出的全局目录在不在 PATH 里。不在的话重装一次:
npm install -g openclaw或者关掉终端重开,让 PATH 刷新。
5.2 服务启动后自动退出
多半是内存不够。free -h看 available,低于 800MB 就升配。也可以看日志定位:
openclaw logs如果是端口被占用,查一下:
lsof -i:18789 kill -9 进程ID5.3 公网打不开 Web 控制台
按顺序查三件事:网关是否在跑(openclaw gateway status)、腾讯云防火墙是否放行 18789、gateway.host是否设成了0.0.0.0。三个都对还打不开,重启网关再试。
5.4 模型调用失败或回复为空
先确认config.toml里api_key没写错、base_url是https://taotoken.net/api且没带多余路径。回复为空时,把reasoning设成false再重启。响应超时就调大timeout、调小max_tokens。
5.5 Skill 装了不生效
clawhub命令不可用就重装npm install -g clawhub。装完不生效,先openclaw skill list看有没有,再openclaw gateway restart重启加载。安装失败多半是镜像问题,重设npm config set registry https://registry.npmmirror.com再装。
5.6 配置文件写不进去
检查当前用户对~/.openclaw/的读写权限。实在乱了就重置:
openclaw onboard --reset6. 后续怎么用与 Key 管理
跑通之后,日常就是openclaw gateway start起服务、浏览器进控制台下指令、openclaw logs --follow看执行过程。Skill 按需加,不用一次装全,装多了启动会慢。
模型这块,如果你要长期跑编码类任务或 Agent 自动化,建议用 Coding Plan 把调用成本压下来,比按 token 计费更适合高频场景:https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
想先验证模型效果、对比不同模型输出,直接在模型对话页面试:https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
Key 的创建和管理都在控制台,建议给 OpenClaw 单独建一个 Key,方便按项目看用量、出问题好定位:https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
接入细节和参数说明以文档为准,遇到配置项不确定就翻一下:https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
如果你用的是 Claude Code 这类编码工具,想让它走同一套 Key,参考这个接入页:https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
最后提醒一句:config.toml里的 Key 是明文,服务器别随便给人登,防火墙稳定后把 18789 的来源限制到自己的 IP,能省不少心。