​

Matrix

​

同梱プラグイン

openclaw plugins install @openclaw/matrix

openclaw plugins install ./path/to/local/matrix-plugin

​

セットアップ

1. Matrixプラグインが利用可能であることを確認します。
   • 現在のパッケージ版OpenClawリリースには、すでに同梱されています。
   • 古いインストールやカスタムインストールでは、上記のコマンドで手動追加できます。
2. ご利用のhomeserverでMatrixアカウントを作成します。
3. 次のいずれかでchannels.matrixを設定します。
   • homeserver + accessToken、または
   • homeserver + userId + password。
4. Gatewayを再起動します。
5. ボットとのDMを開始するか、ルームに招待します。
   • 新しいMatrix招待は、channels.matrix.autoJoinで許可されている場合にのみ機能します。

openclaw channels add
openclaw configure --section channels

• homeserver URL
• 認証方式: access tokenまたはpassword
• user ID（password認証時のみ）
• 任意のデバイス名
• E2EEを有効にするかどうか
• ルームアクセスと招待の自動参加を設定するかどうか

• Matrix認証用の環境変数がすでに存在し、そのアカウントの認証情報がまだconfigに保存されていない場合、ウィザードは認証情報を環境変数に保持するための環境変数ショートカットを提案します。
• アカウント名はアカウントIDに正規化されます。たとえば、Ops Botはops-botになります。
• DMの許可リスト項目には@user:serverを直接指定できます。表示名は、ライブディレクトリ検索で厳密に1件一致した場合にのみ機能します。
• ルーム許可リスト項目にはルームIDとエイリアスを直接指定できます。!room:serverまたは#alias:serverを推奨します。未解決の名前は、許可リスト解決時にランタイムで無視されます。
• 招待の自動参加を許可リストモードで使う場合は、安定した招待対象のみを使用してください: !roomId:server、#alias:server、または*。通常のルーム名は拒否されます。
• 保存前にルーム名を解決するには、openclaw channels resolve --channel matrix "Project Room"を使用します。

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

{
  channels: {
    matrix: {
      autoJoin: "always",
    },
  },
}

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

• MATRIX_HOMESERVER
• MATRIX_ACCESS_TOKEN
• MATRIX_USER_ID
• MATRIX_PASSWORD
• MATRIX_DEVICE_ID
• MATRIX_DEVICE_NAME

• MATRIX_<ACCOUNT_ID>_HOMESERVER
• MATRIX_<ACCOUNT_ID>_ACCESS_TOKEN
• MATRIX_<ACCOUNT_ID>_USER_ID
• MATRIX_<ACCOUNT_ID>_PASSWORD
• MATRIX_<ACCOUNT_ID>_DEVICE_ID
• MATRIX_<ACCOUNT_ID>_DEVICE_NAME

• MATRIX_OPS_HOMESERVER
• MATRIX_OPS_ACCESS_TOKEN

• MATRIX_OPS_X2D_BOT_HOMESERVER
• MATRIX_OPS_X2D_BOT_ACCESS_TOKEN

​

設定例

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

​

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

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

• streaming: "off"がデフォルトです。OpenClawは最終返信を待ってから一度だけ送信します。
• streaming: "partial"は、現在のassistantブロック用に編集可能な単一のプレビューメッセージを通常のMatrixテキストメッセージとして作成します。これにより、Matrixの従来の「最初のプレビュー優先」の通知動作が維持されるため、標準クライアントでは完成済みブロックではなく最初のストリーミングプレビューテキストで通知されることがあります。
• streaming: "quiet"は、現在のassistantブロック用に編集可能な静かなプレビュー通知を1件作成します。これは、確定済みプレビュー編集に対する受信者のプッシュルールも設定する場合にのみ使用してください。
• blockStreaming: trueは、別個のMatrix進行状況メッセージを有効にします。プレビューのストリーミングが有効な場合、Matrixは現在のブロックのライブドラフトを維持し、完了済みブロックは別メッセージとして保持します。
• プレビューのストリーミングが有効でblockStreamingがoffの場合、Matrixはライブドラフトをその場で編集し、ブロックまたはターンが完了した時点で同じイベントを確定します。
• プレビューが1つのMatrixイベントに収まらなくなった場合、OpenClawはプレビューストリーミングを停止し、通常の最終配信にフォールバックします。
• メディア返信は引き続き通常どおり添付ファイルを送信します。古いプレビューを安全に再利用できなくなった場合、OpenClawは最終的なメディア返信を送る前にそれをredactします。
• プレビュー編集では追加のMatrix API呼び出しが発生します。最も保守的なレート制限動作を望む場合は、ストリーミングをoffのままにしてください。

