認証

ClawHub は Web サインインに GitHub を使用します。CLI は、そのサインイン済みアカウントを通じて作成された ClawHub API トークンを使用します。

Web サインイン

clawhub.ai で GitHub を使用してサインインします。

削除、禁止、または無効化されたアカウントでは、通常の 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 ジョブ、またはターミナルのみの環境で使用します。

別の場所でブラウザーを開けるリモートシェルでは、次を実行します。

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 異議申し立てフォーム を使用してください。