Cấu hình — các kênh

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.

​

Kênh

​

Quyền truy cập DM và nhóm

​

Ghi đè mô hình theo kênh

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

​

Mặc định kênh và Heartbeat

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

• channels.defaults.groupPolicy: chính sách nhóm dự phòng khi groupPolicy cấp nhà cung cấp chưa được đặt.
• channels.defaults.contextVisibility: chế độ hiển thị ngữ cảnh bổ sung mặc định cho tất cả kênh. Giá trị: all (mặc định, bao gồm tất cả ngữ cảnh trích dẫn/luồng/lịch sử), allowlist (chỉ bao gồm ngữ cảnh từ người gửi trong danh sách cho phép), allowlist_quote (giống danh sách cho phép nhưng giữ ngữ cảnh trích dẫn/trả lời rõ ràng). Ghi đè theo kênh: channels.<channel>.contextVisibility.
• channels.defaults.heartbeat.showOk: bao gồm trạng thái kênh khỏe mạnh trong đầu ra Heartbeat.
• channels.defaults.heartbeat.showAlerts: bao gồm trạng thái suy giảm/lỗi trong đầu ra Heartbeat.
• channels.defaults.heartbeat.useIndicator: hiển thị đầu ra Heartbeat dạng chỉ báo gọn.

​

WhatsApp

{
  web: {
    whatsapp: {
      keepAliveIntervalMs: 25000,
      connectTimeoutMs: 60000,
      defaultQueryTimeoutMs: 60000,
    },
  },
  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"],
    },
  },
  web: {
    enabled: true,
    heartbeatSeconds: 60,
    reconnect: {
      initialMs: 2000,
      maxMs: 120000,
      factor: 1.4,
      jitter: 0.2,
      maxAttempts: 0,
    },
  },
}

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

• Token bot: channels.telegram.botToken hoặc channels.telegram.tokenFile (chỉ tệp thông thường; từ chối symlink), với TELEGRAM_BOT_TOKEN làm dự phòng cho tài khoản mặc định.
• apiRoot chỉ là gốc Telegram Bot API. Dùng https://api.telegram.org hoặc gốc tự lưu trữ/proxy của bạn, không dùng https://api.telegram.org/bot<TOKEN>; openclaw doctor --fix xóa hậu tố /bot<TOKEN> vô tình ở cuối.
• channels.telegram.defaultAccount tùy chọn ghi đè lựa chọn tài khoản mặc định khi khớp với id tài khoản đã cấu hình.
• Trong thiết lập nhiều tài khoản (2+ id tài khoản), đặt mặc định rõ ràng (channels.telegram.defaultAccount hoặc channels.telegram.accounts.default) để tránh định tuyến dự phòng; openclaw doctor cảnh báo khi mục này bị thiếu hoặc không hợp lệ.
• configWrites: false chặn các ghi cấu hình khởi phát từ Telegram (di chuyển ID supergroup, /config set|unset).
• Các mục bindings[] cấp cao nhất với type: "acp" cấu hình liên kết ACP bền vững cho chủ đề diễn đàn (dùng chatId:topic:topicId chuẩn trong match.peer.id). Ngữ nghĩa trường được chia sẻ trong Tác tử ACP.
• Bản xem trước luồng Telegram dùng sendMessage + editMessageText (hoạt động trong trò chuyện trực tiếp và nhóm).
• Chính sách thử lại: xem Chính sách thử lại.

​

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: "off", // off | partial | block | progress (progress maps to partial on Discord)
      maxLinesPerMessage: 17,
      ui: {
        components: {
          accentColor: "#5865F2",
        },
      },
      threadBindings: {
        enabled: true,
        idleHours: 24,
        maxAgeHours: 0,
        spawnSubagentSessions: false, // opt-in for sessions_spawn({ thread: true })
      },
      voice: {
        enabled: true,
        autoJoin: [
          {
            guildId: "123456789012345678",
            channelId: "234567890123456789",
          },
        ],
        daveEncryption: true,
        decryptionFailureTolerance: 24,
        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,
      },
    },
  },
}

