首页
开始 安装引导快速开始文档总览
文档 渠道接入模型与 APIGateway 运维Tools 与 Skills
更多 精选文章资源导航帮助中心
开始安装
文档导航 模型提供商
模型提供商 3 个部分

Claude

Anthropic

Anthropic 的主路线是 API Key,订阅用户则可以通过 claude setup-token 生成长期 token 交给 OpenClaw。对服务器场景,API Key 通常更稳;对订阅复用场景,setup-token 更合适。

两条主路径

API Key 推荐

Anthropic API Key

适合标准 API 调用和按量计费,也是服务器和多智能体环境里最容易复制与轮换的方式。

Subscription

setup-token

适合 Claude 订阅用户。你可以在任意机器上执行 claude setup-token,再把 token 粘贴到 Gateway 主机。

常见命令

API Key 设置

openclaw onboard
# 选择:Anthropic API key
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

setup-token

claude setup-token
openclaw models auth setup-token --provider anthropic
openclaw models auth paste-token --provider anthropic

检查模型认证

openclaw models status

高频问题

为什么突然出现 OAuth token refresh failed

订阅认证状态过期或被撤销时很常见。对于 Anthropic,最稳的恢复方式通常是重新生成并粘贴 setup-token。

No API key found for provider anthropic 是什么原因

大多是当前智能体没有对应的 Anthropic 认证配置。认证是按智能体隔离的,新智能体不会自动继承主智能体密钥。