问题排查

规划中

先看本页，再检查“工具配置”和“开发者 API”。大多数问题都可以通过服务地址、API Key、模型名三项排除。

我应该从哪里开始？

普通用户：阅读“开始使用”，创建 API Key，再按“工具配置”选择自己的客户端。

开发者：阅读“开发者 API”，先用最短的 curl 请求验证接口，再接入 SDK 或业务代码。

API Key 在哪里创建？

登录控制台后，在账户或 API Key 页面创建。创建后请立即复制并妥善保存；页面隐藏后不要尝试猜测原 Key。

为什么返回 401？

401 通常表示认证信息无效：

检查 API Key 是否复制完整。

检查请求头格式是否正确。

OpenAI 兼容接口通常使用 Authorization: Bearer 你的 API Key。

Claude Code 按配置页使用 ANTHROPIC_AUTH_TOKEN。

确认使用的是当前账户的 Key，而不是旧项目的 Key。

为什么返回 403？

403 通常表示当前 Key、账户、分组或接口没有权限。请确认：

该模型或接口是否在控制台可见

API Key 是否被禁用

当前方案是否包含该能力

是否误把 Claude Code 配置用于 OpenAI 接口，或反过来

为什么返回 404？

优先检查服务地址和路径：

服务地址是否来自控制台

是否重复拼接 /v1

OpenAI Chat Completions 使用 /v1/chat/completions

OpenAI Responses 使用 /v1/responses

Anthropic Messages 使用 /v1/messages

为什么返回 429？

429 一般表示额度不足、请求过快或并发达到限制。先暂停重试，查看账户余额、用量和请求记录，再降低并发或更换可用模型。

为什么请求超时？

检查本机网络和代理。

先关闭流式输出，用最短请求测试。

检查是否选择了暂时不可用的模型。

不要在短时间内无限重试，避免触发频率限制。

如果只有某一个工具超时，检查该工具自己的代理和网络设置。

为什么模型不可用？

模型列表会随账户、方案和灰度状态变化。请使用控制台当前显示的模型名，不要照抄旧截图或旧文章。

配置改了但工具没有变化？

大多数 CLI 需要重启：

退出正在运行的工具。

关闭旧终端窗口。

检查配置文件路径和格式。

重新打开终端并再次测试。

API Key 泄露了怎么办？

立即在控制台禁用泄露的 Key 并创建新 Key，然后检查请求记录。不要只修改本地文件而继续使用已经公开的 Key。

普通用户需要看开发者 API 吗？

不需要。普通用户按“开始使用”和“工具接入”操作即可；开发者 API 只面向需要自行写程序或调用 SDK 的用户。

OpenClaw 和 Hermes 怎么配置？

先打开“工具配置”，找到对应章节，复制控制台提供的服务地址、API Key 和模型名。不同版本的配置字段可能变化；如果本地配置与页面不一致，优先使用客户端版本对应的配置向导。

功能状态怎么看？

已支持：可以按页面说明使用。

灰度中：部分账户或模型可用，结果可能变化。

规划中：已纳入方向，尚未承诺上线时间。

仍然无法解决怎么办？

提交问题时请提供：工具名称和版本、操作系统、接口路径、模型名、发生时间、状态码和脱敏后的错误信息。

请勿提交 API Key、完整 Cookie、账号密码或未脱敏的请求头。

排查完成标志

问题排查至少应确认：接口路径、认证方式、模型名称、余额或额度、请求时间和状态码。反馈时只提供脱敏信息。

下一步

配置仍未成功：回到工具接入，按工具版本重新检查。

需要人工协助：查看合作咨询。

我应该从哪里开始？#

API Key 在哪里创建？#

为什么返回 401？#

为什么返回 403？#

为什么返回 404？#

为什么返回 429？#

为什么请求超时？#

为什么模型不可用？#

配置改了但工具没有变化？#

API Key 泄露了怎么办？#

普通用户需要看开发者 API 吗？#

OpenClaw 和 Hermes 怎么配置？#

功能状态怎么看？#

仍然无法解决怎么办？#

排查完成标志#

下一步#