設定 — チャンネル

channels.* 配下のチャンネル別設定キー。DM とグループアクセス、 複数アカウント構成、メンションゲート、Slack、Discord、 Telegram、WhatsApp、Matrix、iMessage、およびその他の同梱チャンネル Plugin 向けのチャンネル別キーを扱います。

エージェント、ツール、Gateway ランタイム、その他のトップレベルキーについては、 設定リファレンスを参照してください。

# チャンネル

各チャンネルは、その設定セクションが存在すると自動的に起動します（enabled: false の場合を除く）。

# DM とグループアクセス

すべてのチャンネルは DM ポリシーとグループポリシーをサポートします。

# チャンネルモデルの上書き

特定のチャンネル ID をモデルに固定するには channels.modelByChannel を使用します。値には provider/model または設定済みのモデルエイリアスを指定できます。チャンネルマッピングは、セッションにモデル上書きがまだない場合（たとえば /model で設定された場合など）に適用されます。

{
  channels: {
    modelByChannel: {
      discord: {
        "123456789012345678": "anthropic/claude-opus-4-6",
      },
      slack: {
        C1234567890: "openai/gpt-4.1",
      },
      telegram: {
        "-1001234567890": "openai/gpt-4.1-mini",
        "-1001234567890:topic:99": "anthropic/claude-sonnet-4-6",
      },
    },
  },
}

# チャンネルのデフォルトと Heartbeat

プロバイダー全体で共有するグループポリシーと Heartbeat の動作には channels.defaults を使用します。

{
  channels: {
    defaults: {
      groupPolicy: "allowlist", // open | allowlist | disabled
      contextVisibility: "all", // all | allowlist | allowlist_quote
      heartbeat: {
        showOk: false,
        showAlerts: true,
        useIndicator: true,
      },
    },
  },
}

• channels.defaults.groupPolicy: プロバイダーレベルの groupPolicy が未設定の場合のフォールバックグループポリシー。
• channels.defaults.contextVisibility: すべてのチャンネルで使用する補足コンテキストのデフォルト可視性モード。値: all（デフォルト、引用/スレッド/履歴コンテキストをすべて含める）、allowlist（許可リスト内の送信者からのコンテキストのみ含める）、allowlist_quote（許可リストと同じだが、明示的な引用/返信コンテキストは保持）。チャンネル別の上書き: channels.<channel>.contextVisibility。
• channels.defaults.heartbeat.showOk: Heartbeat 出力に正常なチャンネルステータスを含めます。
• channels.defaults.heartbeat.showAlerts: Heartbeat 出力に劣化/エラーステータスを含めます。
• channels.defaults.heartbeat.useIndicator: コンパクトなインジケーター形式の Heartbeat 出力をレンダリングします。

# WhatsApp

WhatsApp は Gateway の Web チャンネル（Baileys Web）を通じて実行されます。リンク済みセッションが存在すると自動的に起動します。

