本文摘要
给 OpenClaw 配置自定义 AI 模型（NEW API）时出现 403 报错，原因是代理服务器把请求识别为爬虫并拦截。文章给出的解决办法是在 provider 配置中添加自定义 User-Agent 请求头，可通过命令行写入 JSON 或直接编辑 ~/.openclaw/openclaw.json，之后重启网关并用测试命令验证。适合遇到同类调用失败的 OpenClaw 用户参考，同时提醒排查配置未生效与换用其他 User-Agent 等情况。

最近在给 OpenClaw 配置自定义 AI 模型时，遇到了一个 403 错误。折腾了一会儿才发现是 User-Agent 的问题。这篇文章记录一下解决过程，希望能帮到遇到同样问题的朋友。

问题现象

配置好自定义 AI 模型（NEW API）后，测试时一直报错：

403 Forbidden - Your request was blocked

模型配置看起来没问题，API 端点也能访问，但就是无法正常调用。

问题原因

原来是代理服务器把 OpenClaw 的请求识别成了爬虫，直接拦截了。

很多 AI 模型的代理服务为了防止滥用，会检查请求的 User-Agent。如果 User-Agent 看起来不像正常的 API 客户端，就会被拦截。

解决方案

给模型配置添加自定义 User-Agent 就行了。

方法一：命令行配置（推荐）

Terminal window
openclaw config set models.providers.wong.headers '{"User-Agent": "OpenClaw-Agent/1.0 (compatible; Anthropic-API-Client)"}' --json
  • --json 参数很重要，告诉 OpenClaw 这是 JSON 格式
  • User-Agent 可以自定义，但最好看起来像个正经的 API 客户端

方法二：直接编辑配置文件

如果你喜欢手动编辑，也可以直接改配置文件：

Terminal window
vim ~/.openclaw/openclaw.json

找到对应的 provider，添加 headers 字段：

{
  "models": {
    "providers": {
      "wong": {
        "endpoint": "https://your-api-url",
        "apiType": "anthropic-messages",
        "headers": {
          "User-Agent": "OpenClaw-Agent/1.0 (compatible; Anthropic-API-Client)"
        }
      }
    }
  }
}

重启网关

配置修改后，记得重启 OpenClaw 网关：

Terminal window
openclaw gateway restart

或者直接：

Terminal window
kill -HUP $(pgrep openclaw-gateway)

验证结果

重启后，再测试一下模型调用，应该就正常了。

你可以用 OpenClaw 的测试命令：

Terminal window
openclaw test model wong/claude-haiku-4-5-20251001

或者直接在对话里试试，看看模型是否能正常响应。

其他可能遇到的问题

1. 配置没生效？

确认一下：

  • 配置文件格式是否正确（JSON 语法）
  • 是否重启了网关
  • 检查日志：openclaw gateway logs

2. 还是 403？

可能需要调整 User-Agent 的内容。试试这些：

Mozilla/5.0 (compatible; OpenClaw/1.0)
OpenClaw-Client/1.0
Anthropic-API-Client/1.0

3. 其他错误码？

  • 401：API Key 错误
  • 429：请求太频繁，被限流了
  • 500：服务器问题，等等再试

写在最后

OpenClaw 的配置系统很灵活，支持给每个 provider 单独设置 headers。这次遇到的 User-Agent 问题只是一个小例子。

如果你也在用 OpenClaw 配置自定义模型，遇到类似的问题，不妨试试添加自定义 headers。

✅

小贴士：OpenClaw 的配置文件在 ~/.openclaw/openclaw.json，建议定期备份。

相关链接：

有问题欢迎留言交流！