TokenBroker Skill — 统一AI API网关#

智能路由 + 预算管控 + 费用统计。自动选最省钱的模型，深度任务切满血版，所有调用记入账单。

前置条件#

本 Skill 依赖 TokenBroker 后端服务（ localhost:8766）。安装时自动检测并启动。

如果端口8766已被占用，或无法自动启动，请手动启动：

bash

cd ~/.openclaw/workspace/production-system/token-broker
npx ts-node src/server.ts

核心能力#

1. 智能路由（自动执行）#

Agent 调 LLM 时，自动走 TokenBroker 决策：

text

任务进来
  → 查预算（TokenBudget联动的日/月预算）
  → 选供应商（默认选最便宜的可用模型）
  → 调API
  → 记录消耗到统计

路由策略：

任务类型默认模型说��日常问答DeepSeek V3 Lite（免费）预算友好分析/写作DeepSeek V4 Fast（¥2/百万token）性价比优先深度推理/代码/命理DeepSeek V4 Thinking（¥8/百万token）深度任务用满血预算紧张 + 非关键自动降级到免费模型自动执行

2. 管理命令#

用户可以通过对话管理 TokenBroker：

命令行为Broker状态 / 网关状态检查服务是否运行、连通性路由统计 / API统计查看所有路由调用记录设置路由 [任务类型] [供应商]自定义路由规则今天花了多少查看当日费用汇总Broker帮助显示所有可用命令

3. 与TokenBudget联动#

安装 TokenBroker 后，TokenBudget 的预算查询会自动显示：

text

📊 AI额度日报 — ⚡ 已对接TokenBroker网关
━━━━━━━━━━━━━━━━━━━━
今日已用: 45,320 / 100,000 token (45%)
路由优化: 自动选最便宜模型 ✅
━━━━━━━━━━━━━━━━━━━━

4. 自动健康检查#

每次初始化时自动检测：

text

检查 http://localhost:8766/api/health
  → 200 → 正常加载，LLM调用走Broker
  → 失败 → 降级到直调，提示用户启动服务

安装说明#

bash

# 从ClawHub安装
clawhub install ai-token-broker

# 或从OpenClaw
openclaw skills install ai-token-broker

安装后：

1. 自动编译 TypeScript 代码
2. 检测端口8766是否可用
3. 启动 TokenBroker 服务
4. 配置为 Supervisor 托管

不适用场景#

• 未安装 TokenBudget（建议先装TokenBudget）
• 用户明确指定直调模型（不走路由）
• cron定时任务（不计入日预算单独统计）

---

最后更新：2026-05-22