設定 — チャンネル

​

チャンネル

​

DM とグループのアクセス

​

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

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

​

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

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

• channels.defaults.groupPolicy：プロバイダーレベルの groupPolicy が未設定の場合のフォールバックグループポリシー。
• channels.defaults.contextVisibility：すべてのチャンネルに対する補足コンテキストのデフォルト表示モード。値：all（デフォルト、引用／スレッド／履歴のすべてのコンテキストを含める）、allowlist（許可リスト内の送信者からのコンテキストのみを含める）、allowlist_quote（許可リストと同じだが、明示的な引用／返信コンテキストは保持）。チャンネル別のオーバーライド：channels.<channel>.contextVisibility。
• channels.defaults.implicitMentions：サポートされている受信情報のうち、どれをメンションとして扱うかを制御します。replyToBot、quotedBot、threadParticipation はそれぞれデフォルトで true となり、現在の動作を維持します。チャンネルごとに channels.<channel>.implicitMentions、アカウントごとに channels.<channel>.accounts.<id>.implicitMentions でオーバーライドできます。各フラグは、アカウント → チャンネル → デフォルトの順に個別に解決されます。名前は肯定形です。その情報がメンションゲーティングをバイパスしないようにするには、フラグを false に設定します。ネイティブの明示的メンションは常に許可され、チャンネルがその情報を生成しない場合、フラグは効果を持ちません。現在の生成元マトリクスについては、メンションゲーティングを参照してください。これらの設定は、送信時の返信／スレッドモードや、承認済みコマンドの処理には影響しません。
• channels.defaults.heartbeat.showOk：Heartbeat 出力に正常なチャンネルステータスを含めます（デフォルトは false）。
• channels.defaults.heartbeat.showAlerts：Heartbeat 出力に劣化／エラーステータスを含めます（デフォルトは true）。
• channels.defaults.heartbeat.useIndicator：コンパクトなインジケータースタイルの Heartbeat 出力をレンダリングします（デフォルトは true）。

​

WhatsApp