• Token: channels.discord.token, với DISCORD_BOT_TOKEN làm phương án dự phòng cho tài khoản mặc định.
• Các lệnh gọi đi trực tiếp cung cấp Discord token tường minh sẽ dùng token đó cho lệnh gọi; thiết lập thử lại/chính sách của tài khoản vẫn đến từ tài khoản đã chọn trong ảnh chụp thời gian chạy đang hoạt động.
• channels.discord.defaultAccount tùy chọn sẽ ghi đè lựa chọn tài khoản mặc định khi khớp với một id tài khoản đã cấu hình.
• Dùng user:<id> (DM) hoặc channel:<id> (kênh bang hội) cho đích gửi; ID số trần sẽ bị từ chối.
• Slug bang hội dùng chữ thường và thay khoảng trắng bằng -; khóa kênh dùng tên đã tạo slug (không có #). Ưu tiên ID bang hội.
• Tin nhắn do bot viết mặc định bị bỏ qua. allowBots: true bật các tin nhắn đó; dùng allowBots: "mentions" để chỉ chấp nhận tin nhắn bot có nhắc đến bot (tin nhắn của chính bot vẫn bị lọc).
• channels.discord.guilds.<id>.ignoreOtherMentions (và các ghi đè kênh) loại bỏ tin nhắn nhắc đến người dùng hoặc vai trò khác nhưng không nhắc đến bot (không tính @everyone/@here).
• maxLinesPerMessage (mặc định 17) chia nhỏ tin nhắn cao ngay cả khi dưới 2000 ký tự.
• channels.discord.threadBindings kiểm soát định tuyến gắn với luồng Discord:
  • enabled: ghi đè Discord cho các tính năng phiên gắn với luồng (/focus, /unfocus, /agents, /session idle, /session max-age, và gửi/định tuyến đã gắn)
  • idleHours: ghi đè Discord cho tự động bỏ tập trung khi không hoạt động, tính bằng giờ (0 tắt)
  • maxAgeHours: ghi đè Discord cho tuổi tối đa cứng, tính bằng giờ (0 tắt)
  • spawnSubagentSessions: công tắc chọn tham gia cho việc tự động tạo/gắn luồng sessions_spawn({ thread: true })
• Các mục bindings[] cấp cao nhất với type: "acp" cấu hình liên kết ACP bền vững cho kênh và luồng (dùng id kênh/luồng trong match.peer.id). Ngữ nghĩa trường được chia sẻ trong Tác nhân ACP.
• channels.discord.ui.components.accentColor đặt màu nhấn cho vùng chứa thành phần Discord v2.
• channels.discord.voice bật hội thoại kênh thoại Discord và các ghi đè tự động tham gia + LLM + TTS tùy chọn.
• channels.discord.voice.model tùy chọn ghi đè mô hình LLM dùng cho phản hồi kênh thoại Discord.
• channels.discord.voice.daveEncryption và channels.discord.voice.decryptionFailureTolerance được truyền qua các tùy chọn DAVE của @discordjs/voice (true và 24 theo mặc định).
• OpenClaw cũng cố gắng khôi phục nhận thoại bằng cách rời/tham gia lại một phiên thoại sau các lỗi giải mã lặp lại.
• channels.discord.streaming là khóa chế độ luồng chuẩn. Các giá trị cũ streamMode và streaming boolean được tự động di trú.
• channels.discord.autoPresence ánh xạ tình trạng sẵn sàng thời gian chạy sang trạng thái hiện diện của bot (healthy => online, degraded => idle, exhausted => dnd) và cho phép ghi đè văn bản trạng thái tùy chọn.
• channels.discord.dangerouslyAllowNameMatching bật lại khớp tên/thẻ có thể thay đổi (chế độ tương thích phá kính).
• channels.discord.execApprovals: gửi phê duyệt exec theo kiểu gốc Discord và ủy quyền người phê duyệt.
  • enabled: true, false, hoặc "auto" (mặc định). Ở chế độ tự động, phê duyệt exec kích hoạt khi có thể phân giải người phê duyệt từ approvers hoặc commands.ownerAllowFrom.
  • approvers: ID người dùng Discord được phép phê duyệt yêu cầu exec. Quay về commands.ownerAllowFrom khi bị bỏ qua.
  • agentFilter: danh sách cho phép ID tác nhân tùy chọn. Bỏ qua để chuyển tiếp phê duyệt cho tất cả tác nhân.
  • sessionFilter: mẫu khóa phiên tùy chọn (chuỗi con hoặc biểu thức chính quy).
  • target: nơi gửi lời nhắc phê duyệt. "dm" (mặc định) gửi đến DM của người phê duyệt, "channel" gửi đến kênh phát sinh, "both" gửi đến cả hai. Khi đích bao gồm "channel", các nút chỉ dùng được bởi người phê duyệt đã phân giải.
  • cleanupAfterResolve: khi true, xóa DM phê duyệt sau khi phê duyệt, từ chối hoặc hết thời gian chờ.

​

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 tài khoản dịch vụ: nội tuyến (serviceAccount) hoặc dựa trên tệp (serviceAccountFile).
• SecretRef tài khoản dịch vụ cũng được hỗ trợ (serviceAccountRef).
• Phương án dự phòng môi trường: GOOGLE_CHAT_SERVICE_ACCOUNT hoặc GOOGLE_CHAT_SERVICE_ACCOUNT_FILE.
• Dùng spaces/<spaceId> hoặc users/<userId> cho đích gửi.
• channels.googlechat.dangerouslyAllowNameMatching bật lại khớp định danh email có thể thay đổi (chế độ tương thích phá kính).

​

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

• Chế độ socket yêu cầu cả botToken và appToken (SLACK_BOT_TOKEN + SLACK_APP_TOKEN cho phương án dự phòng môi trường của tài khoản mặc định).
• Chế độ HTTP yêu cầu botToken cộng với signingSecret (ở gốc hoặc theo từng tài khoản).
• socketMode truyền tinh chỉnh truyền tải Chế độ Socket của SDK Slack qua API bộ nhận Bolt công khai. Chỉ dùng khi điều tra thời gian chờ ping/pong hoặc hành vi websocket cũ.
• botToken, appToken, signingSecret, và userToken chấp nhận chuỗi văn bản thuần hoặc đối tượng SecretRef.
• Ảnh chụp tài khoản Slack phơi bày các trường nguồn/trạng thái theo từng thông tin xác thực như botTokenSource, botTokenStatus, appTokenStatus, và, ở chế độ HTTP, signingSecretStatus. configured_unavailable nghĩa là tài khoản được cấu hình qua SecretRef nhưng đường dẫn lệnh/thời gian chạy hiện tại không thể phân giải giá trị bí mật.
• configWrites: false chặn các thao tác ghi cấu hình do Slack khởi tạo.
• channels.slack.defaultAccount tùy chọn sẽ ghi đè lựa chọn tài khoản mặc định khi khớp với một id tài khoản đã cấu hình.
• channels.slack.streaming.mode là khóa chế độ luồng Slack chuẩn. channels.slack.streaming.nativeTransport kiểm soát truyền tải luồng gốc của Slack. Các giá trị cũ streamMode, streaming boolean, và nativeStreaming được tự động di trú.
• Dùng user:<id> (DM) hoặc channel:<id> cho đích gửi.

• Luồng gốc Slack cộng với trạng thái luồng kiểu trợ lý Slack “is typing…” yêu cầu một đích luồng trả lời. DM cấp cao nhất mặc định vẫn nằm ngoài luồng, nên dùng typingReaction hoặc gửi bình thường thay vì bản xem trước kiểu luồng.
• typingReaction thêm một phản ứng tạm thời vào tin nhắn Slack đến trong khi phản hồi đang chạy, rồi xóa phản ứng đó khi hoàn tất. Dùng một shortcode emoji Slack như "hourglass_flowing_sand".
• channels.slack.execApprovals: gửi phê duyệt exec theo kiểu gốc Slack và ủy quyền người phê duyệt. Cùng lược đồ như Discord: enabled (true/false/"auto"), approvers (ID người dùng Slack), agentFilter, sessionFilter, và target ("dm", "channel", hoặc "both").

​

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

• commands.callbackPath phải là một đường dẫn (ví dụ /api/channels/mattermost/command), không phải URL đầy đủ.
• commands.callbackUrl phải phân giải đến điểm cuối Gateway OpenClaw và có thể truy cập được từ máy chủ Mattermost.
• Callback slash gốc được xác thực bằng token theo từng lệnh do Mattermost trả về trong quá trình đăng ký slash command. Nếu đăng ký thất bại hoặc không có lệnh nào được kích hoạt, OpenClaw từ chối callback với Unauthorized: invalid command token.
• Với máy chủ callback riêng tư/tailnet/nội bộ, Mattermost có thể yêu cầu ServiceSettings.AllowedUntrustedInternalConnections bao gồm máy chủ/miền callback. Dùng giá trị máy chủ/miền, không dùng URL đầy đủ.
• channels.mattermost.configWrites: cho phép hoặc từ chối các thao tác ghi cấu hình do Mattermost khởi tạo.
• channels.mattermost.requireMention: yêu cầu @mention trước khi trả lời trong kênh.
• channels.mattermost.groups.<channelId>.requireMention: ghi đè kiểm soát bằng nhắc đến theo từng kênh ("*" cho mặc định).
• channels.mattermost.defaultAccount tùy chọn sẽ ghi đè lựa chọn tài khoản mặc định khi khớp với một id tài khoản đã cấu hình.

​

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

• channels.signal.account: ghim quá trình khởi động kênh vào một danh tính tài khoản Signal cụ thể.
• channels.signal.configWrites: cho phép hoặc từ chối các lần ghi cấu hình do Signal khởi tạo.
• channels.signal.defaultAccount tùy chọn ghi đè lựa chọn tài khoản mặc định khi khớp với một id tài khoản đã cấu hình.

​

BlueBubbles

{
  channels: {
    bluebubbles: {
      enabled: true,
      dmPolicy: "pairing",
      // serverUrl, password, webhookPath, group controls, and advanced actions:
      // see /channels/bluebubbles
    },
  },
}

• Các đường dẫn khóa cốt lõi được trình bày ở đây: channels.bluebubbles, channels.bluebubbles.dmPolicy.
• channels.bluebubbles.defaultAccount tùy chọn ghi đè lựa chọn tài khoản mặc định khi khớp với một id tài khoản đã cấu hình.
• Các mục bindings[] cấp cao nhất với type: "acp" có thể liên kết các cuộc trò chuyện BlueBubbles với các phiên ACP bền vững. Dùng một handle BlueBubbles hoặc chuỗi đích (chat_id:*, chat_guid:*, chat_identifier:*) trong match.peer.id. Ngữ nghĩa trường dùng chung: Tác tử ACP.
• Cấu hình kênh BlueBubbles đầy đủ được ghi lại trong BlueBubbles.

​

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",
      region: "US",
    },
  },
}