• blockStreaming: trueは、各完了済みブロックを通常の通知付きMatrixメッセージとして送信します。
• blockStreaming: falseは、最終的に完成した返信のみを通常の通知付きMatrixメッセージとして送信します。

​

自己ホスト型プッシュルールによる静かな確定済みプレビュー

• recipient user = 通知を受け取るべきユーザー
• bot user = 返信を送信するOpenClaw Matrixアカウント
• 以下のAPI呼び出しにはrecipient userのaccess tokenを使用します
• プッシュルールのsenderはbot userの完全なMXIDと一致させます

1. OpenClawで静かなプレビューを使用するよう設定します:

{
  channels: {
    matrix: {
      streaming: "quiet",
    },
  },
}

2. 受信者アカウントが、すでに通常のMatrixプッシュ通知を受け取れていることを確認します。静かなプレビュー ルールは、そのユーザーに正常に動作するpusherやデバイスがすでにある場合にのみ機能します。
3. recipient userのaccess tokenを取得します。
   • ボットのトークンではなく、受信側ユーザーのトークンを使用してください。
   • 既存のクライアントセッショントークンを再利用するのが通常は最も簡単です。
   • 新しいトークンを発行する必要がある場合は、標準のMatrix Client-Server APIでログインできます:

curl -sS -X POST \
  "https://matrix.example.org/_matrix/client/v3/login" \
  -H "Content-Type: application/json" \
  --data '{
    "type": "m.login.password",
    "identifier": {
      "type": "m.id.user",
      "user": "@alice:example.org"
    },
    "password": "REDACTED"
  }'

4. recipient accountにすでにpusherがあることを確認します:

curl -sS \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  "https://matrix.example.org/_matrix/client/v3/pushers"

{
  "com.openclaw.finalized_preview": true
}

5. これらの通知を受け取る各recipient accountに対してoverrideプッシュルールを作成します:

curl -sS -X PUT \
  "https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
    "conditions": [
      { "kind": "event_match", "key": "type", "pattern": "m.room.message" },
      {
        "kind": "event_property_is",
        "key": "content.m\\.relates_to.rel_type",
        "value": "m.replace"
      },
      {
        "kind": "event_property_is",
        "key": "content.com\\.openclaw\\.finalized_preview",
        "value": true
      },
      { "kind": "event_match", "key": "sender", "pattern": "@bot:example.org" }
    ],
    "actions": [
      "notify",
      { "set_tweak": "sound", "value": "default" },
      { "set_tweak": "highlight", "value": false }
    ]
  }'

• https://matrix.example.org: あなたのhomeserverのベースURL
• $USER_ACCESS_TOKEN: 受信側ユーザーのaccess token
• openclaw-finalized-preview-botname: この受信側ユーザーに対するこのボット用の一意なrule ID
• @bot:example.org: 受信側ユーザーのMXIDではなく、あなたのOpenClaw MatrixボットのMXID

• プッシュルールはruleIdで識別されます。同じrule IDに対してPUTを再実行すると、その1つのルールが更新されます。
• 1人の受信側ユーザーが複数のOpenClaw Matrixボットアカウントから通知を受ける必要がある場合は、送信者一致ごとに一意なrule IDでボットごとに1つのルールを作成してください。
• 単純なパターンはopenclaw-finalized-preview-<botname>です。たとえばopenclaw-finalized-preview-opsやopenclaw-finalized-preview-supportです。

• 受信側ユーザーのトークンで認証する
• senderをOpenClawボットのMXIDと一致させる

6. ルールが存在することを確認します:

curl -sS \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  "https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname"

7. ストリーミング返信をテストします。quietモードでは、ルームには静かなドラフトプレビューが表示され、 最終的なその場編集でブロックまたはターン完了時に1回通知されるはずです。

curl -sS -X DELETE \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  "https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname"

• ルール作成には、ボットのトークンではなく受信側ユーザーのaccess tokenを使用してください。
• 新しいユーザー定義overrideルールはデフォルトの抑制ルールより前に挿入されるため、追加の順序パラメータは不要です。
• これは、OpenClawが安全にその場で確定できるテキストのみのプレビュー編集にのみ影響します。メディアフォールバックや古いプレビューフォールバックは、引き続き通常のMatrix配信を使用します。
• GET /_matrix/client/v3/pushersでpusherが表示されない場合、そのユーザーはまだそのアカウント/デバイスで正常に動作するMatrixプッシュ配信を利用できていません。

