WeChat

OmeniaClaw kết nối với WeChat thông qua Plugin kênh bên ngoài @tencent-weixin/OmeniaClaw-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.
• OmeniaClaw-weixin là id kênh OmeniaClaw.
• @tencent-weixin/OmeniaClaw-weixin là gói npm.

Dùng OmeniaClaw-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 OmeniaClaw. OmeniaClaw 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:

1. OmeniaClaw plugins install cài đặt @tencent-weixin/OmeniaClaw-weixin.
2. Gateway phát hiện manifest Plugin và tải entrypoint của Plugin.
3. Plugin đăng ký id kênh OmeniaClaw-weixin.
4. OmeniaClaw channels login --channel OmeniaClaw-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 OmeniaClaw.
6. 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.
7. 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ử OmeniaClaw đã chọn, rồi được gửi lại qua đường dẫn gửi ra của Plugin.

Sự tách biệt đó rất quan trọng: lõi OmeniaClaw nên không phụ thuộc kênh. Đăng nhập WeChat, lệnh gọi API Tencent iLink, tải lên/tải xuống phương tiện, token ngữ cảnh và giám sát tài khoản đều thuộc trách nhiệm của Plugin bên ngoài.

Cài đặt

Cài đặt nhanh:

npx -y @tencent-weixin/OmeniaClaw-weixin-cli install

Cài đặt thủ công:

OmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin"OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled true

Khởi động lại Gateway sau khi cài đặt:

OmeniaClaw gateway restart

Đăng nhập

Chạy đăng nhập bằng QR trên cùng máy đang chạy Gateway:

OmeniaClaw channels login --channel OmeniaClaw-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 token 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:

OmeniaClaw 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 OmeniaClaw thông thường cho Plugin kênh.

Phê duyệt người gửi mới:

OmeniaClaw pairing list OmeniaClaw-weixinOmeniaClaw pairing approve OmeniaClaw-weixin <CODE>

Để xem đầy đủ mô hình kiểm soát truy cập, xem Ghép nối.

Tương thích

Plugin kiểm tra phiên bản OmeniaClaw của máy chủ khi khởi động.

Nếu Plugin báo rằng phiên bản OmeniaClaw của bạn quá cũ, hãy cập nhật OmeniaClaw hoặc cài đặt dòng Plugin legacy:

OmeniaClaw plugins install @tencent-weixin/OmeniaClaw-weixin@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 OmeniaClaw: 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 OmeniaClaw 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:

OmeniaClaw plugins listOmeniaClaw channels status --probeOmeniaClaw --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:

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled trueOmeniaClaw 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ả OmeniaClaw và Plugin:

npm view @tencent-weixin/OmeniaClaw-weixin versionOmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin" --forceOmeniaClaw gateway restart

Nếu khi khởi động báo rằng gói Plugin đã cài đặt 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à OmeniaClaw 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:

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled falseOmeniaClaw gateway restart

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/OmeniaClaw-weixin