formulahendry/wechat-acp

何を解決するか

wechat-acp は、Copilot CLI、Claude Code、Gemini などの ACP互換 AI エージェントに、WeChatの1:1メッセージ経由で直接アクセスできるブリッジです。ターミナルや専用のAIアプリを使わずに、WeChatのメッセージをローカルのAIエージェントにルーティングし、エージェントの返信をユーザーに送り返すことで、作業の手間を省きます。

動作方法

このツールは WeChat iLink ボット API を使ってログインし、受信する1:1メッセージをポーリングします。メッセージが到着すると、ローカルで実行中の設定済みACPエージェント（stdio経由）に内容を転送し、各WeChatユーザー用に専用のセッションを管理します。さまざまなデータ形式を処理し、画像、音声、ファイルなどのエージェント出力をネイティブなWeChatメッセージに変換します。また、複数のWeChatメッセージ（テキスト、画像、ファイル）を1つのエージェントリクエストにまとめるバッファリングモードも提供し、複数の独立したターンをトリガーするのを回避します。

対象ユーザー

モバイルメッセージインターフェース経由でローカルAIエージェントやCLIベースのAIツールにアクセスしたい開発者やパワーユーザー、またはローカルインジェクションコマンドを使ってWeChat経由でAIの操作を自動化したいユーザー。

特徴

• マルチエージェント対応：Claude、Gemini、Qwen、Copilot などの人気エージェント用の組み込みプリセットを提供。
• セッション管理：ユーザーごとに分離されたセッションをサポート。再起動後もオプションで状態を保持可能。
• リッチメディア処理：WeChatとエージェント間で画像、音声、ファイルを転送。受信したバイナリファイルはディスクに保存され、エージェントがアクセスできるようになります。
• ブリッジコマンド：セッションのリセット（/acp-new）、ターンのキャンセル（/acp-cancel）、設定（/acp-config）用の組み込みスラッシュコマンドを提供。
• ローカルインジェクション：外部スクリプトやcronジョブからエージェントにメッセージをキューイングし、WeChat経由で応答を送信可能。
• インスタンス分離：異なるWeChatアカウントとプロジェクトディレクトリで複数のブリッジインスタンスを同時に実行可能。