OpenClaw 接入 Token Plan：从订阅到跑通

摘要： OpenClaw 接入腾讯云 Token Plan，用 openclaw onboard 向导或直接编辑 openclaw.json：在 models.providers 里加一个 provider，baseUrl 填 https://tokenhub.tencentmaas.com/plan/v3、apiKey 填 sk-tp 密钥，再在 agents.defaults 指定 primary 模型，保存生效即可用国产模型自主执行任务。

OpenClaw 是能自主动手干活的开源本地 AI 代理，给它接上 Token Plan，就等于给这个"执行体"配了国产模型大脑、按积分包月。接入有两条路：新手用 openclaw onboard 向导一步步走，老手直接改 openclaw.json。我更推荐直接改配置文件——OpenClaw 有个已知的缓存坑，向导配完有时会 404/401，改文件重启反而最稳。

接入前准备

OpenClaw 支持在 Windows、macOS、Linux 自主运行，能自动完成文件整理、代码编写等任务。接入 Token Plan 前备好套餐和 API Key。

Token Plan 是腾讯云大模型服务平台 TokenHub 的个人订阅套餐，通用 Token Plan 聚合 DeepSeek、GLM、Kimi、MiniMax、混元等国产模型，Hy Token Plan 为混元系列，按月订阅、按积分计量。OpenClaw 走 OpenAI 协议，用通用 Token Plan 可选模型更多。

API Key 在控制台 Token Plan 页面「生成密钥」获取，格式 sk-tp-xxx，每主账号一个。

安装 OpenClaw

按系统执行安装命令。macOS / Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

安装时的配置向导，模型相关项先全部选 Skip for now，后面统一配，能少走弯路。

编辑 openclaw.json 接入 Token Plan

执行 openclaw dashboard 打开 WebUI，在左侧 Config > Raw 编辑配置。核心是加一个指向 Token Plan 的 provider。

第一步，在 models.providers 下新增：

"models": {
  "mode": "merge",
  "providers": {
    "tencent-token-plan": {
      "baseUrl": "https://tokenhub.tencentmaas.com/plan/v3",
      "apiKey": "<你的_API_KEY>",
      "api": "openai-completions",
      "models": [
        { "id": "deepseek-v4-pro-202606", "name": "DeepSeek-V4-Pro", "input": ["text"], "contextWindow": 1000000, "maxTokens": 384000 },
        { "id": "glm-5.3", "name": "GLM-5.3", "input": ["text"], "contextWindow": 202752, "maxTokens": 16384 }
      ]
    }
  }
}

第二步，在 agents.defaults 指定默认模型（primary 按偏好改）：

"agents": {
  "defaults": {
    "model": { "primary": "tencent-token-plan/glm-5.3" },
    "models": {
      "tencent-token-plan/deepseek-v4-pro-202606": {},
      "tencent-token-plan/glm-5.3": {}
    }
  }
}

要点：baseUrl 用 Token Plan 的 OpenAI 兼容地址；primary 决定 OpenClaw 默认用哪个模型，自主执行任务建议挂推理强的模型如 DeepSeek-V4-Pro。配置文件已有内容时是合并、不要整体覆盖。

保存生效并处理缓存坑

WebUI 里点 Save 保存、再点 Update 生效。这里是最该记住的一条：如果配置看起来没问题却报 404 / 401，多半是 OpenClaw 的缓存问题。解法是直接改本地配置文件再重启 gateway。文件路径：

• Windows：C:\Users\<用户名>\.openclaw\openclaw.json
• macOS / Linux：~/.openclaw/openclaw.json

配置校验严格，字段写错会导致 gateway 启动失败，可执行 openclaw doctor 查问题、openclaw doctor --fix 自动修。

跑通验证

OpenClaw 支持两种交互：openclaw dashboard 打开 WebUI 点「聊天」，或 openclaw tui 开终端界面。给它一个任务，比如「整理当前目录下的文件并生成清单」，能自主规划执行即接入成功、积分开始计量。

接入失败排查

OpenClaw 自主性强、会动手改文件和跑命令，首次使用建议在隔离目录里试，看清它的行为再放开权限。个人版 Token Plan 面向交互式使用、仅一个 API Key，禁止账号共享与批量 API 调用；需稳定 API 能力请用企业版。

完成本教程还需要什么

• 直接改文件更稳：避开向导缓存坑，配置写进 openclaw.json 再重启。
• primary 挂强模型：自主执行任务吃推理能力，默认模型别用太弱的。
• 盯积分：OpenClaw 自主跑任务可能连续多轮调用，积分消耗快，勤看控制台用量页。

查看套餐与订阅入口，前往腾讯云 Token Plan 页面：https://cloud.tencent.com/act/pro/tokenplan