概要

wechat-agent-channelは、WeChat上のメッセージをローカルで動作するAIコーディングアシスタント（Codex / OpenCode / Claude Code など）へルーティングして、そのままWeChatで応答をやり取りできる橋渡しツールです。ClawBot等のWeChat連携を利用して受信したチャットをPython側で処理し、各種プロバイダのCLIコマンドを呼び出して生成されたコードや解析結果を返信します。環境依存はあるものの、ローカルで安全にAIを試したい開発者や、外出先でIDEを開けない状況でもコーディング支援を受けたい場面に適しています。（約300字）

リポジトリの統計情報

スター数: 40
フォーク数: 0
ウォッチャー数: 40
コミット数: 12
ファイル数: 11
メインの言語: Python

主な特徴

WeChat（ClawBot等）経由で受け取ったメッセージをローカルのAIコーディングアシスタントに転送し、応答を返す。
Codex、OpenCode、Claude Codeなど複数プロバイダに対応し、同一のWeChat入口でプロバイダを切替可能。
各プロバイダの公式CLIを利用する設計で、ネットワーク経由のAPIキーを直接埋め込まずに済む構成。
Pythonベースで軽量に実装されており、ローカル開発環境に組み込みやすい。

技術的なポイント

このプロジェクトは「WeChatブリッジ（ClawBot等）」と「ローカルAI CLI」をつなぐ中継器として動作します。全体のフローは概ね次の通りです：WeChatからのメッセージをClawBotが受け取り、そのHTTP/ローカルインターフェースを介して本プロジェクトがメッセージを受信。受信したテキストを解析して適切なプロバイダへルーティングし、プロバイダ用CLI（例：@openai/codex、@anthropic-ai/claude-code、OpenCodeのCLIなど）をサブプロセスとして呼び出して応答を生成し、その結果をWeChatへ返信します。

設計上の注目点はCLIベースのアダプタ方式です。多くの実装はHTTP APIを直接叩く代わりに各プロバイダ公式のCLIを使うことを前提としており、これにより認証情報や実行環境がローカルに閉じるメリットがあります。一方でCLIの出力パースやエラー処理、ストリーミング応答の取り扱いが必要になるため、サブプロセス管理、タイムアウト、ログの取り扱い、非同期処理（複数チャット同時処理）に注意が必要です。

実装面ではPython 3.11+を想定しており、Node.js 18+のCLIツールが前提です。プロバイダごとのラッパーを追加すれば拡張も容易で、例えば新しいモデルやCLIが出た場合は新しいアダプタ関数を実装してコマンド呼び出しと出力整形を定義するだけで対応できます。セキュリティと運用の観点では、WeChatおよびCLIが持つ認証情報はローカルで管理し、外部に平常系で送信しない設計にすることが望ましいです。また、WeChat側のメッセージサイズや頻度制限、プロバイダ側のレート制限に対するバックオフやキューイング機構を導入すると実運用で安定します。

実例としてREADMEにもある通り、ユーザは各プロバイダのCLIを事前にグローバルインストールし、環境変数や設定ファイルで認証を済ませておく必要があります。軽量である反面、ローカルのCLIに依存するため、クロスプラットフォームでの動作確認やCLIのバージョン互換性を考慮する必要があります。

（約700〜1000字相当の技術解説）

プロジェクトの構成

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

.gitignore: file
.mcp.json: file
LICENSE: file
README.md: file
package-lock.json: file

…他 6 ファイル

（上記ファイル群はプロジェクトの環境設定や依存管理、ライセンスと実装ドキュメントを含みます。READMEには実行前の準備（Python 3.11+, Node.js 18+、ClawBot連携、各CLIのインストール手順）やサンプルコマンドが記載されており、セットアップ手順に従って環境を整えることでWeChat経由のやり取りが可能になります。）

まとめ

WeChatを入口にしてローカルのAIコーディングアシスタントを手軽に利用できる、実用的で拡張しやすいブリッジツールです。（約50字）

リポジトリ情報：

名前: wechat-agent-channel
説明: Use WeChat to route messages to Claude Code or Codex.
スター数: 40
言語: Python
URL: https://github.com/sitarua/wechat-agent-channel
オーナー: sitarua
アバター: https://avatars.githubusercontent.com/u/130620802?v=4

READMEの抜粋：

wechat-agent-channel

简体中文 | English

简体中文

把微信消息接到本地 AI 编码助手里用。你可以选择把消息转给 Codex、OpenCode 或 Claude Code，然后直接在微信里和它们对话。

适合做什么

在微信里让 AI 帮你看代码、写脚本、解释仓库
在外面不方便开 IDE 时，继续和本地编码助手协作
在同一套微信入口下切换不同 provider

运行前准备

Python 3.11+
Node.js 18+
微信端已接入 ClawBot
你要使用的 CLI 已安装并能在终端里直接运行

示例：

npm install -g @openai/codex
# 按 OpenCode 官方文档安装 opencode
npm install -g @anthropic-ai/claude-code

安装项目依赖：

...

wechat-agent-channel — WeChatでローカルAIコーディングアシスタントを使う