Nhóm

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.

​

Giới thiệu cho người mới bắt đầu (2 phút)

• Nhóm bị hạn chế (groupPolicy: "allowlist").
• Phản hồi yêu cầu nhắc đến, trừ khi bạn tắt rõ ràng cơ chế chặn theo nhắc đến.
• Phản hồi cuối thông thường trong nhóm/kênh là riêng tư theo mặc định. Đầu ra hiển thị trong phòng dùng công cụ message.

groupPolicy? disabled -> drop
groupPolicy? allowlist -> group allowed? no -> drop
requireMention? yes -> mentioned? no -> store for context only
otherwise -> reply

​

Phản hồi hiển thị

{
  messages: {
    groupChat: {
      visibleReplies: "automatic",
    },
  },
}

{
  messages: {
    visibleReplies: "message_tool",
  },
}

​

Khả năng hiển thị ngữ cảnh và danh sách cho phép

• Ủy quyền kích hoạt: ai có thể kích hoạt agent (groupPolicy, groups, groupAllowFrom, danh sách cho phép theo kênh).
• Khả năng hiển thị ngữ cảnh: ngữ cảnh bổ sung nào được đưa vào mô hình (văn bản trả lời, trích dẫn, lịch sử luồng, siêu dữ liệu chuyển tiếp).

​

Khóa phiên

• Phiên nhóm dùng khóa phiên agent:<agentId>:<channel>:group:<id> (phòng/kênh dùng agent:<agentId>:<channel>:channel:<id>).
• Chủ đề diễn đàn Telegram thêm :topic:<threadId> vào id nhóm để mỗi chủ đề có phiên riêng.
• Trò chuyện trực tiếp dùng phiên chính (hoặc theo từng người gửi nếu được cấu hình).
• Heartbeat bị bỏ qua đối với phiên nhóm.

​

Mẫu: DM cá nhân + nhóm công khai (một agent)

• DM: đầy đủ công cụ (máy chủ)
• Nhóm: sandbox + công cụ hạn chế

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main", // groups/channels are non-main -> sandboxed
        scope: "session", // strongest isolation (one container per group/channel)
        workspaceAccess: "none",
      },
    },
  },
  tools: {
    sandbox: {
      tools: {
        // If allow is non-empty, everything else is blocked (deny still wins).
        allow: ["group:messaging", "group:sessions"],
        deny: ["group:runtime", "group:fs", "group:ui", "nodes", "cron", "gateway"],
      },
    },
  },
}

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main",
        scope: "session",
        workspaceAccess: "none",
        docker: {
          binds: [
            // hostPath:containerPath:mode
            "/home/user/FriendsShared:/data:ro",
          ],
        },
      },
    },
  },
}

• Khóa cấu hình và mặc định: Cấu hình Gateway
• Gỡ lỗi lý do một công cụ bị chặn: Sandbox so với Chính sách công cụ so với Elevated
• Chi tiết bind mount: Sandboxing

​

Nhãn hiển thị

• Nhãn UI dùng displayName khi có, được định dạng là <channel>:<token>.
• #room được dành riêng cho phòng/kênh; trò chuyện nhóm dùng g-<slug> (chữ thường, khoảng trắng -> -, giữ #@+._-).

​

Chính sách nhóm

{
  channels: {
    whatsapp: {
      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"
      groupAllowFrom: ["+15551234567"],
    },
    telegram: {
      groupPolicy: "disabled",
      groupAllowFrom: ["123456789"], // numeric Telegram user id (wizard can resolve @username)
    },
    signal: {
      groupPolicy: "disabled",
      groupAllowFrom: ["+15551234567"],
    },
    imessage: {
      groupPolicy: "disabled",
      groupAllowFrom: ["chat_id:123"],
    },
    msteams: {
      groupPolicy: "disabled",
      groupAllowFrom: ["user@org.com"],
    },
    discord: {
      groupPolicy: "allowlist",
      guilds: {
        GUILD_ID: { channels: { help: { allow: true } } },
      },
    },
    slack: {
      groupPolicy: "allowlist",
      channels: { "#general": { allow: true } },
    },
    matrix: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["@owner:example.org"],
      groups: {
        "!roomId:example.org": { enabled: true },
        "#alias:example.org": { enabled: true },
      },
    },
  },
}

​

Cơ chế chặn theo nhắc đến (mặc định)

{
  channels: {
    whatsapp: {
      groups: {
        "*": { requireMention: true },
        "123@g.us": { requireMention: false },
      },
    },
    telegram: {
      groups: {
        "*": { requireMention: true },
        "123456789": { requireMention: false },
      },
    },
    imessage: {
      groups: {
        "*": { requireMention: true },
        "123": { requireMention: false },
      },
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: {
          mentionPatterns: ["@openclaw", "openclaw", "\\+15555550123"],
          historyLimit: 50,
        },
      },
    ],
  },
}

​

Hạn chế công cụ theo nhóm/kênh (tùy chọn)

• tools: cho phép/từ chối công cụ cho toàn bộ nhóm.
• toolsBySender: ghi đè theo từng người gửi trong nhóm. Dùng tiền tố khóa tường minh: id:<senderId>, e164:<phone>, username:<handle>, name:<displayName>, và ký tự đại diện "*". Các khóa cũ không có tiền tố vẫn được chấp nhận và chỉ được khớp như id:.

{
  channels: {
    telegram: {
      groups: {
        "*": { tools: { deny: ["exec"] } },
        "-1001234567890": {
          tools: { deny: ["exec", "read", "write"] },
          toolsBySender: {
            "id:123456789": { alsoAllow: ["exec"] },
          },
        },
      },
    },
  },
}

​

Danh sách cho phép nhóm

{
  channels: { whatsapp: { groupPolicy: "disabled" } },
}

{
  channels: {
    whatsapp: {
      groups: {
        "123@g.us": { requireMention: true },
        "456@g.us": { requireMention: false },
      },
    },
  },
}

{
  channels: {
    whatsapp: {
      groups: { "*": { requireMention: true } },
    },
  },
}

{
  channels: {
    whatsapp: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
      groups: { "*": { requireMention: true } },
    },
  },
}

​

Kích hoạt (chỉ chủ sở hữu)

• /activation mention
• /activation always

​

Trường ngữ cảnh

• ChatType=group
• GroupSubject (nếu biết)
• GroupMembers (nếu biết)
• WasMentioned (kết quả kiểm soát lượt nhắc đến)
• Chủ đề diễn đàn Telegram cũng bao gồm MessageThreadId và IsForum.

• BlueBubbles có thể tùy chọn bổ sung thông tin người tham gia nhóm macOS chưa có tên từ cơ sở dữ liệu Danh bạ cục bộ trước khi điền GroupMembers. Tính năng này mặc định tắt và chỉ chạy sau khi kiểm soát nhóm thông thường đã đạt.

​

Chi tiết riêng của iMessage

• Ưu tiên chat_id:<id> khi định tuyến hoặc đưa vào danh sách cho phép.
• Liệt kê chat: imsg chats --limit 20.
• Trả lời nhóm luôn quay lại cùng chat_id.

​

Lời nhắc hệ thống WhatsApp

​

Chi tiết riêng của WhatsApp

​

Liên quan

• Nhóm phát sóng
• Định tuyến kênh
• Tin nhắn nhóm
• Ghép nối