OpenClaw身份验证配置教程

OpenClaw身份验证

2026-04-24 33

OpenClaw 支持主流模型服务商的 OAuth 授权与 API 密钥两种登录方式。针对 Anthropic 账号，优先推荐使用 API 密钥；如果需要调用 Claude 订阅权益，则可通过 claude setup-token 生成长期授权令牌完成登录。

一、Anthropic 推荐配置：API 密钥登录

直接对接 Anthropic 官方服务时，使用 API 密钥是最稳定、最简捷的方式。

1、前往 Anthropic 控制台，手动创建专属 API 密钥；

2、在部署 OpenClaw 网关的服务器设备中，配置环境变量：

export ANTHROPIC_API_KEY=”你的密钥内容”

执行命令，验证模型读取状态是否正常：

openclaw models status

3、若网关通过 systemd、launchd 等守护进程托管，建议将密钥写入本地环境配置文件，方便程序持续读取：

cat >> ~/.openclaw/.env <<‘EOF’
ANTHROPIC_API_KEY=你的密钥
EOF

配置完成后，重启网关守护进程，依次执行以下命令检查与授权状态：

openclaw models status
openclaw doctor

如果不熟悉环境变量配置，也可以使用新手引导工具，自动保存并托管密钥：

openclaw onboard

二、Anthropic 订阅用户：setup-token 令牌验证

拥有 Claude 付费订阅的用户，除 API 密钥外，也支持官方令牌授权方案。

在网关服务器执行命令，交互式生成订阅长期令牌：

claude setup-token

拿到令牌后，在 OpenClaw 中完成绑定：

openclaw models auth setup-token –provider anthropic

若令牌在其他设备生成，可手动复制粘贴完成授权：

openclaw models auth paste-token –provider anthropic

常见报错说明：

如出现以下提示：

This credential is only authorized for use with Claude Code and cannot be used for other API requests.

代表当前订阅令牌仅限制用于 Claude Code，无法适配 OpenClaw 调用，请改用 Anthropic API 密钥方式。

三、通用手动粘贴令牌（全平台适用）

除 Anthropic 外，OpenRouter 等平台都支持手动录入令牌，自动写入 auth-profiles.json 并更新全局配置：

openclaw models auth paste-token –provider anthropic
openclaw models auth paste-token –provider openrouter

如需日常自动化巡检，可使用检测命令：

授权缺失或已过期：程序退出码 1
令牌即将到期预警：程序退出码 2

openclaw models status –check

系统运维、Termux、systemd 环境下的自动监控脚本，可查阅官方目录：/automation/auth-monitoring。

注意：claude setup-token 命令需要交互式终端环境才能正常。

四、查看模型授权状态

日常排查、自检可使用两条核心命令，快速核验凭证、环境与模型连通性：

openclaw models status
openclaw doctor

五、灵活切换与管理授权凭证

1. 单会话临时指定账号

在对话命令中，通过格式 /model 模型ID@凭证ID，为当前会话固定专属服务商账号；可使用 /model 快速切换模型，或用 /model status 查看全部可用模型、授权账号与接口配置信息。

2. 智能体全局默认授权

可手动调整单个智能体的授权优先级，统一管理账号调用顺序：

# 查看当前授权顺序
openclaw models auth order get –provider anthropic

# 设置默认授权账号
openclaw models auth order set –provider anthropic anthropic:default

# 清空自定义授权规则
openclaw models auth order clear –provider anthropic

搭配 –agent 智能体ID 可指定单独设备，不加参数则默认修改全局配置。