☰
2026年OpenClaw搭建实战:腾讯云2分钟部署+大模型APIKey与Skill集成配置指南
2026/9/27 17:19:09 网站建设 项目流程

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 够用
防火墙放行 18789OpenClaw Web 控制台默认端口
登录SSH 密钥或密码后面用 SSH 操作

买完在「防火墙」里加一条规则:TCP 18789,来源0.0.0.0/0(测试阶段先全开,稳定后建议限制来源 IP)。

2.3 登录服务器并检查环境

用 SSH 连上服务器,先看系统版本和内存:

cat /etc/os-release free -h

free -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 -v

node -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 --version

openclaw --version能打印版本号,说明全局安装成功。

3.3 初始化并设置公网访问

openclaw onboard

按提示走:同意协议 → 选择快速启动 → 模型配置先跳过(下一步手写)→ 启用需要的通道。初始化完成后设置监听地址和端口:

openclaw config set gateway.host 0.0.0.0 openclaw config set gateway.port 18789

gateway.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_urlAPI 入口固定https://taotoken.net/api
model_name调用的模型按需换,先小模型验证
timeout超时秒数云端建议 60
reasoning推理链开关回复为空时设 false

注意:base_url结尾不要加/v1或斜杠,OpenClaw 会自己拼路径,多写反而 404。

改完重启网关让配置生效:

openclaw gateway restart

4. 验证请求与 Skill 集成

4.1 启动服务并做一次自检

openclaw gateway start openclaw gateway status

status显示 running 就说明网关起来了。然后看日志确认模型配置被加载:

openclaw logs --follow

日志里出现模型初始化的记录、没有api_key invalid之类的报错,就说明 Key 接对了。浏览器打开:

http://你的服务器公网IP:18789

能进 Web 控制台,输入一句「你好,帮我列一下当前目录文件」,模型能返回结果,说明整条链路通了。

4.2 安装 Skill 管理工具

Skill 是 OpenClaw 的功能扩展模块,搜索、浏览器操作、摘要、文件管理都靠它。先装管理工具:

npm install -g clawhub clawhub --version

4.3 安装常用 Skill

clawhub install tavily-search clawhub install agent-browser clawhub install summarize clawhub install skill-vetter

通用格式就是clawhub install <技能名>。装完查看列表:

openclaw skill list

4.4 启动 Skill 并验证生效

openclaw skill start tavily-search openclaw skill status tavily-search

status显示 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 进程ID

5.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 --reset

6. 后续怎么用与 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,能省不少心。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询