5676a6b38d
What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style Tests: pnpm docs:build
4.2 KiB
read_when, summary, title, x-i18n
| read_when | summary | title | x-i18n | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
模型认证：OAuth、API 密钥和 setup-token | 认证 |
|
认证
OpenClaw 支持通过 OAuth 和 API 密钥对模型提供商进行认证。对于 Anthropic 账户，我们推荐使用 API 密钥。对于 Claude 订阅访问，请使用 claude setup-token 创建的长期有效令牌。
参见 /concepts/oauth 了解全部 OAuth 流程和存储布局。
推荐的 Anthropic 设置（API 密钥）
如果你直接使用 Anthropic，请使用 API 密钥。
- 在 Anthropic 控制台中创建 API 密钥。
- 将其放置在 Gateway网关主机（运行
openclaw gateway的机器）上。
export ANTHROPIC_API_KEY="..."
openclaw models status
- 如果 Gateway网关在 systemd/launchd 下运行，建议将密钥放在
~/.openclaw/.env中，以便守护进程能够读取：
cat >> ~/.openclaw/.env <<'EOF'
ANTHROPIC_API_KEY=...
EOF
然后重启守护进程（或重启 Gateway网关进程）并重新检查：
openclaw models status
openclaw doctor
如果你不想自行管理环境变量，新手引导向导可以为守护进程存储 API 密钥：openclaw onboard。
参见帮助了解环境变量继承的详细信息（env.shellEnv、~/.openclaw/.env、systemd/launchd）。
Anthropic：setup-token（订阅认证）
对于 Anthropic，推荐的方式是使用 API 密钥。如果你使用的是 Claude 订阅，也支持 setup-token 流程。在 Gateway网关主机上运行：
claude setup-token
然后将其粘贴到 OpenClaw 中：
openclaw models auth setup-token --provider anthropic
如果令牌是在另一台机器上创建的，请手动粘贴：
openclaw models auth paste-token --provider anthropic
如果你看到如下 Anthropic 错误：
This credential is only authorized for use with Claude Code and cannot be used for other API requests.
……请改用 Anthropic API 密钥。
手动输入令牌（适用于任何提供商；写入 auth-profiles.json 并更新配置）：
openclaw models auth paste-token --provider anthropic
openclaw models auth paste-token --provider openrouter
适用于自动化的检查（过期/缺失时退出码为 1，即将过期时为 2）：
openclaw models status --check
可选的运维脚本（systemd/Termux）文档参见：/automation/auth-monitoring
claude setup-token需要交互式 TTY。
检查模型认证状态
openclaw models status
openclaw doctor
控制使用哪个凭据
按会话（聊天命令）
使用 /model <alias-or-id>@<profileId> 为当前会话指定特定的提供商凭据（示例配置 ID：anthropic:default、anthropic:work）。
使用 /model（或 /model list）打开紧凑选择器；使用 /model status 查看完整视图（候选项 + 下一个认证配置，以及配置的提供商端点详情）。
按智能体（CLI 覆盖）
为智能体设置显式的认证配置顺序覆盖（存储在该智能体的 auth-profiles.json 中）：
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> 指定特定智能体；省略则使用已配置的默认智能体。
故障排除
"No credentials found"
如果 Anthropic 令牌配置缺失，请在 Gateway网关主机上运行 claude setup-token，然后重新检查：
openclaw models status
令牌即将过期/已过期
运行 openclaw models status 确认哪个配置即将过期。如果配置缺失，请重新运行 claude setup-token 并再次粘贴令牌。
要求
- Claude Max 或 Pro 订阅（用于
claude setup-token） - 已安装 Claude Code CLI（
claude命令可用）