{
  web: {
    enabled: true,
    heartbeatSeconds: 60,
    whatsapp: {
      keepAliveIntervalMs: 25000,
      connectTimeoutMs: 60000,
      defaultQueryTimeoutMs: 60000,
    },
    reconnect: {
      initialMs: 2000,
      maxMs: 120000,
      factor: 1.4,
      jitter: 0.2,
      maxAttempts: 0,
    },
  },
  channels: {
    whatsapp: {
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["+15555550123", "+447700900123"],
      textChunkLimit: 4000,
      chunkMode: "length", // length | newline
      mediaMaxMb: 50,
      sendReadReceipts: true, // blue ticks (false in self-chat mode)
      groups: {
        "*": { requireMention: true },
      },
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

{
channels: {
  whatsapp: {
    accounts: {
      default: {},
      personal: {},
      biz: {
        // authDir: "~/.openclaw/credentials/whatsapp/biz",
      },
    },
  },
},
}

# Telegram

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "your-bot-token",
      dmPolicy: "pairing",
      allowFrom: ["tg:123456789"],
      groups: {
        "*": { requireMention: true },
        "-1001234567890": {
          allowFrom: ["@admin"],
          systemPrompt: "Keep answers brief.",
          topics: {
            "99": {
              requireMention: false,
              skills: ["search"],
              systemPrompt: "Stay on topic.",
            },
          },
        },
      },
      customCommands: [
        { command: "backup", description: "Git backup" },
        { command: "generate", description: "Create an image" },
      ],
      historyLimit: 50,
      replyToMode: "first", // off | first | all | batched
      linkPreview: true,
      streaming: "partial", // off | partial | block | progress (default: off; opt in explicitly to avoid preview-edit rate limits)
      actions: { reactions: true, sendMessage: true },
      reactionNotifications: "own", // off | own | all
      mediaMaxMb: 100,
      retry: {
        attempts: 3,
        minDelayMs: 400,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
      network: {
        autoSelectFamily: true,
        dnsResultOrder: "ipv4first",
      },
      apiRoot: "https://api.telegram.org",
      proxy: "socks5://localhost:9050",
      webhookUrl: "https://example.com/telegram-webhook",
      webhookSecret: "secret",
      webhookPath: "/telegram-webhook",
    },
  },
}

• ボットトークン: channels.telegram.botToken または channels.telegram.tokenFile（通常ファイルのみ。シンボリックリンクは拒否）。デフォルトアカウントのフォールバックとして TELEGRAM_BOT_TOKEN を使用します。
• apiRoot は Telegram Bot API のルートのみです。https://api.telegram.org/bot<TOKEN> ではなく、https://api.telegram.org または自己ホスト/プロキシのルートを使用してください。openclaw doctor --fix は、誤って付いた末尾の /bot<TOKEN> サフィックスを削除します。
• 任意の channels.telegram.defaultAccount は、設定済みアカウント ID と一致する場合、デフォルトアカウント選択を上書きします。
• 複数アカウント構成（2 個以上のアカウント ID）では、フォールバックルーティングを避けるために明示的なデフォルト（channels.telegram.defaultAccount または channels.telegram.accounts.default）を設定してください。これがない、または無効な場合、openclaw doctor が警告します。
• configWrites: false は、Telegram 起点の設定書き込み（スーパーグループ ID 移行、/config set|unset）をブロックします。
• type: "acp" を持つトップレベルの bindings[] エントリは、フォーラムトピック用の永続的な ACP バインディングを設定します（match.peer.id には正規の chatId:topic:topicId を使用）。フィールドの意味は ACP エージェントで共有されています。
• Telegram のストリームプレビューは sendMessage + editMessageText を使用します（ダイレクトチャットとグループチャットで動作します）。
• 再試行ポリシー: 再試行ポリシーを参照してください。

# Discord

{
  channels: {
    discord: {
      enabled: true,
      token: "your-bot-token",
      mediaMaxMb: 100,
      allowBots: false,
      actions: {
        reactions: true,
        stickers: true,
        polls: true,
        permissions: true,
        messages: true,
        threads: true,
        pins: true,
        search: true,
        memberInfo: true,
        roleInfo: true,
        roles: false,
        channelInfo: true,
        voiceStatus: true,
        events: true,
        moderation: false,
      },
      replyToMode: "off", // off | first | all | batched
      dmPolicy: "pairing",
      allowFrom: ["1234567890", "123456789012345678"],
      dm: { enabled: true, groupEnabled: false, groupChannels: ["openclaw-dm"] },
      guilds: {
        "123456789012345678": {
          slug: "friends-of-openclaw",
          requireMention: false,
          ignoreOtherMentions: true,
          reactionNotifications: "own",
          users: ["987654321098765432"],
          channels: {
            general: { allow: true },
            help: {
              allow: true,
              requireMention: true,
              users: ["987654321098765432"],
              skills: ["docs"],
              systemPrompt: "Short answers only.",
            },
          },
        },
      },
      historyLimit: 20,
      textChunkLimit: 2000,
      chunkMode: "length", // length | newline
      streaming: {
        mode: "progress", // off | partial | block | progress (Discord default: progress)
        progress: {
          label: "auto",
          maxLines: 8,
          toolProgress: true,
        },
      },
      maxLinesPerMessage: 17,
      ui: {
        components: {
          accentColor: "#5865F2",
        },
      },
      threadBindings: {
        enabled: true,
        idleHours: 24,
        maxAgeHours: 0,
        spawnSessions: true,
        defaultSpawnContext: "fork",
      },
      voice: {
        enabled: true,
        autoJoin: [
          {
            guildId: "123456789012345678",
            channelId: "234567890123456789",
          },
        ],
        daveEncryption: true,
        decryptionFailureTolerance: 24,
        connectTimeoutMs: 30000,
        reconnectGraceMs: 15000,
        tts: {
          provider: "openai",
          openai: { voice: "alloy" },
        },
      },
      execApprovals: {
        enabled: "auto", // true | false | "auto"
        approvers: ["987654321098765432"],
        agentFilter: ["default"],
        sessionFilter: ["discord:"],
        target: "dm", // dm | channel | both
        cleanupAfterResolve: false,
      },
      retry: {
        attempts: 3,
        minDelayMs: 500,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
  },
}

• トークン: channels.discord.token。デフォルトアカウントのフォールバックとして DISCORD_BOT_TOKEN を使用します。
• 明示的な Discord token を指定する直接アウトバウンド呼び出しは、その呼び出しにそのトークンを使用します。アカウントのリトライ/ポリシー設定は、アクティブなランタイムスナップショット内で選択されたアカウントから引き続き取得されます。
• 任意の channels.discord.defaultAccount は、設定済みアカウント ID と一致する場合にデフォルトアカウント選択を上書きします。
• 配信ターゲットには user:<id> (DM) または channel:<id> (ギルドチャンネル) を使用します。そのままの数値 ID は拒否されます。
• ギルドスラッグは小文字で、スペースは - に置換されます。チャンネルキーはスラッグ化された名前を使用します (# なし)。ギルド ID を推奨します。
• ボットが作成したメッセージはデフォルトで無視されます。allowBots: true で有効になります。ボットへのメンションを含むボットメッセージだけを受け入れるには allowBots: "mentions" を使用します (自身のメッセージは引き続きフィルタされます)。
• channels.discord.guilds.<id>.ignoreOtherMentions (およびチャンネル上書き) は、ボットではなく別のユーザーまたはロールにメンションするメッセージを破棄します (@everyone/@here は除外)。
• channels.discord.mentionAliases は、送信前に安定したアウトバウンド @handle テキストを Discord ユーザー ID にマップするため、一時的なディレクトリキャッシュが空でも既知のチームメイトを決定的にメンションできます。アカウント別の上書きは channels.discord.accounts.<accountId>.mentionAliases 配下にあります。
• maxLinesPerMessage (デフォルト 17) は、2000 文字未満でも縦に長いメッセージを分割します。
• channels.discord.threadBindings は Discord のスレッドバインドされたルーティングを制御します:
  • enabled: スレッドバインドされたセッション機能 (/focus、/unfocus、/agents、/session idle、/session max-age、およびバインドされた配信/ルーティング) の Discord 上書き
  • idleHours: 非アクティブ時の自動フォーカス解除の Discord 上書き時間 (0 で無効)
  • maxAgeHours: ハード最大経過時間の Discord 上書き時間 (0 で無効)
  • spawnSessions: sessions_spawn({ thread: true }) および ACP スレッド生成時の自動スレッド作成/バインドのスイッチ (デフォルト: true)
  • defaultSpawnContext: スレッドバインド生成用のネイティブサブエージェントコンテキスト (デフォルトは "fork")
• type: "acp" を持つトップレベルの bindings[] エントリは、チャンネルとスレッドの永続 ACP バインディングを設定します (match.peer.id にはチャンネル/スレッド ID を使用)。フィールドのセマンティクスは ACP エージェント で共有されています。
• channels.discord.ui.components.accentColor は Discord コンポーネント v2 コンテナのアクセントカラーを設定します。
• channels.discord.voice は Discord ボイスチャンネル会話と、任意の自動参加 + LLM + TTS 上書きを有効にします。テキストのみの Discord 設定では、デフォルトでボイスはオフのままです。オプトインするには channels.discord.voice.enabled=true を設定します。
• channels.discord.voice.model は、Discord ボイスチャンネル応答に使用する LLM モデルを任意で上書きします。
• channels.discord.voice.daveEncryption と channels.discord.voice.decryptionFailureTolerance は、@discordjs/voice の DAVE オプションにそのまま渡されます (デフォルトは true と 24)。
• channels.discord.voice.connectTimeoutMs は /vc join と自動参加試行に対する初期 @discordjs/voice Ready 待機を制御します (デフォルトは 30000)。
• channels.discord.voice.reconnectGraceMs は、切断されたボイスセッションが再接続シグナリングに入るまで OpenClaw が破棄せずに待つ時間を制御します (デフォルトは 15000)。
• Discord ボイス再生は、別ユーザーの発話開始イベントによって中断されません。フィードバックループを避けるため、OpenClaw は TTS 再生中の新しい音声キャプチャを無視します。
• OpenClaw はさらに、復号失敗が繰り返された後にボイスセッションを離脱/再参加することで、音声受信の復旧を試みます。
• channels.discord.streaming は正規のストリームモードキーです。Discord のデフォルトは streaming.mode: "progress" で、ツール/作業の進行状況が 1 つの編集済みプレビューメッセージに表示されます。無効にするには streaming.mode: "off" を設定します。レガシーの streamMode と真偽値の streaming 値はランタイムエイリアスとして残ります。永続化された設定を書き換えるには openclaw doctor --fix を実行してください。
• channels.discord.autoPresence はランタイム可用性をボットプレゼンスにマップし (healthy => online、degraded => idle、exhausted => dnd)、任意のステータステキスト上書きを許可します。
• channels.discord.dangerouslyAllowNameMatching は、可変の名前/タグ照合を再有効化します (緊急互換モード)。
• channels.discord.execApprovals: Discord ネイティブの exec 承認配信と承認者認可。
  • enabled: true、false、または "auto" (デフォルト)。自動モードでは、approvers または commands.ownerAllowFrom から承認者を解決できる場合に exec 承認が有効になります。
  • approvers: exec リクエストの承認を許可された Discord ユーザー ID。省略時は commands.ownerAllowFrom にフォールバックします。
  • agentFilter: 任意のエージェント ID 許可リスト。省略するとすべてのエージェントの承認を転送します。
  • sessionFilter: 任意のセッションキーパターン (部分文字列または正規表現)。
  • target: 承認プロンプトの送信先。"dm" (デフォルト) は承認者の DM に送信し、"channel" は送信元チャンネルに送信し、"both" は両方に送信します。ターゲットに "channel" が含まれる場合、ボタンは解決済み承認者だけが使用できます。
  • cleanupAfterResolve: true の場合、承認、拒否、またはタイムアウト後に承認 DM を削除します。

リアクション通知モード: off (なし)、own (ボットのメッセージ、デフォルト)、all (すべてのメッセージ)、allowlist (すべてのメッセージで guilds.<id>.users から)。

# Google Chat

{
  channels: {
    googlechat: {
      enabled: true,
      serviceAccountFile: "/path/to/service-account.json",
      audienceType: "app-url", // app-url | project-number
      audience: "https://gateway.example.com/googlechat",
      webhookPath: "/googlechat",
      botUser: "users/1234567890",
      dm: {
        enabled: true,
        policy: "pairing",
        allowFrom: ["users/1234567890"],
      },
      groupPolicy: "allowlist",
      groups: {
        "spaces/AAAA": { allow: true, requireMention: true },
      },
      actions: { reactions: true },
      typingIndicator: "message",
      mediaMaxMb: 20,
    },
  },
}

• サービスアカウント JSON: インライン (serviceAccount) またはファイルベース (serviceAccountFile)。
• サービスアカウント SecretRef もサポートされています (serviceAccountRef)。
• 環境変数フォールバック: GOOGLE_CHAT_SERVICE_ACCOUNT または GOOGLE_CHAT_SERVICE_ACCOUNT_FILE。
• 配信ターゲットには spaces/<spaceId> または users/<userId> を使用します。
• channels.googlechat.dangerouslyAllowNameMatching は、可変のメールプリンシパル照合を再有効化します (緊急互換モード)。

# Slack

{
  channels: {
    slack: {
      enabled: true,
      botToken: "xoxb-...",
      appToken: "xapp-...",
      socketMode: {
        clientPingTimeout: 15000,
        serverPingTimeout: 30000,
        pingPongLoggingEnabled: false,
      },
      dmPolicy: "pairing",
      allowFrom: ["U123", "U456", "*"],
      dm: { enabled: true, groupEnabled: false, groupChannels: ["G123"] },
      channels: {
        C123: { allow: true, requireMention: true, allowBots: false },
        "#general": {
          allow: true,
          requireMention: true,
          allowBots: false,
          users: ["U123"],
          skills: ["docs"],
          systemPrompt: "Short answers only.",
        },
      },
      historyLimit: 50,
      allowBots: false,
      reactionNotifications: "own",
      reactionAllowlist: ["U123"],
      replyToMode: "off", // off | first | all | batched
      thread: {
        historyScope: "thread", // thread | channel
        inheritParent: false,
      },
      actions: {
        reactions: true,
        messages: true,
        pins: true,
        memberInfo: true,
        emojiList: true,
      },
      slashCommand: {
        enabled: true,
        name: "openclaw",
        sessionPrefix: "slack:slash",
        ephemeral: true,
      },
      typingReaction: "hourglass_flowing_sand",
      textChunkLimit: 4000,
      chunkMode: "length",
      streaming: {
        mode: "partial", // off | partial | block | progress
        nativeTransport: true, // use Slack native streaming API when mode=partial
      },
      mediaMaxMb: 20,
      execApprovals: {
        enabled: "auto", // true | false | "auto"
        approvers: ["U123"],
        agentFilter: ["default"],
        sessionFilter: ["slack:"],
        target: "dm", // dm | channel | both
      },
    },
  },
}

• ソケットモード には botToken と appToken の両方が必要です (デフォルトアカウントの環境変数フォールバックは SLACK_BOT_TOKEN + SLACK_APP_TOKEN)。
• HTTP モード には botToken に加えて signingSecret (ルートまたはアカウント別) が必要です。
• socketMode は Slack SDK ソケットモード転送の調整を公開 Bolt レシーバー API にそのまま渡します。ping/pong タイムアウトまたは古い websocket の挙動を調査する場合にだけ使用してください。
• botToken、appToken、signingSecret、userToken はプレーンテキスト 文字列または SecretRef オブジェクトを受け入れます。
• Slack アカウントスナップショットは、botTokenSource、botTokenStatus、appTokenStatus、および HTTP モードの signingSecretStatus など、認証情報ごとのソース/ステータスフィールドを公開します。configured_unavailable は、アカウントが SecretRef 経由で設定されているものの、現在のコマンド/ランタイムパスが シークレット値を解決できなかったことを意味します。
• configWrites: false は Slack から開始される設定書き込みをブロックします。
• 任意の channels.slack.defaultAccount は、設定済みアカウント ID と一致する場合にデフォルトアカウント選択を上書きします。
• channels.slack.streaming.mode は正規の Slack ストリームモードキーです。channels.slack.streaming.nativeTransport は Slack のネイティブストリーミング転送を制御します。レガシーの streamMode、真偽値の streaming、および nativeStreaming 値はランタイムエイリアスとして残ります。永続化された設定を書き換えるには openclaw doctor --fix を実行してください。
• 配信ターゲットには user:<id> (DM) または channel:<id> を使用します。

リアクション通知モード: off、own (デフォルト)、all、allowlist (reactionAllowlist から)。

スレッドセッション分離: thread.historyScope はスレッドごと (デフォルト) またはチャンネル全体で共有です。thread.inheritParent は親チャンネルのトランスクリプトを新しいスレッドにコピーします。

• Slack ネイティブストリーミングと Slack アシスタント風の「入力中...」スレッドステータスには、返信スレッドターゲットが必要です。トップレベル DM はデフォルトでスレッド外のままなので、スレッド形式のネイティブストリーム/ステータスプレビューを表示する代わりに、Slack の下書き投稿と編集プレビューを通じて引き続きストリーミングできます。
• typingReaction は、返信の実行中に受信 Slack メッセージへ一時的なリアクションを追加し、完了時に削除します。"hourglass_flowing_sand" のような Slack 絵文字ショートコードを使用してください。
• channels.slack.execApprovals: Slack ネイティブの exec 承認配信と承認者認可。Discord と同じスキーマです: enabled (true/false/"auto")、approvers (Slack ユーザー ID)、agentFilter、sessionFilter、target ("dm"、"channel"、または "both")。

# Mattermost

Mattermost は現在の OpenClaw リリースではバンドル Plugin として提供されます。古いビルドまたは カスタムビルドでは、現在の npm パッケージを openclaw plugins install @openclaw/mattermost でインストールできます。バージョンを固定する前に、現在の dist-tag を npmjs.com/package/@openclaw/mattermost で確認してください。

{
  channels: {
    mattermost: {
      enabled: true,
      botToken: "mm-token",
      baseUrl: "https://chat.example.com",
      dmPolicy: "pairing",
      chatmode: "oncall", // oncall | onmessage | onchar
      oncharPrefixes: [">", "!"],
      groups: {
        "*": { requireMention: true },
        "team-channel-id": { requireMention: false },
      },
      commands: {
        native: true, // opt-in
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // Optional explicit URL for reverse-proxy/public deployments
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
      textChunkLimit: 4000,
      chunkMode: "length",
    },
  },
}

チャットモード: oncall（@メンションに応答、デフォルト）、onmessage（すべてのメッセージ）、onchar（トリガープレフィックスで始まるメッセージ）。

Mattermostのネイティブコマンドが有効な場合:

• commands.callbackPath は完全なURLではなく、パス（例: /api/channels/mattermost/command）である必要があります。
• commands.callbackUrl はOpenClaw Gatewayエンドポイントに解決され、Mattermostサーバーから到達可能である必要があります。
• ネイティブスラッシュコールバックは、スラッシュコマンド登録時にMattermostから返されるコマンドごとのトークンで認証されます。登録に失敗した場合、または有効化されたコマンドがない場合、OpenClawはコールバックを Unauthorized: invalid command token. で拒否します。
• プライベート/tailnet/内部コールバックホストでは、Mattermostで ServiceSettings.AllowedUntrustedInternalConnections にコールバックホスト/ドメインを含める必要がある場合があります。完全なURLではなく、ホスト/ドメイン値を使用してください。
• channels.mattermost.configWrites: Mattermost起点の設定書き込みを許可または拒否します。
• channels.mattermost.requireMention: チャンネルで返信する前に @mention を要求します。
• channels.mattermost.groups.<channelId>.requireMention: チャンネルごとのメンションゲート上書き（デフォルトは "*"）。
• 任意の channels.mattermost.defaultAccount は、設定済みアカウントIDと一致する場合にデフォルトアカウント選択を上書きします。

# Signal

{
  channels: {
    signal: {
      enabled: true,
      account: "+15555550123", // optional account binding
      dmPolicy: "pairing",
      allowFrom: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],
      configWrites: true,
      reactionNotifications: "own", // off | own | all | allowlist
      reactionAllowlist: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],
      historyLimit: 50,
    },
  },
}

リアクション通知モード: off、own（デフォルト）、all、allowlist（reactionAllowlist から）。

• channels.signal.account: チャンネル起動を特定のSignalアカウントIDに固定します。
• channels.signal.configWrites: Signal起点の設定書き込みを許可または拒否します。
• 任意の channels.signal.defaultAccount は、設定済みアカウントIDと一致する場合にデフォルトアカウント選択を上書きします。

# BlueBubbles

BlueBubblesは従来のiMessageブリッジ（Pluginベース、channels.bluebubbles 配下で設定）です。既存のセットアップは引き続きサポートされますが、新しいOpenClaw iMessageデプロイでは、Messagesホスト上で imsg を実行できる場合は channels.imessage を優先してください。

{
  channels: {
    bluebubbles: {
      enabled: true,
      dmPolicy: "pairing",
      // serverUrl, password, webhookPath, group controls, and advanced actions:
      // see /channels/bluebubbles
    },
  },
}

• ここで扱うコアキーパス: channels.bluebubbles、channels.bluebubbles.dmPolicy。
• 任意の channels.bluebubbles.defaultAccount は、設定済みアカウントIDと一致する場合にデフォルトアカウント選択を上書きします。
• type: "acp" を持つトップレベルの bindings[] エントリは、BlueBubbles会話を永続ACPセッションにバインドできます。match.peer.id にはBlueBubblesハンドルまたはターゲット文字列（chat_id:*、chat_guid:*、chat_identifier:*）を使用してください。共有フィールドのセマンティクス: ACP Agents。
• BlueBubblesチャンネル設定全体と非推奨化の理由は BlueBubbles に記載されています。

# iMessage

OpenClawは imsg rpc（stdio越しのJSON-RPC）を起動します。デーモンやポートは不要です。ホストがMessagesデータベースとオートメーション権限を付与できる場合、これは新しいOpenClaw iMessageセットアップの推奨パスです。

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
      remoteHost: "user@gateway-host",
      dmPolicy: "pairing",
      allowFrom: ["+15555550123", "[email protected]", "chat_id:123"],
      historyLimit: 50,
      includeAttachments: false,
      attachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      remoteAttachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      mediaMaxMb: 16,
      service: "auto",
      region: "US",
    },
  },
}

