Chuyển đến nội dung chí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.

Nhóm truy cập là danh sách người gửi có tên mà bạn định nghĩa một lần và tham chiếu từ danh sách cho phép của kênh bằng accessGroup:<name>. Dùng chúng khi cùng một nhóm người cần được cho phép trên nhiều kênh tin nhắn, hoặc khi một tập hợp đáng tin cậy nên áp dụng cho cả DM và ủy quyền người gửi trong nhóm. Nhóm truy cập tự chúng không cấp quyền truy cập. Một nhóm chỉ có tác dụng khi một trường danh sách cho phép tham chiếu đến nó.

​
Nhóm người gửi tin nhắn tĩnh

Nhóm người gửi tĩnh dùng type: "message.senders". 
{
  accessGroups: {
    operators: {
      type: "message.senders",
      members: {
        "*": ["global-owner-id"],
        discord: ["discord:123456789012345678"],
        telegram: ["987654321"],
        whatsapp: ["+15551234567"],
      },
    },
  },
}
Danh sách thành viên được khóa theo id kênh tin nhắn:
KhóaÝ nghĩa
"*"Mục dùng chung được kiểm tra cho mọi kênh tin nhắn tham chiếu nhóm.
discordMục chỉ được kiểm tra cho khớp danh sách cho phép của Discord.
telegramMục chỉ được kiểm tra cho khớp danh sách cho phép của Telegram.
whatsappMục chỉ được kiểm tra cho khớp danh sách cho phép của WhatsApp.
Các mục được khớp bằng quy tắc allowFrom thông thường của kênh đích. OpenClaw không chuyển đổi id người gửi giữa các kênh. Nếu Alice có id Telegram và id Discord, hãy liệt kê cả hai id dưới các khóa phù hợp.

​
Tham chiếu nhóm từ danh sách cho phép

Tham chiếu một nhóm bằng accessGroup:<name> ở bất kỳ nơi nào đường dẫn kênh tin nhắn hỗ trợ danh sách cho phép người gửi. Ví dụ danh sách cho phép DM: 
{
  accessGroups: {
    operators: {
      type: "message.senders",
      members: {
        discord: ["discord:123456789012345678"],
        telegram: ["987654321"],
      },
    },
  },
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:operators"],
    },
    telegram: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:operators"],
    },
  },
}
Ví dụ danh sách cho phép người gửi trong nhóm: 
{
  accessGroups: {
    oncall: {
      type: "message.senders",
      members: {
        whatsapp: ["+15551234567"],
        googlechat: ["users/1234567890"],
      },
    },
  },
  channels: {
    whatsapp: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["accessGroup:oncall"],
    },
    googlechat: {
      spaces: {
        "spaces/AAA": {
          users: ["accessGroup:oncall"],
        },
      },
    },
  },
}
Bạn có thể kết hợp nhóm và mục trực tiếp: 
{
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:operators", "discord:123456789012345678"],
    },
  },
}

​
Đường dẫn kênh tin nhắn được hỗ trợ

Nhóm truy cập có sẵn trong các đường dẫn ủy quyền kênh tin nhắn dùng chung, bao gồm:
  • danh sách cho phép người gửi DM như channels.<channel>.allowFrom
  • danh sách cho phép người gửi trong nhóm như channels.<channel>.groupAllowFrom
  • danh sách cho phép người gửi theo từng phòng, riêng cho từng kênh, dùng cùng quy tắc khớp người gửi
  • đường dẫn ủy quyền lệnh tái sử dụng danh sách cho phép người gửi của kênh tin nhắn
Mức hỗ trợ của kênh phụ thuộc vào việc kênh đó có được nối qua các helper ủy quyền người gửi dùng chung của OpenClaw hay không. Hỗ trợ tích hợp hiện tại bao gồm Discord, Feishu, Google Chat, iMessage, LINE, Mattermost, Microsoft Teams, Nextcloud Talk, Nostr, QQBot, Signal, WhatsApp, Zalo và Zalo Personal. Nhóm message.senders tĩnh được thiết kế để không phụ thuộc kênh, nên các kênh tin nhắn mới nên hỗ trợ chúng bằng cách dùng các helper SDK Plugin dùng chung thay vì mở rộng danh sách cho phép tùy chỉnh.

