Ghép nối

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.

1. Ghép nối DM (ai được phép trò chuyện với bot)
2. Ghép nối Node (thiết bị/Node nào được phép tham gia mạng Gateway)

​

1) Ghép nối DM (quyền truy cập trò chuyện đến)

• 8 ký tự, chữ hoa, không có ký tự dễ nhầm lẫn (0O1I).
• Hết hạn sau 1 giờ. Bot chỉ gửi tin nhắn ghép nối khi một yêu cầu mới được tạo (xấp xỉ mỗi giờ một lần cho mỗi người gửi).
• Các yêu cầu ghép nối DM đang chờ được giới hạn mặc định ở 3 yêu cầu cho mỗi kênh; các yêu cầu bổ sung sẽ bị bỏ qua cho đến khi một yêu cầu hết hạn hoặc được phê duyệt.

​

Phê duyệt người gửi

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

​

Nhóm người gửi có thể tái sử dụng

{
  accessGroups: {
    operators: {
      type: "message.senders",
      members: {
        discord: ["discord:123456789012345678"],
        telegram: ["987654321"],
        whatsapp: ["+15551234567"],
      },
    },
  },
  channels: {
    telegram: { dmPolicy: "allowlist", allowFrom: ["accessGroup:operators"] },
    whatsapp: { groupPolicy: "allowlist", groupAllowFrom: ["accessGroup:operators"] },
  },
}

​

Trạng thái được lưu ở đâu

• Yêu cầu đang chờ: <channel>-pairing.json
• Kho danh sách cho phép đã phê duyệt:
  • Tài khoản mặc định: <channel>-allowFrom.json
  • Tài khoản không mặc định: <channel>-<accountId>-allowFrom.json

• Tài khoản không mặc định chỉ đọc/ghi tệp danh sách cho phép theo phạm vi của chúng.
• Tài khoản mặc định dùng tệp danh sách cho phép không phạm vi theo kênh.

​

2) Ghép nối thiết bị Node (Node iOS/Android/macOS/headless)

​

Ghép nối qua Telegram (khuyến nghị cho iOS)

1. Trong Telegram, nhắn cho bot của bạn: /pair
2. Bot trả lời bằng hai tin nhắn: một tin nhắn hướng dẫn và một tin nhắn mã thiết lập riêng (dễ sao chép/dán trong Telegram).
3. Trên điện thoại, mở ứng dụng OpenClaw iOS → Settings → Gateway.
4. Quét mã QR hoặc dán mã thiết lập rồi kết nối.
5. Quay lại Telegram: /pair pending (xem lại ID yêu cầu, vai trò và phạm vi), rồi phê duyệt.

• url: URL WebSocket của Gateway (ws://... hoặc wss://...)
• bootstrapToken: token khởi tạo ngắn hạn cho một thiết bị, dùng cho bắt tay ghép nối ban đầu

• token node chính được bàn giao vẫn là scopes: []
• mọi token operator được bàn giao vẫn bị giới hạn trong danh sách cho phép khởi tạo: operator.approvals, operator.read, operator.talk.secrets, operator.write
• kiểm tra phạm vi khởi tạo được tiền tố theo vai trò, không phải một nhóm phạm vi phẳng: các mục phạm vi operator chỉ đáp ứng yêu cầu operator, và các vai trò không phải operator vẫn phải yêu cầu phạm vi dưới tiền tố vai trò của chính chúng
• việc xoay vòng/thu hồi token sau này vẫn bị giới hạn bởi cả hợp đồng vai trò đã phê duyệt của thiết bị và phạm vi operator của phiên gọi

​

Phê duyệt thiết bị Node

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

​

Tùy chọn tự động phê duyệt Node theo CIDR đáng tin cậy

{
  gateway: {
    nodes: {
      pairing: {
        autoApproveCidrs: ["192.168.1.0/24"],
      },
    },
  },
}

​

Lưu trữ trạng thái ghép nối Node

• pending.json (ngắn hạn; yêu cầu đang chờ sẽ hết hạn)
• paired.json (thiết bị đã ghép nối + token)

​

Ghi chú

• API node.pair.* cũ (CLI: openclaw nodes pending|approve|reject|remove|rename) là một kho ghép nối riêng do gateway sở hữu. Node WS vẫn cần ghép nối thiết bị.
• Bản ghi ghép nối là nguồn chân lý bền vững cho các vai trò đã phê duyệt. Token thiết bị đang hoạt động vẫn bị giới hạn trong tập vai trò đã phê duyệt đó; một mục token lạc nằm ngoài các vai trò đã phê duyệt không tạo quyền truy cập mới.

​

Tài liệu liên quan

• Mô hình bảo mật + prompt injection: Bảo mật
• Cập nhật an toàn (chạy doctor): Cập nhật
• Cấu hình kênh:
  • Telegram: Telegram
  • WhatsApp: WhatsApp
  • Signal: Signal
  • iMessage: iMessage
  • Discord: Discord
  • Slack: Slack