매트릭스

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

설치

openclaw plugins install @openclaw/matrix

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

​

설정

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 정규화

​

캐시된 인증 정보

• 기본 계정: credentials.json
• 명명된 계정: credentials-<account>.json

​

환경 변수

​

구성 예시

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

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

• 미리보기가 Matrix의 이벤트당 크기 제한을 넘어서면 OpenClaw는 미리보기 스트리밍을 중지하고 최종 결과만 전달하는 방식으로 대체합니다.
• 미디어 응답은 항상 첨부 파일을 정상적으로 전송합니다. 오래된 미리보기를 더 이상 안전하게 재사용할 수 없으면 OpenClaw는 최종 미디어 응답을 보내기 전에 이를 삭제 처리합니다.
• Matrix 미리보기 스트리밍이 활성화되면 도구 진행률 미리보기 업데이트가 기본적으로 활성화됩니다. 답변 텍스트에는 미리보기 수정을 유지하되 도구 진행률은 일반 전달 경로에 두려면 streaming.preview.toolProgress: false를 설정하세요.
• 미리보기 수정은 추가 Matrix API 호출 비용이 듭니다. 가장 보수적인 속도 제한 프로필을 원하면 streaming: "off"로 두세요.

​

승인 메타데이터

​

조용한 최종 미리보기를 위한 자체 호스팅 푸시 규칙

​

봇 간 방

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

• allowBots: true는 허용된 방과 DM에서 구성된 다른 Matrix 봇 계정의 메시지를 수락합니다.
• allowBots: "mentions"는 방에서 해당 메시지가 이 봇을 눈에 띄게 멘션할 때만 수락합니다. DM은 계속 허용됩니다.
• groups.<room>.allowBots는 한 방에 대해 계정 수준 설정을 재정의합니다.
• OpenClaw는 자기 응답 루프를 피하기 위해 동일한 Matrix 사용자 ID에서 온 메시지는 계속 무시합니다.
• Matrix는 여기서 네이티브 봇 플래그를 노출하지 않습니다. OpenClaw는 “봇 작성”을 “이 OpenClaw Gateway의 구성된 다른 Matrix 계정에서 보낸 것”으로 처리합니다.

​

암호화 및 확인

​

암호화 활성화

openclaw matrix encryption setup

• --recovery-key <key> 부트스트랩 전에 복구 키를 적용합니다(아래에 문서화된 stdin 형식을 권장)
• --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를 폐기합니다(의도한 경우에만)

​

방 키 백업

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 방이 하나의 세션을 공유합니다.
• "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에서 작동합니다.
• 최상위 /focus는 threadBindings.spawnSessions가 활성화된 경우 새 Matrix 스레드를 만들고 대상 세션에 바인딩합니다.
• 기존 Matrix 스레드 안에서 /focus 또는 /acp spawn --thread here를 실행하면 해당 스레드가 제자리에서 바인딩됩니다.

​

ACP 대화 바인딩

• 계속 사용하려는 Matrix DM, 방 또는 기존 스레드 안에서 /acp spawn codex --bind here를 실행합니다.
• 최상위 Matrix DM 또는 방에서는 현재 DM/방이 채팅 표면으로 유지되고 이후 메시지는 생성된 ACP 세션으로 라우팅됩니다.
• 기존 Matrix 스레드 안에서는 --bind here가 현재 스레드를 제자리에서 바인딩합니다.
• /new 및 /reset은 같은 바인딩된 ACP 세션을 제자리에서 재설정합니다.
• /acp close는 ACP 세션을 닫고 바인딩을 제거합니다.

• --bind here는 하위 Matrix 스레드를 만들지 않습니다.
• threadBindings.spawnSessions는 OpenClaw가 하위 Matrix 스레드를 만들거나 바인딩해야 하는 /acp spawn --thread auto|here를 제어합니다.

​

스레드 바인딩 구성

• threadBindings.enabled
• threadBindings.idleHours
• threadBindings.maxAgeHours
• threadBindings.spawnSessions
• threadBindings.defaultSpawnContext

