Matrix

​

インストール

openclaw plugins install @openclaw/matrix

​

セットアップ

1. ホームサーバー上に Matrix アカウントを作成します。
2. channels.matrix を homeserver + accessToken、または homeserver + userId + password で設定します。
3. Gateway を再起動します。
4. ボットとの DM を開始するか、ボットをルームに招待します。新しい招待は、autoJoin で許可されている場合にのみ参加対象になります。

​

対話形式のセットアップ

openclaw channels add
openclaw configure --section channels

​

最小構成

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      accessToken: "syt_xxx",
      dm: { policy: "pairing" },
    },
  },
}

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      userId: "@bot:example.org",
      password: "replace-me", // pragma: allowlist secret
      deviceName: "OpenClaw Gateway",
    },
  },
}

​

自動参加

{
  channels: {
    matrix: {
      autoJoin: "allowlist",
      autoJoinAllowlist: ["!ops:example.org", "#support:example.org"],
      groups: {
        "!ops:example.org": { requireMention: true },
      },
    },
  },
}

​

許可リストの対象形式

• DM（dm.allowFrom、groupAllowFrom、groups.<room>.users）: @user:server を使用します。表示名はデフォルトでは無視されます（変更可能なため）。表示名との明示的な互換性が必要な場合にのみ、dangerouslyAllowNameMatching: true を設定してください。
• ルーム許可リストのキー（groups、旧エイリアス rooms）: !room:server または #alias:server を使用します。dangerouslyAllowNameMatching: true でない限り、単純な名前は無視されます。
• 招待許可リスト（autoJoinAllowlist）: !room:server、#alias:server、または * を使用します。単純な名前は常に拒否されます。

​

アカウント ID の正規化

​

キャッシュされた認証情報

​

環境変数

​

設定例

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      accessToken: "syt_xxx",
      encryption: true,

      dm: {
        policy: "pairing",
        sessionScope: "per-room",
        threadReplies: "off",
      },

      groupPolicy: "allowlist",
      groupAllowFrom: ["@admin:example.org"],
      groups: {
        "!roomid:example.org": { requireMention: true },
      },

      autoJoin: "allowlist",
      autoJoinAllowlist: ["!roomid:example.org"],
      threadReplies: "inbound",
      replyToMode: "off",
      streaming: { mode: "partial" },
    },
  },
}

​

ストリーミングプレビュー

{
  channels: {
    matrix: {
      streaming: { mode: "partial" },
    },
  },
}

{
  channels: {
    matrix: {
      streaming: {
        mode: "partial",
        preview: {
          toolProgress: false,
        },
      },
    },
  },
}

{
  channels: {
    matrix: {
      streaming: {
        mode: "progress",
        progress: {
          label: "auto", // 設定済みまたは組み込みのラベルから選択（非表示にするには false）
          labels: ["Thinking", "Writing", "Searching"], // label: "auto" の候補
          maxLines: 8, // ローリング進捗行の最大数（デフォルト: 8）
          maxLineChars: 120, // 切り詰め前の各行の最大文字数（デフォルト: 120）
          toolProgress: true, // ツール/進捗アクティビティを表示（デフォルト: true）
        },
      },
    },
  },
}

• progress.label: カスタムラベル、設定済みまたは組み込みのラベルを選択するには "auto"/未設定、非表示にするには false。
• progress.labels: label が "auto" または未設定の場合にのみ使用される候補。
• progress.maxLines: 下書きに保持するローリング進捗行の最大数。この数を超えた古い行は削除されます。
• progress.maxLineChars: 切り詰め前のコンパクトな進捗行ごとの最大文字数。
• progress.toolProgress: true（デフォルト）の場合、ツールや進捗のライブアクティビティが下書きに表示されます。