{
  web: {
    enabled: true,
  },
  channels: {
    whatsapp: {
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["+15555550123", "+447700900123"],
      textChunkLimit: 4000,
      streaming: { chunkMode: "length" }, // length | newline
      mediaMaxMb: 50,
      sendReadReceipts: true, // blue ticks (false in self-chat mode)
      groups: {
        "*": { requireMention: true },
      },
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

• トップレベルの bindings[] エントリで type: "acp" を使用すると、WhatsApp の DM とグループ向けの永続的な ACP バインディングを設定できます。match.peer.id には E.164 形式の直接番号または WhatsApp グループ JID を使用します。フィールドの意味は ACP エージェントで共通化されています。

{
  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: { mode: "partial" }, // off | partial | block | progress (default: partial)
      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",
      trustedLocalFileRoots: ["/srv/telegram-bot-api-data"],
      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> サフィックスを削除します。
• --local モードのセルフホスト Bot API サーバーでは、trustedLocalFileRoots に OpenClaw が読み取り可能なホストパスを列挙します。OpenClaw ホストにサーバーのデータボリュームをマウントし、そのデータルートまたはトークン別ディレクトリのいずれかを設定します。/var/lib/telegram-bot-api 配下のコンテナパスは、それらのルートにマッピングされます。その他の絶対パスは引き続き拒否されます。
• 省略可能な channels.telegram.defaultAccount が設定済みのアカウント ID と一致する場合、デフォルトのアカウント選択をオーバーライドします。
• マルチアカウント構成（アカウント ID が 2 つ以上）では、フォールバックルーティングを避けるため、明示的なデフォルト（channels.telegram.defaultAccount または channels.telegram.accounts.default）を設定します。これが欠けているか無効な場合、openclaw doctor が警告します。
• configWrites: false は、Telegram によって開始される設定の書き込み（スーパーグループ ID の移行、/config set|unset）をブロックします。
• トップレベルの bindings[] エントリで type: "acp" を使用すると、フォーラムトピック向けの永続的な ACP バインディングを設定できます（match.peer.id では正規形式の chatId:topic:topicId を使用）。フィールドの意味は ACP エージェントで共通化されています。
• Telegram のストリームプレビューでは sendMessage と editMessageText を使用します（ダイレクトチャットとグループチャットの両方で動作）。
• network.dnsResultOrder のデフォルトは "ipv4first" で、一般的な IPv6 取得エラーを回避します。
• 再試行ポリシーについては、再試行ポリシーを参照してください。

​

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: "短い回答のみ。",
            },
          },
        },
      },
      historyLimit: 20,
      textChunkLimit: 2000,
      suppressEmbeds: true,
      streaming: {
        mode: "progress", // off | partial | block | progress（Discord のデフォルト: progress）
        chunkMode: "length", // length | newline
        progress: {
          label: "auto",
          maxLines: 8,
          maxLineChars: 120,
          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 の使用を推奨します。
• Bot が作成したメッセージはデフォルトで無視されます。allowBots: true で有効にできます。Bot にメンションした Bot メッセージのみを受け入れるには allowBots: "mentions" を使用します（自身のメッセージは引き続き除外されます）。
• Bot が作成した受信メッセージをサポートするチャンネルでは、共通の Bot ループ保護を使用できます。基本となるペア予算を channels.defaults.botLoopProtection で設定し、特定のサーフェスに異なる制限が必要な場合にのみ、チャンネルまたはアカウントで上書きします。
• channels.discord.guilds.<id>.ignoreOtherMentions（およびチャンネルごとの上書き）は、Bot ではなく別のユーザーまたはロールにメンションしているメッセージを除外します（@everyone/@here は除きます）。
• channels.discord.mentionAliases は、送信前に安定した送信 @handle テキストを Discord ユーザー ID にマッピングします。これにより、一時的なディレクトリキャッシュが空でも、既知のチームメイトを決定論的にメンションできます。アカウントごとの上書きは channels.discord.accounts.<accountId>.mentionAliases に配置します。
• maxLinesPerMessage（デフォルト 17）は、2000 文字未満でも縦に長いメッセージを分割します。
• channels.discord.suppressEmbeds のデフォルトは true であるため、無効にしない限り、送信 URL は Discord のリンクプレビューとして展開されません。明示的な embeds ペイロードは通常どおり送信されます。メッセージごとのツール呼び出しでは suppressEmbeds によって上書きできます。
• 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 components v2 コンテナのアクセントカラーを設定します。
• channels.discord.agentComponents.ttlMs は、送信済みの Discord コンポーネントコールバックを登録状態に保つ時間を制御します。デフォルトは 1800000（30 分）、最大は 86400000（24 時間）です。アカウントごとの上書きは channels.discord.accounts.<accountId>.agentComponents.ttlMs に配置します。ワークフローに適合する最短の TTL を推奨します。
• channels.discord.voice は、Discord ボイスチャンネルでの会話と、オプションの自動参加、LLM、TTS の上書きを有効にします。テキストのみの Discord 設定では、ボイスはデフォルトで無効です。有効にするには channels.discord.voice.enabled=true を設定します。
• channels.discord.voice.model は、Discord ボイスチャンネルへの応答に使用する LLM モデルを任意で上書きします。
• channels.discord.voice.daveEncryption（デフォルト true）および channels.discord.voice.decryptionFailureTolerance（デフォルト 24）は、@discordjs/voice の DAVE オプションにそのまま渡されます。
• 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、chunkMode、blockStreaming、draftChunk、blockStreamingCoalesce）はランタイムで読み込まれなくなりました。永続化された設定を移行するには openclaw doctor --fix を実行します。
• channels.discord.autoPresence は、ランタイムの可用性を Bot のプレゼンスにマッピングし（正常 => オンライン、劣化 => アイドル、枯渇 => dnd）、任意のステータステキスト上書きを許可します。
• channels.discord.guilds.<id>.presenceEvents は、ユーザーが利用可能になったことを示す到着イベントを、設定済みの 1 つの Discord チャンネルへエージェントのシステムイベントとしてルーティングします。対象メンバーは channelId を閲覧できる必要があります。公開スレッドは親の可視性を継承し、非公開スレッドではさらにメンバーシップまたは Manage Threads が必要です。users で対象者をさらに絞り込めます。完全な GUILD_CREATE スナップショットから現在オンラインのメンバーを初期登録し、観測されたオフラインからオンラインへの遷移をルーティングします。また、未確認のメンバーから後で初めてオンライン信号を受信した場合、スナップショット後にオンラインになったのか参加したのかは断定せず、新たに利用可能になったものとして扱います。Discord の 75,000 メンバーのスナップショット上限を超えるギルドでは、最初に明示的なオフライン更新が必要です。スロットリング設定: reconnectSuppressSeconds（ギルドのプレゼンス状態を再構築している間、新しい Gateway セッションの後に設ける静止期間。デフォルト 300、0 で無効化）および burstLimit/burstWindowSeconds（ギルドごとに正常にキュー投入されたイベントのレート制限。デフォルトは 60s のスライディングウィンドウあたり 8 イベント）。再開されたセッションでは、再接続抑制ウィンドウは開始されません。既存のユーザーごとの再挨拶クールダウンは 8 時間のままです。これには channels.discord.intents.presence=true、Discord の Developer Portal にある特権 Presence Intent、および有効なエージェント Heartbeat が必要です。
• channels.discord.dangerouslyAllowNameMatching は、変更可能な名前・タグによる照合を再度有効にします（緊急時の互換モード）。
• channels.discord.execApprovals: Discord ネイティブの実行承認配信および承認者の認可。
  • enabled: true、false、または "auto"（デフォルト）。自動モードでは、approvers または commands.ownerAllowFrom から承認者を解決できる場合、実行承認が有効になります。
  • approvers: 実行リクエストの承認を許可する Discord ユーザー ID。省略した場合は commands.ownerAllowFrom にフォールバックします。
  • agentFilter: オプションのエージェント ID 許可リスト。すべてのエージェントの承認を転送する場合は省略します。
  • sessionFilter: オプションのセッションキーパターン（部分文字列または正規表現）。
  • target: 承認プロンプトの送信先。"dm"（デフォルト）は承認者の DM に送信し、"channel" は送信元チャンネルに送信し、"both" は両方に送信します。送信先に "channel" が含まれる場合、ボタンを使用できるのは解決済みの承認者のみです。
  • cleanupAfterResolve: true の場合、承認、拒否、またはタイムアウト後に承認 DM を削除します。

​

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",
      dmPolicy: "pairing",
      allowFrom: ["users/1234567890"],
      groupPolicy: "allowlist",
      groups: {
        "spaces/AAAA": { allow: true, requireMention: true },
      },
      actions: { reactions: true },
      typingIndicator: "message",
      mediaMaxMb: 20,
    },
  },
}

