Signal

ZeroClawのSignalチャネルは、実行中のsignal-cli HTTPデーモンと通信します。Signalは公式のボットAPIを提供していないため、ZeroClawはローカルHTTP経由でsignal-cliに接続し、signal-cliがSignalアカウント、デバイスキー、メッセージ転送を管理します。

既に signal-cli で Signal アカウントを運用している場合、または ZeroClaw の隣でデーモンを実行できる場合は、このチャネルを使用してください。Signal のデスクトップアプリまたはモバイルアプリのみがインストールされている場合、それだけでは不十分です。ZeroClaw には HTTP デーモンのエンドポイントが必要です。

エージェントと対話できるユーザー

受信側の送信者は、バインドされたエージェントに対して解決されたピアセットに照らして制御されます。これはエージェントが所属する peer_groups 設定から導出されます。照合では先頭の @ を取り除き、チャネルのネイティブな送信者識別子に対して大文字・小文字を区別せずに行われます。空のセットはすべてを拒否し、"*" を含むセットはすべてを受け入れます。それ以外の場合は、リストに記載された外部ピア（およびピアエージェント）のみが受け入れられます。これはゲートウェイのペアリング（gateway.require_pairing）とは別物であり、ペアリングはチャットチャネルの送信者ではなく HTTP/WebSocket クライアントを認証します。

signal 用のピアグループは、channel に signal を設定し、許可された送信者を external_peers に列挙し（signal の場合、E.164 形式の電話番号または signal-cli ソース識別子。["*"] は誰でも受け付けます）、必要に応じてクロスエージェントディスパッチ用のピア agents を指定し、ignore ブロックリスト、および output_modality（mirror、voice、または text）を指定します。フィールドのリファレンスについては Peer Groups を参照してください。

この設定の場所:

チャンネルレベルでトラフィックを絞り込むこともできます。dm_only = true はグループを無視します。group_ids = ["<signal-group-id>"] は、DMを受け付けつつ、リストに記載されたグループのみを受け付けます。ignore_attachments と ignore_stories は、これらのメッセージタイプをエージェントに到達する前に破棄します。

前提条件

• signal-cli でリンクまたは登録された Signal アカウント。
• 実行中の signal-cli HTTP デーモン。例: signal-cli daemon --http 127.0.0.1:8686。
• channel-signal 機能を有効にした ZeroClaw ビルド。

デーモンは、独自の認証済みネットワーク境界の背後に配置しない限り、localhost にバインドしたままにしてください。デーモンは、リンクされた Signal アカウントとして送受信できます。

チャネルを構成する

zeroclaw config set channels.signal.<alias>.account <value>

export ZEROCLAW_channels__signal__<alias>__account=

zeroclaw config set channels.signal.<alias>.approval_timeout_secs <value>

export ZEROCLAW_channels__signal__<alias>__approval_timeout_secs=

zeroclaw config set channels.signal.<alias>.dm_only <value>

export ZEROCLAW_channels__signal__<alias>__dm_only=

zeroclaw config set channels.signal.<alias>.excluded_tools <value>

export ZEROCLAW_channels__signal__<alias>__excluded_tools=

zeroclaw config set channels.signal.<alias>.group_ids <value>

export ZEROCLAW_channels__signal__<alias>__group_ids=

zeroclaw config set channels.signal.<alias>.http_url <value>

export ZEROCLAW_channels__signal__<alias>__http_url=

zeroclaw config set channels.signal.<alias>.ignore_attachments <value>

export ZEROCLAW_channels__signal__<alias>__ignore_attachments=

zeroclaw config set channels.signal.<alias>.ignore_stories <value>

export ZEROCLAW_channels__signal__<alias>__ignore_stories=

zeroclaw config set channels.signal.<alias>.proxy_url <value>

export ZEROCLAW_channels__signal__<alias>__proxy_url=

zeroclaw config set channels.signal.<alias>.reply_min_interval_secs <value>

export ZEROCLAW_channels__signal__<alias>__reply_min_interval_secs=

zeroclaw config set channels.signal.<alias>.reply_queue_depth_max <value>

export ZEROCLAW_channels__signal__<alias>__reply_queue_depth_max=

エージェントの channels リストを使用して、チャネルをそのエージェントにバインドします。

開始と確認

最初にデーモンを起動し、その後 ZeroClaw チャンネルを起動します:

signal-cli daemon --http 127.0.0.1:8686
zeroclaw channel start

zeroclaw channel doctor を使用して、ZeroClaw が設定済みのチャンネルを読み込めることを確認してください。チャンネルが実行時に失敗する場合は、http_url がデーモンを指していること、アカウントが signal-cli に登録されていること、ビルドに channel-signal が含まれていることを確認してください。

よくある混乱

signal-cli プロジェクトは主に CLI として知られていますが、ZeroClaw はその HTTP デーモンモードを必要とします。コマンドラインバイナリのみをインストールしてデーモンを起動していない場合、ZeroClaw には接続先がありません。