​

Nhóm

​

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

• Nhóm bị giới hạn (groupPolicy: "allowlist").
• Phản hồi yêu cầu nhắc đến trừ khi bạn tắt tính năng này.

Tóm tắt

• Truy cập DM được kiểm soát bởi *.allowFrom.
• Truy cập nhóm được kiểm soát bởi *.groupPolicy + danh sách cho phép (*.groups, *.groupAllowFrom).
• Kích hoạt phản hồi được kiểm soát bởi nhắc đến (requireMention, /activation).

groupPolicy? disabled -> bỏ qua
groupPolicy? allowlist -> nhóm được phép? không -> bỏ qua
requireMention? có -> được nhắc đến? không -> lưu cho ngữ cảnh
khác -> phản hồi

​

Khóa phiên

• Phiên nhóm sử dụng khóa phiên agent:<agentId>:<channel>:group:<id> (phòng/kênh sử 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 sử dụng phiên chính (hoặc theo người gửi nếu được cấu hình).
• Bỏ qua nhịp tim cho phiên nhóm.

​

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

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

Nếu bạn cần không gian làm việc/nhân vật hoàn toàn riêng biệt (“cá nhân” và “công khai” không bao giờ được trộn lẫn), hãy sử dụng agent thứ hai + ràng buộc. Xem Định tuyến Multi-Agent.

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main", // nhóm/kênh là không chính -> trong sandbox
        scope: "session", // cách ly mạnh nhất (một container cho mỗi nhóm/kênh)
        workspaceAccess: "none",
      },
    },
  },
  tools: {
    sandbox: {
      tools: {
        // Nếu allow không rỗng, mọi thứ khác bị chặn (deny vẫn thắng).
        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 tại sao một công cụ bị chặn: Sandbox vs Chính sách Công cụ vs Nâng cao
• Chi tiết gắn kết: Sandboxing

​

Nhãn hiển thị

• Nhãn UI sử dụng displayName khi có, định dạng là <channel>:<token>.
• #room dành riêng cho phòng/kênh; trò chuyện nhóm sử 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"], // id người dùng Telegram (wizard có thể giải quyết @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": { allow: true },
        "#alias:example.org": { allow: true },
      },
    },
  },
}

• groupPolicy tách biệt với nhắc đến (yêu cầu @mentions).
• WhatsApp/Telegram/Signal/iMessage/Microsoft Teams/Zalo: sử dụng groupAllowFrom (dự phòng: allowFrom rõ ràng).
• Phê duyệt ghép đôi DM (*-allowFrom lưu trữ mục) chỉ áp dụng cho truy cập DM; ủy quyền người gửi nhóm vẫn rõ ràng cho danh sách cho phép nhóm.
• Discord: danh sách cho phép sử dụng channels.discord.guilds.<id>.channels.
• Slack: danh sách cho phép sử dụng channels.slack.channels.
• Matrix: danh sách cho phép sử dụng channels.matrix.groups (id phòng, bí danh hoặc tên). Sử dụng channels.matrix.groupAllowFrom để hạn chế người gửi; danh sách cho phép users theo phòng cũng được hỗ trợ.
• DM nhóm được kiểm soát riêng (channels.discord.dm.*, channels.slack.dm.*).
• Danh sách cho phép Telegram có thể khớp với id người dùng ("123456789", "telegram:123456789", "tg:123456789") hoặc tên người dùng ("@alice" hoặc "alice"); tiền tố không phân biệt chữ hoa chữ thường.
• Mặc định là groupPolicy: "allowlist"; nếu danh sách cho phép nhóm của bạn trống, tin nhắn nhóm bị chặn.
• An toàn khi chạy: khi một khối nhà cung cấp hoàn toàn thiếu (channels.<provider> không có), chính sách nhóm sẽ quay lại chế độ đóng thất bại (thường là allowlist) thay vì kế thừa channels.defaults.groupPolicy.

1. groupPolicy (open/disabled/allowlist)
2. danh sách cho phép nhóm (*.groups, *.groupAllowFrom, danh sách cho phép cụ thể theo kênh)
3. nhắc đến (requireMention, /activation)

​

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

• mentionPatterns là các mẫu regex an toàn không phân biệt chữ hoa chữ thường; các mẫu không hợp lệ và các dạng lặp lồng không an toàn bị bỏ qua.
• Các bề mặt cung cấp nhắc đến rõ ràng vẫn được thông qua; các mẫu là dự phòng.
• Ghi đè theo agent: agents.list[].groupChat.mentionPatterns (hữu ích khi nhiều agent chia sẻ một nhóm).
• Nhắc đến chỉ được thực thi khi phát hiện nhắc đến có thể (nhắc đến gốc hoặc mentionPatterns được cấu hình).
• Mặc định Discord sống trong channels.discord.guilds."*" (có thể ghi đè theo guild/kênh).
• Ngữ cảnh lịch sử nhóm được bao bọc đồng nhất trên các kênh và chỉ đang chờ (tin nhắn bị bỏ qua do nhắc đến); sử dụng messages.groupChat.historyLimit cho mặc định toàn cầu và channels.<channel>.historyLimit (hoặc channels.<channel>.accounts.*.historyLimit) cho ghi đè. Đặt 0 để tắt.

​

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

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

1. khớp toolsBySender nhóm/kênh
2. tools nhóm/kênh
3. khớp toolsBySender mặc định ("*")
4. tools mặc định ("*")

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

• Hạn chế công cụ nhóm/kênh được áp dụng ngoài chính sách công cụ toàn cầu/agent (deny vẫn thắng).
• Một số kênh sử dụng cấu trúc lồng khác cho phòng/kênh (ví dụ: Discord guilds.*.channels.*, Slack channels.*, Microsoft Teams teams.*.channels.*).

​

Danh sách cho phép nhóm

1. Tắt tất cả phản hồi nhóm

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

2. Chỉ cho phép nhóm cụ thể (WhatsApp)

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

3. Cho phép tất cả nhóm nhưng yêu cầu nhắc đến (rõ ràng)

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

4. Chỉ chủ sở hữu có thể kích hoạt trong nhóm (WhatsApp)

{
  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ả nhắc đến)
• Chủ đề diễn đàn Telegram cũng bao gồm MessageThreadId và IsForum.

​

Cụ thể iMessage

• Ưu tiên chat_id:<id> khi định tuyến hoặc danh sách cho phép.
• Liệt kê trò chuyện: imsg chats --limit 20.
• Phản hồi nhóm luôn quay lại cùng chat_id.

​

Cụ thể WhatsApp