OpenClaw

OpenClaw 是一个开源 Anthropic 协议本地代理。它把进来的 Anthropic 风格请求改写后转发到任意 OpenAI 兼容上游，并把响应转回 Anthropic 格式。

大多数场景：你不需要 OpenClaw

wrouter 已经原生暴露 Anthropic 协议（参见 Messages API）。直接把 Anthropic 客户端的 ANTHROPIC_BASE_URL 指向 https://api.wrouter.io 即可，无需中间层。

只有以下场景才推荐叠加 OpenClaw：

场景	原因
需要在本地审计 / 改写每一条请求	OpenClaw 支持中间件链路
团队共享一台机器，想统一注入 wrouter Token	客户端不知道实际 Token
需要做请求重试 / fallback / 多上游切换	网关层做策略

前置要求

项	要求
Python	≥ 3.10
pipx 或 uv	用于安装
wrouter	一把 Token

安装

# 推荐使用 pipx 隔离环境
pipx install openclaw

或参考 OpenClaw 官方 README 的最新安装方式。

启动

openclaw \
  --upstream-base-url https://api.wrouter.io/v1 \
  --upstream-api-key  sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
  --listen            127.0.0.1:8788

配置 Anthropic 客户端指向 OpenClaw

例如 Claude Code：

export ANTHROPIC_BASE_URL="http://127.0.0.1:8788"
export ANTHROPIC_AUTH_TOKEN="placeholder"   # 由 OpenClaw 自己注入真实 Token

验证

# 直接探活
curl http://127.0.0.1:8788/v1/messages \
  -H "x-api-key: placeholder" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-5","max_tokens":64,"messages":[{"role":"user","content":"hi"}]}'

直连 vs 经 OpenClaw

维度	直连 wrouter	经 OpenClaw
部署组件	无	多一个本地进程
延迟	0 额外跳转	+1–5ms
审计 / 改写	不可	可（中间件）
多上游 fallback	不可	可
客户端是否知道 Token	是	否

故障排查

现象	处理
Connection refused	OpenClaw 进程未启动；检查 --listen 端口
401（从 OpenClaw 返回）	--upstream-api-key 配置错或被禁用
工具调用结果不返回	OpenClaw 版本过旧；升级
HTTPS 客户端拒绝 http://	OpenClaw 默认 HTTP；前置 nginx / caddy 终结 TLS

已知限制

• OpenClaw 是社区项目，更新节奏与 Anthropic 官方协议演进可能有滞后
• 不支持 Anthropic 的部分实验特性（如 extended-thinking 的某些组合）