认证

令牌认证 vs mTLS。择一并锁定网关。Moltbot 支持模型提供商的 OAuth 与 API 密钥。对 Anthropic 账户推荐使用 API 密钥。对 Claude 订阅访问，使用由 claude setup-token 创建的长效令牌。完整 OAuth 流程与存储布局见 OAuth。

推荐 Anthropic 设置（API 密钥）

若直接使用 Anthropic，请使用 API 密钥。

在 Anthropic Console 创建 API 密钥。
将密钥放在网关主机（运行 moltbot gateway 的机器）：


export ANTHROPIC_API_KEY="..."
moltbot models status

若网关在 systemd/launchd 下运行，建议将密钥放在 ~/.clawdbot/.env 以便守护进程读取：


cat >> ~/.clawdbot/.env <<'EOF'
ANTHROPIC_API_KEY=...
EOF

然后重启守护进程（或重启网关进程）并再次检查：


moltbot models status
moltbot doctor

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

环境变量继承（env.shellEnv、~/.clawdbot/.env、systemd/launchd）详见帮助。

Anthropic：setup-token（订阅认证）

对 Anthropic，推荐路径是 API 密钥。若使用 Claude 订阅，也支持 setup-token 流程。在网关主机上执行：


claude setup-token

然后将令牌粘贴到 Moltbot：


moltbot models auth setup-token --provider anthropic

若令牌在另一台机器上创建，可手动粘贴：


moltbot 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 并更新配置）：


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

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


moltbot models status --check

可选运维脚本（systemd/Termux）见：认证监控

claude setup-token 需要交互式 TTY。

检查模型认证状态


moltbot models status
moltbot doctor

控制使用哪组凭据

按会话（聊天命令）

使用 /model <alias-or-id>@<profileId> 为当前会话固定某组提供商凭据（示例 profile id：anthropic:default、anthropic:work）。

使用 /model（或 /model list）打开紧凑选择器；使用 /model status 查看完整视图（候选 + 下一 auth profile，以及配置时的提供商端点详情）。

按 Agent（CLI 覆盖）

为某 agent 设置显式 auth profile 顺序覆盖（存储在该 agent 的 auth-profiles.json）：


moltbot models auth order get --provider anthropic
moltbot models auth order set --provider anthropic anthropic:default
moltbot models auth order clear --provider anthropic

使用 --agent <id> 指定 agent；省略则使用配置的默认 agent。

故障排查

“No credentials found”

若 Anthropic token profile 缺失，在网关主机上运行 claude setup-token，然后再次检查：


moltbot models status

令牌即将过期/已过期

运行 moltbot models status 确认哪个 profile 即将过期。若 profile 缺失，重新运行 claude setup-token 并再次粘贴令牌。

要求

Claude Max 或 Pro 订阅（用于 claude setup-token）
已安装 Claude Code CLI（claude 命令可用）