背景
原理简介
微信 ClawBot 插件（社区昵称"龙虾插件"）是腾讯微信官方于 2026 年 3 月推出的个人号 Bot API 通道，底层基于官方 iLink（智联）协议。
它让你可以合法地把 AI Agent（如 OpenClaw、Codex、Claude Code 等）接入微信个人号，聊天列表会多出一个"ClawBot"联系人，直接对话即可。
它到底是什么
本质：
微信内置的一个官方插件 + 云端 iLink 消息中继通道（域名 ilinkai.weixin.qq.com），不是第三方逆向协议。
作用：
只负责消息透传——把你发给 ClawBot 的文字/图片/文件通过 iLink 协议转发给你的本地 AI 程序（OpenClaw/Codex/Claude code等），AI 的回复再通过它发回微信。AI 能力由你后端提供，ClawBot 本身不带模型。
入口：微信 App（iOS/Android ≥ v8.0.70，灰度放量）→ 我 → 设置 → 插件 → ClawBot
目的：
本教程不使用 OpenClaw 中转，而是直接把codex在 ClawBot插件基础上绑定微信。
前置准备
- Nodejs
- Codex
- codex-acp
- weixin-acp
安装步骤
1 安装nodejs
下载nodejs，下载地址：https://nodejs.org/zh-cn/download/
2 安装codex
打开CMD命令行窗口，输入以下命令，敲Enter回车，自动安装codex。
# 官方下载
npm install -g @openai/codex
详细教程参考文章：《》。
3 安装codex-acp
打开CMD命令行窗口，输入以下命令，敲Enter回车，安装codex-acp
codex-acp 作用把 Codex CLI 包装为 ACP（Agent Client Protocol）标准进程，与 weixin-acp 通信。
# 1. 全局安装 Codex ACP 适配器
npm install -g @zed-industries/codex-acp
4 启动weixin-acp桥接
打开CMD命令行窗口，输入以下命令，敲Enter回车，启动weixin-acp桥接
# 2. 启动微信 ClawBot 桥接（自动拉起 codex-acp 子进程）
npx weixin-acp start -- codex-acp
5 微信扫码绑定clawbot
终端会显示微信二维码 → 用手机微信扫 → 确认授权。
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
绑定成功后微信聊天列表出现 ClawBot / AI Agent 这个联系人，发消息即由本地 Codex 处理回复。
6 验证AI助手是否安装成功
在微信上，点击微信clawbot（AI）头像，进入聊天框，输入对话，比如"你是谁"，如果正常回复消息，说明安装成功。
第一次对话，反应时间会有点长，后期时间会正常。