設定 — チャンネル

channels.* 配下のチャンネルごとの設定キー。DM とグループアクセス、複数アカウント設定、メンションによるゲート、Slack、Discord、 Telegram、WhatsApp、Matrix、iMessage、およびその他の同梱チャンネルプラグイン向けのチャンネルごとのキーを扱います。エージェント、ツール、Gateway ランタイム、その他のトップレベルキーについては、設定リファレンスを参照してください。

チャンネル

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

DM とグループアクセス

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

DM ポリシー	動作
`pairing` (デフォルト)	不明な送信者に 1 回限りのペアリングコードを発行し、所有者の承認が必要
`allowlist`	`allowFrom` 内の送信者（またはペアリング済み許可ストア）のみ
`open`	すべての受信 DM を許可（`allowFrom: ["*"]` が必要）
`disabled`	すべての受信 DM を無視

グループポリシー	動作
`allowlist` (デフォルト)	設定済み許可リストに一致するグループのみ
`open`	グループ許可リストをバイパス（メンションによるゲートは引き続き適用）
`disabled`	すべてのグループ/ルームメッセージをブロック

channels.defaults.groupPolicy は、プロバイダーの groupPolicy が未設定の場合のデフォルトを設定します。ペアリングコードは 1 時間後に期限切れになります。保留中の DM ペアリング要求は チャンネルごとに 3 件までです。プロバイダーブロック全体が存在しない場合（channels.<provider> がない場合）、ランタイムのグループポリシーは起動時警告とともに allowlist（失敗時は閉じる）へフォールバックします。

チャンネルモデルのオーバーライド

channels.modelByChannel を使用して、特定のチャンネル ID をモデルに固定します。値には 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（allowlist と同じだが、明示的な引用/返信コンテキストを保持）。チャンネルごとのオーバーライド: channels.<channel>.contextVisibility。
channels.defaults.heartbeat.showOk: 正常なチャンネルステータスを Heartbeat 出力に含めます。
channels.defaults.heartbeat.showAlerts: 低下/エラーステータスを Heartbeat 出力に含めます。
channels.defaults.heartbeat.useIndicator: コンパクトなインジケーター形式の Heartbeat 出力をレンダリングします。

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"],
    },
  },
}

複数アカウント WhatsApp

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

送信コマンドは、存在する場合はアカウント default にデフォルト設定されます。存在しない場合は、最初に設定されたアカウント ID（ソート済み）になります。
オプションの channels.whatsapp.defaultAccount は、設定済みアカウント ID と一致する場合、そのフォールバックのデフォルトアカウント選択をオーバーライドします。
レガシーの単一アカウント Baileys 認証ディレクトリは、openclaw doctor によって whatsapp/default に移行されます。
アカウントごとのオーバーライド: channels.whatsapp.accounts.<id>.sendReadReceipts、channels.whatsapp.accounts.<id>.dmPolicy、channels.whatsapp.accounts.<id>.allowFrom。

{
  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",
    },
  },
}

