WeChat — 誰のアプリにもAIを
WeChat — 誰のアプリにもAIを — 公式ドキュメントに基づくわかりやすいガイド
これは、あなたのWeChatに超賢いアシスタントと話す方法を教えるようなものだと考えてほしい。ただし、そのアシスタントはクラウド上に存在し、動かすためにサーバーを1台も構築する必要はない。
これは一体何なのか?
Hermes Agentは、オープンソースのAIエージェントフレームワークだ。平たく言えば、お気に入りのメッセージングアプリを、質問に答えたり、タスクを自動化したり、カレンダーを管理したりできるAIツールに接続できるようにするものだ。
このガイドでは、何十億人もの人々が毎日使っている個人向けメッセージングアプリWeChatに焦点を当てる。Hermesを使えば、簡単なQRコードログインだけで、WeChatをAIボットとチャットさせることができる。複雑なWebhookも、パブリックIPアドレスも、サーバー設定も一切不要だ。
始める前に必要なもの
- 個人のWeChatアカウント(スマホに入っているもの)
- コンピューターにインストールされたPython
- ターミナル(Windowsならコマンドプロンプト、Mac/Linuxならターミナル)
これだけだ。有料のAPIキーも、クラウドホスティングも必要ない。
ステップ 1: 必要なパッケージをインストールする
ターミナルを開いて、以下を実行する:
pip install aiohttp cryptography
Hermesを「messaging」オプション付きでインストールした場合は、次のコマンドも実行できる:
cd ~/.hermes/hermes-agent && uv pip install -e ".[messaging]"
これにより、ターミナルにQRコードをきれいに表示するための追加ツールがインストールされるだけだ。
ステップ 2: セットアップウィザードを実行する
WeChatを接続する最も簡単な方法は、内蔵のウィザードを使うことだ:
hermes gateway setup
プロンプトが表示されたら、Weixinを選択する。ウィザードは次のことを行う:
- WeChatのiLink Bot APIにQRコードを要求する
- そのQRコードをターミナルに表示する(またはURLを提供する)
- スマホのWeChatアプリでスキャンするのを待つ
- ログイン認証情報を自動的に保存する
スマホでログインを確認すると、次のように表示される:
WeChat connected successfully, account_id=your-account-id
アカウントIDは保存される。
ステップ 3: 環境変数を設定する
次に、Hermesにどのアカウントを使うかを伝える必要がある。~/.hermes/.envファイルを開いて、以下を追加する:
WEIXIN_ACCOUNT_ID = your-account-id
また、誰がボットと話せるかを制御することもできる:
WEIXIN_DM_POLICY = open
WEIXIN_ALLOWED_USERS = user_id_1,user_id_2
openは、誰でもボットにメッセージを送れることを意味するallowed_usersは、特定のユーザーに制限できる
現実をちょっと確認(重要!)
このアダプターは、あなたの個人のWeChatアカウントに直接接続するのではなく、iLinkボットのIDに接続する。つまり、次のことを意味する:
- ボットは、あなたの個人アカウントとは別のIDである
- ダイレクトメッセージや小規模なグループチャットでは確実に動作する
- 大量配信やスパム送信を目的としたものではない
つまり、拡声器ではなく、頼りになる同僚のように扱ってほしい。
最初のチャット
すべての設定が完了したら、ゲートウェイを起動する:
hermes gateway start
次に、スマホでWeChatを開き、ボットの連絡先を見つけて、「こんにちは」のような簡単なメッセージを送信する。数秒以内に、AIアシスタントから返信が届くはずだ。
そこから、ニュースの要約、メールの下書き、リマインダーの設定などを、WeChatから離れることなく依頼できる。
まとめと実用的なヒント
これで、無料のオープンソースツールを通じて接続された、WeChatの中に住むパーソナルAIアシスタントが手に入った。セットアップ全体は10分もかからず、クラウドインフラは一切不要だ。
実用的なヒント: 実際の連絡先を招待する前に、まずは少人数の友達グループやテストチャットから始めよう。これにより、ボットの動作を学び、権限設定を調整し、初期の気まずいミスを避けることができる。慣れてきたら、水門を開いて、WeChatに語らせよう。
📖 公式ドキュメント
この記事は Hermes Agent の公式ドキュメントに基づいています:公式ドキュメント › user-guide/messaging/weixin