• プレビューが Matrix のイベントごとのサイズ上限を超えた場合、OpenClaw はプレビューストリーミングを停止し、最終結果のみの配信にフォールバックします。
• メディア返信では、添付ファイルは常に通常どおり送信されます。古いプレビューを安全に再利用できない場合、OpenClaw は最終的なメディア返信を送信する前にそのプレビューを削除します。
• プレビューストリーミングが有効な場合、ツール進捗のプレビュー更新はデフォルトで有効です。回答テキストのプレビュー編集を維持しつつ、ツール進捗を通常の配信経路に残すには、streaming.preview.toolProgress: false を設定します。
• プレビュー編集では、Matrix API の呼び出し回数が増えます。最も保守的なレート制限プロファイルを使用するには、streaming.mode: "off" のままにしてください。
• 従来のスカラー/ブール値の streaming と、フラットな blockStreaming / chunkMode キーは、openclaw doctor --fix によってこのネスト形式に書き換えられます。

​

音声メッセージ

• m.audio イベントおよび audio/* MIME タイプの m.file イベントが対象です。
• 暗号化されたルームでは、OpenClaw は文字起こしの前に、既存の Matrix メディアパスを介して添付ファイルを復号します。
• 文字起こしは、エージェントプロンプト内で機械生成かつ信頼できないものとしてマークされます。
• 添付ファイルは文字起こし済みとしてマークされるため、後続のメディアツールが再度文字起こしすることはありません。
• 音声文字起こしをグローバルに無効化するには、tools.media.audio.enabled: false を設定します。

​

承認メタデータ

​

確定済みプレビューを静かに通知するためのセルフホスト型プッシュルール

​

Bot 間ルーム

{
  channels: {
    matrix: {
      allowBots: "mentions", // true | "mentions"
      groups: {
        "!roomid:example.org": {
          requireMention: true,
        },
      },
    },
  },
}

• allowBots: true は、許可されたルームおよび DM で、設定済みの別の Matrix Bot アカウントからのメッセージを受け入れます。
• allowBots: "mentions" は、ルーム内でこの Bot が明示的にメンションされている場合に限り、それらのメッセージを受け入れます。DM は引き続き、メンションの有無にかかわらず許可されます。
• groups.<room>.allowBots は、特定の 1 ルームについてアカウントレベルの設定を上書きします。
• 受け入れられた設定済み Bot のメッセージには、共有の Bot ループ保護が適用されます。channels.defaults.botLoopProtection を設定し、アカウントごとに channels.matrix.botLoopProtection、またはルームごとに channels.matrix.groups.<room>.botLoopProtection で上書きします。
• OpenClaw は、自己応答ループを回避するため、同じ Matrix ユーザー ID からのメッセージを引き続き無視します。
• Matrix にはネイティブの Bot フラグがありません。OpenClaw は「Bot が作成した」を「この OpenClaw Gateway 上の、設定済みの別の Matrix アカウントによって送信された」として扱います。

​

暗号化と検証

​

暗号化を有効化する

openclaw matrix encryption setup
printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix encryption setup --recovery-key-stdin

• --recovery-key-stdin は、プロセス引数にリカバリーキーを公開せずに標準入力から読み取ります。互換性のため --recovery-key <key> も引き続き利用できます
• --force-reset-cross-signing は、現在のクロス署名 ID を破棄して新しいものを作成します（意図的な場合にのみ使用）

openclaw matrix account add \
  --homeserver https://matrix.example.org \
  --access-token syt_xxx \
  --enable-e2ee

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      accessToken: "syt_xxx",
      encryption: true,
      dm: { policy: "pairing" },
    },
  },
}

​

状態と信頼シグナル

openclaw matrix verify status
openclaw matrix verify status --include-recovery-key --json

• Locally trusted：このクライアントだけが信頼
• Cross-signing verified：SDK がクロス署名による検証を報告
• Signed by owner：自身の自己署名キーによって署名済み（診断専用）

​

リカバリーキーを使用してこのデバイスを検証する

printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin

• Recovery key accepted：Matrix がシークレットストレージまたはデバイスの信頼に使用するキーを受け入れました。
• Backup usable：信頼済みのリカバリー素材を使用してルームキーのバックアップを読み込めます。
• Device verified by owner：このデバイスは Matrix のクロス署名 ID から完全に信頼されています。

openclaw matrix verify self

​

クロス署名を初期化または修復する

openclaw matrix verify bootstrap

• 可能な場合は既存のリカバリーキーを再利用して、シークレットストレージを初期化します
• クロス署名を初期化し、不足している公開鍵をアップロードします
• 現在のデバイスをマークし、クロス署名します
• サーバー側のルームキーバックアップがまだ存在しない場合は作成します

• --recovery-key-stdin（printf '%s\n' "$MATRIX_RECOVERY_KEY" | ... と組み合わせて使用）または --recovery-key <key>
• --force-reset-cross-signing は、現在のクロス署名 ID を破棄します（意図的な場合のみ。アクティブなリカバリーキーが保存されているか、--recovery-key-stdin で指定されている必要があります）

​

ルームキーのバックアップ

openclaw matrix verify backup status
printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin

openclaw matrix verify backup reset --yes

​

検証の一覧表示、要求、応答

openclaw matrix verify list

openclaw matrix verify request --own-user
openclaw matrix verify request --user-id @ops:example.org --device-id ABCDEF

​

複数アカウントに関する注意事項

openclaw matrix account add \
  --account assistant \
  --homeserver https://matrix.example.org \
  --user-id '@assistant:example.org' \
  --password '<password>' \
  --device-name OpenClaw-Gateway

openclaw matrix account add \
  --account assistant \
  --homeserver https://matrix.example.org \
  --access-token '<token>'

openclaw matrix devices list
openclaw matrix devices prune-stale

​

プロフィール管理

openclaw matrix profile set --name "OpenClaw Assistant"
openclaw matrix profile set --avatar-url https://cdn.example.org/avatar.png

​

スレッド

​

セッションルーティング（sessionScope）

• "per-user"（デフォルト）: 同じルーティング先ピアを持つすべての DM ルームが 1 つのセッションを共有します。
• "per-room": 同じピアであっても、Matrix の各 DM ルームに固有のセッションキーが割り当てられます。

​

返信のスレッド化（threadReplies）

• "off": 返信はトップレベルに投稿されます。受信したスレッド内メッセージは親セッションに留まります。
• "inbound": 受信メッセージがすでにスレッド内にある場合にのみ、そのスレッド内で返信します。
• "always": トリガーとなったメッセージをルートとするスレッド内で返信します。その会話は最初のトリガー以降、対応するスレッドスコープのセッションを経由してルーティングされます。

​

スレッドの継承とスラッシュコマンド

• 受信したスレッド内メッセージには、追加のエージェントコンテキストとしてスレッドのルートメッセージが含まれます。
• 明示的な threadId が指定されていない限り、同じルーム（または同じ DM ユーザーターゲット）へのメッセージツールによる送信は、現在の Matrix スレッドを自動的に継承します。
• DM ユーザーターゲットの再利用は、現在のセッションメタデータによって、同じ Matrix アカウント上の同じ DM ピアであることが証明される場合にのみ行われます。それ以外の場合、OpenClaw は通常のユーザースコープのルーティングにフォールバックします。
• /focus、/unfocus、/agents、/session idle、/session max-age、およびスレッドにバインドされた /acp spawn は、すべて Matrix のルームと DM で機能します。
• threadBindings.spawnSessions が有効な場合、トップレベルの /focus は新しい Matrix スレッドを作成し、ターゲットセッションにバインドします。
• 既存の Matrix スレッド内で /focus または /acp spawn --thread here を実行すると、そのスレッドがその場でバインドされます。

​

ACP 会話バインディング

• 引き続き使用する Matrix の DM、ルーム、または既存のスレッド内で /acp spawn codex --bind here を実行します。
• トップレベルの DM またはルームでは、現在の DM/ルームがチャット画面として維持され、以後のメッセージは生成された ACP セッションにルーティングされます。
• 既存のスレッド内では、--bind here が現在のスレッドをその場でバインドします。
• /new と /reset は、同じバインド済み ACP セッションをその場でリセットします。
• /acp close は ACP セッションを閉じ、バインディングを削除します。

​

スレッドバインディング設定

• threadBindings.enabled
• threadBindings.idleHours
• threadBindings.maxAgeHours
• threadBindings.spawnSessions: サブエージェントと ACP の両方のスレッド生成を制御します。
• 非推奨の threadBindings.spawnSubagentSessions / threadBindings.spawnAcpSessions キーは、openclaw doctor --fix によって spawnSessions へ移行されます。
• threadBindings.defaultSpawnContext

​

リアクション

• react は Matrix イベントにリアクションを追加します。
• reactions は Matrix イベントの現在のリアクション概要を一覧表示します。
• emoji="" は、そのイベントに対するボット自身のリアクションを削除します。
• remove: true は、ボットが付けた指定の絵文字リアクションだけを削除します。

​

履歴コンテキスト

• channels.matrix.historyLimit は、ルームメッセージがエージェントをトリガーしたときに、InboundHistory として含める直近のルームメッセージ数を制御します。messages.groupChat.historyLimit にフォールバックし、両方とも未設定の場合の実効デフォルトは 0（無効）です。
• Matrix のルーム履歴はルーム内に限定されます。DM では引き続き通常のセッション履歴を使用します。
• ルーム履歴は保留中のメッセージだけを対象とします。OpenClaw はまだ返信をトリガーしていないルームメッセージをバッファリングし、メンションなどのトリガーが到着した時点でそのウィンドウのスナップショットを取得します。
• 現在のトリガーメッセージは InboundHistory に含まれません。そのターンのメインの受信本文に留まります。
• 同じ Matrix イベントを再試行する際は、新しいルームメッセージに向かってずれることなく、元の履歴スナップショットを再利用します。

​

コンテキストの可視性

• contextVisibility: "all" がデフォルトです。補足コンテキストは受信したまま保持されます。
• contextVisibility: "allowlist" は、アクティブなルーム/ユーザーの許可リストチェックで許可された送信者に補足コンテキストを絞り込みます。
• contextVisibility: "allowlist_quote" は allowlist と同様に動作しますが、明示的に引用された返信を 1 件だけ保持します。

​

DM とルームのポリシー

{
  channels: {
    matrix: {
      dm: {
        policy: "allowlist",
        allowFrom: ["@admin:example.org"],
        threadReplies: "off",
      },
      groupPolicy: "allowlist",
      groupAllowFrom: ["@admin:example.org"],
      groups: {
        "!roomid:example.org": { requireMention: true },
      },
    },
  },
}

{
  channels: {
    matrix: {
      dm: { enabled: false },
      groupPolicy: "allowlist",
      groupAllowFrom: ["@admin:example.org"],
    },
  },
}

openclaw pairing list matrix
openclaw pairing approve matrix <CODE>

​

ダイレクトルームの修復

openclaw matrix direct inspect --user-id @alice:example.org

openclaw matrix direct repair --user-id @alice:example.org

• m.direct にすでにマッピングされている厳密な 1:1 DM を優先します
• そのユーザーと現在参加中の厳密な 1:1 DM があれば、それにフォールバックします
• 正常な DM が存在しない場合は、新しいダイレクトルームを作成し、m.direct を書き換えます

​

実行承認

• enabled: Matrix ネイティブのプロンプトで承認を配信します。未設定または "auto" の場合、少なくとも 1 人の承認者を解決できるようになると自動的に有効化されます。明示的に無効化するには false を設定します。
• approvers: 実行リクエストを承認できる Matrix ユーザー ID（@owner:example.org）。channels.matrix.dm.allowFrom にフォールバックします。
• target: プロンプトの送信先。"dm"（デフォルト）は承認者の DM に送信し、"channel" は送信元のルームまたは DM に送信し、"both" は両方に送信します。
• agentFilter / sessionFilter: Matrix 配信をトリガーするエージェント/セッションを制限するための任意の許可リスト。

• 実行承認は execApprovals.approvers を使用し、dm.allowFrom にフォールバックします。
• Plugin 承認は dm.allowFrom のみを通じて認可します。

• ✅ 1 回だけ許可
• ❌ 拒否
• ♾️ 常に許可（有効な実行ポリシーで許可されている場合）

​

スラッシュコマンド

​

マルチアカウント

{
  channels: {
    matrix: {
      enabled: true,
      defaultAccount: "assistant",
      dm: { policy: "pairing" },
      accounts: {
        assistant: {
          homeserver: "https://matrix.example.org",
          accessToken: "syt_assistant_xxx",
          encryption: true,
        },
        alerts: {
          homeserver: "https://matrix.example.org",
          accessToken: "syt_alerts_xxx",
          dm: {
            policy: "allowlist",
            allowFrom: ["@ops:example.org"],
            threadReplies: "off",
          },
        },
      },
    },
  },
}

• トップレベルの channels.matrix 値は、名前付きアカウントで上書きされない限り、そのデフォルトとして機能します。
• groups.<room>.account を使用すると、継承されたルームエントリを特定のアカウントに限定できます。account のないエントリはアカウント間で共有されます。デフォルトアカウントがトップレベルで設定されている場合も、account: "default" は引き続き機能します。

• defaultAccount を設定して、暗黙的なルーティング、プローブ、CLI コマンドが優先する名前付きアカウントを選択します。
• 複数のアカウントがあり、そのうち 1 つが文字どおり default という名前の場合、defaultAccount が未設定でも OpenClaw はそのアカウントを暗黙的に使用します。
• 複数の名前付きアカウントがあり、デフォルトが選択されていない場合、CLI コマンドは推測を拒否します。defaultAccount を設定するか、--account <id> を渡してください。
• トップレベルの channels.matrix.* ブロックが暗黙の default アカウントとして扱われるのは、その認証が完了している場合（homeserver + accessToken、または homeserver + userId + password）のみです。キャッシュされた資格情報で認証を満たせる場合、名前付きアカウントは homeserver + userId から引き続き検出できます。

• 修復またはセットアップ中に OpenClaw が単一アカウント設定をマルチアカウントへ昇格する際、既存の名前付きアカウントがある場合、または defaultAccount がすでにそのアカウントを指している場合は、それを維持します。昇格されたアカウントへ移動するのは Matrix の認証／ブートストラップキーのみで、共有の配信ポリシーキーはトップレベルに残ります。

​

プライベート／LAN ホームサーバー

{
  channels: {
    matrix: {
      homeserver: "http://matrix-synapse:8008",
      network: {
        dangerouslyAllowPrivateNetwork: true,
      },
      accessToken: "syt_internal_xxx",
    },
  },
}

openclaw matrix account add \
  --account ops \
  --homeserver http://matrix-synapse:8008 \
  --allow-private-network \
  --access-token syt_ops_xxx

​

Matrix トラフィックのプロキシ

{
  channels: {
    matrix: {
      homeserver: "https://matrix.example.org",
      accessToken: "syt_bot_xxx",
      proxy: "http://127.0.0.1:7890",
    },
  },
}

​

ターゲットの解決

• ユーザー: @user:server、user:@user:server、または matrix:user:@user:server
• ルーム: !room:server、room:!room:server、または matrix:room:!room:server
• エイリアス: #alias:server、channel:#alias:server、または matrix:channel:#alias:server

• ユーザー検索では、そのホームサーバー上の Matrix ユーザーディレクトリを照会します。
• ルーム検索は、明示的なルーム ID とエイリアスを直接受け付けます。参加済みルームの名前検索はベストエフォートであり、dangerouslyAllowNameMatching: true が設定されている場合にのみ、実行時のルーム許可リストへ適用されます。
• ルーム名を ID またはエイリアスへ解決できない場合、実行時の許可リスト解決では無視されます。

​

設定リファレンス

​

アカウントと接続

• enabled: チャンネルを有効または無効にします。
• name: アカウントの任意の表示ラベル。
• defaultAccount: 複数の Matrix アカウントが設定されている場合に優先するアカウント ID。
• accounts: アカウントごとの名前付き上書き。トップレベルの channels.matrix 値はデフォルトとして継承されます。
• homeserver: ホームサーバー URL。例: https://matrix.example.org。
• network.dangerouslyAllowPrivateNetwork: このアカウントによる localhost、LAN/Tailscale IP、または内部ホスト名への接続を許可します。
• proxy: Matrix トラフィック用の任意の HTTP(S) プロキシ URL。アカウントごとの上書きをサポートします。
• userId: 完全な Matrix ユーザー ID（@bot:example.org）。
• accessToken: トークンベース認証用のアクセストークン。env/file/exec プロバイダー全体で、平文および SecretRef 値をサポートします（シークレット管理）。
• password: パスワードベースのログイン用パスワード。平文および SecretRef 値をサポートします。
• deviceId: 明示的な Matrix デバイス ID。
• deviceName: パスワードログイン時に使用されるデバイス表示名。
• avatarUrl: プロフィール同期および profile set 更新用に保存された自分のアバター URL。
• initialSyncLimit: 起動時の同期で取得するイベントの最大数。

​

暗号化

• encryption: E2EE を有効にします。デフォルト: false。
• startupVerification: "if-unverified"（E2EE がオンの場合のデフォルト）または "off"。このデバイスが未検証の場合、起動時に自己検証を自動要求します。
• startupVerificationCooldownHours: 次回の起動時自動要求までのクールダウン。デフォルト: 24。

​

アクセスとポリシー

• groupPolicy: "open"、"allowlist"、または "disabled"。デフォルト: "allowlist"。
• groupAllowFrom: ルームトラフィックを許可するユーザー ID のリスト。
• mentionPatterns: ルームメンション用のスコープ付き正規表現パターン。{ mode: "allow"|"deny", allowIn: [roomId, ...], denyIn: [roomId, ...] } を持つオブジェクト。設定済みの agents.entries.*.groupChat.mentionPatterns をルームごとに適用するかどうかを制御します。
• dm.enabled: false の場合、すべての DM を無視します。デフォルト: true。
• dm.policy: "pairing"（デフォルト）、"allowlist"、"open"、または "disabled"。ボットが参加し、ルームを DM として分類した後に適用されます。招待処理には影響しません。
• dm.allowFrom: DM トラフィックを許可するユーザー ID のリスト。
• dm.sessionScope: "per-user"（デフォルト）または "per-room"。
• dm.threadReplies: 返信のスレッド化に対する DM 専用の上書き（"off"、"inbound"、"always"）。
• allowBots: 設定されている他の Matrix ボットアカウントからのメッセージを受け付けます（true または "mentions"）。
• allowlistOnly: true の場合、すべての有効な DM ポリシー（"disabled" を除く）および "open" グループポリシーを "allowlist" に強制します。"disabled" ポリシーは変更しません。
• dangerouslyAllowNameMatching: true の場合、ユーザー許可リストのエントリに対する Matrix 表示名ディレクトリ検索と、ルーム許可リストキーに対する参加済みルーム名検索を許可します。完全な @user:server ID、およびルーム ID またはエイリアスを使用することを推奨します。
• autoJoin: "always"、"allowlist"、または "off"。デフォルト: "off"。DM 形式の招待を含む、すべての Matrix 招待に適用されます。
• autoJoinAllowlist: autoJoin が "allowlist" の場合に許可されるルーム／エイリアス。エイリアスエントリは、招待されたルームが主張する状態ではなく、ホームサーバーに対して解決されます。
• contextVisibility: 補足コンテキストの可視性（"all" がデフォルト、"allowlist"、"allowlist_quote"）。

​

返信動作

• replyToMode: "off"（デフォルト）、"first"、"all"、または "batched"。
• threadReplies: "off"（明示的に設定されていない限り、トップレベルのデフォルトは "inbound" に解決されます）、"inbound"、または "always"。
• threadBindings: スレッドに紐づくセッションのルーティングとライフサイクルに対するチャンネルごとのオーバーライド。
• streaming: ネストされたオブジェクト { mode, chunkMode, block: { enabled, coalesce }, preview: { toolProgress }, progress: { label, labels, maxLines, maxLineChars, toolProgress } }。mode は "off"（デフォルト）、"partial"、"quiet"、または "progress"。従来のスカラー値／ブール値の表記は openclaw doctor --fix によって移行されます。
• streaming.block.enabled: true の場合、完了したアシスタントブロックは個別の進捗メッセージとして保持されます。デフォルト: false。
• markdown: 送信テキスト用のオプションの Markdown レンダリング設定。
• responsePrefix: 送信返信の先頭に付加されるオプションの文字列。
• textChunkLimit: streaming.chunkMode: "length" の場合の送信チャンクサイズ（文字数）。デフォルト: 4000。
• streaming.chunkMode: "length"（デフォルト、文字数で分割）または "newline"（行境界で分割）。
• historyLimit: ルームメッセージがエージェントをトリガーしたときに、InboundHistory として含める直近のルームメッセージ数。messages.groupChat.historyLimit にフォールバックします。有効なデフォルトは 0（無効）です。
• mediaMaxMb: 送信および受信処理におけるメディアサイズの上限（MB）。デフォルト: 20。

​

リアクション設定

• ackReaction: このチャンネル／アカウントの確認リアクションのオーバーライド。
• ackReactionScope: スコープのオーバーライド（デフォルトは "group-mentions"、ほかに "group-all"、"direct"、"all"、"none"、"off"）。
• reactionNotifications: 受信リアクションの通知モード（デフォルトは "own"、または "off"）。

​

ツールとルームごとのオーバーライド

• actions: アクションごとのツール制限（messages、reactions、pins、profile、memberInfo、channelInfo、verification）。
• groups: ルームごとのポリシーマップ。セッション識別情報には、解決後の安定したルーム ID が使用されます。（rooms は従来のエイリアスです。）
  • groups.<room>.account: 継承されたルームエントリを特定のアカウントに限定します。
  • groups.<room>.enabled: ルームごとの切り替え。false の場合、そのルームはマップに存在しないものとして無視されます。
  • groups.<room>.requireMention: チャンネルレベルのメンション要件をルームごとにオーバーライドします。
  • groups.<room>.allowBots: チャンネルレベルの設定をルームごとにオーバーライドします（true または "mentions"）。
  • groups.<room>.botLoopProtection: ボット間ループ保護の上限をルームごとにオーバーライドします。
  • groups.<room>.users: ルームごとの送信者許可リスト。
  • groups.<room>.tools: ルームごとのツール許可／拒否のオーバーライド。
  • groups.<room>.autoReply: ルームごとのメンション制限のオーバーライド。true はそのルームのメンション要件を無効にし、false は再び強制的に有効にします。
  • groups.<room>.skills: ルームごとのスキルフィルター。
  • groups.<room>.systemPrompt: ルームごとのシステムプロンプトのスニペット。

​

Exec 承認設定

• execApprovals.enabled: Matrix ネイティブのプロンプトを通じて Exec 承認を配信します。
• execApprovals.approvers: 承認を許可する Matrix ユーザー ID。dm.allowFrom にフォールバックします。
• execApprovals.target: "dm"（デフォルト）、"channel"、または "both"。
• execApprovals.agentFilter / execApprovals.sessionFilter: 配信用のオプションのエージェント／セッション許可リスト。

​

関連項目

• チャンネルの概要 - サポートされているすべてのチャンネル
• ペアリング - DM の認証とペアリングの流れ
• グループ - グループチャットの動作とメンション制限
• チャンネルルーティング - メッセージのセッションルーティング
• セキュリティ - アクセスモデルと堅牢化