OpenClaw 配置 AI 模型：5 分钟搞定 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 就行了。

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

openclaw config set models.providers.wong.headers '{"User-Agent": "OpenClaw-Agent/1.0 (compatible; Anthropic-API-Client)"}' --json

注意

--json 参数很重要，告诉 OpenClaw 这是 JSON 格式
User-Agent 可以自定义，但最好看起来像个正经的 API 客户端

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

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

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 网关：

openclaw gateway restart

或者直接：

kill -HUP $(pgrep openclaw-gateway)

验证结果

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

你可以用 OpenClaw 的测试命令：

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，建议定期备份。

相关链接：

OpenClaw 官网：https://openclaw.ai
OpenClaw GitHub：https://github.com/openclaw/openclaw
文档：https://docs.openclaw.ai

有问题欢迎留言交流！

OpenClaw 配置 AI 模型：5 分钟搞定 User-Agent 问题 by https://oneszhang.com/archives/openclaw-user-agent-fix.html