WeClaw는 WeChat을 AI 에이전트 인터페이스로 쓰게 해주는 브리지다. QR 로그인으로 WeChat 계정을 연결한 뒤 Claude, Codex, Gemini, Kimi, Cursor, OpenCode 같은 에이전트에 채팅 메시지를 라우팅한다.
작동 방식
WeClaw는 로컬에서 실행되며 처음 시작할 때 설치된 AI 에이전트를 자동 감지한다. 에이전트 연결 방식은 세 가지다.
| 모드 | 설명 |
|---|---|
| ACP | 장기 실행 서브프로세스와 JSON-RPC stdio로 통신. 세션 재사용이 가능해 가장 빠른 방식 |
| CLI | 메시지마다 CLI 프로세스를 실행. --resume 같은 세션 재개 옵션 활용 |
| HTTP | OpenAI 호환 Chat Completions API로 연결 |
사용자는 WeChat에서 /codex, /cc, /gemini 같은 명령을 보내 특정 에이전트로 메시지를 보낼 수 있다. /cwd로 작업 디렉터리를 바꾸고, /new로 새 대화를 시작하는 식의 원격 조작도 지원한다.
기능
- WeChat 텍스트 메시지를 AI 에이전트 프롬프트로 전달
- 음성 메시지는 WeChat 음성 인식을 거쳐 텍스트로 전달
- 에이전트 응답의 마크다운을 WeChat용 일반 텍스트로 변환
- 이미지 URL을 다운로드해 WeChat 이미지 메시지로 전송
- CLI나 HTTP API로 특정 WeChat 사용자에게 능동 메시지 발송
기본 실행
curl -sSL https://raw.githubusercontent.com/fastclaw-ai/weclaw/main/install.sh | sh
weclaw start첫 실행 때 QR 코드를 스캔하면 ~/.weclaw/config.json에 설정이 저장된다.
사용 시 주의점
저장소는 개인 학습용이며 상업적 사용을 의도하지 않는다고 밝힌다. WeChat 계정 자동화는 플랫폼 정책과 계정 위험을 동반할 수 있으므로, 개인 알림·실험·내부 보조 정도로 범위를 좁히는 편이 현실적이다. 또한 원격 채팅에서 코딩 에이전트를 실행하면 파일 접근, 명령 실행, 인증 정보 노출 문제가 생길 수 있으므로 작업 디렉터리와 권한을 제한해야 한다.
관련 문서
- claude-code — 터미널에서 동작하는 Anthropic의 AI 코딩 에이전트
- mimocode — 세션 간 기억을 유지하는 Xiaomi의 터미널 기반 AI 코딩 에이전트
- openclaw — Kimi K2.6 기반의 24/7 능동적 로컬 AI 에이전트 플랫폼
참고 자료
- fastclaw-ai/weclaw — GitHub 공식 저장소