Signal

​

番号モデル（最初に読んでください）

• Gateway は Signal デバイス、つまり signal-cli アカウントに接続します。
• ボットを 個人用 Signal アカウントで実行すると、自分自身のメッセージを無視します（ループ保護）。
• 「自分がボットにテキストを送り、ボットが返信する」には、別のボット用番号を使用します。

​

インストール

openclaw plugins install @openclaw/signal

​

クイックセットアップ

openclaw plugins install @openclaw/signal

openclaw channels add

openclaw gateway call channels.status --params '{"probe":true}'

{
  channels: {
    signal: {
      enabled: true,
      account: "+15551234567",
      cliPath: "signal-cli",
      dmPolicy: "pairing",
      allowFrom: ["+15557654321"],
    },
  },
}

​

概要

• 決定的ルーティング: 返信は常に Signal に戻ります。
• DM はエージェントのメインセッションを共有します。グループは分離されます（agent:<agentId>:signal:group:<groupId>）。
• デフォルトでは、Signal は /config set|unset によってトリガーされた設定更新を書き込む場合があります（commands.config: true が必要）。channels.signal.configWrites: false で無効化します。

​

セットアップパス A: 既存の Signal アカウントをリンクする（QR）

1. signal-cli（JVM またはネイティブビルド）をインストールするか、openclaw channels add にインストールさせます。
2. ボットアカウントをリンクします: signal-cli link -n "OpenClaw" を実行してから、Signal で QR をスキャンします。
3. Signal を構成し、Gateway を起動します。

​

セットアップパス B: 専用ボット番号を登録する（SMS、Linux）

1. SMS を受信できる番号（または固定電話向けの音声検証）を取得します。専用ボット番号により、アカウントやセッションの競合を避けられます。
2. Gateway ホストに signal-cli をインストールします:

