Bối cảnh
Giới thiệu nguyên lý
Plugin WeChat ClawBot (cộng đồng còn gọi là "plugin tôm hùm") là kênh Bot cho tài khoản cá nhân do Tencent WeChat chính thức ra mắt vào tháng 3 năm 2026, với nền tảng dựa trên giao thức iLink (智联) chính thức.
Plugin này cho phép bạn kết nối hợp pháp AI Agent (như OpenClaw, Codex, Claude Code, v.v.) với tài khoản WeChat cá nhân. Trong danh sách trò chuyện sẽ xuất hiện thêm một liên hệ "ClawBot" để bạn trò chuyện trực tiếp.
Thực chất nó là gì
Bản chất:
Một plugin chính thức được tích hợp trong WeChat + kênh chuyển tiếp tin nhắn iLink trên đám mây (tên miền ilinkai.weixin.qq.com), không phải giao thức đảo ngược của bên thứ ba.
Chức năng:
Chỉ chịu trách nhiệm chuyển tiếp tin nhắn: chuyển văn bản/hình ảnh/tệp bạn gửi cho ClawBot đến chương trình AI cục bộ của bạn (OpenClaw/Codex/Claude code, v.v.) thông qua giao thức iLink, sau đó gửi phản hồi của AI trở lại WeChat. Khả năng AI do phần backend của bạn cung cấp; bản thân ClawBot không tích hợp mô hình.
Đường dẫn: ứng dụng WeChat (iOS/Android ≥ v8.0.70, đang phát hành theo từng đợt) → Tôi → Cài đặt → Plugin → ClawBot
Mục đích:
教程 này không sử dụng OpenClaw làm trung gian, mà liên kết trực tiếp codex với WeChat trên nền tảng plugin ClawBot.
Chuẩn bị
- Nodejs
- Codex
- codex-acp
- weixin-acp
Các bước cài đặt
1 Cài đặt nodejs
Tải nodejs tại: https://nodejs.org/zh-cn/download/
2 Cài đặt codex
Mở cửa sổ dòng lệnh CMD, nhập lệnh sau rồi nhấn Enter để tự động cài đặt codex.
# Tải xuống chính thức
npm install -g @openai/codex
Tham khảo hướng dẫn chi tiết tại bài viết: 《》.
3 Cài đặt codex-acp
Mở cửa sổ dòng lệnh CMD, nhập lệnh sau rồi nhấn Enter để cài đặt codex-acp.
codex-acp có chức năng đóng gói Codex CLI thành tiến trình theo tiêu chuẩn ACP (Agent Client Protocol) để giao tiếp với weixin-acp.
# 1. Cài đặt toàn cục bộ điều hợp Codex ACP
npm install -g @zed-industries/codex-acp
4 Khởi động cầu nối weixin-acp
Mở cửa sổ dòng lệnh CMD, nhập lệnh sau rồi nhấn Enter để khởi động cầu nối weixin-acp.
# 2. Khởi động cầu nối WeChat ClawBot (tự động khởi chạy tiến trình con codex-acp)
npx weixin-acp start -- codex-acp
5 Quét mã QR WeChat để liên kết clawbot
Thiết bị đầu cuối sẽ hiển thị mã QR WeChat → dùng WeChat trên điện thoại để quét → xác nhận cấp quyền.
D:\tools>npx weixin-acp start -- codex-acp
Need to install the following packages:
weixin-acp@0.6.0
Ok to proceed? (y) y
npm warn deprecated @zed-industries/claude-agent-acp@0.23.1: This package has been renamed to @agentclientprotocol/claude-agent-acp. Please migrate to continue receiving updates.
未检测到登录信息，请先扫码登录微信
正在启动微信扫码登录...
使用微信扫描以下二维码，以完成连接：
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
█ ▄▄▄▄▄ █▀ █▀▀█▀▀▄▀ ▄▄▄▀▄█▀ ▀▀█ ▄▄▄▄▄ █
█ █ █ █▀ ▄ █▀▄ ▀▀▀▄▄▄▀█▄█ █▄█ █ █ █
█ █▄▄▄█ █▀█ █▄▄ ▀ ▀█▄ ▄█▄▄▀▀▀▀█ █▄▄▄█ █
█▄▄▄▄▄▄▄█▄█▄█ █ ▀▄█ █ ▀ ▀ █ ▀▄█▄▄▄▄▄▄▄█
█▄ ▄█▄▄▄▄▄█▄▄▀█ ▄▄▀▄▀▄▀▄ ▄▄ ▄█ █ ▀ ██
█ ▄██▀█▄ ███ ▄▄▀ ▀█▄█▄▀▀█▀█▀▄ ▀▀ █ ▄▀▄█
█ ▄▀ ▄▄▄▄█ ▄▀▀█▄ ▄▄▀▄▀▀▀▀█ ██ ▄▀▄▄ ▀▄█
██▀▄█▀▀▄█▄▀██▀ ▄▄ ▄▀▀▀ ███▀ █▀ ▄▀▄▄ █
█ ▄█▄▄▀▄▀█ ██▄█▄▀ ▄▀▀▀▀▄▀▀▄ █▀▄▄ ▄▄ ▀▄█
█▄ █ ▀▄▄▀ ▄▀ ▄█▀ ▀▄ █▀▀▄███ ▄ ▀▀▀ █▄▄ █
█ ██▄▀▀▀▀▄▀▀▀▄ ▄▀▀▀▀▀ ▀▄▀█▀▄▄█▄▄ ▄█
█ ▀█ ▄ ▀▄██▀ ▄▄ ▄ ▀▄ ▀███▀▄▄▄███▄█▄ █
█▀ █▄█ ▄▀█▀ █▄█▄█▀▄▀▀▀▀▀▀▄ ▀▄▀█▄ ▄ ▄█
█ ████▀▄▀ ▄ ▄█▀▄██▄█ ▀ █▄▄ ▄▀▄█████▄ █
█▄█████▄█ █ ▄▀▀▀▄▀▄▀▀▄▀▀▀▄▄ ▀ ▄▄▄ █▄███
█ ▄▄▄▄▄ █▄ █▀ ▄▄▀▄▄▀▀ █▀██▀▀ █▄█ ▄█ █
█ █ █ █ ▄██▄█▄▄█▄▄▀▀▀▄ ▄▄ ▄▄ ▄▄▀▀█
█ █▄▄▄█ █ ▄ ▄█▀ ▀▄███ ▀▀▄█▄▀▄▀ ███▄ █
█▄▄▄▄▄▄▄█▄▄█▄███▄▄▄▄▄▄███▄▄▄██▄▄██▄▄▄▄█
等待扫码...
✅ 与微信连接成功！
[weixin] 启动 bot, account=b0a5baab53cc-im-bot
[weixin] monitor started (https://ilinkai.weixin.qq.com, account=b0a5baab53cc-im-bot)
[weixin] no previous sync buf, starting fresh
[weixin] config cached for o8cq904eE-n35QmeWzLBueMLWaoQ@im.wechat
[acp] spawning: codex-acp
[acp] initializing connection...
[acp] connection initialized
Sau khi liên kết thành công, danh sách trò chuyện WeChat sẽ xuất hiện liên hệ ClawBot / AI Agent. Tin nhắn gửi đến sẽ được Codex cục bộ xử lý và phản hồi.
6 Kiểm tra trợ lý AI đã cài đặt thành công
Trên WeChat, nhấn vào ảnh đại diện WeChat clawbot (AI) để vào khung trò chuyện, sau đó nhập một câu hỏi, chẳng hạn như "Bạn là ai". Nếu nhận được phản hồi bình thường thì quá trình cài đặt đã thành công.
Thời gian phản hồi trong lần trò chuyện đầu tiên có thể hơi lâu; những lần sau sẽ trở lại bình thường.