Sebastian Petrus

Posted on Mar 25 • Originally published at apidog.com

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

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

Dùng thử Apidog ngay hôm nay

Giới thiệu

Chạy một trợ lý AI trên WeChat thường đòi hỏi đăng ký API tốn kém, cấu hình phức tạp hoặc tài khoản doanh nghiệp. Với OpenClaw, mọi thứ đơn giản hơn rất nhiều.

Plugin @tencent-weixin/openclaw-weixin cho phép bạn kết nối tài khoản WeChat cá nhân với OpenClaw AI gateway chỉ bằng vài bước. Không cần tài khoản doanh nghiệp, không phí duy trì. Quét mã QR xong là có thể dùng ngay.

Bài hướng dẫn này sẽ giúp bạn thiết lập plugin, thêm nhiều tài khoản, cô lập ngữ cảnh hội thoại, để biến WeChat thành một trợ lý AI thực thụ trên OpenClaw.

💡Nếu bot WeChat của bạn cần gọi các API bên ngoài (thời tiết, thanh toán, CRM), bạn sẽ cần một công cụ kiểm thử API. Hãy dùng thử Apidog Free để thiết kế, kiểm thử và tạo tài liệu API của bạn trước khi kết nối chúng với bot của mình.

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

Đã cài OpenClaw (phiên bản >=2026.3.22 cho plugin v2.0.x)
CLI openclaw có sẵn trong terminal
Tài khoản WeChat cá nhân hợp lệ
Node.js đã được cài đặt (để dùng trình cài đặt 1 cú nhấp)

Kiểm tra phiên bản OpenClaw:

openclaw --version

Nếu phiên bản cũ, cần cập nhật lên >=2026.3.22 trước khi cài plugin v2.0.x.

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

Phiên bản Plugin	Phiên bản OpenClaw	Trạng thái
2.0.x	`>=2026.3.22`	Hoạt động
1.0.x	`>=2026.1.0 <2026.3.22`	Bảo trì

Nếu phiên bản OpenClaw không tương thích, plugin sẽ từ chối tải khi khởi động.

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

Lệnh này tự động cài đặt plugin, cấu hình và khởi tạo hoàn toàn.

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

Cài đặt plugin:

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

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

Đăng nhập bằng tài khoản WeChat:

openclaw channels login --channel openclaw-weixin

Mã QR sẽ xuất hiện trong terminal. Bật WeChat trên điện thoại, quét mã QR, xác nhận ủy quyền.

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

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

Sau khi đã ủy quyền, khởi động lại gateway để plugin hoạt động:

openclaw gateway restart

Sau bước này, tài khoản WeChat đã kết nối với OpenClaw. Mọi tin nhắn đến sẽ do AI xử lý.

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

Để thêm tài khoản WeChat khác, lặp lại lệnh đăng nhập:

openclaw channels login --channel openclaw-weixin

Mỗi lần quét tương ứng một tài khoản mới. Các tài khoản hoạt động song song, 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)

Mặc định, tất cả các kênh chung một ngữ cảnh AI. Để mỗi tài khoản WeChat có bộ nhớ AI riêng:

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

Mỗi cặp "tài khoản WeChat + liên hệ" sẽ có bộ nhớ độc lập, hội thoại không bị lẫn.

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

Header Xác thực

Các API của plugin dùng các header sau:

Header	Giá trị
`Content-Type`	`application/json`
`AuthorizationType`	`ilink_bot_token`
`Authorization`	`Bearer <token>`
`X-WECHAT-UIN`	Uint32 ngẫu nhiên, base64

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

Điểm cuối	Đường dẫn	Mục đích
getUpdates	`getupdates`	Long-poll nhận tin nhắn mới
sendMessage	`sendmessage`	Gửi văn bản/ảnh/video/tệp
getUploadUrl	`getuploadurl`	Lấy URL upload CDN
getConfig	`getconfig`	Lấy cấu hình tài khoản
sendTyping	`sendtyping`	Hiển thị/ẩn typing

Nhận tin nhắn (Long Polling)

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

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

Luôn truyền lại get_updates_buf để chỉ nhận 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

Loại	Giá trị
TEXT	1
IMAGE	2
VOICE	3
FILE	4
VIDEO	5

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

Gọi getUploadUrl với metadata file
Nhận URL upload CDN đã ký
Mã hóa file bằng AES-128-ECB
Upload lên CDN
Gửi tham chiếu file qua 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 không load

Khắc phục: Kiểm tra và cập nhật OpenClaw:

openclaw --version
# Nếu lỗi thời, cập nhật OpenClaw

Mã QR hết hạn

Lỗi: Mã QR quá hạn trước khi quét

Khắc phục: Chạy lại lệnh đăng nhập (QR có hạn ~30 giây):

openclaw channels login --channel openclaw-weixin

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

Lỗi: WeChat không chuyển tin về OpenClaw

Khắc phục: Khởi động lại gateway:

openclaw gateway restart

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

Lỗi: AI phản hồi sai tài khoản

Khắc phục: Bật cô lập ngữ cảnh theo kênh:

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

DEV Community