배경
원리 소개
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 App(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
다음 패키지를 설치해야 합니다:
weixin-acp@0.6.0
계속 진행하시겠습니까? (y) y
npm warn deprecated @zed-industries/claude-agent-acp@0.23.1: 이 패키지의 이름이 @agentclientprotocol/claude-agent-acp로 변경되었습니다. 계속 업데이트를 받으려면 마이그레이션하세요.
로그인 정보가 감지되지 않았습니다. 먼저 QR 코드를 스캔하여 WeChat에 로그인하세요
WeChat QR 코드 로그인을 시작하는 중...
연결을 완료하려면 다음 QR 코드를 WeChat으로 스캔하세요:
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
█ ▄▄▄▄▄ █▀ █▀▀█▀▀▄▀ ▄▄▄▀▄█▀ ▀▀█ ▄▄▄▄▄ █
█ █ █ █▀ ▄ █▀▄ ▀▀▀▄▄▄▀█▄█ █▄█ █ █ █
█ █▄▄▄█ █▀█ █▄▄ ▀ ▀█▄ ▄█▄▄▀▀▀▀█ █▄▄▄█ █
█▄▄▄▄▄▄▄█▄█▄█ █ ▀▄█ █ ▀ ▀ █ ▀▄█▄▄▄▄▄▄▄█
█▄ ▄█▄▄▄▄▄█▄▄▀█ ▄▄▀▄▀▄▀▄ ▄▄ ▄█ █ ▀ ██
█ ▄██▀█▄ ███ ▄▄▀ ▀█▄█▄▀▀█▀█▀▄ ▀▀ █ ▄▀▄█
█ ▄▀ ▄▄▄▄█ ▄▀▀█▄ ▄▄▀▄▀▀▀▀█ ██ ▄▀▄▄ ▀▄█
██▀▄█▀▀▄█▄▀██▀ ▄▄ ▄▀▀▀ ███▀ █▀ ▄▀▄▄ █
█ ▄█▄▄▀▄▀█ ██▄█▄▀ ▄▀▀▀▀▄▀▀▄ █▀▄▄ ▄▄ ▀▄█
█▄ █ ▀▄▄▀ ▄▀ ▄█▀ ▀▄ █▀▀▄███ ▄ ▀▀▀ █▄▄ █
█ ██▄▀▀▀▀▄▀▀▀▄ ▄▀▀▀▀▀ ▀▄▀█▀▄▄█▄▄ ▄█
█ ▀█ ▄ ▀▄██▀ ▄▄ ▄ ▀▄ ▀███▀▄▄▄███▄█▄ █
█▀ █▄█ ▄▀█▀ █▄█▄█▀▄▀▀▀▀▀▀▄ ▀▄▀█▄ ▄ ▄█
█ ████▀▄▀ ▄ ▄█▀▄██▄█ ▀ █▄▄ ▄▀▄█████▄ █
█▄█████▄█ █ ▄▀▀▀▄▀▄▀▀▄▀▀▀▄▄ ▀ ▄▄▄ █▄███
█ ▄▄▄▄▄ █▄ █▀ ▄▄▀▄▄▀▀ █▀██▀▀ █▄█ ▄█ █
█ █ █ █ ▄██▄█▄▄█▄▄▀▀▀▄ ▄▄ ▄▄ ▄▄▀▀█
█ █▄▄▄█ █ ▄ ▄█▀ ▀▄███ ▀▀▄█▄▀▄▀ ███▄ █
█▄▄▄▄▄▄▄█▄▄█▄███▄▄▄▄▄▄███▄▄▄██▄▄██▄▄▄▄█
QR 코드 스캔을 기다리는 중...
✅ WeChat 연결 성공!
[weixin] 봇 시작, account=b0a5baab53cc-im-bot
[weixin] 모니터링 시작됨 (https://ilinkai.weixin.qq.com, account=b0a5baab53cc-im-bot)
[weixin] 이전 동기화 버퍼 없음, 새로 시작합니다
[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) 프로필 사진을 클릭해 대화창으로 들어간 다음, "너는 누구야"와 같은 메시지를 입력합니다. 정상적으로 응답하면 설치가 성공한 것입니다.
첫 대화는 응답 시간이 다소 길 수 있으며, 이후에는 정상적으로 빨라집니다.