• サービスアカウント JSON: インライン（serviceAccount）またはファイルベース（serviceAccountFile）。
• serviceAccount は SecretRef を直接受け入れます。
• 環境変数のフォールバック: 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: { enabled: true, requireMention: true, allowBots: false },
        "#general": {
          enabled: true,
          requireMention: true,
          allowBots: false,
          users: ["U123"],
          skills: ["docs"],
          systemPrompt: "短い回答のみ。",
        },
      },
      historyLimit: 50,
      allowBots: false,
      reactionNotifications: "own",
      reactionAllowlist: ["U123"],
      replyToMode: "off", // off | first | all | batched
      thread: {
        historyScope: "thread", // thread | channel
        inheritParent: false,
        initialHistoryLimit: 20,
      },
      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,
      streaming: {
        mode: "partial", // off | partial | block | progress
        chunkMode: "length", // length | newline
        nativeTransport: true, // mode=partial の場合に Slack ネイティブストリーミング API を使用
      },
      mediaMaxMb: 20,
      execApprovals: {
        enabled: "auto", // true | false | "auto"
        approvers: ["U123"],
        agentFilter: ["default"],
        sessionFilter: ["slack:"],
        target: "dm", // dm | channel | both
      },
    },
  },
}

• Socket モードには、botToken と appToken の両方が必要です（デフォルトアカウントの環境変数フォールバックには SLACK_BOT_TOKEN + SLACK_APP_TOKEN）。
• HTTP モードには、botToken に加えて signingSecret（ルートまたはアカウント単位）が必要です。
• ユーザー ID（identity: "user"）は、認可した人間として投稿および読み取りを行います。Socket モードでは userToken と appToken、HTTP モードでは userToken と signingSecret が必要です。ボットトークンやボットユーザーは必要ありません。ユーザースコープとイベントサブスクリプションについては、ユーザー IDを参照してください。
• enterpriseOrgInstall: true は、アカウントを Slack Enterprise Grid の 組織全体イベントパスにオプトインします。起動時に auth.test でボットトークンを検証し、 設定されたモードが Slack のインストール ID と一致しない場合は 失敗します。Enterprise DM は無効にするか、有効な allowFrom: ["*"] とともに dmPolicy: "open" を使用する必要があります。 チャンネルおよびユーザーポリシーでは、安定した Slack ID を使用する必要があります。 変更可能な名前やサポートされていないチャンネルプレフィックスがあると起動に失敗します。V1 が処理するのは、 直接の Socket モードまたは HTTP の message および app_mention イベントと即時応答のみです。 リレー、コマンド、インタラクション、App Home、リアクションイベントリスナー、 ピン、アクションツール、ネイティブ承認、バインディング、遅延配信、 プロアクティブ送信は利用できません。リスナーが所有する確認応答、入力中表示、 ステータスリアクションは reactions:write で引き続き利用できますが、受信リアクション 通知とリアクションアクションツールは利用できません。最小権限のマニフェスト、 セットアップワークフロー、完全な制限事項については、 Enterprise Grid の組織全体インストール を参照してください。
• socketMode は、Slack SDK Socket モードのトランスポート調整を公開 Bolt レシーバー API に渡します。ping/pong タイムアウトや古い WebSocket の動作を調査する場合にのみ使用してください。clientPingTimeout のデフォルトは 15000 です。serverPingTimeout と pingPongLoggingEnabled は、設定されている場合にのみ渡されます。
• botToken、appToken、signingSecret、userToken は、プレーンテキストの 文字列または SecretRef オブジェクトを受け入れます。
• Slack アカウントのスナップショットは、 botTokenSource、botTokenStatus、userTokenSource、userTokenStatus、 appTokenStatus、および HTTP モードでは signingSecretStatus など、認証情報ごとのソース／ステータスフィールドを公開します。 configured_unavailable は、アカウントが SecretRef を介して設定されているものの、現在のコマンド／ランタイムパスでは シークレット値を解決できなかったことを意味します。
• configWrites: false は、Slack から開始される設定の書き込みをブロックします。
• オプションの channels.slack.defaultAccount は、設定済みのアカウント ID と一致する場合、デフォルトのアカウント選択を上書きします。
• channels.slack.streaming.mode は、Slack ストリームモードの正規キーです（デフォルトは "partial"）。channels.slack.streaming.nativeTransport は、Slack のネイティブストリーミングトランスポートを制御します（デフォルトは true）。従来の streamMode、ブール値の streaming、chunkMode、blockStreaming、blockStreamingCoalesce、nativeStreaming の値は、ランタイムでは読み取られなくなりました。openclaw doctor --fix を実行して、永続化された設定を streaming.{mode,chunkMode,block.enabled,block.coalesce,nativeTransport} に移行してください。
• unfurlLinks と unfurlMedia は、ボットの返信について Slack の chat.postMessage リンクおよびメディア展開のブール値を渡します。unfurlLinks のデフォルトは false であるため、有効にしない限り、送信ボットリンクはインライン展開されません。unfurlMedia は、設定されていない場合は省略されます。1 つのアカウントでトップレベルの値を上書きするには、いずれかの値を channels.slack.accounts.<accountId> に設定します。
• 配信先には user:<id>（DM）または channel:<id> を使用します。