​

Synapse

• 確定済みOpenClawプレビュー通知のために特別なhomeserver.yaml変更は不要です。
• Synapse環境ですでに通常のMatrixプッシュ通知が送れている場合、主なセットアップ手順は上記のユーザートークン + pushrules呼び出しです。
• Synapseをリバースプロキシまたはworkerの背後で運用している場合は、/_matrix/client/.../pushrules/が正しくSynapseに届くことを確認してください。
• Synapse workerを使用している場合は、pusherが正常であることを確認してください。プッシュ配信はメインプロセスまたはsynapse.app.pusher / 設定されたpusher workerで処理されます。

​

Tuwunel

• 確定済みプレビューマーカー自体にTuwunel固有の設定は不要です。
• そのユーザーで通常のMatrix通知がすでに機能している場合、主なセットアップ手順は上記のユーザートークン + pushrules呼び出しです。
• ユーザーが別のデバイスでアクティブな間に通知が消えるように見える場合は、suppress_push_when_activeが有効か確認してください。Tuwunelは2025年9月12日のTuwunel 1.4.2でこのオプションを追加しており、1つのデバイスがアクティブな間は他のデバイスへのプッシュを意図的に抑制することがあります。

​

ボット同士のルーム

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

• allowBots: trueは、許可されたルームとDMにおいて、他の設定済みMatrixボットアカウントからのメッセージを受け付けます。
• allowBots: "mentions"は、ルームではそれらのメッセージがこのボットに明示的にメンションしている場合にのみ受け付けます。DMは引き続き許可されます。
• groups.<room>.allowBotsは、1つのルームに対してアカウントレベル設定を上書きします。
• OpenClawは、自己返信ループを避けるため、同じMatrix user IDからのメッセージは引き続き無視します。
• Matrixはここでネイティブのボットフラグを提供しません。OpenClawは「ボットによる送信」を「このOpenClaw Gateway上で設定された別のMatrixアカウントから送信されたもの」として扱います。

​

暗号化と検証

