Cấu hình — kênh

Documentation Index

Fetch the complete documentation index at: https://docs2.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 đè model 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 mọi 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 allowlist 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: {
    enabled: true,
    heartbeatSeconds: 60,
    whatsapp: {
      keepAliveIntervalMs: 25000,
      connectTimeoutMs: 60000,
      defaultQueryTimeoutMs: 60000,
    },
    reconnect: {
      initialMs: 2000,
      maxMs: 120000,
      factor: 1.4,
      jitter: 0.2,
      maxAttempts: 0,
    },
  },
  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"],
    },
  },
}

{
  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 một 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 giá trị này bị thiếu hoặc không hợp lệ.
• configWrites: false chặn các thao tác ghi cấu hình do Telegram khởi tạo (di chuyển ID siêu nhóm, /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 Agent ACP.
• Bản xem trước stream của Telegram dùng sendMessage + editMessageText (hoạt động trong chat 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: {
        mode: "progress", // off | partial | block | progress (Discord default: progress)
        progress: {
          label: "auto",
          maxLines: 8,
          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,
      },
    },
  },
}

• Token: channels.discord.token, với DISCORD_BOT_TOKEN làm dự phòng cho tài khoản mặc định.
• Các lệnh gọi trực tiếp đi ra cung cấp token Discord rõ ràng sẽ dùng token đó cho lệnh gọi; các thiết lập thử lại/chính sách của tài khoản vẫn lấy từ tài khoản đã chọn trong ảnh chụp runtime đang hoạt động.
• channels.discord.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.
• Dùng user:<id> (DM) hoặc channel:<id> (kênh guild) cho mục tiêu gửi; các ID số trần bị từ chối.
• Slug guild dùng chữ thường và thay khoảng trắng bằng -; khóa kênh dùng tên đã slug hóa (không có #). Ưu tiên dùng ID guild.
• Tin nhắn do bot tạo mặc định bị bỏ qua. allowBots: true bật chúng; 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à 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).
• channels.discord.mentionAliases ánh xạ văn bản @handle gửi đi ổn định sang ID người dùng Discord trước khi gửi, để có thể nhắc đến đồng đội đã biết một cách xác định ngay cả khi cache thư mục tạm thời trống. Ghi đè theo từng tài khoản nằm dưới channels.discord.accounts.<accountId>.mentionAliases.
• maxLinesPerMessage (mặc định 17) chia các tin nhắn cao ngay cả khi dưới 2000 ký tự.
• channels.discord.threadBindings điều khiển định tuyến gắn với thread Discord:
  • enabled: ghi đè Discord cho các tính năng phiên gắn với thread (/focus, /unfocus, /agents, /session idle, /session max-age, và gửi/định tuyến đã ràng buộc)
  • idleHours: ghi đè Discord cho tự động bỏ focus 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)
  • spawnSessions: công tắc cho sessions_spawn({ thread: true }) và tạo/ràng buộc thread tự động khi ACP thread-spawn (mặc định: true)
  • defaultSpawnContext: ngữ cảnh subagent gốc cho spawn gắn với thread (mặc định là "fork")
• Các mục bindings[] cấp cao nhất với type: "acp" cấu hình ràng buộc ACP bền vững cho kênh và thread (dùng id kênh/thread trong match.peer.id). Ngữ nghĩa trường được chia sẻ trong ACP Agents.
• channels.discord.ui.components.accentColor đặt màu nhấn cho container Discord components v2.
• channels.discord.voice bật hội thoại kênh thoại Discord và các ghi đè auto-join + LLM + TTS tùy chọn. Cấu hình Discord chỉ văn bản mặc định để tắt thoại; đặt channels.discord.voice.enabled=true để bật.
• 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 chuyển tiếp tới tùy chọn DAVE của @discordjs/voice (mặc định là true và 24).
• channels.discord.voice.connectTimeoutMs điều khiển thời gian chờ Ready ban đầu của @discordjs/voice cho /vc join và các lần thử auto-join (mặc định là 30000).
• channels.discord.voice.reconnectGraceMs điều khiển thời lượng một phiên thoại đã ngắt kết nối có thể dùng để vào tín hiệu kết nối lại trước khi OpenClaw hủy nó (mặc định là 15000).
• Phát lại thoại Discord không bị gián đoạn bởi sự kiện bắt đầu nói của người dùng khác. Để tránh vòng lặp phản hồi, OpenClaw bỏ qua thu âm giọng nói mới trong khi TTS đang phát.
• OpenClaw cũng thử khôi phục nhận thoại bằng cách rời/tham gia lại 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 chính tắc. Discord mặc định là streaming.mode: "progress" để tiến trình công cụ/công việc xuất hiện trong một tin nhắn xem trước được chỉnh sửa; đặt streaming.mode: "off" để tắt. Các giá trị legacy streamMode và streaming dạng boolean vẫn là alias runtime; chạy openclaw doctor --fix để viết lại cấu hình đã lưu.
• channels.discord.autoPresence ánh xạ trạng thái sẵn sàng runtime sang hiện diện 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/tag có thể thay đổi (chế độ tương thích phá kính).
• channels.discord.execApprovals: gửi phê duyệt exec gốc Discord và ủy quyền người phê duyệt.
  • enabled: true, false, hoặc "auto" (mặc định). Ở chế độ auto, 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. Dự phòng về commands.ownerAllowFrom khi bị bỏ qua.
  • agentFilter: allowlist ID agent tùy chọn. Bỏ qua để chuyển tiếp phê duyệt cho mọi agent.
  • 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) gửi tới DM của người phê duyệt, "channel" gửi tới kênh khởi nguồn, "both" gửi tới cả hai. Khi target gồm "channel", 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.

