WeChat向け Claude Code チャネルプラグイン (claude-code-wechat-channel)

Tool
WeChat向け Claude Code チャネルプラグイン (claude-code-wechat-channel)

WeChat向け Claude Code チャネルプラグイン (claude-code-wechat-channel)

Claude Code と WeChat をブリッジする軽量なチャネルプラグインです。WeChat の ClawBot ilink API（@tencent-weixin/openclaw-weixin と同一プロトコル）を通じて、WeChat からのメッセージを Claude Code のセッションへ受け渡し、逆方向に返答を戻します。TypeScript で書かれ、Node.js（>=18）または Bun（>=1.0）で動作します。MCP Channel Protocol と wechat_reply ツールを併用する設計で、手早く Claude Code を WeChat に統合したい開発者向けの実験的実装です（事前に Claude Code >= 2.1.80 が必要）。このリポジトリは小規模なプロトタイプ実装で、シンプルなコードベースと最低限の依存で素早く試せる点が特徴です。

https://github.com/Johnixr/claude-code-wechat-channel

概要

claude-code-wechat-channel は、WeChat（微信）と Claude Code を直接つなぐチャネルプラグインです。WeChat の ClawBot ilink API（@tencent-weixin/openclaw-weixin と互換のプロトコル）を利用して、ユーザーのメッセージを Claude Code のセッションに渡し、その応答を WeChat 側に戻します。アーキテクチャは比較的シンプルで、WeChat(iOS) → WeChat ClawBot → ilink API → 本プラグイン → Claude Code Session、という双方向フローを実現します。Node.js または Bun 上で動作し、TypeScript で実装された小さなコードベースなので、試験導入やカスタム拡張に向いています。

GitHub

リポジトリの統計情報

  • スター数: 78
  • フォーク数: 19
  • ウォッチャー数: 78
  • コミット数: 4
  • ファイル数: 11
  • メインの言語: TypeScript

主な特徴

  • WeChat の ClawBot ilink API と互換のプロトコルで Claude Code とブリッジ
  • TypeScript 実装で Node.js / Bun のどちらでも動作可能
  • MCP Channel Protocol と wechat_reply ツールを組み合わせた双方向通信設計
  • 小規模で取り回しが良く、プロトタイプや実験用途に適した構成

技術的なポイント

本プロジェクトは「WeChat の ilink API」と「Claude Code のセッション API」をつなぐミドルウェアとして設計されています。ilink 側は WeChat の ClawBot（公式のボット連携）プロトコルを利用し、@tencent-weixin/openclaw-weixin と同等のメッセージ形式・イベントを想定しているため、既存の WeChat 開発フローに馴染みやすい点が利点です。Claude 側とは MCP Channel Protocol を通してやり取りし、wechat_reply ツールを介して返信を戻す二重構造になっています。

TypeScript の採用により型安全にイベント処理やメッセージ変換ロジックを記述でき、Node.js 18+ や Bun 1.0+ といったモダンランタイムでそのまま動かせます。メッセージフローでは受信した WeChat イベントをパースし、必要に応じてテキストや添付を Claude のセッションに投げ、返答を受け取って WeChat 用にフォーマットして返送します。セッション管理は Claude Code セッションと WeChat のユーザー／会話をマッピングする形で行われるため、コンテキスト保持や会話スレッドの再利用が可能です（実装の詳細はコードを参照）。

運用面では、ilink と Claude いずれも外部 API との通信が発生するため、認証情報（トークン類）の安全な管理、リトライ／バックオフ、レート制御、ログ出力や監視が重要です。また小規模リポジトリであることから、プロダクション利用時は永続化や冗長化、スケール時のセッション同期（複数インスタンスでのセッション共有）など追加実装が求められます。本リポジトリは実験的・プロトタイプ用途を想定しており、拡張ポイント（メッセージ中継のフィルタリング、カスタムルーティング、メディアハンドリングなど）を比較的容易に追加できる構造になっています。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitignore: file
  • .mcp.json: file
  • LICENSE: file
  • README.md: file
  • bun.lock: file

…他 6 ファイル

まとめ

WeChat と Claude Code を手早く接続できる実験的プラグインで、拡張性と取り回しの良さが魅力。

リポジトリ情報：

READMEの抜粋：

Claude Code WeChat Channel

将微信消息桥接到 Claude Code 会话的 Channel 插件。

基于微信官方 ClawBot ilink API（与 @tencent-weixin/openclaw-weixin 使用相同协议），让你在微信中直接与 Claude Code 对话。

工作原理

微信 (iOS) → WeChat ClawBot → ilink API → [本插件] → Claude Code Session
                                                  ↕
Claude Code ← MCP Channel Protocol ← wechat_reply tool

前置要求