OpenClawをWeChatで無料で使う方法

TL;DR: @tencent-weixin/openclaw-weixinプラグインをインストールし、QRコードをスキャンしてアカウントを認証し、ゲートウェイを再起動することで、OpenClawをWeChatに接続します。セットアップ全体は5分もかかりません。このプラグインは無料でオープンソースであり、複数のWeChatアカウントを同時にサポートします。

はじめに

WeChatでAIアシスタントを稼働させるのは複雑に聞こえます。ほとんどのソリューションは、高価なAPIサブスクリプション、複雑なサーバー設定、またはエンタープライズアカウントを必要とします。OpenClawはそれを変えます。

@tencent-weixin/openclaw-weixinプラグインは、あなたの個人WeChatアカウントをOpenClawのAIゲートウェイに数分で接続します。エンタープライズアカウントは不要です。月額費用もかかりません。QRコードをスキャンするだけで稼働します。

このガイドでは、プラグインのインストールから、複数のアカウントの処理、会話コンテキストの分離まで、完全なセットアップを順を追って説明します。最終的に、あなたのWeChatにはOpenClaw上で完全に機能するAIアシスタントが稼働します。

💡

WeChatボットが外部API（天気、決済、CRM）を呼び出す必要がある場合、APIテストツールが必要になります。ボットに接続する前にAPIを設計、テスト、文書化するためにApidog Freeをお試しください。

button

前提条件

開始する前に、以下のものが必要です：

OpenClawがインストールされていること（プラグインv2.0.xにはバージョン>=2026.3.22）
ターミナルでopenclaw CLIが利用可能であること
WeChatアカウント（個人アカウントで動作します — 企業アカウントは不要です）
Node.jsがインストールされていること（ワンクリックインストーラー用）

OpenClawのバージョンを確認してください：

openclaw --version

古いバージョンを使用している場合は、まずアップデートしてください。プラグインv2.0.xにはOpenClaw >=2026.3.22が必要です。

プラグインの互換性

プラグインバージョン	OpenClawバージョン	ステータス
2.0.x	`>=2026.3.22`	アクティブ
1.0.x	`>=2026.1.0 <2026.3.22`	メンテナンス

プラグインは起動時にホストバージョンをチェックします。OpenClawのバージョンが範囲外の場合、プラグインはロードを拒否します。

ステップ1：プラグインをインストールする

オプションA：ワンクリックインストール（推奨）

npx -y @tencent-weixin/openclaw-weixin-cli install

これにより、プラグインのインストール、設定、初期セットアップがすべて自動的に処理されます。

オプションB：手動インストール

ワンクリックインストーラーがシステムで動作しない場合は、手動でインストールしてください：

1. プラグインをインストールします：

openclaw plugins install "@tencent-weixin/openclaw-weixin"

2. プラグインを有効にします：

openclaw config set plugins.entries.openclaw-weixin.enabled true

ステップ2：QRコードをスキャンしてWeChatを認証する

プラグインがインストールされたら、WeChatアカウントでログインします：

openclaw channels login --channel openclaw-weixin

ターミナルにQRコードが表示されます。スマートフォンでWeChatを開き、スキャンアイコンをタップしてコードをスキャンします。スマートフォンで認証を確定します。

ログイン認証情報は自動的にローカルに保存されます。ログアウトしない限り、再度スキャンする必要はありません。

ステップ3：ゲートウェイを再起動する

認証後、OpenClawゲートウェイを再起動してプラグインをアクティブにします：

openclaw gateway restart

これで完了です。あなたのWeChatアカウントはOpenClawに接続されました。あなたのWeChatに送信されたメッセージはAIエージェントによって処理されます。

ステップ4：複数のWeChatアカウントを追加する（オプション）

OpenClawは複数のWeChatアカウントを同時にサポートします。別のアカウントを追加するには、ログインコマンドを再度実行するだけです：

openclaw channels login --channel openclaw-weixin

各QRコードスキャンは新しいアカウントエントリを作成します。すべてのアカウントは互いに干渉することなく並行して実行されます。

ステップ5：会話コンテキストを分離する（オプション）

デフォルトでは、すべてのチャネルが同じAI会話コンテキストを共有します。これは、あなたのWeChatの会話と他のチャネル（Telegram、Discordなど）が同じAIメモリを共有することを意味します。

各WeChatアカウントが独自の分離されたコンテキストを持つようにしたい場合：

openclaw config set agents.mode per-channel-per-peer

この設定により、「WeChatアカウント + 連絡先」のすべての組み合わせが独自の独立したAIメモリを持ちます。異なるアカウント間の会話が互いに混ざり合うことはありません。

プラグインの内部動作

プラグインの動作を理解したり拡張したりしたい開発者向けに、OpenClawゲートウェイとの通信方法を説明します。

認証ヘッダー

すべてのAPIリクエストはこれらのヘッダーを使用します：

ヘッダー	値
`Content-Type`	`application/json`
`AuthorizationType`	`ilink_bot_token`
`Authorization`	`Bearer <token>`
`X-WECHAT-UIN`	ランダムなuint32をbase64エンコード

コアAPIエンドポイント