• Slack ネイティブストリーミングと、Slack アシスタント形式の「入力中…」スレッドステータスには、返信スレッドの配信先が必要です。トップレベルの DM はデフォルトでスレッド外のままであるため、スレッド形式のネイティブストリーム／ステータスプレビューを表示する代わりに、Slack の下書き投稿・編集プレビューを通じて引き続きストリーミングできます。
• typingReaction は、返信の実行中に受信 Slack メッセージへ一時的なリアクションを追加し、完了時に削除します。"hourglass_flowing_sand" のような Slack 絵文字ショートコードを使用してください。
• channels.slack.execApprovals：Slack ネイティブの承認クライアント配信および実行承認者の認可。Discord と同じスキーマです：enabled（true/false/"auto"）、approvers（Slack ユーザー ID）、agentFilter、sessionFilter、target（"dm"、"channel"、または "both"）。Slack Plugin の承認者を解決できる場合、Plugin の承認は Slack からのリクエストにこのネイティブクライアントパスを使用できます。Slack ネイティブの Plugin 承認配信は、Slack 由来のセッションまたは Slack の配信先に対して approvals.plugin を介して有効にすることもできます。Plugin の承認では、実行承認者ではなく、allowFrom の Slack Plugin 承認者とデフォルトルーティングを使用します。

​

Mattermost

openclaw plugins install @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, // オプトイン
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // リバースプロキシ／公開デプロイ向けのオプションの明示的 URL
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
      textChunkLimit: 4000,
      streaming: { chunkMode: "length" },
    },
  },
}

• 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", // オプションのアカウントバインディング
      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,
    },
  },
}