• 최상위 /focus 및 /acp spawn --thread auto|here가 Matrix 스레드를 만들거나 바인딩하지 못하게 하려면 threadBindings.spawnSessions: false를 설정합니다.
• 네이티브 하위 에이전트 스레드 생성이 상위 트랜스크립트를 포크하지 않아야 할 때는 threadBindings.defaultSpawnContext: "isolated"를 설정합니다.

​

반응

• react는 Matrix 이벤트에 반응을 추가합니다.
• reactions는 Matrix 이벤트의 현재 반응 요약을 나열합니다.
• emoji=""는 해당 이벤트에서 봇 자신의 반응을 제거합니다.
• remove: true는 봇에서 지정된 이모지 반응만 제거합니다.

​

기록 컨텍스트

• channels.matrix.historyLimit는 Matrix 방 메시지가 에이전트를 트리거할 때 InboundHistory로 포함되는 최근 방 메시지 수를 제어합니다. messages.groupChat.historyLimit로 대체되며, 둘 다 설정되지 않은 경우 유효 기본값은 0입니다. 비활성화하려면 0으로 설정합니다.
• Matrix 방 기록은 방 전용입니다. DM은 일반 세션 기록을 계속 사용합니다.
• Matrix 방 기록은 보류 중 메시지만 포함합니다. OpenClaw는 아직 응답을 트리거하지 않은 방 메시지를 버퍼링한 다음, 멘션 또는 다른 트리거가 도착하면 해당 창의 스냅샷을 만듭니다.
• 현재 트리거 메시지는 InboundHistory에 포함되지 않습니다. 해당 턴의 기본 인바운드 본문에 남습니다.
• 같은 Matrix 이벤트의 재시도는 더 최신 방 메시지로 이동하지 않고 원래 기록 스냅샷을 재사용합니다.

​

컨텍스트 가시성

• contextVisibility: "all"이 기본값입니다. 보조 컨텍스트는 수신된 그대로 유지됩니다.
• contextVisibility: "allowlist"는 활성 방/사용자 허용 목록 검사에서 허용된 발신자로 보조 컨텍스트를 필터링합니다.
• contextVisibility: "allowlist_quote"는 allowlist처럼 동작하지만, 명시적으로 인용된 답글 하나는 계속 유지합니다.

​

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"인 경우, 최소 한 명의 승인자를 해석할 수 있으면 Matrix가 자동 활성화됩니다. 명시적으로 비활성화하려면 false를 설정합니다.
• approvers: exec 요청을 승인할 수 있는 Matrix 사용자 ID(@owner:example.org)입니다. 선택 사항이며 channels.matrix.dm.allowFrom으로 대체됩니다.
• target: 프롬프트가 전송될 위치입니다. "dm"(기본값)은 승인자 DM으로 보내고, "channel"은 원본 Matrix 방 또는 DM으로 보내며, "both"는 둘 다로 보냅니다.
• agentFilter / sessionFilter: Matrix 전달을 트리거하는 에이전트/세션에 대한 선택적 허용 목록입니다.

• 실행 승인은 execApprovals.approvers를 사용하며, dm.allowFrom으로 대체됩니다.
• Plugin 승인은 dm.allowFrom만 통해 권한을 부여합니다.

• ✅ 한 번 허용
• ❌ 거부
• ♾️ 항상 허용(유효한 exec 정책에서 허용하는 경우)

​

슬래시 명령

​

다중 계정

