Agent Skills
返回列表
智谱 Coding Plan 用量查询

智谱 Coding Plan 用量查询

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_39299230/zhipu-usage。

技能介绍

要解决什么问题

在使用智谱 Coding Plan（含 OpenClaw / Z.ai 等接入场景）时，配额是按时段与 Token 滑动窗口计费的。开发或运维往往需要在改配置、压测或排障前确认：当前还剩多少调用次数、Token 额度是否触顶、套餐是 lite 还是 pro、下一次重置是什么时候。手工登录控制台核对既慢，也不适合写进自动化流程。

技能如何工作

本技能通过智谱官方的 monitor 用量接口拉取配额快照，而不是猜测或解析账单页。

  • 请求端点：国内智谱为 https://open.bigmodel.cn/api/monitor/usage/quota/limit；Z.ai 线路为 https://api.z.ai/api/monitor/usage/quota/limit
  • 认证：Authorization: Bearer <API Key>。Key 常见来自 OpenClaw 的 auth-profiles.json（路径如 ~/.openclaw/agents/main/agent/auth-profiles.json，字段 zai:default.key），也可经环境变量 ZHIPU_API_KEY 传入
  • 返回字段含义：TIME_LIMIT 表示时段内调用次数上限（例如 5 小时窗口）；TOKENS_LIMIT 表示 Token 消耗限额（文档示例为 3×5 小时滑动窗口）；level 为套餐等级（lite / pro）；nextResetTime 为下次重置时间的毫秒时间戳

按 SKILL 说明运行内置查询脚本即可得到上述结构化结果，便于在终端或 Agent 对话里快速对照配额。

适用边界与注意点

  • 只覆盖 Coding Plan 配额监控这一读接口；不能代替计费明细、历史用量报表或模型调用本身
  • 两个 API 主机对应不同接入域，需与当前 Key / 产品线一致，否则可能鉴权失败或读到错误环境
  • Bearer Token 等同于账户权限，脚本与配置文件应限制在本机可读范围，避免把 Key 打进日志

使用场景

  • 在 OpenClaw 主 Agent 连续跑多轮编码任务前，用脚本确认当前 5 小时时段内 `TIME_LIMIT` 是否还有余量
  • 线上 Coding 助手突然返回限流或 429，需要对照 `TOKENS_LIMIT` 与 `nextResetTime` 判断是配额耗尽还是配置错误
  • 切换智谱国内端与 Z.ai 线路前，核对 `level`（lite/pro）和对应 monitor 主机是否匹配当前 API Key
  • 本地改完 `auth-profiles.json` 里的 `zai:default.key` 后，验证 Bearer 鉴权能否正常读到配额接口返回

适合人员

  • 维护 OpenClaw `main` Agent、需在批量任务前确认 Coding Plan 未触顶的本地部署工程师
  • 对接 Z.ai 或 open.bigmodel.cn 的集成开发，需要把 Token 滑动窗口用量纳入排障 checklist 的后端同学
  • 负责智谱 Coding 套餐采购与用量对齐，要用官方 monitor 字段和合同档位交叉核对的一线运维
  • 在 CI 或定时任务里嵌入配额探测、避免夜间自动化把时段调用次数打满的 SRE