1. 为什么要在腾讯云轻量服务器上跑 OpenClawOpenClaw 是一个本地优先、云端可适配的开源 AI 自动化代理。它和普通聊天机器人最大的区别在于大模型只是它的“大脑”真正干活的是 Skills 插件生态——也就是它的“手脚”。你可以用自然语言让它去读邮件、整理文档、抓网页、生成周报而不需要自己写 Python 脚本。适合谁用三类人最合适一是想拥有一个跨平台个人助理的开发者二是需要把重复办公流程自动化的小团队三是想拿一台云服务器练手大模型 API 接入的新手。腾讯云轻量应用服务器正好满足这个场景固定带宽、公网 IP、按年付费便宜2 核 4GB 就能跑起来。这篇教程的路径很明确先在腾讯云轻量服务器上完成环境准备和 OpenClaw 安装然后通过 TaoToken 统一 Key 接入大模型 API接着写 Skill 配置文件最后做一次可复现的对话验证。全程命令可复制配置片段可直接改。需要提前说明一点OpenClaw 本身不绑定任何一家模型厂商它通过 OpenAI 兼容协议调用模型。所以只要你的 API 通道兼容这个协议就能接进来。TaoToken 提供的正是这样一个统一入口一个 Key 可以切换多个模型省去在多个控制台之间来回复制密钥的麻烦。我实测下来从零到跑通对话大约 25 分钟其中大部分时间花在等系统更新和拉取依赖上。下面按步骤来。2. 腾讯云轻量服务器环境准备与 OpenClaw 安装2.1 购买与初始化腾讯云轻量服务器登录腾讯云控制台进入“轻量应用服务器”模块点击新建。镜像选择 Ubuntu 22.04 LTS 64 位这是目前兼容性最稳的系统版本。实例规格选 2 核 4GB 内存、40GB 系统盘带宽 5Mbps 起步。地域按你主要使用地选国内地域访问速度更好。创建完成后在防火墙页面放行两个端口22SSH和 18789OpenClaw 服务通信端口。如果你还想用 Web 控制台再放行 1878。腾讯云轻量的防火墙是在控制台图形化操作的点“添加规则”即可协议选 TCP。然后用 SSH 登录服务器ssh root你的服务器公网IP首次登录会提示输入密码密码在腾讯云控制台重置。登录成功后先更新系统依赖apt update apt upgrade -y这一步可能要几分钟取决于镜像源速度。如果卡住可以换成国内镜像源再执行。2.2 安装 Docker 与 OpenClawOpenClaw 官方推荐用 Docker 部署隔离性好升级也方便。先装 Dockercurl -fsSL https://get.docker.com | bash -s docker systemctl enable docker systemctl start docker docker --version看到版本号输出就说明 Docker 装好了。接着拉取 OpenClaw 镜像并启动容器docker run -d \ --name openclaw-core \ --restart always \ -p 18789:18789 \ -p 1878:1878 \ -v openclaw-data:/app/data \ openclaw/openclaw:latest这里-v openclaw-data:/app/data是把配置和聊天记录挂到数据卷容器重建不会丢数据。启动后检查容器状态docker ps | grep openclaw如果状态是 Up说明服务已经在跑。再验证一下端口监听curl http://localhost:18789/api/health返回{status:ok}就说明 OpenClaw 核心服务正常。如果返回连接拒绝先看容器日志docker logs -f openclaw-core常见原因是内存不足导致进程被杀2GB 内存的机器容易出这个问题建议至少 4GB。2.3 进入容器配置环境后续很多命令需要在容器内执行先进入容器docker exec -it openclaw-core /bin/bash进去之后你会看到/app目录OpenClaw 的 CLI 工具是node cli.js或者直接openclaw命令。先确认一下openclaw --version能输出版本号就说明 CLI 可用。到这里安装部分完成接下来是接入大模型 API。3. 通过 TaoToken 统一 Key 接入大模型 API3.1 获取 TaoToken API Key打开 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 注册登录后进入控制台。在 API Keys 页面创建一个新 Key复制保存好这个 Key 只显示一次。TaoToken 的 API 入口是 https://taotoken.net/api 它兼容 OpenAI 协议所以 OpenClaw 里配置baseUrl时填这个地址即可。模型 ID 按你实际想用的填比如claude-sonnet-4-20250514或gpt-4o具体以控制台模型列表为准。3.2 写入 OpenClaw 配置文件OpenClaw 的模型配置支持 JSON 和 TOML 两种格式配置文件默认在/app/data/openclaw.json。你可以直接用 CLI 写入也可以手动编辑。先看 CLI 方式openclaw config set models.providers.taotoken.apiKey 你的TaoToken API Key openclaw config set models.providers.taotoken.baseUrl https://taotoken.net/api openclaw config set agents.defaults.model.primary taotoken/claude-sonnet-4-20250514如果你更喜欢手动编辑配置文件片段长这样{ models: { providers: { taotoken: { apiKey: 你的TaoToken API Key, baseUrl: https://taotoken.net/api, models: [ { id: claude-sonnet-4-20250514, maxTokens: 8192, temperature: 0.7 } ] } } }, agents: { defaults: { model: { primary: taotoken/claude-sonnet-4-20250514 } } } }注意三个关键字段baseUrl必须是https://taotoken.net/api不要加多余路径apiKey填你复制的 Keyprimary里的模型 ID 要和models数组里的id一致。改完保存重启服务openclaw gateway restart3.3 验证 API 配置是否生效重启后先查配置有没有写进去openclaw config get models.providers.taotoken.baseUrl应该输出https://taotoken.net/api。再测一下健康检查curl http://localhost:18789/api/health返回 ok 之后直接发一个测试请求确认模型能调通curl -X POST http://localhost:18789/api/chat \ -H Content-Type: application/json \ -d {message:你好请用一句话介绍你自己,model:taotoken/claude-sonnet-4-20250514}如果返回内容里包含模型生成的回复说明 TaoToken 通道已经打通。如果报 401检查 Key 是否复制完整如果报 model not found检查模型 ID 是否和控制台一致。4. Skill 配置与对话验证全流程4.1 安装常用 Skill 插件OpenClaw 的能力靠 Skills 扩展。先看已安装列表openclaw skills list然后安装几个高频插件openclaw skills install email openclaw skills install summarize openclaw skills install nano-pdf安装完成后再次openclaw skills list能看到这三个技能就说明装好了。如果安装失败多半是网络问题先测一下技能市场的连通性curl -I https://clawhub.com能返回 200 就说明网络通失败的话检查服务器 DNS 或换源。4.2 编写 Skill 配置文件以 email 技能为例它的配置文件在/app/data/skills/email/config.json。你可以手动创建{ imap: { host: imap.qq.com, port: 993, secure: true, user: 你的邮箱地址, password: 你的邮箱授权码 }, smtp: { host: smtp.qq.com, port: 465, secure: true, user: 你的邮箱地址, password: 你的邮箱授权码 }, maxResults: 10 }注意密码填的是邮箱授权码不是登录密码。QQ 邮箱需要在设置里开启 IMAP 服务并生成授权码。配置写好后测试技能是否加载openclaw skills configure email按提示确认配置无误即可。4.3 可复现的对话验证现在做一次完整验证。进入 OpenClaw 交互模式docker exec -it openclaw-core /bin/bash cd /app node cli.js在交互提示符下输入查看我的未读邮件提取最近3封的主题和发件人预期结果是 OpenClaw 调用 email 技能返回未读邮件的主题、发件人和时间。如果返回的是“技能未配置”或“无法连接 IMAP”回到上一步检查 config.json 的 host 和端口。再测一个不依赖外部服务的技能验证模型调用链路请用三句话总结一下 OpenClaw 的核心能力如果返回内容结构清晰、没有报错说明 TaoToken 的模型通道和 Skill 调度都正常。到这里安装、接入、配置、验证四步全部跑通。5. 常见报错排查与修复5.1 401 Unauthorized这是最常见的报错说明 API Key 没被正确识别。先检查配置openclaw config get models.providers.taotoken.apiKey如果输出为空或明显不对重新写入openclaw config set models.providers.taotoken.apiKey 你的Key openclaw gateway restart还要确认 Key 没有多余空格复制时容易带上换行符。另外检查 TaoToken 控制台里这个 Key 是否被禁用或额度耗尽。5.2 local proxy failed 或 connection refused这个报错通常出现在容器内访问外部 API 时。先测网络curl -I https://taotoken.net/api如果连不上检查腾讯云轻量服务器的防火墙是否放行了出站流量默认是放行的以及 DNS 是否正常cat /etc/resolv.conf如果 DNS 有问题改成8.8.8.8或223.5.5.5再试。还有一种情况是容器网络模式问题启动容器时没加--network host但一般默认 bridge 也能出网除非你改过 iptables。5.3 reading choices 报错这个报错一般出现在模型返回格式不符合预期时。OpenClaw 期望 OpenAI 兼容的choices数组如果 TaoToken 返回的模型 ID 不对或者请求体里model字段写错就会解析失败。检查openclaw config get agents.defaults.model.primary确保输出的模型 ID 和 TaoToken 控制台里的一致。另外确认baseUrl没有多写/v1TaoToken 的入口就是https://taotoken.net/apiOpenClaw 会自动拼接路径。5.4 OAuth 或 token 过期如果你用的是需要 OAuth 的模型通道token 过期后会报这个错。TaoToken 的 API Key 是长期有效的不存在 OAuth 刷新问题。但如果你在 OpenClaw 里配了其他 provider检查它的 token 是否过期。统一用 TaoToken 的 Key 可以避免这类问题一个 Key 管所有模型。5.5 容器启动后立即退出docker ps看不到容器用docker ps -a看到状态是 Exited。看日志docker logs openclaw-core如果日志里出现 OOM 或 killed说明内存不够。腾讯云轻量 2GB 内存的实例跑 OpenClaw 加模型调用容易触发 OOM建议升到 4GB。如果日志里是配置文件解析错误检查openclaw.json的 JSON 格式逗号和引号最容易写错。6. 长期使用建议与接入入口跑通之后建议把 OpenClaw 配成开机自启Docker 的--restart always已经做了这件事。另外定期备份数据卷docker run --rm -v openclaw-data:/data -v $(pwd):/backup alpine tar czf /backup/openclaw-data-$(date %Y%m%d).tar.gz -C /data .如果你打算长期用 OpenClaw 做编码辅助或 Agent 任务TaoToken 的 Coding Plan 更适合按次计费比按 token 计费更可控。接入文档里有详细的 Base URL、Key 和 Model ID 三件套说明照着填就行。需要提醒的是Skill 配置里涉及邮箱、文档等敏感信息时不要把配置文件提交到公开仓库。腾讯云轻量服务器的快照功能可以定期备份整机比手动备份更省事。最后一步验证你的接入是否稳定连续发 5 次对话请求观察是否有超时或报错。如果全部正常返回说明这套环境可以日常使用了。遇到问题优先看容器日志90% 的报错都能在日志里找到原因。