cc-weixin — WeChat上でClaude Code Agentを動かすデモ

Tool
cc-weixin — WeChat上でClaude Code Agentを動かすデモ

cc-weixin — WeChat上でClaude Code Agentを動かすデモ

本リポジトリは、TencentのiLink Bot API（OpenClawフレームワーク）を用いて、WeChat（微信）個人アカウント上でClaude Code Agentを動作させるデモ実装です。Node.js/TypeScriptで書かれた軽量なサンプルで、iLink（ilinkai.weixin.qq.com）経由のメッセージ送受信、エージェントとの連携、簡易的なCLI/バイナリ入口を含みます。開発初期段階のWIPで、実運用のためには設定・安全対策・エラーハンドリングの追加が必要です。

https://github.com/hao-ji-xing/cc-weixin

概要

cc-weixinは「在微信里使用 Claude Code Agent — 基于腾讯官方 iLink Bot API」を謳うデモプロジェクトです。2026年にTencentが公開したiLink（OpenClaw）経由で個人用WeChat Botを公式に扱える流れを受け、WeChat上でClaude Code Agent（コード実行や対話を担うAIエージェント）を動かすための最小構成を示しています。TypeScriptで実装され、Node実行環境向けのモジュール（.mjs）やバイナリ入口を含む構成で、現在は開発初期・デモレベル。実際の運用には追加設定や安定化が必要です。

GitHub

リポジトリの統計情報

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

主な特徴

  • Tencent公式のiLink（OpenClaw）Bot APIを利用したWeChat個人Botデモ
  • Claude Code Agentとの連携を想定したエージェント型ワークフロー
  • Node.js/TypeScriptでの軽量実装（.mjsエントリ、binディレクトリ）
  • 開発初期（WIP）でサンプル・学習用に適した構成

技術的なポイント

本プロジェクトはTypeScriptで書かれたNode.js向けのデモで、iLink（ilinkai.weixin.qq.com）を介したBot APIとAIエージェントの橋渡しを目的としています。技術的に注目すべき点は次の通りです。

  • iLinkプロトコル適用：Tencentが提供するOpenClaw/iLinkフレームワークのエンドポイントを想定し、公式APIを使ってメッセージの受信・送信やイベント処理を行う設計になっています。公式API採用に伴い、非公式な逆解析やhookより安全かつ長期運用に適した方針をとれます。
  • エージェント統合：リポジトリ名やREADMEから、会話やコード実行を担う「Claude Code Agent」との連携を前提としています。APIトークンやセッション管理を通じて、ユーザーからの指示をAIに送り、返信を整形してWeChatへ送り返す処理フローが中心です。
  • 実行環境と構成：cc-weixin.mjsやbinディレクトリがある点から、CLIやスクリプトとして直接起動可能な設計で、NodeのES Module（.mjs）を利用した最新のモジュール解決を行っています。TypeScriptソースをトランスパイルして実行する前提が考えられます。
  • 拡張性と安全性の課題：現状はWIPであるため、認証情報（APIキーやWebhookシークレット）の安全な管理、リトライ／レート制御、入力検証、メッセージ長の制限、マルチユーザー／マルチセッションの取り扱い、ログの取り扱いといった運用面の整備が必要です。特にWeChat個人アカウントでのBot利用はプラットフォームポリシーに依存するため、公式ガイドに従った実装が求められます。
  • デモ向け設計：READMEにdemo.pngやauthor-wechat.JPGが含まれており、利用イメージを示すUIやスクリーンショットが含まれる構成です。学習やPoC（概念実証）用途に向き、コミュニティでの拡張・改善が想定されています。

これらを踏まえ、本リポジトリはiLinkを利用したWeChatボットと外部AI（Claude系）の接続パターンを学ぶのに適したサンプルであり、実運用化には追加実装とセキュリティ対策が不可欠です。

プロジェクトの構成

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

  • .gitignore: file
  • README.md: file
  • author-wechat.JPG: file
  • bin: dir
  • cc-weixin.mjs: file

…他 6 ファイル

まとめ

公式APIを利用するWeChat向けAIエージェントの初期デモとして有用、実運用には設定・安全対策が必要。

リポジトリ情報：

READMEの抜粋：

cc-weixin

在微信里使用 Claude Code Agent — 基于腾讯官方 iLink Bot API

WIP — 本项目目前还在早期开发阶段，是一个 demo 级的项目。很多配置能力还待添加，欢迎贡献和提 Issue。

demo

背景：微信首次合法开放个人 Bot API

2026 年，腾讯通过 OpenClaw（AI Gateway 框架）正式开放了微信个人账号的 Bot API。官方名称叫微信 ClawBot 插件功能，底层协议叫 iLink（智联），接入域名是 ilinkai.weixin.qq.com — 腾讯的官方服务器。

这是历史性时刻。在此之前，开发者想让程序控制微信，只有灰色地带的选项：

方式典型实现性质
逆向 iPad 协议WeChatPadPro、itchat灰色地带，违反协议，随时封号
PC 客户端 Hook注入 D…