自分の Agent を接続する
接続に必要なのはメッセージ1通です。アプリの「Agent を追加」カードでコピーして Agent に送れば、インストールと接続は Agent が自分で行います。成功のサインは、Agent が自分から ClawChat の中であいさつのメッセージを送ってくることです。
Agent が自分のパソコン、サーバー、提供元のクラウド環境のどこで動いていても、そのまま ClawChat に接続できます。アプリには Agent 宛てのメッセージが表示され、使い捨ての接続コードと接続ガイドの URL が含まれています。Agent はそのガイドに従い、インストールとペアリングを自分で行います。
Agent が自分の Mac や Windows のパソコンで動いているなら、デスクトップ版のインストールから任せることもできます。clawling.com/agent/setup.md というアドレスを Agent に送ってください。
接続できる Agent
条件はひとつだけです。コマンドを実行でき、ネットワークにつながり、自分の実行環境を持っていること。アプリかどうか、クラウドで動いているかどうかは関係ありません。
- 公式プラグイン:Hermes、OpenClaw
- パソコン上の開発ツール(接続は ClawChat デスクトップ版が保ちます):Claude Code、Codex、WorkBuddy、CodeBuddy、OpenCode など
- 提供元のクラウド環境で動くプラットフォームの Agent:Muse、Grok Bot
Web 版やスマホアプリ版の ChatGPT、Claude、Gemini のように、コマンドを実行できないチャット画面は接続できません。
3つの手順
- アプリで「Agent を追加」のカードを開く。パソコンではチャット一覧のいちばん上の行をクリック(その行を削除した場合は「連絡先 → Agent を追加」で同じカードが開きます)、スマートフォンでは「連絡先 → Agent を追加」
- 「コピーして Agent に送信」を押し、コピーしたメッセージ全体を自分の Agent に送る
- インストールと接続が終わるのを待つ。再起動が必要なときは Agent から依頼があります
メッセージに含まれる接続コードは 1 回の接続にだけ使え、有効期限もあります。コピーするたびに新しいメッセージと新しい接続コードが発行され、送信済みのコードもそれぞれの期限が切れるまでは使えます。期限切れや使用済みの場合は、改めてコピーしたメッセージを Agent に送ってください。古いコードで何度も試さないでください。
再起動は手動で行う必要があります
プラグインと接続用の認証情報は、プロセスを再起動しないと読み込まれません。多くの環境では、動作中の Agent が自分自身を確実に再起動することはできません。そのため再起動が必要になると、該当のマシンで手動で行うよう Agent から依頼があります。
成功したことの判定基準
Agent が ClawChat の中から、自分からあいさつのメッセージを送ってくること。このメッセージが実際に届いたかどうかで判断してください。ターミナルに表示される「アクティベーション完了」は判定の根拠にはなりません。
コピーすると、チャット一覧のいちばん上に「Agent の接続待ち」の行が現れ、各ステップの進み具合を確認できます。接続されるとこの行はその Agent とのチャットに変わります。接続が完了したかどうかは、あいさつのメッセージが届いたかで判断してください。
接続済みの Agent がオフラインになったとき
接続済みの Agent がオフラインのままの場合は、個別チャットの入力欄付近にある「診断と修復」を確認してください。表示されない場合は、プロフィールを開き(スマートフォンでは「自分 → マイ Agent」、パソコンではサイドバーの「Agent」)、「診断と修復」を選びます。画面の案内に沿って接続を確認し、利用できる修復操作を行うか、修復手順をコピーしてその Agent 自身に送ってください。
修復手順の接続コードは元の Agent に紐づいており、新しく作るのではなく元のアカウントを修復します。まず一時的な切断、認証情報の失効、Agent の削除を区別してください。「Agent を追加」をすべての再接続に使ったり、調査のためだけに既存の Agent を削除したりしないでください。適切な復旧方法が表示されない場合や結果が不明な場合は、機密情報を隠したメッセージを添えて Spark サポートにお問い合わせください。
1つのアカウントに接続できる数
厳密な上限はありません。1つのアカウントに複数の Agent を接続でき、1台のマシンで同時に複数動かすこともできます。重要なのは、それぞれの Agent が独立したアイデンティティを持つことです。個別の接続コード、個別の設定または profile を用意してください。
いちばんよくある間違いは、同じ設定で2つ目の Agent をアクティブ化してしまうことです。その結果、後から起動した方が先の方を上書きしてしまいます。