VERSION=$(curl -Ls -o /dev/null -w %{url_effective} https://github.com/AsamK/signal-cli/releases/latest | sed -e 's/^.*\/v//')
curl -L -O "https://github.com/AsamK/signal-cli/releases/download/v${VERSION}/signal-cli-${VERSION}-Linux-native.tar.gz"
sudo tar xf "signal-cli-${VERSION}-Linux-native.tar.gz" -C /opt
sudo ln -sf /opt/signal-cli /usr/local/bin/
signal-cli --version

3. 番号を登録して検証します:

signal-cli -a +<BOT_PHONE_NUMBER> register

1. https://signalcaptchas.org/registration/generate.html を開きます。
2. captcha を完了し、「Open Signal」から signalcaptcha://... リンクターゲットをコピーします。
3. 可能な場合は、ブラウザーセッションと同じ外部 IP から実行します（captcha トークンはすぐに期限切れになります）。
4. すぐに登録して検証します:

signal-cli -a +<BOT_PHONE_NUMBER> register --captcha '<SIGNALCAPTCHA_URL>'
signal-cli -a +<BOT_PHONE_NUMBER> verify <VERIFICATION_CODE>

4. OpenClaw を構成し、Gateway を再起動して、チャンネルを検証します:

# Gateway をユーザー systemd サービスとして実行している場合:
systemctl --user restart openclaw-gateway.service

# その後、検証:
openclaw doctor
openclaw channels status --probe

5. DM 送信者をペアリングします:
   • ボット番号に任意のメッセージを送信します。
   • サーバーで承認します: openclaw pairing approve signal <PAIRING_CODE>。
   • 「Unknown contact」を避けるため、ボット番号を電話の連絡先として保存します。

• signal-cli README: https://github.com/AsamK/signal-cli
• Captcha フロー: https://github.com/AsamK/signal-cli/wiki/Registration-with-captcha
• リンクフロー: https://github.com/AsamK/signal-cli/wiki/Linking-other-devices-(Provisioning)

​

外部デーモンモード（httpUrl）

{
  channels: {
    signal: {
      httpUrl: "http://127.0.0.1:8080",
      autoStart: false,
    },
  },
}

​

コンテナモード（bbernhard/signal-cli-rest-api）

• リアルタイムのメッセージ受信には、コンテナを 必ず MODE=json-rpc で実行する必要があります。
• OpenClaw に接続する前に、コンテナ内で Signal アカウントを登録またはリンクしてください。

signal-cli:
  image: bbernhard/signal-cli-rest-api:latest
  environment:
    MODE: json-rpc
  ports:
    - "8080:8080"
  volumes:
    - signal-cli-data:/home/.local/share/signal-cli

{
  channels: {
    signal: {
      enabled: true,
      account: "+15551234567",
      httpUrl: "http://signal-cli:8080",
      autoStart: false,
      apiMode: "container", // or "auto" to detect automatically
    },
  },
}

• コンテナモードでは autoStart: false を使用してください。apiMode: "container" が選択されている場合、OpenClaw はネイティブデーモンをスポーンすべきではありません。
• 受信には MODE=json-rpc を使用してください。MODE=normal では /v1/about が正常に見える場合がありますが、/v1/receive/{account} は WebSocket にアップグレードされないため、OpenClaw は auto モードでコンテナ受信ストリーミングを選択しません。
• httpUrl が bbernhard REST API を指す場合は apiMode: "container"、ネイティブ signal-cli JSON-RPC/SSE を指す場合は "native"、デプロイが変わる可能性がある場合は "auto" を設定します。
• コンテナの添付ファイルダウンロードは、ネイティブモードと同じメディアバイト制限に従います。サーバーが Content-Length を送信する場合、サイズ超過レスポンスは完全にバッファリングされる前に拒否され、それ以外の場合はストリーミング中に拒否されます。

​

アクセス制御（DM + グループ）

• デフォルト: channels.signal.dmPolicy = "pairing"。
• 不明な送信者にはペアリングコードが送信されます。承認されるまでメッセージは無視されます（コードは 1 時間後に期限切れになります）。
• openclaw pairing list signal と openclaw pairing approve signal <CODE> で承認します。
• ペアリングは Signal DM のデフォルトのトークン交換です。詳細: ペアリング
• UUID のみの送信者（sourceUuid 由来）は、channels.signal.allowFrom に uuid:<id> として保存されます。

• channels.signal.groupPolicy = open | allowlist | disabled。
• channels.signal.groupAllowFrom は、allowlist が設定されている場合にグループ返信をトリガーできるグループまたは送信者を制御します。エントリには、Signal グループ ID（raw、group:<id>、または signal:group:<id>）、送信者の電話番号、uuid:<id> 値、または * を使用できます。
• channels.signal.groups["<group-id>" | "*"] は、requireMention、tools、toolsBySender でグループ動作を上書きできます。
• マルチアカウントセットアップでアカウントごとの上書きを行うには、channels.signal.accounts.<id>.groups を使用します。
• groupAllowFrom でグループを許可リストに追加しても、それ自体ではメンションゲートは無効になりません。明示的に構成された channels.signal.groups["<group-id>"] エントリは、requireMention: true が明示的に設定されていない限り、すべてのグループメッセージを処理します。
• ランタイムメモ: channels.signal が完全に欠落している場合、ランタイムはグループチェックで groupPolicy="allowlist" にフォールバックします（channels.defaults.groupPolicy が設定されている場合でも）。

​

仕組み（動作）

• ネイティブモード: signal-cli はデーモンとして実行され、Gateway は SSE 経由でイベントを読み取ります。
• コンテナモード: Gateway は REST API 経由で送信し、WebSocket 経由で受信します。
• 受信メッセージは共有チャンネルエンベロープに正規化されます。
• 返信は常に同じ番号またはグループにルーティングされます。

​

メディア + 制限

• 送信テキストは channels.signal.textChunkLimit（デフォルト 4000）に分割されます。
• 任意の改行分割: 長さによる分割の前に空行（段落境界）で分割するには、channels.signal.chunkMode="newline" を設定します。
• 添付ファイルに対応しています（signal-cli から base64 を取得）。
• ボイスメモの添付では、contentType がない場合に signal-cli のファイル名を MIME フォールバックとして使うため、音声文字起こしは AAC ボイスメモを引き続き分類できます。
• デフォルトのメディア上限: channels.signal.mediaMaxMb（デフォルト 8）。
• メディアのダウンロードをスキップするには channels.signal.ignoreAttachments を使います。
• グループ履歴コンテキストは channels.signal.historyLimit（または channels.signal.accounts.*.historyLimit）を使い、messages.groupChat.historyLimit にフォールバックします。無効にするには 0 を設定します（デフォルト 50）。

​

入力中表示 + 既読通知

• 入力中インジケーター: OpenClaw は signal-cli sendTyping 経由で入力中シグナルを送信し、返信の実行中に更新します。
• 既読通知: channels.signal.sendReadReceipts が true の場合、OpenClaw は許可された DM の既読通知を転送します。
• signal-cli はグループの既読通知を公開しません。

​

ライフサイクルステータスのリアクション

​

リアクション（メッセージツール）

• 対象: 送信者の E.164 または UUID（ペアリング出力の uuid:<id> を使います。裸の UUID も動作します）。
• messageId は、リアクションするメッセージの Signal タイムスタンプです。
• グループリアクションには targetAuthor または targetAuthorUuid が必要です。

message action=react channel=signal target=uuid:123e4567-e89b-12d3-a456-426614174000 messageId=1737630212345 emoji=🔥
message action=react channel=signal target=+15551234567 messageId=1737630212345 emoji=🔥 remove=true
message action=react channel=signal target=signal:group:<groupId> targetAuthor=uuid:<sender-uuid> messageId=1737630212345 emoji=✅

• channels.signal.actions.reactions: リアクションアクションを有効化/無効化します（デフォルト true）。
• channels.signal.reactionLevel: off | ack | minimal | extensive（デフォルト minimal）。
  • off/ack はエージェントリアクションを無効にします（メッセージツールの react はエラーになります）。
  • minimal/extensive はエージェントリアクションを有効にし、ガイダンスレベルを設定します。
• アカウント単位の上書き: channels.signal.accounts.<id>.actions.reactions、channels.signal.accounts.<id>.reactionLevel。

​

承認リアクション

• 👍 は 1 回だけ承認します。
• 👎 は拒否します。
• リクエストが永続的な承認を提供する場合は /approve <id> allow-always を使います。

​

配信先（CLI/Cron）

• DM: signal:+15551234567（またはプレーンな E.164）。
• UUID DM: uuid:<id>（または裸の UUID）。
• グループ: signal:group:<groupId>。
• ユーザー名: username:<name>（Signal アカウントで対応している場合）。

​

エイリアス

{
  channels: {
    signal: {
      aliases: {
        me: "+15557654321",
        jane: "uuid:123e4567-e89b-12d3-a456-426614174000",
        ops: "group:<groupId>",
      },
      defaultTo: "signal:me",
    },
  },
}

openclaw message send --channel signal --target signal:ops --message "Deployment is complete"

{
  channels: {
    signal: {
      aliases: {
        me: "+15557654321",
      },
      accounts: {
        work: {
          aliases: {
            ops: "group:<workGroupId>",
          },
        },
      },
    },
  },
}

​

トラブルシューティング

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

openclaw pairing list signal

• デーモンには到達できるが返信がない: アカウント/デーモン設定（httpUrl、account）と受信モードを確認します。
• DM が無視される: 送信者がペアリング承認待ちです。
• グループメッセージが無視される: グループ送信者/メンションのゲートが配信をブロックしています。
• 編集後に設定検証エラーが出る: openclaw doctor --fix を実行します。
• 診断に Signal がない: channels.signal.enabled: true を確認します。

openclaw pairing list signal
pgrep -af signal-cli
grep -i "signal" "/tmp/openclaw/openclaw-$(date +%Y-%m-%d).log" | tail -20

​

セキュリティメモ

• signal-cli はアカウントキーをローカルに保存します（通常は ~/.local/share/signal-cli/data/）。
• サーバー移行または再構築の前に、Signal アカウント状態をバックアップしてください。
• より広い DM アクセスを明示的に必要としない限り、channels.signal.dmPolicy: "pairing" のままにします。
• SMS 認証は登録またはリカバリーフローでのみ必要ですが、番号/アカウントの制御を失うと再登録が複雑になる可能性があります。

​

設定リファレンス（Signal）

• channels.signal.enabled: チャンネル起動を有効化/無効化します。
• channels.signal.apiMode: auto | native | container（デフォルト: auto）。コンテナモード を参照してください。
• channels.signal.account: bot アカウントの E.164。
• channels.signal.cliPath: signal-cli へのパス。
• channels.signal.configPath: 任意の signal-cli --config ディレクトリ。
• channels.signal.httpUrl: 完全なデーモン URL（host/port を上書きします）。
• channels.signal.httpHost、channels.signal.httpPort: デーモンのバインド（デフォルト 127.0.0.1:8080）。
• channels.signal.autoStart: デーモンを自動起動します（httpUrl が未設定の場合、デフォルト true）。
• channels.signal.startupTimeoutMs: 起動待機タイムアウト（ミリ秒）（最小 1000、上限 120000、デフォルト 30000）。
• channels.signal.receiveMode: on-start | manual。
• channels.signal.ignoreAttachments: 添付ファイルのダウンロードをスキップします。
• channels.signal.ignoreStories: デーモンからのストーリーを無視します。
• channels.signal.sendReadReceipts: 既読通知を転送します。
• channels.signal.dmPolicy: pairing | allowlist | open | disabled（デフォルト: pairing）。
• channels.signal.allowFrom: DM 許可リスト（E.164 または uuid:<id>）。open には "*" が必要です。Signal にはユーザー名がありません。電話番号/UUID ID を使います。
• channels.signal.aliases: DM またはグループ配信先の OpenClaw 側エイリアス。
• channels.signal.groupPolicy: open | allowlist | disabled（デフォルト: allowlist）。
• channels.signal.groupAllowFrom: グループ許可リスト。Signal グループ ID（raw、group:<id>、または signal:group:<id>）、送信者の E.164 番号、または uuid:<id> 値を受け付けます。
• channels.signal.groups: Signal グループ ID（または "*"）をキーにしたグループ単位の上書き。対応フィールド: requireMention、tools、toolsBySender。
• channels.signal.accounts.<id>.groups: マルチアカウント設定向けの channels.signal.groups のアカウント単位版。
• channels.signal.accounts.<id>.aliases: アカウント単位のエイリアス。トップレベルのエイリアスとマージされます。
• channels.signal.historyLimit: コンテキストに含めるグループメッセージの最大数（0 で無効）。
• channels.signal.dmHistoryLimit: ユーザーターン単位の DM 履歴上限。ユーザー単位の上書き: channels.signal.dms["<phone_or_uuid>"].historyLimit。
• channels.signal.textChunkLimit: 送信チャンクサイズ（文字数）（デフォルト 4000）。
• channels.signal.chunkMode: length（デフォルト）または、長さによる分割の前に空行（段落境界）で分割する newline。
• channels.signal.mediaMaxMb: 受信/送信メディアの上限（MB）（デフォルト 8）。
• channels.signal.reactionLevel: off | ack | minimal | extensive（デフォルト minimal）。リアクション を参照してください。
• channels.signal.reactionNotifications: off | own | all | allowlist（デフォルト own）- 他者からの受信リアクションをエージェントに通知するタイミング。
• channels.signal.reactionAllowlist: reactionNotifications: "allowlist" の場合に、リアクションでエージェントに通知する送信者。
• channels.signal.blockStreaming、channels.signal.blockStreamingCoalesce: チャンネル間で共有されるブロックモードのストリーミング制御。ストリーミング を参照してください。

• agents.list[].groupChat.mentionPatterns（Signal はネイティブメンションに対応していません）。
• messages.groupChat.mentionPatterns（グローバルフォールバック）。
• messages.responsePrefix。

​

関連

• チャンネル概要 - 対応するすべてのチャンネル
• ペアリング - DM 認証とペアリングフロー
• グループ - グループチャットの動作とメンションゲート
• チャンネルルーティング - メッセージのセッションルーティング
• セキュリティ - アクセスモデルと強化