Bot トークン: 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> (guild チャンネル) を使用します。裸の数値 ID は拒否されます。
Guild スラッグは小文字で、スペースは - に置き換えられます。チャンネルキーはスラッグ化された名前を使用します (# なし)。guild ID を推奨します。
Bot 作成メッセージはデフォルトで無視されます。allowBots: true で有効化できます。bot へのメンションを含む bot メッセージのみを受け付けるには allowBots: "mentions" を使用します (自身のメッセージは引き続きフィルタされます)。
channels.discord.guilds.<id>.ignoreOtherMentions (およびチャンネル上書き) は、bot ではなく別のユーザーまたはロールをメンションするメッセージを破棄します (@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: 非アクティブ時の自動 unfocus の 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 components 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 と boolean streaming 値はランタイムエイリアスとして残ります。永続化済み設定を書き換えるには openclaw doctor --fix を実行します。
channels.discord.autoPresence はランタイムの可用性を bot プレゼンスにマッピングし (healthy => online, degraded => idle, exhausted => dnd)、省略可能なステータステキスト上書きを許可します。
channels.discord.dangerouslyAllowNameMatching は、可変の名前/タグ一致を再有効化します (緊急互換モード)。
channels.discord.execApprovals: Discord ネイティブの exec 承認配信と承認者認可。
- enabled: true, false, または "auto" (デフォルト)。auto モードでは、approvers または commands.ownerAllowFrom から承認者を解決できる場合に exec 承認が有効化されます。
- approvers: exec リクエストを承認できる Discord ユーザー ID。省略時は commands.ownerAllowFrom にフォールバックします。
- agentFilter: 省略可能なエージェント ID 許可リスト。省略するとすべてのエージェントの承認を転送します。
- sessionFilter: 省略可能なセッションキーパターン (部分文字列または正規表現)。
- target: 承認プロンプトの送信先。"dm" (デフォルト) は承認者の DM に送信し、"channel" は発信元チャンネルに送信し、"both" は両方に送信します。target に "channel" が含まれる場合、ボタンは解決済み承認者のみ使用できます。
- cleanupAfterResolve: true の場合、承認、拒否、またはタイムアウト後に承認 DM を削除します。

リアクション通知モード: off (なし)、own (bot のメッセージ、デフォルト)、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",
      unfurlLinks: false,
      unfurlMedia: false,
      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 Socket Mode トランスポート調整を public Bolt receiver API にそのまま渡します。ping/pong タイムアウトまたは古い websocket 動作を調査する場合にのみ使用してください。
botToken, appToken, signingSecret, userToken はプレーンテキスト文字列または SecretRef オブジェクトを受け付けます。
Slack アカウントスナップショットは、botTokenSource, botTokenStatus, appTokenStatus、および HTTP モードでは signingSecretStatus など、認証情報ごとの source/status フィールドを公開します。configured_unavailable は、アカウントが SecretRef 経由で設定されているものの、現在のコマンド/ランタイムパスがシークレット値を解決できなかったことを意味します。
configWrites: false は Slack から開始される設定書き込みをブロックします。
省略可能な channels.slack.defaultAccount は、設定済みアカウント id と一致する場合にデフォルトアカウント選択を上書きします。
channels.slack.streaming.mode は正規の Slack ストリームモードキーです。channels.slack.streaming.nativeTransport は Slack のネイティブストリーミングトランスポートを制御します。従来の streamMode、boolean streaming、および nativeStreaming 値はランタイムエイリアスとして残ります。永続化済み設定を書き換えるには openclaw doctor --fix を実行します。
unfurlLinks と unfurlMedia は、bot 返信用に Slack の chat.postMessage リンクおよびメディア unfurl boolean をそのまま渡します。Slack のデフォルト動作を維持するには省略します。1 つのアカウントでトップレベルのデフォルトを上書きするには channels.slack.accounts.<accountId> に設定します。
配信ターゲットには user:<id> (DM) または channel:<id> を使用します。

リアクション通知モード: off, own (デフォルト), all, allowlist (reactionAllowlist から)。 スレッドセッション分離: thread.historyScope はスレッドごと (デフォルト) またはチャンネル全体で共有されます。thread.inheritParent は親チャンネルのトランスクリプトを新しいスレッドにコピーします。

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

アクショングループ	デフォルト	備考
reactions	有効	リアクション追加 + リアクション一覧
messages	有効	読み取り/送信/編集/削除
pins	有効	ピン留め/ピン留め解除/一覧
memberInfo	有効	メンバー情報
emojiList	有効	カスタム絵文字一覧

Mattermost

Mattermost は現在の OpenClaw リリースでは同梱Pluginとして提供されています。古いビルドまたはカスタムビルドでは、openclaw plugins install @openclaw/mattermost を使用して現在の npm パッケージをインストールできます。バージョンを固定する前に、現在の dist-tags を 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 と一致する場合にデフォルトアカウント選択をオーバーライドします。

iMessage

OpenClaw は imsg rpc（stdio 経由の JSON-RPC）を起動します。デーモンやポートは不要です。ホストが Messages データベースと Automation 権限を付与できる場合、新しい OpenClaw iMessage セットアップではこれが推奨パスです。 BlueBubbles サポートは削除されました。channels.bluebubbles 設定を channels.imessage に移行してください。OpenClaw は imsg のみを通じて iMessage をサポートします。 Gateway がサインイン済みの Messages Mac で実行されていない場合は、channels.imessage.enabled=true のままにし、channels.imessage.cliPath をその Mac 上で imsg "$@" を実行する SSH ラッパーに設定してください。デフォルトのローカル imsg パスは macOS 専用です。

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
      remoteHost: "user@gateway-host",
      dmPolicy: "pairing",
      allowFrom: ["+15555550123", "user@example.com", "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 エージェント。

iMessage SSH ラッパーの例

#!/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"（デフォルト）。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: "bot@example.com",
      },
    },
  },
}