​

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ụ: inline (serviceAccount) hoặc dựa trên tệp (serviceAccountFile).
• SecretRef tài khoản dịch vụ cũng được hỗ trợ (serviceAccountRef).
• Dự phòng env: GOOGLE_CHAT_SERVICE_ACCOUNT hoặc GOOGLE_CHAT_SERVICE_ACCOUNT_FILE.
• Dùng spaces/<spaceId> hoặc users/<userId> cho mục tiêu gửi.
• channels.googlechat.dangerouslyAllowNameMatching bật lại khớp principal 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",
      unfurlLinks: false,
      unfurlMedia: false,
      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 dự phòng env của tài khoản mặc định).
• Chế độ HTTP yêu cầu botToken cộng với signingSecret (ở root hoặc theo từng tài khoản).
• socketMode chuyển tiếp tinh chỉnh transport Socket Mode của Slack SDK tới API Bolt receiver công khai. Chỉ dùng nó khi điều tra timeout ping/pong hoặc hành vi websocket cũ.
• botToken, appToken, signingSecret, và userToken chấp nhận chuỗi plaintext hoặc đối tượng SecretRef.
• Ảnh chụp tài khoản Slack hiển thị các trường nguồn/trạng thái theo từng credential như botTokenSource, botTokenStatus, appTokenStatus, và, trong 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/runtime hiện tại không thể phân giải giá trị secret.
• configWrites: false chặn ghi cấu hình do Slack khởi tạo.
• channels.slack.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.
• channels.slack.streaming.mode là khóa chế độ luồng Slack chính tắc. channels.slack.streaming.nativeTransport điều khiển transport luồng gốc của Slack. Các giá trị legacy streamMode, streaming dạng boolean, và nativeStreaming vẫn là alias runtime; chạy openclaw doctor --fix để viết lại cấu hình đã lưu.
• unfurlLinks và unfurlMedia chuyển tiếp boolean unfurl liên kết và media của chat.postMessage Slack cho phản hồi bot. Bỏ qua chúng để giữ hành vi mặc định của Slack; đặt chúng tại channels.slack.accounts.<accountId> để ghi đè mặc định cấp cao nhất cho một tài khoản.
• Dùng user:<id> (DM) hoặc channel:<id> cho mục tiêu gửi.

• Streaming gốc Slack cộng với trạng thái thread kiểu trợ lý “is typing…” của Slack yêu cầu mục tiêu thread trả lời. DM cấp cao nhất mặc định vẫn ngoài thread, nên chúng vẫn có thể stream qua bản xem trước bài nháp đăng-và-sửa của Slack thay vì hiển thị bản xem trước stream/trạng thái gốc kiểu thread.
• typingReaction thêm reaction tạm thời vào tin nhắn Slack đến trong khi phản hồi đang chạy, rồi xóa nó khi hoàn tất. Dùng shortcode emoji Slack như "hourglass_flowing_sand".
• channels.slack.execApprovals: gửi phê duyệt exec gốc Slack và ủy quyền người phê duyệt. Cùng schema 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 tới endpoint Gateway của 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 riêng cho 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 các 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ủ/tên miền callback. Dùng giá trị máy chủ/tên 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 phản hồi trong kênh.
• channels.mattermost.groups.<channelId>.requireMention: ghi đè theo từng kênh cho cơ chế chặn theo mention ("*" cho mặc định).
• channels.mattermost.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.

​

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 thao tác 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.

​

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",
      actions: {
        reactions: true,
        edit: true,
        unsend: true,
        reply: true,
        sendWithEffect: true,
        sendAttachment: true,
      },
      catchup: {
        enabled: false,
      },
    },
  },
}

