Nhóm

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.

​

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

• Nhóm bị giới hạn (groupPolicy: "allowlist").
• Câu trả lời yêu cầu có nhắc đến trừ khi bạn tắt rõ ràng cổng kiểm soát bằng nhắc đến.
• Câu trả lời cuối thông thường trong nhóm/kênh mặc định là riêng tư. Đầ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

​

Câu trả lờ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 riêng theo kênh).
• Khả năng hiển thị ngữ cảnh: ngữ cảnh bổ sung nào được đưa vào model (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ấu hình).
• Heartbeat được bỏ qua cho phiên nhóm.

​

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

• DM: đầy đủ công cụ (host)
• Nhóm: sandbox + công cụ bị giới hạn

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

​

Kiểm soát bằng đề cập (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,
        },
      },
    ],
  },
}

​

Giới hạn 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: channel:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName>, và ký tự đại diện "*". ID kênh dùng ID kênh OpenClaw chuẩn; các bí danh như teams được chuẩn hóa thành msteams. 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"] },
          },
        },
      },
    },
  },
}

​

Allowlist 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 bằng đề cập)
• Chủ đề diễn đàn Telegram cũng bao gồm MessageThreadId và IsForum.

​

Chi tiết riêng của iMessage

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

​

Prompt 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 cặp