プラグインは5つのHTTP JSONエンドポイントを使用します：

エンドポイント	パス	目的
getUpdates	`getupdates`	新しいメッセージのロングポーリング
sendMessage	`sendmessage`	テキスト/画像/動画/ファイルを送信
getUploadUrl	`getuploadurl`	メディアのCDNアップロードURLを取得
getConfig	`getconfig`	アカウント設定（タイピングチケット）を取得
sendTyping	`sendtyping`	タイピングインジケータの表示/非表示

メッセージの受信（ロングポーリング）

プラグインはロングポーリングを使用してメッセージを受信します：

// リクエスト
{
  "get_updates_buf": ""
}

// レスポンス
{
  "ret": 0,
  "msgs": [...],
  "get_updates_buf": "<new_cursor>",
  "longpolling_timeout_ms": 35000
}

後続のリクエストでget_updates_bufカーソルを返すことで、新しいメッセージのみを受信できます。

メッセージの送信

{
  "msg": {
    "to_user_id": "<target_user_id>",
    "context_token": "<session_context_token>",
    "item_list": [
      {
        "type": 1,
        "text_item": { "text": "Hello!" }
      }
    ]
  }
}

メッセージタイプ

タイプ	値
TEXT	1
IMAGE	2
VOICE	3
FILE	4
VIDEO	5

メディアのアップロード（画像、ファイル、動画）

メディアファイルはアップロード前にAES-128-ECBで暗号化されます。手順は次のとおりです：

ファイルメタデータ（サイズ、MD5）を指定してgetUploadUrlを呼び出します
事前に署名されたCDNアップロードパラメータを受信します
AES-128-ECBでファイルを暗号化します
事前に署名されたURLを使用してCDNにアップロードします
sendMessageでCDNファイルを参照します

よくある問題と修正

プラグインがロードを拒否する

エラー： プラグインが起動時にロードを拒否する

修正： OpenClawのバージョンを確認してください。プラグインv2.0.xには>=2026.3.22が必要です。

openclaw --version
# 古い場合は、まずOpenClawを更新してください

QRコードの期限切れ

エラー： QRコードがスキャンする前にタイムアウトする

修正： ログインコマンドを再度実行してください。QRコードは約30秒後に期限切れになります。

openclaw channels login --channel openclaw-weixin

メッセージが受信されない

エラー： WeChatメッセージがOpenClawに届かない

修正： ログイン後にゲートウェイを再起動してください。

openclaw gateway restart

複数アカウントでコンテキストが混ざる

エラー： あるアカウントからのAI応答が別のアカウントに表示される

修正： チャネルごとのコンテキスト分離を有効にしてください。

openclaw config set agents.mode per-channel-per-peer

実世界のユースケース

パーソナルAIアシスタント

あなたの個人WeChatをOpenClawに接続し、忙しいときにAIアシスタントがメッセージに返信するようにします。各連絡先が会話履歴に基づいてパーソナライズされた応答を受け取るようにコンテキスト分離を設定します。

中小企業向けカスタマーサポート

異なる事業ライン向けに複数のWeChatアカウントを運用します。各アカウントは、分離されたAIメモリを使用して独自の顧客クエリを処理します。アカウント間の相互汚染はありません。

開発者テスト

HTTP JSON APIを使用してカスタム統合を構築します。プラグインのバックエンドプロトコルは完全に文書化されており、デフォルトの動作を簡単に拡張または置き換えることができます。

結論

OpenClawとWeChatのセットアップは5分もかかりません。プラグインをインストールし、QRコードをスキャンし、ゲートウェイを再起動するだけで完了です。無料のセットアップは、複数アカウント、コンテキスト分離、および完全なメディアサポート（画像、音声、ファイル、動画）をサポートします。

開発者にとって、文書化されたHTTP JSON APIによりカスタム統合は簡単です。

ワンクリックインストーラーから始めましょう：

npx -y @tencent-weixin/openclaw-weixin-cli install

次のステップ： WeChatボットが稼働したら、決済ゲートウェイ、CRM、天気サービスなどの外部APIに接続する必要があるでしょう。ApidogでAPIをテストし、ボットが常に正しいデータを送信していることを確認してください。無料プランも利用可能で、クレジットカードは不要です。

button

よくある質問

Q: 個人のWeChatアカウントでも動作しますか？

A: はい。ほとんどのWeChat自動化ツールとは異なり、このプラグインは個人アカウントで動作します。企業アカウントや公式アカウントは不要です。

Q: プラグインは無料ですか？

A: はい。@tencent-weixin/openclaw-weixinプラグインは無料でオープンソースです。動作するOpenClawのインストールのみが必要です。

Q: 複数のWeChatアカウントを同時に実行できますか？

A: はい。各アカウントでopenclaw channels login --channel openclaw-weixinを実行してください。すべてのアカウントは同時に実行されます。

Q: コンピュータを再起動したらどうなりますか？

A: ログイン認証情報はローカルに保存されます。再起動後、QRコードを再度スキャンする必要はありません。openclaw gateway restartでゲートウェイを再起動するだけです。

Q: これを基にカスタム統合を構築できますか？

Apidogを使用してAPI統合をテストおよび検証してください。