文档
网关（Gateway）
身份验证

身份验证

适用范围

在以下情况使用此页面：

  • 调试模型身份验证或 OAuth 过期
  • 记录身份验证或凭据存储

Moltbot 支持模型提供程序的 OAuth 和 API 密钥。对于 Anthropic 账户，我们建议使用 API 密钥。Moltbot 还可以重用 Claude Code 凭据，包括由 claude setup-token 创建的长期令牌。

有关完整的 OAuth 流程和存储布局，请参阅 /concepts/oauth。

推荐的 Anthropic 设置（API 密钥）

如果您直接使用 Anthropic，请使用 API 密钥。

  1. 在 Anthropic 控制台中创建 API 密钥。
  2. 将其放在 网关主机（运行 moltbot gateway 的机器）上。
export ANTHROPIC_API_KEY="..."
moltbot models status
  1. 如果网关在 systemd/launchd 下运行，最好将密钥放在 ~/.moltbot/.env 中，以便守护进程可以读取它：
cat >> ~/.moltbot/.env <<'EOF'
ANTHROPIC_API_KEY=...
EOF

然后重启守护进程（或重启您的网关进程）并重新检查：

moltbot models status
moltbot doctor

如果您不想自己管理环境变量，入门向导可以存储 API 密钥供守护进程使用：moltbot onboard。

有关环境继承的详细信息，请参阅 帮助 （env.shellEnv、~/.moltbot/.env、systemd/launchd）。

Anthropic：Claude Code CLI setup-token（支持）

对于 Anthropic，推荐的路径是 API 密钥。如果您已经在使用 Claude Code CLI，也支持 setup-token 流程。 在 网关主机上运行它：

claude setup-token

然后验证并同步到 Moltbot：

moltbot models status
moltbot doctor

这应该在代理身份验证存储中创建（或刷新）类似 anthropic:claude-cli 的身份验证配置文件。

Moltbot 配置将 auth.profiles["anthropic:claude-cli"].mode 设置为 "oauth"，以便 配置文件接受 OAuth 和 setup-token 凭据。使用 "token" 的旧配置 在加载时自动迁移。

如果您看到类似以下的 Anthropic 错误：

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

…请改用 Anthropic API 密钥。

替代方案：运行包装器（也更新 Moltbot 配置）：

moltbot models auth setup-token --provider anthropic

手动令牌输入（任何提供程序；写入 auth-profiles.json + 更新配置）：

moltbot models auth paste-token --provider anthropic
moltbot models auth paste-token --provider openrouter

自动化友好的检查（过期/缺失时退出 1，即将过期时退出 2）：

moltbot models status --check

可选的操作脚本（systemd/Termux）记录在此处： /automation/auth-monitoring

moltbot models status 将 Claude Code 凭据加载到 Moltbot 的 auth-profiles.json 中并显示过期时间（默认在 24 小时内警告）。 moltbot doctor 在运行时也会执行同步。

claude setup-token 需要交互式 TTY。

检查模型身份验证状态 

moltbot models status
moltbot doctor

控制使用哪个凭据

每会话（聊天命令）

使用 /model <alias-or-id>@<profileId> 为当前会话固定特定的提供程序凭据（示例配置文件 id：anthropic:claude-cli、anthropic:default）。

使用 /model（或 /model list）进行紧凑选择器；使用 /model status 查看完整视图（候选者 + 下一个身份验证配置文件，以及配置时的提供程序端点详细信息）。

每代理（CLI 覆盖）

为代理设置显式身份验证配置文件顺序覆盖（存储在该代理的 auth-profiles.json 中）：

moltbot models auth order get --provider anthropic
moltbot models auth order set --provider anthropic anthropic:claude-cli
moltbot models auth order clear --provider anthropic

使用 --agent <id> 来定位特定的代理；省略它以使用配置的默认代理。

同步如何工作

  1. Claude Code 将凭据存储在 ~/.claude/.credentials.json 中（或 macOS 上的钥匙串中）。
  2. Moltbot 在加载身份验证存储时将这些同步到 ~/.moltbot/agents/<agentId>/agent/auth-profiles.json 中。
  3. 可刷新的 OAuth 配置文件可以在使用时自动刷新。静态 令牌配置文件（包括 Claude Code CLI setup-token）不可被 Moltbot 刷新。

故障排除

“未找到凭据”

如果 Anthropic 令牌配置文件缺失，请在 网关主机上运行 claude setup-token， 然后重新检查：

moltbot models status

令牌即将过期/已过期

运行 moltbot models status 以确认哪个配置文件即将过期。如果配置文件 是 anthropic:claude-cli，请重新运行 claude setup-token。

要求

  • Claude Max 或 Pro 订阅（用于 claude setup-token）
  • 已安装 Claude Code CLI（claude 命令可用）
沙箱 vs 工具策略 vs 提升模式使用远程网关运行 Moltbot.app