​
Chẩn đoán Plugin

Tác giả Plugin có thể kiểm tra trạng thái nhóm truy cập có cấu trúc mà không cần mở rộng lại thành danh sách cho phép phẳng: 
import { resolveAccessGroupAllowFromState } from "openclaw/plugin-sdk/security-runtime";

const state = await resolveAccessGroupAllowFromState({
  accessGroups: cfg.accessGroups,
  allowFrom: channelConfig.allowFrom,
  channel: "my-channel",
  accountId: "default",
  senderId,
  isSenderAllowed,
});
Kết quả báo cáo các nhóm được tham chiếu, được khớp, bị thiếu, không được hỗ trợ và thất bại. Dùng cách này khi bạn cần chẩn đoán hoặc kiểm thử tuân thủ. Chỉ dùng expandAllowFromWithAccessGroups(...) cho các đường dẫn tương thích vẫn cần một mảng allowFrom phẳng.

​
Đối tượng kênh Discord

Discord cũng hỗ trợ một loại nhóm truy cập động: 
{
  accessGroups: {
    maintainers: {
      type: "discord.channelAudience",
      guildId: "1456350064065904867",
      channelId: "1456744319972282449",
      membership: "canViewChannel",
    },
  },
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:maintainers"],
    },
  },
}
discord.channelAudience nghĩa là “cho phép người gửi DM Discord hiện có thể xem kênh guild này.” OpenClaw phân giải người gửi qua Discord tại thời điểm ủy quyền và áp dụng quy tắc quyền ViewChannel của Discord. Dùng cách này khi một kênh Discord đã là nguồn sự thật cho một nhóm, chẳng hạn như #maintainers hoặc #on-call. Yêu cầu và hành vi khi thất bại:
  • Bot cần quyền truy cập vào guild và kênh.
  • Bot cần Ý định Thành viên Máy chủ trong Cổng thông tin Nhà phát triển Discord.
  • Nhóm truy cập đóng khi thất bại nếu Discord trả về Missing Access, không thể phân giải người gửi là thành viên guild, hoặc kênh thuộc về guild khác.
Thêm ví dụ riêng cho Discord: Kiểm soát truy cập Discord

​
Ghi chú bảo mật

  • Nhóm truy cập là bí danh danh sách cho phép, không phải vai trò. Chúng tự chúng không tạo chủ sở hữu, phê duyệt yêu cầu ghép đôi, hoặc cấp quyền công cụ.
  • dmPolicy: "open" vẫn yêu cầu "*" trong danh sách cho phép DM hiệu lực. Tham chiếu một nhóm truy cập không tương đương với truy cập công khai.
  • Tên nhóm bị thiếu sẽ đóng khi thất bại. Nếu allowFrom chứa accessGroup:operators và không có accessGroups.operators, mục đó không ủy quyền cho ai.
  • Giữ id kênh ổn định. Ưu tiên id số/người dùng hơn tên hiển thị khi kênh hỗ trợ cả hai.

​
Khắc phục sự cố

Nếu một người gửi đáng ra phải khớp nhưng bị chặn:
  1. Xác nhận trường danh sách cho phép chứa tham chiếu accessGroup:<name> chính xác.
  2. Xác nhận accessGroups.<name>.type là đúng.
  3. Xác nhận id người gửi được liệt kê dưới khóa kênh khớp, hoặc dưới "*".
  4. Xác nhận mục dùng cú pháp danh sách cho phép thông thường của kênh đó.
  5. Với đối tượng kênh Discord, xác nhận bot có thể thấy kênh guild và đã bật Ý định Thành viên Máy chủ.
Chạy openclaw doctor sau khi chỉnh sửa cấu hình kiểm soát truy cập. Lệnh này phát hiện nhiều tổ hợp danh sách cho phép và chính sách không hợp lệ trước runtime.