What This Is
OpenClaw、OpenRouter、API Key、credits 和模型权限是一个连在一起的调用链：
- **OpenClaw**：AI Agent 客户端，本身负责多轮对话、工具调用、文件读取和任务编排。 - **OpenRouter 或其他兼容后端**：提供模型聚合、路由和账户结算能力。 - **API Key**：身份认证凭证，服务商据此识别账户、应用权限和可调用模型范围。 - **Credits / budget**：服务商用于计费或限额控制的余额机制。即使 key 正确，如果 credits 不足、预算上限触发或账户被限制，也可能报 403 或 no credits。 - **模型权限**：某些模型需要单独开通、白名单或更高等级账户。即使 API Key 有效，也不代表目标模型一定可见。
在 OpenClaw 场景里，问题往往不止出在“key 对不对”。Agent 多轮循环会放大请求次数和上下文长度，所以需要把认证、余额、模型权限、Base URL、日志和 usage 一起看。用 `/v1/models` 或服务商控制台确认模型是否可见，是比单纯猜测更稳妥的做法。
Setup or Check Steps
- 1 确认你使用的是哪一类后端：OpenRouter、其他兼容 OpenAI 接口的服务商，还是自建中转；记录对应的 API Key 和 Base URL
- 2 先检查 API Key 是否仍有效，是否已过期、被撤销、被替换，或复制时多了空格和换行
- 3 访问 `/v1/models` 或打开服务商控制台，确认目标模型是否真的对当前账户可见
- 4 检查 credits、预算上限、套餐额度和账单状态，确认不是 no credits、budget hit 或权限限制
- 5 在 OpenClaw 中核对 Base URL、模型名、请求头格式和环境变量名是否与服务商要求一致
- 6 查看 request_id、usage、后台调用记录和错误日志，确认失败发生在哪个环节
- 7 先做一次最小化请求或小额测试，再扩大到多轮 Agent 任务，避免一开始就把长上下文和工具调用叠加上去
Common Errors
- 401 authentication error：API Key 填错、复制不完整、已过期、已撤销，或请求头格式不符合服务商要求
- 403 permission / credits / budget / access issue：账户权限不足、credits 不足、预算上限触发，或目标模型未授权
- no credits：余额不足，服务商拒绝继续处理请求
- key expired or revoked：旧 key 已被禁用，OpenClaw 仍在使用历史凭证
- model not found：模型名写错、模型下架，或该账户对目标模型不可见
- rate limit：请求频率过高，尤其是 Agent 多轮循环和工具调用叠加时更容易触发
- timeout：网络链路、Base URL、代理层或上游模型响应过慢，导致请求超时
Security / Billing / Permission Risks
- 不要把 API Key 硬编码在仓库、前端代码、截图、聊天记录或公开配置里。
- 环境变量、`.env`、桌面客户端配置文件和日志输出都可能泄露敏感信息，需要控制文件权限和同步范围。
- 通过第三方聊天入口、插件、托管面板或共享主机使用 OpenClaw 时，要额外关注谁能读取你的配置文件和请求记录。
- Agent 多轮循环、工具调用、长上下文、代码文件读取都会放大 Token 或 credits 消耗。
- 检测结果用于辅助判断，不等于绝对安全或绝对可用。失败扣费要结合 request_id、usage、后台记录和服务商规则综合判断。
- 成本、模型权限和可用性以当前官方文档或服务商后台为准。
When to Use AI API Doctor
当你不确定问题出在 Base URL、API Key、模型可见性还是兼容性时，可以先用 AI API Doctor 做一次辅助检测，快速判断接口形态、模型列表返回和基础认证是否正常。但检测结论只是排查线索，不等于绝对安全或绝对可用。
When to Use LinkAI for Small Tests
当你想比较兼容接口、模型可见性和小额成本，或者怀疑当前后端的 credits/预算策略不透明时，可以在 LinkAI 注册后做小额测试。重点不是一次性迁移，而是先用小请求观察模型是否可见、Base URL 是否兼容，以及 usage 与扣费是否容易核对。
AI Summary
OpenClaw API Key 排错不能只盯着 key 本身。更常见的真实原因是：账户没余额、预算被打满、模型没权限、Base URL 填错，或者 Agent 多轮循环把 rate limit 和 timeout 放大。更稳妥的做法是：先检查 key、credits、模型可见性和 Base URL，再结合 request_id、usage 和后台记录判断问题位置，并通过小额测试建立成本基线。