
背景
仕組みの概要
WeChat ClawBotプラグイン(コミュニティでの通称「ロブスタープラグイン」)は、Tencent WeChat公式が2026年3月に提供開始した個人アカウント向けBot APIチャンネルで、基盤には公式のiLink(智聯)プロトコルを採用しています。
これにより、AI Agent(OpenClaw、Codex、Claude Codeなど)を合法的にWeChat個人アカウントへ接続できます。チャット一覧に「ClawBot」という連絡先が追加され、直接会話できるようになります。
実際には何なのか
本質:
WeChatに組み込まれた公式プラグインと、クラウド上のiLinkメッセージ中継チャンネル(ドメイン:ilinkai.weixin.qq.com)です。サードパーティ製のリバースエンジニアリングプロトコルではありません。
役割:
メッセージの転送だけを担当します。ClawBotに送ったテキスト・画像・ファイルを、iLinkプロトコル経由でローカルのAIプログラム(OpenClaw/Codex/Claude codeなど)へ転送し、AIの返信をWeChatへ送り返します。AIの機能はバックエンド側が提供するもので、ClawBot自体にモデルは搭載されていません。
入口:WeChatアプリ(iOS/Android ≥ v8.0.70、段階的に提供)→ 自分 → 設定 → プラグイン → ClawBot
目的:
このチュートリアルではOpenClawの中継を使わず、ClawBotプラグインをベースにCodexをWeChatへ直接連携します。
事前準備
- 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. WeChat ClawBotブリッジを起動(codex-acpの子プロセスを自動起動)
npx weixin-acp start -- codex-acp
5 WeChatでQRコードをスキャンしてclawbotに連携
ターミナルにWeChatのQRコードが表示されます。スマートフォンのWeChatでスキャンし、認証を確認してください。
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.
ログイン情報が検出されません。先にQRコードをスキャンしてWeChatにログインしてください
WeChatのQRコードログインを開始しています...
接続を完了するには、以下のQRコードをWeChatでスキャンしてください:
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
█ ▄▄▄▄▄ █▀ █▀▀█▀▀▄▀ ▄▄▄▀▄█▀ ▀▀█ ▄▄▄▄▄ █
█ █ █ █▀ ▄ █▀▄ ▀▀▀▄▄▄▀█▄█ █▄█ █ █ █
█ █▄▄▄█ █▀█ █▄▄ ▀ ▀█▄ ▄█▄▄▀▀▀▀█ █▄▄▄█ █
█▄▄▄▄▄▄▄█▄█▄█ █ ▀▄█ █ ▀ ▀ █ ▀▄█▄▄▄▄▄▄▄█
█▄ ▄█▄▄▄▄▄█▄▄▀█ ▄▄▀▄▀▄▀▄ ▄▄ ▄█ █ ▀ ██
█ ▄██▀█▄ ███ ▄▄▀ ▀█▄█▄▀▀█▀█▀▄ ▀▀ █ ▄▀▄█
█ ▄▀ ▄▄▄▄█ ▄▀▀█▄ ▄▄▀▄▀▀▀▀█ ██ ▄▀▄▄ ▀▄█
██▀▄█▀▀▄█▄▀██▀ ▄▄ ▄▀▀▀ ███▀ █▀ ▄▀▄▄ █
█ ▄█▄▄▀▄▀█ ██▄█▄▀ ▄▀▀▀▀▄▀▀▄ █▀▄▄ ▄▄ ▀▄█
█▄ █ ▀▄▄▀ ▄▀ ▄█▀ ▀▄ █▀▀▄███ ▄ ▀▀▀ █▄▄ █
█ ██▄▀▀▀▀▄▀▀▀▄ ▄▀▀▀▀▀ ▀▄▀█▀▄▄█▄▄ ▄█
█ ▀█ ▄ ▀▄██▀ ▄▄ ▄ ▀▄ ▀███▀▄▄▄███▄█▄ █
█▀ █▄█ ▄▀█▀ █▄█▄█▀▄▀▀▀▀▀▀▄ ▀▄▀█▄ ▄ ▄█
█ ████▀▄▀ ▄ ▄█▀▄██▄█ ▀ █▄▄ ▄▀▄█████▄ █
█▄█████▄█ █ ▄▀▀▀▄▀▄▀▀▄▀▀▀▄▄ ▀ ▄▄▄ █▄███
█ ▄▄▄▄▄ █▄ █▀ ▄▄▀▄▄▀▀ █▀██▀▀ █▄█ ▄█ █
█ █ █ █ ▄██▄█▄▄█▄▄▀▀▀▄ ▄▄ ▄▄ ▄▄▀▀█
█ █▄▄▄█ █ ▄ ▄█▀ ▀▄███ ▀▀▄█▄▀▄▀ ███▄ █
█▄▄▄▄▄▄▄█▄▄█▄███▄▄▄▄▄▄███▄▄▄██▄▄██▄▄▄▄█
スキャンを待機中...
✅ WeChatとの接続に成功しました!
[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
連携が完了すると、WeChatのチャット一覧にClawBot / AI Agentという連絡先が表示されます。メッセージを送ると、ローカルのCodexが処理して返信します。
6 AIアシスタントが正常にインストールされたか確認
WeChatでWeChatのclawbot(AI)アイコンをタップしてチャット画面を開き、「あなたは誰ですか」などと入力します。正常に返信されれば、インストールは成功です。
初回の会話は応答に少し時間がかかりますが、次回以降は通常の速度になります。
