api.squarefaceicon.org 0.32 一刀，Claude 支持 1M 上下文，90% 缓存命中率。gpt系列 0.14一刀，官方超高缓存！

本文详细讲解 OpenClaw 配置第三方中转 API 时遇到 403 Forbidden 错误的原因分析与完整解决办法。

一、问题描述

在 OpenClaw 中配置第三方 OpenAI 兼容中转 API 后，发送请求时返回如下错误：

Error: 403 Forbidden

或者在日志中看到类似信息：

{
  "error": {
    "message": "Forbidden",
    "type": "auth_error",
    "code": 403
  }
}

明明 API Key 和 Base URL 都填对了，模型也选对了，为什么还是 403？

二、根本原因

中转站要求请求头（Headers）中携带特定的认证信息，而 OpenClaw 默认发出的请求头可能不包含中转站所需的字段。

具体来说，很多中转站除了标准的 Authorization: Bearer <api-key> 之外，还需要额外的自定义请求头。如果缺少这些 Headers，中转站会直接返回 403 拒绝请求。

三、解决方案

核心：在 openclaw.json 配置中添加 headers 字段

OpenClaw 的配置文件 openclaw.json 支持为每个 provider 配置自定义请求头。只要在配置中正确添加 headers 字段，403 问题即可解决。 如
“headers”: {
“User-Agent”: “Mozilla/5.0”
}
完整的 openclaw.json在最后一行

操作步骤

第 1 步：找到配置文件

OpenClaw 的配置文件路径通常为：

• Linux/macOS: ~/.config/openclaw/openclaw.json
• Windows: %APPDATA%\openclaw\openclaw.json

第 2 步：编辑配置文件

打开 openclaw.json，确保你的 provider 配置中包含 headers 字段。在apikey下方加入headers如图：

第 3 步：重启 OpenClaw

保存配置后，重启 OpenClaw 使配置生效：

# 退出当前 OpenClaw 会话，重新启动
openclaw

第 4 步：验证

重新发送请求，403 错误应该已经消失。可以用一个简单的问题测试：

> 你好，请做个自我介绍

如果正常返回模型回复，说明配置成功。

四、排查清单

如果添加 Headers 后仍然报错，按以下清单逐项排查：

排查项	检查方法
API Key 是否正确	复制粘贴，避免多余空格
Base URL 是否正确	确认末尾是否需要 /v1
Headers 格式是否正确	JSON 格式要合法，注意逗号和引号
中转站是否在线	浏览器直接访问 Base URL 看是否有响应
API Key 是否有余额/额度	联系中转站管理员确认
模型名称是否正确	确认中转站支持你请求的模型

五、完整 openclaw.json 配置参考

以下是一份完整的、已配置好 Headers 的 openclaw.json 示例，可直接参考修改：

{
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "你的token" #通常是遗传字母加数字，这里可以随便写几个字母加数字并不影响 使用时记得把这段注释去掉
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "calendar.add",
        "contacts.add",
        "reminders.add"
      ]
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "square/claude-sonnet-4-6"
      },
      "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace"
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "square": {
        "api": "openai-completions",
        "apiKey": "你的apikey",
        "baseUrl": "https://api.squarefaceicon.org/v1",
        "headers": {
          "User-Agent": "Mozilla/5.0"
        },
        "models": [
          {
            "contextWindow": 200000,
            "id": "claude-sonnet-4-6", #模型名称根据自己的需要更改，使用时记得把这段注释去掉
            "input": [
              "text",
              "image"
            ],
            "maxTokens": 32000,
            "name": "claude-sonnet-4-6",
            "reasoning": true
          }
        ]
      }
    }
  }
}

六、总结

OpenClaw 使用中转 API 报 403 的问题，99% 的情况是因为请求头（Headers）缺失。只需要在 openclaw.json 的 provider 配置中添加正确的 headers 字段，包含 Authorization 和 Content-Type，即可解决。

---

本站claude 使用日志截图（包括缓存率和价格）

如果本文对你有帮助，欢迎点赞收藏，有问题欢迎评论区交流！