認証

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

Web サインイン

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

削除、BAN、または無効化されたアカウントでは、通常の ClawHub サインインを完了できません。サインイン後にログアウト状態へ戻る場合は、アカウントが良好な状態ではない可能性があります。アカウントが BAN または無効化されており、それが誤りだと思われる場合は、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 で新しいトークンを指定してください。

削除、BAN、または無効化されたアカウントでは、既存の API トークンを引き続き使用できません。アカウントが BAN または無効化されており、それが誤りだと思われる場合は、ClawHub 異議申し立てフォームを使用してください。