Gateway 认证（模型提供商）

本页面是模型提供商认证参考（API key、OAuth、Claude CLI 复用、Anthropic setup-token）。Gateway 连接认证（token/password/trusted-proxy）见 gateway-configuration。

推荐方式：API Key

长期运行的 Gateway 优先使用 API key：

export <PROVIDER>_API_KEY="..."
openclaw models status

systemd/launchd 守护进程建议写入 ~/.openclaw/.env：

cat >> ~/.openclaw/.env <<'EOF'
<PROVIDER>_API_KEY=...
EOF

也可通过 openclaw onboard 引导存储。

Anthropic：Claude CLI 复用

Anthropic 官方已允许 OpenClaw 复用本地 Claude CLI 登录：

claude auth login
claude auth status --text
openclaw models auth login --provider anthropic --method cli --set-default

长期 Gateway 仍推荐 Anthropic API key，稳定性更高。

auth-profiles.json 格式

{
  "version": 1,
  "profiles": {
    "openrouter:default": {
      "type": "api_key",
      "provider": "openrouter",
      "key": "OPENROUTER_API_KEY"
    }
  }
}

旧版扁平格式可用 openclaw doctor --fix 自动迁移。

API Key 轮换（限流重试）

优先级顺序：

OPENCLAW_LIVE_<PROVIDER>_KEY
<PROVIDER>_API_KEYS
<PROVIDER>_API_KEY
<PROVIDER>_API_KEY_*

仅在限流错误（429、rate_limit、quota 等）时轮换，非限流错误不重试。

控制使用哪个凭证

会话级：/model <alias>@<profileId> 指定 profile
Agent 级：openclaw models auth order set --provider anthropic anthropic:default

状态检查

openclaw models status        # 查看认证状态
openclaw models status --probe  # 实时探测
openclaw models status --check  # 自动化检查（过期返回 1，即将过期返回 2）
openclaw doctor

Wiki AI

目录