{
  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 --verbose

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

openclaw matrix verify bootstrap

openclaw matrix verify bootstrap --verbose

openclaw matrix verify bootstrap --force-reset-cross-signing

openclaw matrix verify device "<your-recovery-key>"

openclaw matrix verify device "<your-recovery-key>" --verbose

openclaw matrix verify backup status

openclaw matrix verify backup status --verbose

openclaw matrix verify backup restore

openclaw matrix verify backup restore --verbose

openclaw matrix verify backup reset --yes

openclaw matrix verify status --account assistant
openclaw matrix verify backup restore --account assistant
openclaw matrix devices list --account assistant

​

「verified」の意味

• Locally trusted: このデバイスは現在のクライアントでのみ信頼されています
• Cross-signing verified: SDKがこのデバイスをcross-signing経由で検証済みとして報告しています
• Signed by owner: このデバイスはあなた自身のself-signing keyによって署名されています

​

ブートストラップが行うこと

• secret storageをブートストラップし、可能な場合は既存のrecovery keyを再利用する
• cross-signingをブートストラップし、不足している公開cross-signing keyをアップロードする
• 現在のデバイスをマークしてcross-signingすることを試みる
• サーバー側room-key backupがまだ存在しない場合は新しいものを作成する

​

新しいバックアップベースライン

openclaw matrix verify backup reset --yes
openclaw matrix verify backup status --verbose
openclaw matrix verify status

​

起動時の動作

​

検証通知

• 検証リクエスト通知
• 検証準備完了通知（明示的な「絵文字で検証する」案内付き）
• 検証開始および完了通知
• 利用可能な場合はSAS詳細（絵文字および10進数）

​

デバイス衛生

openclaw matrix devices list

openclaw matrix devices prune-stale

​

Crypto store

​

プロファイル管理

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

​

スレッド

• dm.sessionScope: "per-user"（デフォルト）は、Matrix DMルーティングを送信者スコープのままにするため、同じ相手に解決される複数のDMルームが1つのセッションを共有できます。
• dm.sessionScope: "per-room"は、通常のDM認証と許可リストチェックを引き続き使用しながら、各Matrix DMルームを独自のセッションキーに分離します。
• 明示的なMatrix会話bindingは引き続きdm.sessionScopeより優先されるため、bindingされたルームとスレッドは選択した対象セッションを維持します。
• threadReplies: "off"は、返信をトップレベルのままにし、受信したスレッド付きメッセージも親セッション上に維持します。
• threadReplies: "inbound"は、受信メッセージがすでにそのスレッド内にある場合にのみ、そのスレッド内で返信します。
• threadReplies: "always"は、ルーム返信をトリガーメッセージをルートとするスレッド内に保持し、その会話を最初のトリガーメッセージに一致するスレッドスコープのセッション経由でルーティングします。
• dm.threadRepliesは、DMに対してのみトップレベル設定を上書きします。たとえば、ルームスレッドは分離したまま、DMはフラットに維持できます。
• 受信したスレッド付きメッセージには、追加のagent contextとしてスレッドルートメッセージが含まれます。
• message-tool送信は、明示的なthreadIdが指定されていない限り、対象が同じルーム、または同じDMユーザー対象であれば、現在のMatrixスレッドを自動継承します。
• 同一セッションのDMユーザー対象再利用は、現在のセッションメタデータが同じMatrixアカウント上の同一DM相手を証明している場合にのみ有効です。それ以外では、OpenClawは通常のユーザースコープルーティングにフォールバックします。
• OpenClawが、共有された同一Matrix DMセッション上であるMatrix DMルームが別のDMルームと衝突していることを検出した場合、thread bindingsが有効で、dm.sessionScopeのヒントがあると、そのルームに一度だけ/focusエスケープハッチ付きのm.noticeを投稿します。
• Matrixではランタイムthread bindingsがサポートされています。/focus、/unfocus、/agents、/session idle、/session max-age、およびスレッドにバインドされた/acp spawnは、MatrixルームとDMで機能します。
• トップレベルのMatrixルーム/DMでの/focusは、threadBindings.spawnSubagentSessions=trueのとき、新しいMatrixスレッドを作成して対象セッションにbindします。
• 既存のMatrixスレッド内で/focusまたは/acp spawn --thread hereを実行すると、代わりにその現在のスレッドがbindされます。

​

ACP会話bindings

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

• --bind hereは子のMatrixスレッドを作成しません。
• threadBindings.spawnAcpSessionsは、OpenClawが子のMatrixスレッドを作成またはbindする必要がある/acp spawn --thread auto|hereでのみ必要です。

​

スレッドbinding設定

• threadBindings.enabled
• threadBindings.idleHours
• threadBindings.maxAgeHours
• threadBindings.spawnSubagentSessions
• threadBindings.spawnAcpSessions

• トップレベルの/focusで新しいMatrixスレッドを作成してbindできるようにするには、threadBindings.spawnSubagentSessions: trueを設定します。
• /acp spawn --thread auto|hereでACPセッションをMatrixスレッドにbindできるようにするには、threadBindings.spawnAcpSessions: trueを設定します。

​

リアクション

• 送信リアクションツールはchannels["matrix"].actions.reactionsで制御されます。
• reactは特定のMatrixイベントにリアクションを追加します。
• reactionsは特定のMatrixイベントに対する現在のリアクション要約を一覧表示します。
• emoji=""は、そのイベント上のボットアカウント自身のリアクションを削除します。
• remove: trueは、ボットアカウントの指定された絵文字リアクションのみを削除します。

• channels["matrix"].accounts.<accountId>.ackReaction
• channels["matrix"].ackReaction
• messages.ackReaction
• agent identityの絵文字フォールバック

• channels["matrix"].accounts.<accountId>.ackReactionScope
• channels["matrix"].ackReactionScope
• messages.ackReactionScope

• channels["matrix"].accounts.<accountId>.reactionNotifications
• channels["matrix"].reactionNotifications
• デフォルト: own

• reactionNotifications: "own"は、ボットが作成したMatrixメッセージを対象とする追加m.reactionイベントを転送します。
• reactionNotifications: "off"は、リアクションシステムイベントを無効にします。
• リアクション削除は、Matrixではそれらが独立したm.reaction削除ではなくredactionとして表現されるため、システムイベントには合成されません。

​

履歴コンテキスト

• channels.matrix.historyLimitは、MatrixルームメッセージがagentをトリガーしたときにInboundHistoryとして含める最近のルームメッセージ数を制御します。messages.groupChat.historyLimitにフォールバックし、両方とも未設定の場合の実効デフォルトは0です。無効にするには0を設定してください。
• Matrixルーム履歴はルーム専用です。DMは通常のセッション履歴を引き続き使用します。
• Matrixルーム履歴はpendingのみです。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,
        },
      },
    },
  },
}

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を書き換える