ここで扱うコアキーパス: 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）。チャンネルの完全な索引を参照してください: チャンネル。

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

グループメッセージのデフォルトは メンション必須（メタデータメンションまたは安全な正規表現パターン）です。WhatsApp、Telegram、Discord、Google Chat、iMessage のグループチャットに適用されます。表示される返信は別に制御されます。グループ/チャンネルルームのデフォルトは messages.groupChat.visibleReplies: "message_tool" です。OpenClaw はターンの処理を継続しますが、通常の最終返信は非公開のままで、ルームに表示される出力には message(action=send) が必要です。通常の返信をルームに投稿するレガシー動作が必要な場合にのみ "automatic" を設定してください。同じツールのみの表示返信動作を直接チャットにも適用するには、messages.visibleReplies: "message_tool" を設定します。Codex ハーネスも、未設定の直接チャットのデフォルトとしてそのツールのみの動作を使用します。ツールのみの表示返信には、確実にツールを呼び出すモデル/ランタイムが必要です。セッションログに didSendViaMessagingTool: false を含む assistant テキストが表示される場合、モデルはメッセージツールを呼び出す代わりに非公開の最終回答を生成しています。そのチャンネルでは、より強力なツール呼び出しモデルに切り替えるか、messages.groupChat.visibleReplies: "automatic" を設定してレガシーの表示最終返信を復元してください。アクティブなツールポリシーでメッセージツールが利用できない場合、OpenClaw は応答を黙って抑制する代わりに、自動の表示返信にフォールバックします。openclaw doctor はこの不一致について警告します。 Gateway は、ファイル保存後に messages 設定をホットリロードします。デプロイでファイル監視または設定リロードが無効になっている場合のみ再起動してください。 メンション種別:

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

{
  messages: {
    visibleReplies: "automatic", // direct/source チャットのグローバルデフォルト。Codex ハーネスは未設定の direct チャットを message_tool にデフォルト設定します
    groupChat: {
      historyLimit: 50,
      visibleReplies: "message_tool", // デフォルト。レガシーの最終返信には "automatic" を使用
    },
  },
  agents: {
    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],
  },
}

messages.groupChat.historyLimit はグローバルデフォルトを設定します。チャンネルは channels.<channel>.historyLimit（またはアカウント単位）で上書きできます。無効にするには 0 を設定します。 messages.visibleReplies はグローバルな source-turn デフォルトです。messages.groupChat.visibleReplies は、グループ/チャンネルの source turn についてそれを上書きします。messages.visibleReplies が未設定の場合、ハーネスは独自の direct/source デフォルトを提供できます。Codex ハーネスのデフォルトは message_tool です。チャンネルの許可リストとメンションゲートは、引き続き turn を処理するかどうかを決定します。

DM 履歴上限

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

解決順: DM 単位の上書き → プロバイダーのデフォルト → 上限なし（すべて保持）。対応: 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", // 対応している場合にネイティブコマンドを登録
    nativeSkills: "auto", // 対応している場合にネイティブ skill コマンドを登録
    text: true, // チャットメッセージ内の /commands を解析
    bash: false, // ! を許可（別名: /bash）
    bashForegroundMs: 2000,
    config: false, // /config を許可
    mcp: false, // /mcp を許可
    plugins: false, // /plugins を許可
    debug: false, // /debug を許可
    restart: true, // /restart + Gateway 再起動ツールを許可
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw", // raw | hash
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}

コマンド詳細