• 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 đối với Messages DB.
• Ưu tiên các target 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 đường dẫn tệp đính kèm đầu vào (mặc định: /Users/*/Library/Messages/Attachments).
• SCP dùng kiểm tra host-key nghiêm ngặt, vì vậy hãy đảm bảo khóa máy chủ relay đã tồn tại trong ~/.ssh/known_hosts.
• channels.imessage.configWrites: cho phép hoặc từ chối các thao tác ghi cấu hình do iMessage khởi tạo.
• channels.imessage.actions.*: bật các hành động API riêng tư cũng được kiểm soát bởi imsg status / openclaw channels status --probe.
• channels.imessage.includeAttachments mặc định tắt; đặt thành true trước khi mong đợi media đầu vào trong lượt agent.
• channels.imessage.catchup.enabled: chọn tham gia phát lại các tin nhắn đầu vào đã đến khi Gateway bị tắt.
• channels.imessage.groups: registry nhóm và cài đặt theo từng nhóm. Với groupPolicy: "allowlist", cấu hình khóa chat_id rõ ràng hoặc một mục ký tự đại diện "*" để tin nhắn nhóm có thể vượt qua cổng registry.
• Các mục bindings[] cấp cao nhất với type: "acp" có thể liên kết cuộc trò chuyện iMessage với phiên ACP bền vững. Dùng một handle đã chuẩn hóa hoặc target trò chuyện rõ ràng (chat_id:*, chat_guid:*, chat_identifier:*) trong match.peer.id. Ngữ nghĩa trường dùng chung: ACP Agents.

#!/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ên có thể ghi đè bằng channels.matrix.accounts.<id>.proxy.
• channels.matrix.network.dangerouslyAllowPrivateNetwork cho phép homeserver riêng tư/nội bộ. proxy và tùy chọn bật 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 thiết lập nhiều tài khoản.
• channels.matrix.autoJoin mặc định là off, vì vậy 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 của 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 được 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: allowlist ID agent tùy chọn. Bỏ qua để chuyển tiếp phê duyệt cho tất cả agent.
  • sessionFilter: mẫu khóa phiên tùy chọn (chuỗi con hoặc regex).
  • target: nơi gửi prompt 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 DM Matrix được nhóm vào phiên: per-user (mặc định) dùng chung theo peer được định tuyến, trong khi per-room cô lập từng phòng DM.
• Probe 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 lõi được đề cập ở đâ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 lõi được đề cập ở đâ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/allowlist/chặn theo mention) đượ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 mặc định.
• Cài đặt 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 từng tài khoản tới một agent khác nhau.
• Nếu bạn thêm tài khoản không phải mặc định bằng openclaw channels add (hoặc onboarding kênh) trong 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ẽ thă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 gốc 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 target có tên/mặc định khớp sẵn có.
• Các binding chỉ theo kênh hiện có (không có accountId) tiếp tục khớp với tài khoản mặc định; binding có phạm vi tài khoản vẫn là tùy chọn.
• openclaw doctor --fix cũng sửa các dạng hỗn hợp 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 thăng cấp đã chọn cho kênh đó. Hầu hết kênh dùng accounts.default; Matrix có thể giữ lại một target có tên/mặc định khớp sẵn có.

​

Các kênh Plugin khác

​

Chặn theo mention trong trò chuyện nhóm

• Nhắc đến bằng siêu dữ liệu: @-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: Các mẫu regex an toàn trong agents.list[].groupChat.mentionPatterns. Các mẫu không hợp lệ và lặp lồng nhau không an toàn sẽ bị bỏ qua.
• Cổng nhắc đến chỉ được thực thi khi có thể phát hiện (nhắc đến gốc hoặc ít nhất một mẫu).

{
  messages: {
    visibleReplies: "automatic", // mặc định toàn cục cho trò chuyện trực tiếp/nguồn; harness Codex mặc định các trò chuyện trực tiếp chưa đặt thành message_tool
    groupChat: {
      historyLimit: 50,
      visibleReplies: "message_tool", // mặc định; dùng "automatic" cho phản hồi cuối kiểu cũ
    },
  },
  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", // đăng ký lệnh gốc khi được hỗ trợ
    nativeSkills: "auto", // đăng ký lệnh skill gốc khi được hỗ trợ
    text: true, // phân tích /commands trong tin nhắn trò chuyện
    bash: false, // cho phép ! (bí danh: /bash)
    bashForegroundMs: 2000,
    config: false, // cho phép /config
    mcp: false, // cho phép /mcp
    plugins: false, // cho phép /plugins
    debug: false, // cho phép /debug
    restart: true, // cho phép /restart + công cụ khởi động lại gateway
    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