• channels.signal.account：チャンネルの起動を特定の Signal アカウント ID に固定します。
• channels.signal.configWrites：Signal から開始される設定の書き込みを許可または拒否します。
• オプションの channels.signal.defaultAccount は、設定済みのアカウント ID と一致する場合、デフォルトのアカウント選択を上書きします。

​

iMessage

{
  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",
      sendTransport: "auto",
      region: "US",
      actions: {
        reactions: true,
        edit: true,
        unsend: true,
        reply: true,
        sendWithEffect: true,
        sendAttachment: true,
      },
    },
  },
}

• 任意の 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 から開始された設定書き込みを許可または拒否します。
• channels.imessage.sendTransport: 通常の送信返信に使用する優先 imsg RPC 送信トランスポートです。auto（デフォルト）は、実行中であれば既存チャットに IMCore ブリッジを使用し、その後 AppleScript にフォールバックします。bridge はプライベート API による配信を必須とし、applescript は公開の Messages オートメーション経路を強制します。
• channels.imessage.actions.*: imsg status / openclaw channels status --probe によっても制御されるプライベート API アクションを有効にします。
• channels.imessage.includeAttachments はデフォルトで無効です。エージェントターンで受信メディアを利用するには、true に設定してください。
• ブリッジまたは Gateway の再起動後の受信復旧は自動です（GUID 重複排除と古いバックログに対する経過時間制限）。既存の channels.imessage.catchup.enabled: true 設定は非推奨の互換性プロファイルとして引き続き尊重されます。catchup はデフォルトで無効です。
• channels.imessage.groups: グループレジストリとグループごとの設定です。groupPolicy: "allowlist" を使用する場合、グループメッセージがレジストリゲートを通過できるように、明示的な chat_id キーまたは "*" ワイルドカードエントリのいずれかを設定してください。
• type: "acp" を持つトップレベルの bindings[] エントリは、iMessage の会話を永続 ACP セッションにバインドできます。match.peer.id には、正規化されたハンドルまたは明示的なチャットターゲット（chat_id:*、chat_guid:*、chat_identifier:*）を使用してください。共通フィールドのセマンティクス: ACP エージェント。

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

​

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 はプライベートまたは内部のホームサーバーを許可します。proxy とこのネットワークのオプトインは独立した制御です。
• channels.matrix.defaultAccount は、複数アカウント構成で優先するアカウントを選択します。
• channels.matrix.autoJoin のデフォルトは "off" です。そのため、autoJoinAllowlist または autoJoin: "always" を使用して autoJoin: "allowlist" を設定するまで、招待されたルームと新しい DM 形式の招待は無視されます。
• channels.matrix.execApprovals: Matrix ネイティブの実行承認配信と承認者の認可です。
  • enabled: true、false、または "auto"（デフォルト）。自動モードでは、approvers または commands.ownerAllowFrom から承認者を解決できる場合に実行承認が有効になります。
  • approvers: 実行リクエストの承認を許可された 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

{
  channels: {
    msteams: {
      enabled: true,
      configWrites: true,
      // appId、appPassword、tenantId、webhook、チーム/チャネルポリシー:
      // /channels/msteams を参照
    },
  },
}

• ここで扱う主要なキーパス: channels.msteams、channels.msteams.configWrites。
• Teams の完全な設定（認証情報、Webhook、DM/グループポリシー、チームごと/チャネルごとの上書き）については Microsoft Teams を参照してください。

​

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 を参照してください。

​

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

{
  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 チャネル

​

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

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

{
  messages: {
    visibleReplies: "automatic", // 直接／ソースチャットで従来の自動最終返信を強制
    groupChat: {
      historyLimit: 50,
      unmentionedInbound: "room_event", // 常時有効なメンションなしのルーム会話を静かなコンテキストにする
      visibleReplies: "message_tool", // オプトイン。ルームに表示される返信には message(action=send) を要求
    },
  },
  agents: {
    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],
  },
}

​

DM 履歴の上限

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

​

セルフチャットモード

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

​

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

{
  commands: {
    native: "auto", // サポートされている場合にネイティブコマンドを登録
    nativeSkills: "auto", // サポートされている場合にネイティブ Skills コマンドを登録
    text: true, // チャットメッセージ内の /commands を解析
    bash: false, // ! を許可（エイリアス：/bash）
    bashForegroundMs: 2000,
    config: false, // /config を許可
    mcp: false, // /mcp を許可
    plugins: false, // /plugins を許可
    debug: false, // /debug を許可
    restart: true, // /restart と外部からの SIGUSR1 再起動リクエストを許可
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw", // raw | hash
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}

​

関連項目

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