OpenClaw 用户可以用 claude-max-api-proxy 把 Claude Max/Pro 订阅包装成 OpenAI 兼容的本地端点，在 OpenClaw 的智能体中直接调用订阅额度。安装 npm install -g claude-max-api-proxy，启动服务后，在 OpenClaw 配置 env.OPENAI_BASE_URL=http://localhost:3456/v1 即可。注意这是社区工具，Anthropic 可能封锁 Claude Code 之外的订阅使用，生产环境推荐走 API Key。

OpenClaw 怎么配置 Claude Max API Proxy 代理

claude-max-api-proxy 是一个社区工具，将你的 Claude Max/Pro 订阅暴露为 OpenAI 兼容的 API 接口。这样，任何支持 OpenAI API 格式的工具（包括 OpenClaw）都能通过订阅调用 Claude 模型，避免按 token 计费。

⚠️ 警告： 此路径仅为技术兼容性。Anthropic 过去曾封锁部分 Claude Code 之外的订阅使用。使用前务必自行决定，并核实 Anthropic 当前服务条款。

为什么用代理，而不是直接走 API

方式	费用	最适合
Anthropic API	按 token 计费（约 $15/M 输入，$75/M 输出 for Opus）	生产应用，高并发
Claude Max 订阅	$200/月固定	个人使用、开发、无限量用

如果你已有订阅，且想用 OpenAI 兼容工具（如 OpenClaw）调用 Claude，此代理可降低部分工作流成本。生产环境建议使用 API Key。

工作原理

你的应用 → claude-max-api-proxy → Claude Code CLI → Anthropic（通过订阅）
（OpenAI 格式）              （转换格式）              （使用你的登录）

代理在本地完成转换：

1. localhost:3456/v1/chat/completions 接收 OpenAI 格式请求
2. 转换为 Claude Code CLI 命令
3. 以 OpenAI 格式返回响应（支持流式）

安装步骤

需要 Node.js 20+ 和已认证的 Claude Code CLI。

npm install -g claude-max-api-proxy

# 确认 Claude CLI 已登录
claude --version

启动服务

claude-max-api
# 服务默认在 http://localhost:3456 启动

测试代理

# 健康检查
curl http://localhost:3456/health

# 查看可用模型
curl http://localhost:3456/v1/models

# 发起对话
curl http://localhost:3456/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

在 OpenClaw 中配置

将 OpenClaw 指向代理作为自定义 OpenAI 兼容端点：

{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

之后 OpenClaw 的智能体就会使用 claude-opus-4 等模型名通过订阅调用 Claude。

内置模型映射

模型 ID	映射到
claude-opus-4	Claude Opus 4
claude-sonnet-4	Claude Sonnet 4
claude-haiku-4	Claude Haiku 4

高级配置

代理式 OpenAI 兼容注意事项

此路径使用与其它自定义 /v1 后端相同的代理式 OpenAI 兼容路由：

• 原生 OpenAI 专属的请求整形不适用
• 没有 service_tier、Responses store、prompt-cache 提示、OpenAI reasoning 兼容负载整形
• OpenClaw 的隐藏标志头（originator、version、User-Agent）不会注入到代理 URL

macOS 随系统自动启动（LaunchAgent）

创建以下 plist 文件使代理在登录时自动运行：

cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.claude-max-api</string>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/node</string>
    <string>/usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js</string>
  </array>
  <key>EnvironmentVariables</key>
  <dict>
    <key>PATH</key>
    <string>/usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin</string>
  </dict>
</dict>
</plist>
EOF

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plist

相关链接

• npm: https://www.npmjs.com/package/claude-max-api-proxy
• GitHub: https://github.com/atalovesyou/claude-max-api-proxy
• Issues: https://github.com/atalovesyou/claude-max-api-proxy/issues

注意事项

• 这是社区工具，非 Anthropic 或 OpenClaw 官方支持
• 需要已激活的 Claude Max/Pro 订阅，且 Claude Code CLI 已认证
• 代理在本地运行，数据不会发往第三方服务器
• 完全支持流式响应

若需原生 Anthropic 集成（Claude CLI 或 API Key），参见 Anthropic provider。OpenAI/Codex 订阅参见 OpenAI provider。

常见问题

claude-max-api-proxy 能否用于生产环境？

不推荐。这是社区工具，Anthropic 可能封锁非 Claude Code 的订阅使用（过往有过先例）。生产环境应使用 Anthropic API Key 走 Anthropic provider，政策更清晰。

配置 OpenClaw 后模型调用报错怎么办？

检查代理是否运行：curl http://localhost:3456/health。确认 Claude Code CLI 已登录（claude --version）。OpenClaw 配置中 OPENAI_BASE_URL 必须指向正确地址（默认为 http://localhost:3456/v1）。模型 ID 使用映射表中的名称（如 claude-opus-4）。

是否支持流式输出？需要额外配置吗？

支持。代理默认开启流式输出，OpenClaw 端无需额外配置。测试时可用 curl 加 --no-buffer 观察逐 token 返回。