Chuyển đến nội dung chính

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.

OpenClaw kết nối với WeChat thông qua Plugin kênh bên ngoài @tencent-weixin/openclaw-weixin của Tencent. Trạng thái: Plugin bên ngoài. Trò chuyện trực tiếp và phương tiện được hỗ trợ. Trò chuyện nhóm không được siêu dữ liệu năng lực Plugin hiện tại công bố.

Đặt tên

  • WeChat là tên hiển thị với người dùng trong các tài liệu này.
  • Weixin là tên được gói của Tencent và id Plugin sử dụng.
  • openclaw-weixin là id kênh OpenClaw.
  • @tencent-weixin/openclaw-weixin là gói npm.
Dùng openclaw-weixin trong các lệnh CLI và đường dẫn cấu hình.

Cách hoạt động

Mã WeChat không nằm trong repo lõi OpenClaw. OpenClaw cung cấp hợp đồng Plugin kênh chung, còn Plugin bên ngoài cung cấp runtime riêng cho WeChat:
  1. openclaw plugins install cài đặt @tencent-weixin/openclaw-weixin.
  2. Gateway phát hiện manifest Plugin và tải entrypoint của Plugin.
  3. Plugin đăng ký id kênh openclaw-weixin.
  4. openclaw channels login --channel openclaw-weixin bắt đầu đăng nhập bằng QR.
  5. Plugin lưu thông tin xác thực tài khoản trong thư mục trạng thái OpenClaw.
  6. Khi Gateway khởi động, Plugin khởi động bộ giám sát Weixin cho từng tài khoản đã cấu hình.
  7. Tin nhắn WeChat đến được chuẩn hóa thông qua hợp đồng kênh, định tuyến đến agent OpenClaw đã chọn, rồi được gửi lại qua đường gửi đi của Plugin.
Sự tách biệt đó rất quan trọng: lõi OpenClaw phải không phụ thuộc vào kênh. Đăng nhập WeChat, lệnh gọi Tencent iLink API, tải lên/tải xuống phương tiện, mã thông báo ngữ cảnh và giám sát tài khoản thuộc trách nhiệm của Plugin bên ngoài.

Cài đặt

Cài đặt nhanh:
npx -y @tencent-weixin/openclaw-weixin-cli install
Cài đặt thủ công:
openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true
Khởi động lại Gateway sau khi cài đặt:
openclaw gateway restart

Đăng nhập

Chạy đăng nhập QR trên cùng máy đang chạy Gateway:
openclaw channels login --channel openclaw-weixin
Quét mã QR bằng WeChat trên điện thoại của bạn và xác nhận đăng nhập. Plugin lưu mã thông báo tài khoản cục bộ sau khi quét thành công. Để thêm tài khoản WeChat khác, chạy lại cùng lệnh đăng nhập. Với nhiều tài khoản, hãy cô lập phiên tin nhắn trực tiếp theo tài khoản, kênh và người gửi:
openclaw config set session.dmScope per-account-channel-peer

Kiểm soát truy cập

Tin nhắn trực tiếp dùng mô hình ghép nối và danh sách cho phép OpenClaw thông thường cho các Plugin kênh. Phê duyệt người gửi mới:
openclaw pairing list openclaw-weixin
openclaw pairing approve openclaw-weixin <CODE>
Để xem đầy đủ mô hình kiểm soát truy cập, hãy xem Ghép nối.

Tương thích

Plugin kiểm tra phiên bản OpenClaw của host khi khởi động.
Dòng PluginPhiên bản OpenClawthẻ npm
2.x>=2026.3.22latest
1.x>=2026.1.0 <2026.3.22legacy
Nếu Plugin báo rằng phiên bản OpenClaw của bạn quá cũ, hãy cập nhật OpenClaw hoặc cài đặt dòng Plugin cũ:
openclaw plugins install @tencent-weixin/openclaw-weixin@legacy

Tiến trình phụ

Plugin WeChat có thể chạy công việc trợ giúp bên cạnh Gateway trong khi giám sát Tencent iLink API. Trong issue #68451, đường dẫn trợ giúp đó đã làm lộ một lỗi trong quy trình dọn dẹp Gateway cũ chung của OpenClaw: một tiến trình con có thể cố dọn dẹp tiến trình Gateway cha, gây vòng lặp khởi động lại dưới các trình quản lý tiến trình như systemd. Quy trình dọn dẹp khi khởi động hiện tại của OpenClaw loại trừ tiến trình hiện tại và các tiến trình tổ tiên của nó, vì vậy trình trợ giúp kênh không được giết Gateway đã khởi chạy nó. Bản sửa lỗi này là chung; nó không phải là đường dẫn riêng cho WeChat trong lõi.

Khắc phục sự cố

Kiểm tra cài đặt và trạng thái:
openclaw plugins list
openclaw channels status --probe
openclaw --version
Nếu kênh hiển thị là đã cài đặt nhưng không kết nối, hãy xác nhận rằng Plugin đã được bật rồi khởi động lại:
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw gateway restart
Nếu Gateway khởi động lại liên tục sau khi bật WeChat, hãy cập nhật cả OpenClaw và Plugin:
npm view @tencent-weixin/openclaw-weixin version
openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
openclaw gateway restart
Tạm thời tắt:
openclaw config set plugins.entries.openclaw-weixin.enabled false
openclaw gateway restart

Tài liệu liên quan