身份验证

ClawHub 使用 GitHub 进行网页登录。CLI 使用通过该已登录账户创建的 ClawHub API 令牌。

网页登录

使用 GitHub 登录 clawhub.ai。

已删除、被封禁或被停用的账户无法完成正常的 ClawHub 登录。如果登录后返回未登录状态，你的账户可能并非处于正常状态。如果你的账户被封禁或停用，并且你认为这是误判，请使用 ClawHub 申诉表单。

CLI 登录

默认的 CLI 登录流程会打开浏览器：

clawhub loginclawhub whoami

流程如下：

1. CLI 在 127.0.0.1 上启动临时回调服务器。
2. 浏览器打开 ClawHub 登录页面。
3. 完成 GitHub 登录后，ClawHub 会创建一个 API 令牌。
4. 浏览器重定向回本地回调地址。
5. CLI 将令牌存储在你的 ClawHub 配置文件中。

如果由于防火墙、VPN 或代理规则，浏览器无法访问本地回调地址，请使用无头令牌流程。

无头登录

在 ClawHub Web UI 中创建令牌，然后将其传递给 CLI：

clawhub login --token clh_...

此流程适用于服务器、CI 任务或仅有终端的环境。

对于可在其他位置打开浏览器的远程 shell，请运行：

clawhub login --device

CLI 会输出一次性代码，并在你通过 https://clawhub.ai/cli/device 授权期间等待。

令牌存储

默认配置路径：

• macOS：~/Library/Application Support/clawhub/config.json
• Linux/XDG：$XDG_CONFIG_HOME/clawhub/config.json 或 ~/.config/clawhub/config.json
• Windows：%APPDATA%\\clawhub\\config.json

使用以下方式覆盖路径：

export CLAWHUB_CONFIG_PATH=/path/to/config.json

使用以下命令输出已存储的令牌，以便配置 CI：

clawhub token

撤销

你可以在 ClawHub Web UI 中撤销 API 令牌。

已撤销、无效或缺失的令牌会返回 401 Unauthorized。请使用 clawhub login 重新登录，或使用 clawhub login --token 提供新令牌。

已删除、被封禁或被停用的账户无法继续使用现有 API 令牌。如果你的账户被封禁或停用，并且你认为这是误判，请使用 ClawHub 申诉表单。