• 任意の channels.imessage.defaultAccount は、設定済みアカウントIDと一致する場合にデフォルトアカウント選択を上書きします。

• Messages DBへのフルディスクアクセスが必要です。

• chat_id:<id> ターゲットを優先してください。チャットを一覧表示するには imsg chats --limit 20 を使用します。

• cliPath はSSHラッパーを指すことができます。SCPで添付ファイルを取得するには remoteHost（host または user@host）を設定します。

• attachmentRoots と remoteAttachmentRoots は受信添付ファイルパスを制限します（デフォルト: /Users/*/Library/Messages/Attachments）。

• SCPは厳密なホストキー確認を使用するため、リレーホストキーがすでに ~/.ssh/known_hosts に存在することを確認してください。

• channels.imessage.configWrites: iMessage起点の設定書き込みを許可または拒否します。

• type: "acp" を持つトップレベルの bindings[] エントリは、iMessage会話を永続ACPセッションにバインドできます。match.peer.id には正規化済みハンドルまたは明示的なチャットターゲット（chat_id:*、chat_guid:*、chat_identifier:*）を使用してください。共有フィールドのセマンティクス: ACP Agents。

#!/usr/bin/env bash
exec ssh -T gateway-host imsg "$@"

# Matrix

MatrixはPluginベースで、channels.matrix 配下で設定します。

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      accessToken: "syt_bot_xxx",
      proxy: "http://127.0.0.1:7890",
      encryption: true,
      initialSyncLimit: 20,
      defaultAccount: "ops",
      accounts: {
        ops: {
          name: "Ops",
          userId: "@ops:example.org",
          accessToken: "syt_ops_xxx",
        },
        alerts: {
          userId: "@alerts:example.org",
          password: "secret",
          proxy: "http://127.0.0.1:7891",
        },
      },
    },
  },
}

• トークン認証は accessToken を使用します。パスワード認証は userId + password を使用します。
• channels.matrix.proxy はMatrix HTTPトラフィックを明示的なHTTP(S)プロキシ経由でルーティングします。名前付きアカウントは channels.matrix.accounts.<id>.proxy で上書きできます。
• channels.matrix.network.dangerouslyAllowPrivateNetwork はプライベート/内部homeserverを許可します。proxy とこのネットワークのオプトインは独立した制御です。
• channels.matrix.defaultAccount は、マルチアカウントセットアップで優先アカウントを選択します。
• channels.matrix.autoJoin はデフォルトで off です。そのため、招待されたルームと新しいDM形式の招待は、autoJoinAllowlist とともに autoJoin: "allowlist" を設定するか、autoJoin: "always" を設定するまで無視されます。
• channels.matrix.execApprovals: Matrixネイティブのexec承認配信と承認者認可。
  • enabled: true、false、または "auto"（デフォルト）。自動モードでは、approvers または commands.ownerAllowFrom から承認者を解決できる場合にexec承認が有効になります。
  • approvers: execリクエストの承認を許可されたMatrixユーザーID（例: @owner:example.org）。
  • agentFilter: 任意のエージェントID許可リスト。省略すると、すべてのエージェントの承認を転送します。
  • sessionFilter: 任意のセッションキーパターン（部分文字列または正規表現）。
  • target: 承認プロンプトの送信先。"dm"（デフォルト）、"channel"（送信元ルーム）、または "both"。
  • アカウントごとの上書き: channels.matrix.accounts.<id>.execApprovals。
• channels.matrix.dm.sessionScope は、Matrix DMをセッションにグループ化する方法を制御します。per-user（デフォルト）はルーティングされたピアごとに共有し、per-room は各DMルームを分離します。
• Matrixステータスプローブとライブディレクトリ検索は、実行時トラフィックと同じプロキシポリシーを使用します。
• Matrix設定全体、ターゲティングルール、セットアップ例は Matrix に記載されています。

# Microsoft Teams

Microsoft TeamsはPluginベースで、channels.msteams 配下で設定します。

{
  channels: {
    msteams: {
      enabled: true,
      configWrites: true,
      // appId, appPassword, tenantId, webhook, team/channel policies:
      // see /channels/msteams
    },
  },
}

• ここで扱うコアキーパス: channels.msteams、channels.msteams.configWrites。
• Teams設定全体（認証情報、Webhook、DM/グループポリシー、チームごと/チャンネルごとの上書き）は Microsoft Teams に記載されています。

# IRC

IRCはPluginベースで、channels.irc 配下で設定します。

{
  channels: {
    irc: {
      enabled: true,
      dmPolicy: "pairing",
      configWrites: true,
      nickserv: {
        enabled: true,
        service: "NickServ",
        password: "${IRC_NICKSERV_PASSWORD}",
        register: false,
        registerEmail: "[email protected]",
      },
    },
  },
}

• ここで扱うコアキーパス: channels.irc、channels.irc.dmPolicy、channels.irc.configWrites、channels.irc.nickserv.*。
• 任意の channels.irc.defaultAccount は、設定済みアカウントIDと一致する場合にデフォルトアカウント選択を上書きします。
• IRCチャンネル設定全体（ホスト/ポート/TLS/チャンネル/許可リスト/メンションゲート）は IRC に記載されています。

# マルチアカウント（すべてのチャンネル）

チャンネルごとに複数のアカウントを実行します（それぞれ独自の accountId を持ちます）:

{
  channels: {
    telegram: {
      accounts: {
        default: {
          name: "Primary bot",
          botToken: "123456:ABC...",
        },
        alerts: {
          name: "Alerts bot",
          botToken: "987654:XYZ...",
        },
      },
    },
  },
}

• accountId が省略された場合は default が使用されます（CLI + ルーティング）。
• 環境変数トークンは デフォルト アカウントにのみ適用されます。
• 基本チャンネル設定は、アカウントごとに上書きされない限り、すべてのアカウントに適用されます。
• 各アカウントを別のエージェントへルーティングするには、bindings[].match.accountId を使用します。
• 単一アカウントのトップレベルチャンネル設定のまま、openclaw channels add（またはチャンネルオンボーディング）で非デフォルトアカウントを追加すると、OpenClawはまずアカウントスコープのトップレベル単一アカウント値をそのチャンネルのアカウントマップへ昇格し、元のアカウントが動作し続けるようにします。ほとんどのチャンネルではそれらを channels.<channel>.accounts.default に移動します。Matrixでは既存の一致する名前付き/デフォルトターゲットを代わりに保持できます。
• 既存のチャンネルのみのバインディング（accountId なし）はデフォルトアカウントとの照合を続けます。アカウントスコープのバインディングは引き続き任意です。
• openclaw doctor --fix も、そのチャンネルで選択された昇格先アカウントへアカウントスコープのトップレベル単一アカウント値を移動することで、混在した形を修復します。ほとんどのチャンネルでは accounts.default を使用します。Matrixでは既存の一致する名前付き/デフォルトターゲットを代わりに保持できます。

# その他のPluginチャンネル

多くのPluginチャンネルは channels.<id> として設定され、それぞれの専用チャンネルページに記載されています（例: Feishu、Matrix、LINE、Nostr、Zalo、Nextcloud Talk、Synology Chat、Twitch）。 チャンネルインデックス全体を参照してください: Channels。

# グループチャットのメンションゲート

グループメッセージはデフォルトで メンション必須（メタデータメンションまたは安全な正規表現パターン）です。WhatsApp、Telegram、Discord、Google Chat、iMessageのグループチャットに適用されます。

可視返信は個別に制御されます。グループ/チャンネルルームのデフォルトは messages.groupChat.visibleReplies: "message_tool" です。OpenClaw は引き続きターンを処理しますが、通常の最終返信は非公開のままで、ルームに表示される出力には message(action=send) が必要です。通常の返信をルームに投稿し返す従来の動作が必要な場合にのみ "automatic" を設定します。同じツール限定の可視返信動作をダイレクトチャットにも適用するには、messages.visibleReplies: "message_tool" を設定します。Codex ハーネスも、未設定のダイレクトチャットのデフォルトとしてそのツール限定動作を使用します。

ツール限定の可視返信には、確実にツールを呼び出す model/runtime が必要です。 セッションログに didSendViaMessagingTool: false の assistant テキストが表示される場合、 model はメッセージツールを呼び出さずに非公開の最終回答を生成しています。 そのチャンネルには、より強力にツール呼び出しできる model に切り替えるか、 messages.groupChat.visibleReplies: "automatic" を設定して従来の可視最終 返信を復元します。

アクティブなツールポリシー下でメッセージツールが利用できない場合、OpenClaw はレスポンスを黙って抑制するのではなく、自動の可視返信にフォールバックします。openclaw doctor はこの不一致について警告します。

Gateway はファイル保存後に messages 設定をホットリロードします。デプロイでファイル監視または設定リロードが無効化されている場合にのみ再起動してください。

メンションの種類:

• メタデータメンション: ネイティブプラットフォームの @ メンション。WhatsApp のセルフチャットモードでは無視されます。
• テキストパターン: agents.list[].groupChat.mentionPatterns 内の安全な正規表現パターン。無効なパターンや安全でないネストされた繰り返しは無視されます。
• メンションゲートは、検出が可能な場合（ネイティブメンション、または少なくとも 1 つのパターン）にのみ適用されます。

{
  messages: {
    visibleReplies: "automatic", // global default for direct/source chats; Codex harness defaults unset direct chats to message_tool
    groupChat: {
      historyLimit: 50,
      visibleReplies: "message_tool", // default; use "automatic" for legacy final replies
    },
  },
  agents: {
    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],
  },
}

messages.groupChat.historyLimit はグローバルデフォルトを設定します。チャンネルは channels.<channel>.historyLimit（またはアカウント単位）で上書きできます。無効化するには 0 を設定します。

messages.visibleReplies はグローバルなソースターンのデフォルトです。messages.groupChat.visibleReplies は、グループ/チャンネルのソースターンについてそれを上書きします。messages.visibleReplies が未設定の場合、ハーネスは独自のダイレクト/ソースのデフォルトを提供できます。Codex ハーネスのデフォルトは message_tool です。チャンネル許可リストとメンションゲートは引き続き、ターンを処理するかどうかを決定します。

# DM 履歴制限

{
  channels: {
    telegram: {
      dmHistoryLimit: 30,
      dms: {
        "123456789": { historyLimit: 50 },
      },
    },
  },
}

解決順序: DM 単位の上書き → provider デフォルト → 制限なし（すべて保持）。

対応: telegram、whatsapp、discord、slack、signal、imessage、msteams。

# セルフチャットモード

セルフチャットモードを有効にするには、自分の番号を allowFrom に含めます（ネイティブ @ メンションは無視し、テキストパターンにのみ応答します）。

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: { mentionPatterns: ["reisponde", "@openclaw"] },
      },
    ],
  },
}

# コマンド（チャットコマンド処理）

{
  commands: {
    native: "auto", // register native commands when supported
    nativeSkills: "auto", // register native skill commands when supported
    text: true, // parse /commands in chat messages
    bash: false, // allow ! (alias: /bash)
    bashForegroundMs: 2000,
    config: false, // allow /config
    mcp: false, // allow /mcp
    plugins: false, // allow /plugins
    debug: false, // allow /debug
    restart: true, // allow /restart + gateway restart tool
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw", // raw | hash
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}

# 関連

• 設定リファレンス — トップレベルキー
• 設定 — agents
• チャンネル概要