OpenClaw 403 错误终极解决：修改 User-Agent

问题本质

• 错误信息：403 Your request was blocked
• 根本原因：OpenClaw 默认的 User-Agent 被第三方 API 中转站拦截
• 验证方法：用 curl 带上正常 UA 就能成功，用 OpenClaw 就报 403

唯一必须做的修改

编辑 src/agents/claw.ts，找到初始化 OpenAI 客户端的代码，强制覆盖 User-Agent。

修改前（会触发 403）

typescript复制代码

this.openai = new OpenAI({ apiKey, baseURL });

修改后（解决 403）

typescript复制代码

this.openai = new OpenAI({
  apiKey,
  baseURL,
  fetch: async (url, options) => {
    const modified = {
      ...options,
      headers: {
        ...options.headers,
        'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36'
      }
    };
    return fetch(url, modified);
  },
});

如果不想改代码（备选方案）

通过环境变量让 Node.js 走代理，由代理服务器修改 UA：

bash复制代码

export HTTP_PROXY=http://你的代理IP:端口

然后重启 OpenClaw。

验证是否生效

修改后重启 OpenClaw，如果还出现 403，说明中转站还可能拦截其他头（如 Accept），可按需添加：

typescript复制代码

'Accept': 'application/json',
'X-Custom-Header': 'whatever'

总结

OpenClaw 的 403 错误 99% 是 UA 问题，按上述方法覆盖 User-Agent 即可解决。

目录

🦞 OpenClaw 403 错误终极解决：修改 User-Agent

问题本质

唯一必须做的修改

修改前（会触发 403）

修改后（解决 403）

如果不想改代码（备选方案）

验证是否生效

总结