Cách Sử Dụng OpenClaw Với WeChat Miễn Phí

TL;DR: Kết nối OpenClaw với WeChat bằng cách cài đặt plugin @tencent-weixin/openclaw-weixin, quét mã QR để ủy quyền tài khoản của bạn và khởi động lại cổng kết nối. Toàn bộ quá trình thiết lập chỉ mất chưa đầy 5 phút. Plugin này miễn phí, mã nguồn mở và hỗ trợ nhiều tài khoản WeChat cùng lúc.

Giới thiệu

Chạy một trợ lý AI trên WeChat nghe có vẻ phức tạp. Hầu hết các giải pháp đều yêu cầu đăng ký API tốn kém, thiết lập máy chủ phức tạp hoặc tài khoản doanh nghiệp. OpenClaw đã thay đổi điều đó.

Plugin @tencent-weixin/openclaw-weixin kết nối tài khoản WeChat cá nhân của bạn với cổng AI của OpenClaw chỉ trong vài phút. Không cần tài khoản doanh nghiệp. Không phí hàng tháng. Chỉ cần quét mã QR và bạn đã sẵn sàng sử dụng.

Hướng dẫn này sẽ đi sâu vào toàn bộ quá trình thiết lập — từ cài đặt plugin đến xử lý nhiều tài khoản và cô lập các ngữ cảnh hội thoại. Sau cùng, WeChat của bạn sẽ có một trợ lý AI hoạt động đầy đủ chạy trên OpenClaw.

Yêu cầu tiên quyết

Trước khi bắt đầu, bạn cần:

• OpenClaw đã được cài đặt (phiên bản >=2026.3.22 cho plugin v2.0.x)
• openclaw CLI có sẵn trong terminal của bạn
• Một tài khoản WeChat (tài khoản cá nhân hoạt động — không yêu cầu tài khoản doanh nghiệp)
• Node.js đã được cài đặt (để sử dụng công cụ cài đặt một cú nhấp)

Kiểm tra phiên bản OpenClaw của bạn:

openclaw --version

Nếu bạn đang sử dụng phiên bản cũ hơn, hãy cập nhật trước. Plugin v2.0.x yêu cầu OpenClaw >=2026.3.22.

Khả năng tương thích của Plugin

Plugin sẽ kiểm tra phiên bản máy chủ khi khởi động. Nếu phiên bản OpenClaw của bạn không nằm trong phạm vi tương thích, plugin sẽ từ chối tải.

Bước 1: Cài đặt Plugin

Tùy chọn A: Cài đặt một cú nhấp (Khuyến nghị)

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

Thao tác này sẽ xử lý mọi thứ tự động — cài đặt plugin, cấu hình và thiết lập ban đầu.

Tùy chọn B: Cài đặt thủ công

Nếu công cụ cài đặt một cú nhấp không hoạt động trên hệ thống của bạn, hãy cài đặt thủ công:

1. Cài đặt plugin:

openclaw plugins install "@tencent-weixin/openclaw-weixin"

2. Kích hoạt plugin:

openclaw config set plugins.entries.openclaw-weixin.enabled true

Bước 2: Quét mã QR để ủy quyền WeChat

Sau khi cài đặt plugin, hãy đăng nhập bằng tài khoản WeChat của bạn:

openclaw channels login --channel openclaw-weixin

Một mã QR sẽ xuất hiện trong terminal của bạn. Mở WeChat trên điện thoại của bạn, chạm vào biểu tượng quét và quét mã. Xác nhận ủy quyền trên điện thoại của bạn.

Thông tin đăng nhập của bạn được lưu cục bộ tự động. Không cần quét lại trừ khi bạn đăng xuất.

Bước 3: Khởi động lại Cổng kết nối

Sau khi ủy quyền, hãy khởi động lại cổng OpenClaw để kích hoạt plugin:

openclaw gateway restart

Vậy là xong. Tài khoản WeChat của bạn hiện đã được kết nối với OpenClaw. Tin nhắn gửi đến WeChat của bạn sẽ được xử lý bởi tác nhân AI.

