OpenClaw kết nối với WeChat thông qua Plugin kênh bên ngoàiDocumentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
@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
metadata năng lực Plugin hiện tại quảng bá.
Cách đặ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-weixinlà id kênh OpenClaw.@tencent-weixin/openclaw-weixinlà gói npm.
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 dành riêng cho WeChat:openclaw plugins installcài đặt@tencent-weixin/openclaw-weixin.- Gateway phát hiện manifest Plugin và tải entrypoint của Plugin.
- Plugin đăng ký id kênh
openclaw-weixin. openclaw channels login --channel openclaw-weixinbắt đầu đăng nhập bằng QR.- Plugin lưu thông tin xác thực tài khoản trong thư mục trạng thái OpenClaw.
- Khi Gateway khởi động, Plugin khởi động trình giám sát Weixin cho từng tài khoản đã cấu hình.
- Tin nhắn WeChat đến được chuẩn hóa thông qua hợp đồng kênh, được định tuyến đến tác tử OpenClaw đã chọn, rồi được gửi lại qua đường dẫn gửi ra của Plugin.
Cài đặt
Cài đặt nhanh:Đăng nhập
Chạy đăng nhập bằng QR trên cùng máy đang chạy Gateway: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 Plugin kênh. Phê duyệt người gửi mới:Tương thích
Plugin kiểm tra phiên bản OpenClaw của máy chủ khi khởi động.| Dòng Plugin | Phiên bản OpenClaw | Thẻ npm |
|---|---|---|
2.x | >=2026.3.22 | latest |
1.x | >=2026.1.0 <2026.3.22 | legacy |
Tiến trình sidecar
Plugin WeChat có thể chạy công việc trợ giúp bên cạnh Gateway trong khi giám sát API Tencent iLink. Trong issue #68451, đường dẫn trợ giúp đó làm lộ một lỗi trong cơ chế dọn dẹp Gateway cũ chung của OpenClaw: một tiến trình con có thể cố gắng 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. Cơ chế 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 một trình trợ giúp kênh không được giết Gateway đã khởi chạy nó. Bản sửa này là chung; đây không phải là đường dẫn dành riêng cho WeChat trong lõi.Khắc phục sự cố
Kiểm tra cài đặt và trạng thái:requires compiled runtime output for TypeScript entry, gói npm đã được phát hành mà không có các tệp runtime
JavaScript đã biên dịch mà OpenClaw cần. Hãy cập nhật/cài đặt lại sau khi nhà phát hành Plugin
phát hành gói đã sửa, hoặc tạm thời tắt/gỡ cài đặt Plugin.
Tạm thời tắt:
Tài liệu liên quan
- Tổng quan kênh: Kênh trò chuyện
- Ghép nối: Ghép nối
- Định tuyến kênh: Định tuyến kênh
- Kiến trúc Plugin: Kiến trúc Plugin
- SDK Plugin kênh: SDK Plugin kênh
- Gói bên ngoài: @tencent-weixin/openclaw-weixin