1.检查请求格式

遇到 OpenClaw API 密钥无效的问题,可以按照以下步骤排查和解决：

---

检查密钥是否正确

• 核对密钥字符：确保复制粘贴时没有遗漏或多余的空格。
• 区分测试环境和生产环境：确认使用的是对应环境的密钥。

---

验证密钥状态

• 是否已激活：部分平台需要手动激活密钥。
• 是否过期：检查密钥的有效期,过期需重新生成。
• 是否被撤销：在管理后台查看密钥状态。

---

检查权限设置

• 接口权限：确保密钥具备调用特定 API 的权限。
• IP 白名单：如果设置了 IP 限制，确认当前 IP 在允许列表中。

---

确认请求格式

• 请求头（Header）：API 密钥需放在 Authorization 或 X-API-Key 头中，格式如：

  Authorization: Bearer YOUR_API_KEY
  或
  X-API-Key: YOUR_API_KEY

• 请求地址：确认 API 端点（Endpoint）地址正确。

---

查看调用限制

• 频率限制：是否超出调用频率或次数限制。
• 用量配额：检查套餐是否已用完。

---

平台状态与更新

• 服务状态：访问 OpenClaw 状态页，确认 API 服务正常。
• SDK/文档版本：检查是否使用了过时的 SDK 或接口版本。

---

重新生成密钥

在管理后台 吊销旧密钥,生成新密钥并更新到代码中。

---

联系支持

如果以上步骤无效：

• 提供密钥前缀（如 sk-xxx）和错误详情。
• 附上请求代码片段（隐藏敏感信息）。
• 通过 OpenClaw 官网提交工单或咨询客服。

---

示例排查流程

import requests
api_key = "YOUR_API_KEY"
url = "https://api.openclaw.com/v1/endpoint"
headers = {"Authorization": f"Bearer {api_key}"}
# 2. 发送测试请求
try:
    response = requests.get(url, headers=headers)
    print(f"状态码: {response.status_code}")
    print(f"响应: {response.text}")
except Exception as e:
    print(f"请求异常: {e}")

---

常见错误提示

• 401 Unauthorized：密钥无效或权限不足。
• 403 Forbidden：IP 受限或接口无权访问。
• 429 Too Many Requests：触发频率限制。

希望这些步骤能帮助你解决问题！

标签： 检查 格式