このブロックはコマンドサーフェスを設定します。現在の組み込み + バンドル済みコマンドカタログについては、スラッシュコマンドを参照してください。
このページは設定キーのリファレンスであり、完全なコマンドカタログではありません。QQ Bot /bot-ping /bot-help /bot-logs、LINE /card、デバイスペアリング /pair、メモリ /dreaming、電話制御 /phone、Talk /voice などのチャンネル/Plugin 所有コマンドは、各チャンネル/Plugin ページとスラッシュコマンドに記載されています。
テキストコマンドは、先頭に / が付いた単独のメッセージである必要があります。
native: "auto" は Discord/Telegram のネイティブコマンドを有効にし、Slack はオフのままにします。
nativeSkills: "auto" は Discord/Telegram のネイティブ skill コマンドを有効にし、Slack はオフのままにします。
チャンネル単位で上書き: channels.discord.commands.native（bool または "auto"）。Discord では、false にすると起動時のネイティブコマンド登録とクリーンアップをスキップします。
channels.<provider>.commands.nativeSkills で、チャンネル単位のネイティブ skill 登録を上書きします。
channels.telegram.customCommands は追加の Telegram ボットメニューエントリを追加します。
bash: true はホストシェル用に ! <cmd> を有効にします。tools.elevated.enabled と、送信者が tools.elevated.allowFrom.<channel> に含まれていることが必要です。
config: true は /config（openclaw.json の読み書き）を有効にします。Gateway chat.send クライアントでは、永続的な /config set|unset 書き込みにも operator.admin が必要です。読み取り専用の /config show は、通常の書き込みスコープ付き operator クライアントでも引き続き利用できます。
mcp: true は、mcp.servers 配下の OpenClaw 管理 MCP サーバー設定用に /mcp を有効にします。
plugins: true は、Plugin の検出、インストール、有効化/無効化コントロール用に /plugins を有効にします。
channels.<provider>.configWrites はチャンネル単位で設定変更をゲートします（デフォルト: true）。
マルチアカウントチャンネルでは、channels.<provider>.accounts.<id>.configWrites も、そのアカウントを対象にする書き込みをゲートします（例: /allowlist --config --account <id> または /config set channels.<provider>.accounts.<id>...）。
restart: false は /restart と Gateway 再起動ツールのアクションを無効にします。デフォルト: true。
ownerAllowFrom は、所有者専用コマンド/ツール用の明示的な所有者許可リストです。allowFrom とは別です。
ownerDisplay: "hash" はシステムプロンプト内の所有者 ID をハッシュ化します。ハッシュ化を制御するには ownerDisplaySecret を設定します。
allowFrom はプロバイダー単位です。設定されている場合、それが唯一の認可ソースになります（チャンネルの許可リスト/ペアリングと useAccessGroups は無視されます）。
useAccessGroups: false は、allowFrom が設定されていない場合に、コマンドがアクセスグループポリシーをバイパスすることを許可します。
コマンドドキュメントマップ:
- 組み込み + バンドル済みカタログ: スラッシュコマンド
- チャンネル固有のコマンドサーフェス: チャンネル
- QQ Bot コマンド: QQ Bot
- ペアリングコマンド: ペアリング
- LINE カードコマンド: LINE
- メモリ Dreaming: Dreaming

Gateway

Remote access

Security

Nodes and media

Web interfaces

設定 — チャンネル

チャンネル

DM とグループアクセス

チャンネルモデルのオーバーライド

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

WhatsApp

Telegram

Discord

Google Chat

Slack

Mattermost

Signal

iMessage

Matrix

Microsoft Teams

IRC

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

その他の Plugin チャンネル

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

DM 履歴上限

セルフチャットモード

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

関連

Gateway

Remote access

Security

Nodes and media

Web interfaces

Documentation Index

​チャンネル

​DM とグループアクセス

​チャンネルモデルのオーバーライド

​チャンネルデフォルトと Heartbeat

​WhatsApp

​Telegram

​Discord

​Google Chat

​Slack

​Mattermost

​Signal

​iMessage

​Matrix

​Microsoft Teams

​IRC

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

​その他の Plugin チャンネル

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

​DM 履歴上限

​セルフチャットモード

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

​関連

チャンネル

DM とグループアクセス

チャンネルモデルのオーバーライド

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

WhatsApp

Telegram

Discord

Google Chat

Slack

Mattermost

Signal

iMessage

Matrix

Microsoft Teams

IRC

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

その他の Plugin チャンネル

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

DM 履歴上限

セルフチャットモード

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

関連