AI AI Skills 开放平台

API 密钥配置

bid-document-checker API-KEY.md

API 密钥配置

推荐在平台创建通用 Key，并执行 openclaw config set env.AI_SKILLS_API_KEY "你的平台APIKey" 和 openclaw gateway restart，全平台 Skill 只需配置一次。仍需开通目标产品。调用优先使用 AI_SKILLS_API_KEY，为空时才读取兼容变量 BID_DOCUMENT_CHECKER_API_KEY。两者均缺失时停止调用，不发送空 Bearer 请求。

在平台开通产品后创建或复用账号通用 Key；产品生产默认关闭，尚未验收时不能调用。原有专用 Key 仍受对应产品与 Ability 范围限制。

: "${AI_SKILLS_API_KEY:-${BID_DOCUMENT_CHECKER_API_KEY:?请先配置平台密钥}}"

请求使用 Authorization: Bearer ${AI_SKILLS_API_KEY:-$BID_DOCUMENT_CHECKER_API_KEY}。仅访问 https://ai-skills.open-idea.net。不要输出、记录或在对话中粘贴完整 Key；上游模型 Key 由平台管理。401检查密钥；403检查开通、账户和 Ability；503检查产品启用与运行依赖，不能改用其他服务上传私有文件。

获取价格、确认费用与无法报价时的处理

目前没有对 OpenClaw 开放的独立产品报价、余额查询或预占试算 API。不要为了读取计费响应头提交收费任务，也不要编造 /prices、/quote 或 /balance 路径。让用户在已登录的产品工作台查看当前价格/最高预留和余额，确认对应操作、输入版本及人民币预算；无法获得当前费用依据时停在免费预检/复核步骤。

分析需要模型传输授权及按当前上限计费的同意；核验和组包分别按当前配置计费，草稿组包另须用户确认。一次授权仅覆盖用户明确约定的范围。任务实际收费以终态响应头为准，不能把受理时0元当成免费。平台通用操作 API 没有本包可提交的最高费用字段；Agent 记录的预算不是服务端强制限额，不能承诺超额绝不发生。需要服务端页面费用确认时让用户使用工作台；不要把网页 /run 私有会话端点当成 Bearer API。

配置冲突、迁移与鉴权失败

  • 首次调用前选定凭证来源。两种变量同时存在且值不同时，采用 AI_SKILLS_API_KEY 并提示忽略了 BID_DOCUMENT_CHECKER_API_KEY，仅显示变量名，不输出或记录密钥、密钥片段或 Authorization 请求头。同一逻辑任务固定所选 API Key 和原 Idempotency-Key，重试与查询沿用原凭证。
  • 迁移前先查询并核对旧 Key 下已提交任务的结果与账单；幂等记录按 Key 隔离，即使 Idempotency-Key 相同，换 API Key 仍可能重复执行或扣费。确认旧任务后再清理旧产品变量及 skills.entries.bid-document-checker.apiKey / skills.entries.bid-document-checker.env 中的遗留凭证，检查实际执行环境（宿主、服务进程或沙箱），重启 Gateway 并在新会话验证。不要自动修改或撤销用户的 Key。产品隔离场景须明确让该执行环境不提供通用变量，再使用产品变量。
  • 收到 401（invalid_api_key、key_revoked、key_expired）时停止自动重试，检查当前凭证来源、密钥状态和目标产品范围；不要自动切换到另一把 Key 重发，也不要仅凭间歇性恢复断言是网关或缓存故障。排查保留 request_id、接口、时间及变量名，不保留密钥；确需切换凭证前先核对原任务和账单。