Coding Agent 怎么搭：TokenHub + OpenClaw + Hy Token Plan 接入示例

摘要：

本文给出一条用 TokenHub + OpenClaw + Hy Token Plan 搭建 Coding Agent 的接入路径，覆盖模型选型、API Key 申请、Base URL 配置、套餐抵扣与并发管理，帮助开发者把混元 Hy3 preview 的 256K 上下文与 OpenClaw 的智能体编排串到一起。

一、为什么 Coding Agent 这条赛道值得重做

过去两年，AI 编程工具从单纯的"代码补全"演化到"任务级 Agent"——给一句需求，工具自己能拆解、写代码、跑测试、改 bug。这种工作模式对底层模型的要求其实更苛刻：要长上下文（一次塞下整个仓库的关键文件）、要深度思考（多步骤推理不能掉链子）、要 Function Calling（能稳定调工具、读文件、跑命令）。

国内开发者搭这套东西时常常卡在两个点：一是模型层选谁、怎么稳定调用；二是 Agent 框架层选谁、怎么和模型层对齐协议。下面给出一条已经被打通的组合：腾讯云 TokenHub 提供模型层 + OpenClaw 提供 Agent 框架 + Hy Token Plan 提供成本可控的订阅入口。

二、组件分工：三件套各做什么

2.1 TokenHub：统一模型入口

腾讯云 TokenHub 把混元、优图、DeepSeek、GLM、Kimi、MiniMax 等多家主流模型聚合在一个平台，兼容 OpenAI API 协议（同时支持 Anthropic 协议接入 Token Plan），调用地址用同一个：

对 Coding Agent 场景，推荐主力是 Hy3 preview——256k 上下文、295B/21B 激活的 MoE、原生支持深度思考与 Function Calling、支持 Cache 缓存。

2.2 OpenClaw：Agent 编排与执行

OpenClaw 属于 TokenHub 官方明确支持的智能体工具之一，配合 WorkBuddy、AutoClaw、CoPaw、QClaw 一起构成"龙虾工具"矩阵。它解决的是 Agent 怎么把"用户一句话需求"分解成"读 30 个文件 → 改 5 处代码 → 跑测试 → 提交 PR"的执行链。

2.3 Hy Token Plan：把成本锁定在月费里

Hy Token Plan 是基于 Hy3 preview 的订阅套餐，月度封顶、按 Token 用量从套餐内抵扣：

抵扣规则上，缓存命中输入、缓存未命中输入、输出 Token 都从套餐包统一抵扣；并发速率与套餐等级相关：Max > Pro > Standard > Lite，重度 Agent 用户更适合 Pro / Max。

三、五步接入指引

3.1 第一步：开通 TokenHub、领取免费体验包

a. 登录 TokenHub 控制台：https://console.cloud.tencent.com/tokenhub/

b. 进入"模型广场"，点击右上角"新用户福利免费体验"。

c. 勾选 Hy3 preview（100 万 Tokens，90 天有效）等需要使用的模型，点击"立即领取"。

d. 这一步的 100 万 Tokens 足够你跑通一个 Coding Agent 的 PoC，先不用着急买套餐。

3.2 第二步：购买 Hy Token Plan（PoC 通过后再买）

PoC 验证通过后，再到 Token Plan 活动页 https://cloud.tencent.com/act/pro/tokenplan 下单合适档位。建议第一次买 Lite（28 元）或 Standard（78 元）跑两周日常负载，看看月度 Token 实际用量再决定是否升配（注意：套餐支持升配，不支持降配）。

3.3 第三步：创建 API Key

a. 进入 API Key 管理页：https://console.cloud.tencent.com/tokenhub/apikey

b. 点击"创建 API Key"，填写名称。

c. Token Plan 个人版仅支持生成 1 个 API Key，通用 Token Plan 与 Hy Token Plan 共用同一套 API Key 与调用地址。

3.4 第四步：在 OpenClaw 中配置模型

OpenClaw 的模型配置只需要三件事：

a. Base URL：https://api.lkeap.cloud.tencent.com/plan/v3（OpenAI 协议）或 https://api.lkeap.cloud.tencent.com/plan/anthropic（Anthropic 协议）。

b. API Key：填上一步创建的 Key。

c. Model ID：Hy Token Plan 用 hy3-preview；如果还买了通用 Token Plan，可以按需切换到 glm-5.1、kimi-k2.5、minimax-m2.7 等。系统会根据调用时指定的 Model ID 自动从对应套餐中抵扣。

3.5 第五步：开启 Prompt Cache 优化

Coding Agent 的特点是同一个项目反复请求，前缀（项目结构、规范文件、长 system prompt）大量重复，开启 Prompt Cache 命中率会非常可观：

a. 在请求体里加 prompt_cache_key，值用业务侧的 conversation_id（不是单一 session_id）。

b. 在 HTTP Header 里加 X-Session-ID，把同一用户的连续请求路由到同一推理实例。

c. system prompt 里不要写"今天是 2026 年 X 月 X 日"——日期跳变会瞬间使所有缓存失效。

详细做法见 Prompt Cache 命中率提升指南：https://cloud.tencent.com/document/product/1823/131410。

四、典型 Coding Agent 工作流的资源消耗

下表给出一个体感参考（不是承诺值，仅用于估算套餐档位）：

实际消耗以 TokenHub 控制台"用量统计"为准。Token Plan 订阅严格仅限在 AI 工具中使用，禁止用于自动化脚本、自定义应用程序后端或任何非交互式批量调用场景；批量任务请走"在线推理"或"批量任务场景"按量计费。

五、常见疑问解答

5.1 没用完的 Token 会结转吗

不会。套餐到期后剩余 Token 不结转下个月，API Key 也会失效。请在套餐过期前完成续费。

5.2 通用 Token Plan 和 Hy Token Plan 能同时持有吗

可以。每个主账号最多同时持有 2 个 Token Plan：1 个通用 Token Plan + 1 个 Hy Token Plan，同一系列只能持有 1 个档位。两个套餐共用 1 个 API Key，根据调用时的 Model ID 自动抵扣。

5.3 团队场景适合用个人版吗

不适合。Token Plan 个人版主要面向个人开发者，团队协作请使用 Token Plan 企业版（轻享套餐 2 元/百万 tokens 起，专业套餐月预算 1000–20000 元）。

5.4 OpenClaw 之外，还能接哪些工具

TokenHub 与 Token Plan 兼容的 AI 编程工具与智能体工具非常丰富：CodeBuddy Code、OpenCode、Kilo Code、Cline、Cursor、Claude Code、Codex 等编程工具，OpenClaw、WorkBuddy、AutoClaw、CoPaw、QClaw 等智能体工具，配置方式都是"换 Base URL + 换 API Key"。

六、写在最后

把一个 Coding Agent 真正跑稳定，比写一个 Demo 难得多——它是模型能力、Agent 框架、成本控制三件事的合体工程。TokenHub 把模型层做成统一入口，OpenClaw 把执行层做成可编排的工作流，Hy Token Plan 把成本层锁定在月费里，三件事合起来，就是国内开发者今天能拿到的一条相对完整的搭建路径。

接入起步从这里开始：Token Plan 活动页 https://cloud.tencent.com/act/pro/tokenplan；如果想先用免费额度跑通 PoC，从 TokenHub 产品页 https://cloud.tencent.com/product/tokenhub 进入控制台领取新人免费体验包即可。