​

Exec承認

• channels.matrix.execApprovals.enabled
• channels.matrix.execApprovals.approvers（任意。channels.matrix.dm.allowFromにフォールバック）
• channels.matrix.execApprovals.target（dm | channel | both、デフォルト: dm）
• channels.matrix.execApprovals.agentFilter
• channels.matrix.execApprovals.sessionFilter

• channels.matrix.execApprovals.*は、Matrix承認プロンプトのネイティブDM/チャネルファンアウトモードを制御します。
• Exec承認は、execApprovals.approversまたはchannels.matrix.dm.allowFromから取得したexec承認者セットを使用します。
• プラグイン承認は、channels.matrix.dm.allowFromのMatrix DM許可リストを使用します。
• Matrixのリアクションショートカットとメッセージ更新は、exec承認とプラグイン承認の両方に適用されます。

• target: "dm"は承認プロンプトを承認者のDMに送信します
• target: "channel"はプロンプトを発信元のMatrixルームまたはDMに送り返します
• target: "both"は承認者のDMと発信元のMatrixルームまたはDMの両方に送信します

• ✅ = 1回だけ許可
• ❌ = 拒否
• ♾️ = 有効なexecポリシーでその判断が許可されている場合は常に許可

• channels.matrix.accounts.<account>.execApprovals

​

複数アカウント

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

​

プライベート/LAN homeserver

