首页 / 数字化 / 人工智能 / OpenClaw教程

OpenClaw身份验证

OpenClaw

类型：人工智能

OpenClaw（曾用名：Clawdbot、Moltbot），一款可以部署在个人电脑上的AI代理，采用“龙虾”图标设计，核心开发语言为TypeScript。如果你想快速上手OpenClaw却不知从何开始，本系列教程就是你的一站式指南！站长百科会手把手拆解OpenClaw安装的前置条件、OpenClaw安装部署的关键步骤，以及OpenClaw使用个性化配置与平台对接技巧，让你从配置到实操，每一步都清晰易懂。

OpenClaw小龙虾交流群：1087382156

百科词条 访问网站

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 可指定单独设备，不加参数则默认修改全局配置。

六、常见问题排查

1. 提示「找不到凭据」

本地缺失 Anthropic 授权配置，重新执行订阅令牌生成命令，再检测状态即可：

claude setup-token openclaw models status

2. 令牌过期或即将失效

先通过 openclaw models status 查看具体过期账号，删除失效凭证后，重新生成并粘贴新令牌即可。

前置使用要求：

• 订阅权限：使用 claude setup-token 需要拥有 Claude Max 或 Pro 付费订阅；
• 环境依赖：设备已安装 Claude Code 命令行工具，保证 claude 命令可正常调用。

广告合作

QQ群号：4114653