Bước 4: Thêm nhiều tài khoản WeChat (Tùy chọn)

OpenClaw hỗ trợ nhiều tài khoản WeChat cùng lúc. Để thêm một tài khoản khác, chỉ cần chạy lại lệnh đăng nhập:

openclaw channels login --channel openclaw-weixin

Mỗi lần quét mã QR sẽ tạo một mục tài khoản mới. Tất cả các tài khoản chạy song song mà không ảnh hưởng lẫn nhau.

Bước 5: Cô lập các ngữ cảnh hội thoại (Tùy chọn)

Theo mặc định, tất cả các kênh chia sẻ cùng một ngữ cảnh hội thoại AI. Điều này có nghĩa là các cuộc hội thoại WeChat của bạn và các kênh khác (Telegram, Discord, v.v.) chia sẻ cùng một bộ nhớ AI.

Nếu bạn muốn mỗi tài khoản WeChat có ngữ cảnh riêng biệt:

openclaw config set agents.mode per-channel-per-peer

Với cài đặt này, mỗi sự kết hợp giữa "tài khoản WeChat + liên hệ" sẽ có bộ nhớ AI độc lập riêng. Các cuộc hội thoại giữa các tài khoản khác nhau sẽ không bị lẫn vào nhau.

Cách Plugin hoạt động bên dưới

Đối với các nhà phát triển muốn hiểu hoặc mở rộng plugin, đây là cách nó giao tiếp với cổng OpenClaw.

Header Xác thực

Tất cả các yêu cầu API đều sử dụng các header này:

Các điểm cuối API cốt lõi

Plugin sử dụng 5 điểm cuối HTTP JSON:

Nhận tin nhắn (Long Polling)

Plugin sử dụng long polling để nhận tin nhắn:

// Yêu cầu
{
  "get_updates_buf": ""
}

// Phản hồi
{
  "ret": 0,
  "msgs": [...],
  "get_updates_buf": "<new_cursor>",
  "longpolling_timeout_ms": 35000
}

Truyền con trỏ get_updates_buf trở lại trong mỗi yêu cầu tiếp theo để chỉ nhận các tin nhắn mới.

Gửi tin nhắn

{
  "msg": {
    "to_user_id": "<target_user_id>",
    "context_token": "<session_context_token>",
    "item_list": [
      {
        "type": 1,
        "text_item": { "text": "Xin chào!" }
      }
    ]
  }
}

Các loại tin nhắn

Tải lên phương tiện (Ảnh, Tệp, Video)

Các tệp phương tiện được mã hóa bằng AES-128-ECB trước khi tải lên. Quy trình:

1. Gọi getUploadUrl với siêu dữ liệu tệp (kích thước, MD5)
2. Nhận các tham số tải lên CDN đã được ký trước
3. Mã hóa tệp bằng AES-128-ECB
4. Tải lên CDN bằng URL đã được ký trước
5. Tham chiếu tệp CDN trong sendMessage

Các vấn đề thường gặp và cách khắc phục

Plugin từ chối tải

Lỗi: Plugin từ chối tải khi khởi động

Khắc phục: Kiểm tra phiên bản OpenClaw của bạn. Plugin v2.0.x yêu cầu >=2026.3.22.

openclaw --version
# Nếu đã lỗi thời, hãy cập nhật OpenClaw trước

Mã QR hết hạn

Lỗi: Mã QR hết thời gian trước khi quét

Khắc phục: Chạy lại lệnh đăng nhập. Mã QR hết hạn sau khoảng 30 giây.

openclaw channels login --channel openclaw-weixin

Tin nhắn không được nhận

Lỗi: Tin nhắn WeChat không đến được OpenClaw

Khắc phục: Khởi động lại cổng kết nối sau khi đăng nhập.

openclaw gateway restart

Nhiều tài khoản bị trộn lẫn ngữ cảnh

Lỗi: Phản hồi AI từ tài khoản này xuất hiện trong tài khoản khác

Khắc phục: Kích hoạt tính năng cô lập ngữ cảnh cho mỗi kênh.

openclaw config set agents.mode per-channel-per-peer