{
  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

• ユーザー検索は、そのhomeserverのMatrixユーザーディレクトリを問い合わせます。
• ルーム検索は、明示的なルームIDとエイリアスを直接受け付け、その後そのアカウントで参加中のルーム名検索にフォールバックします。
• 参加中ルーム名検索はベストエフォートです。ルーム名をIDまたはエイリアスに解決できない場合、ランタイム許可リスト解決で無視されます。

​

設定リファレンス

• enabled: チャネルを有効化または無効化します。
• name: アカウントの任意ラベルです。
• defaultAccount: 複数のMatrixアカウントが設定されている場合の優先アカウントIDです。
• homeserver: homeserver URL。例: https://matrix.example.org。
• network.dangerouslyAllowPrivateNetwork: このMatrixアカウントがプライベート/内部homeserverに接続できるようにします。homeserverがlocalhost、LAN/Tailscale IP、またはmatrix-synapseのような内部ホストに解決される場合に有効化してください。
• proxy: Matrixトラフィック用の任意のHTTP(S)プロキシURLです。名前付きアカウントは独自のproxyでトップレベルのデフォルトを上書きできます。
• userId: 完全なMatrix user ID。例: @bot:example.org。
• accessToken: トークンベース認証用のaccess tokenです。平文値とSecretRef値の両方が、env/file/execプロバイダー全体でchannels.matrix.accessTokenおよびchannels.matrix.accounts.<id>.accessTokenに対応しています。Secrets Managementを参照してください。
• password: パスワードベースログイン用のpasswordです。平文値とSecretRef値の両方がサポートされます。
• deviceId: 明示的なMatrix device IDです。
• deviceName: パスワードログイン用のデバイス表示名です。
• avatarUrl: プロファイル同期とprofile set更新用に保存されるself-avatar URLです。
• initialSyncLimit: 起動時syncで取得するイベントの最大数です。
• encryption: E2EEを有効にします。
• allowlistOnly: trueの場合、openルームポリシーをallowlistに昇格し、disabled以外のすべての有効なDMポリシー（pairingとopenを含む）をallowlistに強制します。disabledポリシーには影響しません。
• allowBots: 他の設定済みOpenClaw Matrixアカウントからのメッセージを許可します（trueまたは"mentions"）。
• groupPolicy: open、allowlist、またはdisabled。
• contextVisibility: 補足ルームコンテキストの可視性モード（all、allowlist、allowlist_quote）。
• groupAllowFrom: ルームトラフィック用のuser ID許可リストです。項目は完全なMatrix user IDにしてください。未解決の名前はランタイムで無視されます。
• historyLimit: グループ履歴コンテキストとして含めるルームメッセージの最大数です。messages.groupChat.historyLimitにフォールバックし、両方とも未設定の場合の実効デフォルトは0です。無効にするには0を設定してください。
• replyToMode: off、first、all、またはbatched。
• markdown: 送信Matrixテキスト用の任意のMarkdownレンダリング設定です。
• streaming: off（デフォルト）、"partial"、"quiet"、true、またはfalse。"partial"とtrueは、通常のMatrixテキストメッセージでプレビュー優先のドラフト更新を有効にします。"quiet"は、自己ホスト型プッシュルール構成向けの通知なしプレビュー通知を使用します。falseは"off"と同等です。
• blockStreaming: trueで、ドラフトプレビューストリーミングが有効な間、完了したassistantブロックの別個の進行状況メッセージを有効にします。
• threadReplies: off、inbound、またはalways。
• threadBindings: スレッドにbindされたセッションルーティングとライフサイクルのチャネル単位上書きです。
• startupVerification: 起動時の自動自己検証リクエストモード（if-unverified、off）。
• startupVerificationCooldownHours: 自動起動時検証リクエストを再試行するまでのクールダウンです。
• textChunkLimit: 送信メッセージの文字数単位チャンクサイズ（chunkModeがlengthのときに適用）。
• chunkMode: lengthは文字数でメッセージを分割し、newlineは改行境界で分割します。
• responsePrefix: このチャネルのすべての送信返信の前に付加される任意の文字列です。
• ackReaction: このチャネル/アカウント用の任意のackリアクション上書きです。
• ackReactionScope: 任意のackリアクションスコープ上書き（group-mentions、group-all、direct、all、none、off）。
• reactionNotifications: 受信リアクション通知モード（own、off）。
• mediaMaxMb: 送信と受信メディア処理用のメディアサイズ上限（MB）。
• autoJoin: 招待自動参加ポリシー（always、allowlist、off）。デフォルト: off。DM形式の招待を含むすべてのMatrix招待に適用されます。
• autoJoinAllowlist: autoJoinがallowlistのときに許可されるルーム/エイリアス。エイリアス項目は招待処理中にルームIDに解決されます。OpenClawは、招待されたルームが主張するエイリアス状態を信頼しません。
• dm: DMポリシーブロック（enabled、policy、allowFrom、sessionScope、threadReplies）。
• dm.policy: OpenClawがルームに参加し、それをDMとして分類した後のDMアクセスを制御します。招待が自動参加されるかどうかは変更しません。
• dm.allowFrom: ライブディレクトリ検索ですでに解決済みでない限り、項目は完全なMatrix user IDにしてください。
• dm.sessionScope: per-user（デフォルト）またはper-room。相手が同じでも各Matrix DMルームで別個のコンテキストを保持したい場合はper-roomを使用します。
• dm.threadReplies: DM専用のスレッドポリシー上書き（off、inbound、always）。これは、DMにおける返信配置とセッション分離の両方について、トップレベルのthreadReplies設定を上書きします。
• execApprovals: Matrixネイティブのexec承認配信（enabled、approvers、target、agentFilter、sessionFilter）。
• execApprovals.approvers: execリクエストを承認できるMatrix user ID。dm.allowFromですでに承認者を特定できる場合は任意です。
• execApprovals.target: dm | channel | both（デフォルト: dm）。
• accounts: 名前付きアカウント単位の上書き。トップレベルのchannels.matrix値はこれらの項目のデフォルトとして機能します。
• groups: ルーム単位のポリシーマップ。ルームIDまたはエイリアスを推奨します。未解決のルーム名はランタイムで無視されます。セッション/グループidentityは、解決後の安定したルームIDを使用します。
• groups.<room>.account: 複数アカウント構成で、継承された1つのルーム項目を特定のMatrixアカウントに制限します。
• groups.<room>.allowBots: 設定済みボット送信者用のルームレベル上書き（trueまたは"mentions"）。
• groups.<room>.users: ルーム単位の送信者許可リスト。
• groups.<room>.tools: ルーム単位のツール許可/拒否上書き。
• groups.<room>.autoReply: ルームレベルのメンション制御上書き。trueでそのルームのメンション必須を無効にし、falseで再び有効にします。
• groups.<room>.skills: 任意のルームレベルSkillsフィルター。
• groups.<room>.systemPrompt: 任意のルームレベルsystem promptスニペット。
• rooms: groupsのレガシーエイリアス。
• actions: アクション単位のツール制御（messages、reactions、pins、profile、memberInfo、channelInfo、verification）。

​

関連

• Channels Overview — サポートされているすべてのチャネル
• Pairing — DM認証とペアリングフロー
• Groups — グループチャットの動作とメンション制御
• Channel Routing — メッセージのセッションルーティング
• Security — アクセスモデルとハードニング