Ghép nối

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.

1. Ghép nối DM (ai được phép nói chuyện với bot)
2. Ghép nối Node (thiết bị/nút 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ột lần mỗi giờ 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 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 một người gửi

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

​

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

• Yêu cầu đang chờ: <channel>-pairing.json
• Kho allowlist đã 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 allowlist có phạm vi riêng của chúng.
• Tài khoản mặc định dùng tệp allowlist không có phạm vi riêng theo kênh.

​

2) Ghép nối thiết bị Node (nút 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 biệt (dễ sao chép/dán trong Telegram).
3. Trên điện thoại, mở ứng dụng OpenClaw iOS → Settings → Gateway.
4. Dán mã thiết lập và 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 bootstrap ngắn hạn cho một thiết bị, dùng cho handshake ghép nối ban đầu

• token node được bàn giao chính vẫn là scopes: []
• mọi token operator được bàn giao vẫn bị giới hạn trong allowlist bootstrap: operator.approvals, operator.read, operator.talk.secrets, operator.write
• kiểm tra phạm vi bootstrap 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ò riêng của 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ò đã được phê duyệt của thiết bị và các phạm vi operator của phiên gọi

​

Phê duyệt mộ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. Các Node WS vẫn cần ghép nối thiết bị.
• Bản ghi ghép nối là nguồn sự thật bền vững cho các vai trò đã được phê duyệt. Các token thiết bị đang hoạt động vẫn bị giới hạn trong tập vai trò đã được phê duyệt đó; một mục token lạc 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
  • BlueBubbles (iMessage): BlueBubbles
  • iMessage (cũ): iMessage
  • Discord: Discord
  • Slack: Slack