{
  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"는 계속 작동합니다.

• 암시적 라우팅, 프로빙, CLI 명령이 선호할 이름 있는 계정을 선택하려면 defaultAccount를 설정합니다.
• 여러 계정이 있고 그중 하나의 이름이 문자 그대로 default이면, defaultAccount가 설정되지 않아도 OpenClaw가 이를 암시적으로 사용합니다.
• 이름 있는 계정이 여러 개이고 기본값이 선택되지 않은 경우 CLI 명령은 추측을 거부합니다. defaultAccount를 설정하거나 --account <id>를 전달하세요.
• 최상위 channels.matrix.* 블록은 인증이 완료된 경우(homeserver + accessToken, 또는 homeserver + userId + password)에만 암시적 default 계정으로 처리됩니다. 이름 있는 계정은 캐시된 자격 증명이 인증을 처리하면 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: 토큰 기반 인증용 액세스 토큰입니다. 일반 텍스트 및 SecretRef 값은 env/file/exec 공급자 전반에서 지원됩니다(비밀 관리).
• 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 허용 목록입니다.
• 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" 또는 "always"입니다.
• threadBindings: 스레드에 바인딩된 세션 라우팅 및 수명 주기에 대한 채널별 재정의입니다.
• streaming: "off"(기본값), "partial", "quiet" 또는 객체 형식 { mode, preview: { toolProgress } }입니다. true ↔ "partial", false ↔ "off".
• blockStreaming: true인 경우 완료된 어시스턴트 블록이 별도의 진행 메시지로 유지됩니다.
• markdown: 아웃바운드 텍스트에 대한 선택적 Markdown 렌더링 구성입니다.
• responsePrefix: 아웃바운드 답글 앞에 추가되는 선택적 문자열입니다.
• textChunkLimit: chunkMode: "length"일 때 문자 단위 아웃바운드 청크 크기입니다. 기본값: 4000.
• chunkMode: "length"(기본값, 문자 수 기준 분할) 또는 "newline"(줄 경계에서 분할)입니다.
• historyLimit: 방 메시지가 에이전트를 트리거할 때 InboundHistory로 포함되는 최근 방 메시지 수입니다. messages.groupChat.historyLimit로 폴백하며, 유효 기본값은 0(비활성화)입니다.
• mediaMaxMb: 아웃바운드 전송 및 인바운드 처리에 대한 미디어 크기 상한(MB)입니다.

​

반응 설정

• ackReaction: 이 채널/계정에 대한 확인 반응 재정의입니다.
• ackReactionScope: 범위 재정의입니다("group-mentions" 기본값, "group-all", "direct", "all", "none", "off").
• reactionNotifications: 인바운드 반응 알림 모드입니다("own" 기본값, "off").

​

도구 및 방별 재정의

• actions: 작업별 도구 게이팅입니다(messages, reactions, pins, profile, memberInfo, channelInfo, verification).
• groups: 방별 정책 맵입니다. 세션 ID는 확인 후 안정적인 방 ID를 사용합니다. (rooms는 레거시 별칭입니다.)
  • groups.<room>.account: 상속된 방 항목 하나를 특정 계정으로 제한합니다.
  • groups.<room>.allowBots: 채널 수준 설정의 방별 재정의입니다(true 또는 "mentions").
  • groups.<room>.users: 방별 발신자 허용 목록입니다.
  • groups.<room>.tools: 방별 도구 허용/거부 재정의입니다.
  • groups.<room>.autoReply: 방별 멘션 게이팅 재정의입니다. true는 해당 방의 멘션 요구 사항을 비활성화하고, false는 다시 강제합니다.
  • groups.<room>.skills: 방별 skill 필터입니다.
  • groups.<room>.systemPrompt: 방별 시스템 프롬프트 스니펫입니다.

​

Exec 승인 설정

• execApprovals.enabled: Matrix 네이티브 프롬프트를 통해 exec 승인을 전달합니다.
• execApprovals.approvers: 승인이 허용된 Matrix 사용자 ID입니다. dm.allowFrom으로 폴백합니다.
• execApprovals.target: "dm"(기본값), "channel" 또는 "both"입니다.
• execApprovals.agentFilter / execApprovals.sessionFilter: 전달을 위한 선택적 에이전트/세션 허용 목록입니다.

​

관련 항목

• 채널 개요 - 지원되는 모든 채널
• 페어링 - DM 인증 및 페어링 흐름
• 그룹 - 그룹 채팅 동작 및 멘션 게이팅
• 채널 라우팅 - 메시지에 대한 세션 라우팅
• 보안 - 액세스 모델 및 강화