• channels.imessage.defaultAccount tùy chọn ghi đè lựa chọn tài khoản mặc định khi khớp với một id tài khoản đã cấu hình.
• Yêu cầu Full Disk Access tới DB Messages.
• Ưu tiên các đích chat_id:<id>. Dùng imsg chats --limit 20 để liệt kê các cuộc trò chuyện.
• cliPath có thể trỏ tới một SSH wrapper; đặt remoteHost (host hoặc user@host) để lấy tệp đính kèm qua SCP.
• attachmentRoots và remoteAttachmentRoots giới hạn các đường dẫn tệp đính kèm đến (mặc định: /Users/*/Library/Messages/Attachments).
• SCP dùng kiểm tra khóa máy chủ nghiêm ngặt, vì vậy hãy đảm bảo khóa máy chủ chuyển tiếp đã tồn tại trong ~/.ssh/known_hosts.
• channels.imessage.configWrites: cho phép hoặc từ chối các lần ghi cấu hình do iMessage khởi tạo.
• Các mục bindings[] cấp cao nhất với type: "acp" có thể liên kết các cuộc trò chuyện iMessage với các phiên ACP bền vững. Dùng một handle đã chuẩn hóa hoặc đích trò chuyện rõ ràng (chat_id:*, chat_guid:*, chat_identifier:*) trong match.peer.id. Ngữ nghĩa trường dùng chung: Tác tử 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",
        },
      },
    },
  },
}

• Xác thực bằng token dùng accessToken; xác thực bằng mật khẩu dùng userId + password.
• channels.matrix.proxy định tuyến lưu lượng HTTP của Matrix qua một proxy HTTP(S) rõ ràng. Các tài khoản được đặt tên có thể ghi đè bằng channels.matrix.accounts.<id>.proxy.
• channels.matrix.network.dangerouslyAllowPrivateNetwork cho phép homeserver riêng/nội bộ. proxy và tùy chọn tham gia mạng này là các điều khiển độc lập.
• channels.matrix.defaultAccount chọn tài khoản ưu tiên trong các thiết lập nhiều tài khoản.
• channels.matrix.autoJoin mặc định là off, nên các phòng được mời và lời mời kiểu DM mới sẽ bị bỏ qua cho đến khi bạn đặt autoJoin: "allowlist" với autoJoinAllowlist hoặc autoJoin: "always".
• channels.matrix.execApprovals: phân phối phê duyệt exec gốc Matrix và ủy quyền người phê duyệt.
  • enabled: true, false, hoặc "auto" (mặc định). Ở chế độ tự động, phê duyệt exec kích hoạt khi có thể phân giải người phê duyệt từ approvers hoặc commands.ownerAllowFrom.
  • approvers: id người dùng Matrix (ví dụ @owner:example.org) được phép phê duyệt yêu cầu exec.
  • agentFilter: danh sách cho phép id tác tử tùy chọn. Bỏ qua để chuyển tiếp phê duyệt cho tất cả tác tử.
  • sessionFilter: mẫu khóa phiên tùy chọn (chuỗi con hoặc regex).
  • target: nơi gửi lời nhắc phê duyệt. "dm" (mặc định), "channel" (phòng nguồn), hoặc "both".
  • Ghi đè theo từng tài khoản: channels.matrix.accounts.<id>.execApprovals.
• channels.matrix.dm.sessionScope kiểm soát cách các DM Matrix được nhóm vào phiên: per-user (mặc định) chia sẻ theo peer được định tuyến, còn per-room cô lập từng phòng DM.
• Các thăm dò trạng thái Matrix và tra cứu thư mục trực tiếp dùng cùng chính sách proxy như lưu lượng runtime.
• Cấu hình Matrix đầy đủ, quy tắc nhắm mục tiêu và ví dụ thiết lập được ghi lại trong Matrix.

​

Microsoft Teams

{
  channels: {
    msteams: {
      enabled: true,
      configWrites: true,
      // appId, appPassword, tenantId, webhook, team/channel policies:
      // see /channels/msteams
    },
  },
}

• Các đường dẫn khóa cốt lõi được trình bày ở đây: channels.msteams, channels.msteams.configWrites.
• Cấu hình Teams đầy đủ (thông tin xác thực, Webhook, chính sách DM/nhóm, ghi đè theo từng team/từng kênh) được ghi lại trong 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",
      },
    },
  },
}

• Các đường dẫn khóa cốt lõi được trình bày ở đây: channels.irc, channels.irc.dmPolicy, channels.irc.configWrites, channels.irc.nickserv.*.
• channels.irc.defaultAccount tùy chọn ghi đè lựa chọn tài khoản mặc định khi khớp với một id tài khoản đã cấu hình.
• Cấu hình kênh IRC đầy đủ (máy chủ/cổng/TLS/kênh/danh sách cho phép/kiểm soát bằng lượt nhắc đến) được ghi lại trong IRC.

​

Nhiều tài khoản (tất cả kênh)

{
  channels: {
    telegram: {
      accounts: {
        default: {
          name: "Primary bot",
          botToken: "123456:ABC...",
        },
        alerts: {
          name: "Alerts bot",
          botToken: "987654:XYZ...",
        },
      },
    },
  },
}

• default được dùng khi bỏ qua accountId (CLI + định tuyến).
• Token env chỉ áp dụng cho tài khoản default.
• Thiết lập kênh cơ sở áp dụng cho tất cả tài khoản trừ khi được ghi đè theo từng tài khoản.
• Dùng bindings[].match.accountId để định tuyến mỗi tài khoản tới một tác tử khác nhau.
• Nếu bạn thêm một tài khoản không mặc định qua openclaw channels add (hoặc onboarding kênh) khi vẫn đang dùng cấu hình kênh cấp cao nhất một tài khoản, OpenClaw trước tiên sẽ nâng cấp các giá trị một tài khoản cấp cao nhất có phạm vi tài khoản vào bản đồ tài khoản của kênh để tài khoản ban đầu tiếp tục hoạt động. Hầu hết kênh chuyển chúng vào channels.<channel>.accounts.default; Matrix có thể giữ lại một đích được đặt tên/mặc định khớp sẵn có.
• Các liên kết chỉ theo kênh hiện có (không có accountId) tiếp tục khớp tài khoản mặc định; liên kết có phạm vi tài khoản vẫn là tùy chọn.
• openclaw doctor --fix cũng sửa các hình dạng trộn lẫn bằng cách chuyển các giá trị một tài khoản cấp cao nhất có phạm vi tài khoản vào tài khoản đã được nâng cấp được chọn cho kênh đó. Hầu hết kênh dùng accounts.default; Matrix có thể giữ lại một đích được đặt tên/mặc định khớp sẵn có.

​

Các kênh Plugin khác

​

Kiểm soát lượt nhắc trong trò chuyện nhóm

• Lượt nhắc metadata: @-mention gốc của nền tảng. Bị bỏ qua trong chế độ tự trò chuyện WhatsApp.
• Mẫu văn bản: Mẫu regex an toàn trong agents.list[].groupChat.mentionPatterns. Mẫu không hợp lệ và lặp lồng nhau không an toàn sẽ bị bỏ qua.
• Kiểm soát lượt nhắc chỉ được thực thi khi có thể phát hiện (lượt nhắc gốc hoặc ít nhất một mẫu).

{
  messages: {
    visibleReplies: "automatic", // global default for direct/source chats
    groupChat: {
      historyLimit: 50,
      visibleReplies: "message_tool", // default; use "automatic" for legacy final replies
    },
  },
  agents: {
    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],
  },
}

​

Giới hạn lịch sử DM

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

​

Chế độ tự trò chuyện

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

​

Lệnh (xử lý lệnh trò chuyện)

{
  commands: {
    native: "auto", // register native commands when supported
    nativeSkills: "auto", // register native skill commands when supported
    text: true, // parse /commands in chat messages
    bash: false, // allow ! (alias: /bash)
    bashForegroundMs: 2000,
    config: false, // allow /config
    mcp: false, // allow /mcp
    plugins: false, // allow /plugins
    debug: false, // allow /debug
    restart: true, // allow /restart + gateway restart tool
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw", // raw | hash
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}

​

Liên quan

• Tham chiếu cấu hình — các khóa cấp cao nhất
• Cấu hình — agent
• Tổng quan về kênh