Grok Bot 初心者ガイド

日本語

简体中文
繁體中文
English
한국어
Español
Português (Brasil)

日本語

简体中文
繁體中文
English
한국어
Español
Português (Brasil)

外観

有料Q&Aグループ
第3部 · 応用編

第 22 章 FeishuとWeChatの連携 ​

パブリックIPや自前サーバーを用意することなく、Grok BotをFeishuやWeChatに安全に連携できます。

The X Subscription（2026年10月12日発効）は週単位でクォータが差し引かれるため、グループチャットにはメッセージフィルタの設定が必須です。さもないと、雑談で1週間分のクォータを使い果たしてしまいます。

  • Feishu複数Botの協調：公式Python SDKの永続接続（Long Connection）と「Feishuアプリ管理者」テンプレートを利用。
  • WeChat ClawBot直接接続：公式「微信ClawBot」プラグインとiLinkインターフェースを利用。
  • WeChatショートカット経由の取り込み：AppleショートカットとWebhookを活用してログをアーカイブ。

接入飞书与微信

連携チャネルの比較と技術選定 ​

接入通道对比与技术选型

3つの連携方式はいずれもパブリックIPを必要としません。

  • Feishu複数Botチャネル：チーム業務やグループチャットでのタスク割り当て向け。公式WebSocketアウトバウンド永続接続を利用し、リッチテキストやインタラクティブカードに対応。グループ内では@メンションにのみ応答してクォータを保護。
  • WeChat ClawBotチャネル：個人の日常アシスタントやタスク指示向け。iLinkロングポーリングを利用し、プレーンテキストのみサポート。ホワイトリストによる個別チャットで不要な起動を防止。
  • WeChatショートカットチャネル：画像・テキスト・音声アセットのナレッジ格納向け。Webhookによる一方向プッシュとレシート（処理結果）返却を行い、オンデマンドでトリガーされるためメッセージがない時は追加消費なし。

チーム向けFeishu連携：複数Botの協調とFeishuアプリ管理者 ​

团队接入飞书：多 Bot 协同与飞书应用管家

Feishu永続接続とドアベルトリガーの仕組み ​

アウトバウンドの永続接続を利用するため、パブリックIP、SSL証明書、開放ポートが不要です。

  1. Feishuカスタムアプリ：グループチャットおよび個別チャットの送受信を担当。
  2. クラウド転送プログラム：バックグラウンドで永続接続をリッスンしてメッセージを転送。
  3. ドアベルトリガー：Botを呼び出し、SDKを経由して返信。

重複した設定作業を避けるため、「Feishuアプリ管理者」を使ってQRコードスキャンによるアプリ自動作成を行います。

手順：単一Botの疎通から複数Botの協調まで ​

QRコードスキャンで最初のBotを作成（記事チーフエディター） ​

  1. 個別チャットでBotにFeishu SDKを呼び出させ、QRコードスキャンによるアプリ作成リンクを発行させます。このリンクは1回限りの認証情報であり管理者専用です。他人のリンクをクリックしたり転送したりしないでください。
  2. ブラウザでリンクを開いて「作成」をクリックし権限を承認すると、認証情報が自動的にBotへ返送されます。
  3. Feishuからテストメッセージを受信したら1通返信します。Botが自動的にあなたのOpen IDをホワイトリストに登録します。

ドアベルルーティンの作成 ​

  1. チャット上部のBot名をクリックし、詳細内の Details パネルを開きます。手順は 例程 を参照してください。
  2. ルーティンでWebhookドアベルを作成し、POST toアドレスとkeyを取得します。
  3. 平文での漏洩を防ぐため、必ずBotがポップアップ表示する暗号化入力ボックスに認証情報を送信してください。個別チャットでテストテキストを送信し、Botが正常に返信すれば疎通完了です。

アプリの一括作成とグループチャット協調 ​

  1. テンプレート https://x.ai/bot/AJpUlCwa8tyMX7L5UHnuY をインポートします。登録簿と復旧スクリプトはGitのプライベートリポジトリに保存し、秘密鍵は平文で保存しないでください。
  2. 管理者に指示してQRコードスキャンリンクを一括生成させ（各リンクは1時間有効）、スキャン後に暗号化ウィンドウでkeyを入力すると、管理者が自動的に転送処理を起動します。
  3. グループを作成して各Botを追加し、@所有人 を送信して管轄範囲の報告を確認します。@文章主编 が 虚拟机服务管家 を呼び出し、サービス管理者が登録簿をグループに送信すれば協調設定は完了です。

インタラクションのセキュリティ ​

  • コマンド送信元検証：グループ内のホワイトリストに登録された管理者からの直接コマンドにのみ応答します。
  • Feishuカードによる確認：設定変更、DB書き込み、再起動などの高リスクな操作には「承認」と「却下」ボタン付きのカードをプッシュ通知し、Feishu内でクリックするだけで2段階認証・承認が完了します。

達成基準・運用目安 ​

  • E2Eレイテンシ1秒未満：メッセージ送信後、ほぼ即座に返信。
  • グループチャットメッセージの正確な振り分け：雑談には無反応、メンションされたBotだけが返信、@全員では各Botが役割に応じて順番に報告し奪い合いません。
  • 高可用性と自己修復：プロセス終了時は5秒以内に再起動、5分ごとにハングアップを巡回監視、プロセスを強制終了しても約9秒で復旧。

実践手順は 『Grok Bot 团队接入飞书保姆级教程（附飞书管家模板）』 を参照してください。

個人向けWeChat連携：微信ClawBotプラグイン直接接続 ​

个人接入微信：微信 ClawBot 插件直连

公式iLinkインターフェース（ilinkai.weixin.qq.com）を経由し、純粋なアウトバウンドのロングポーリングを行うため、パブリックポートを開放せず、コンプライアンスに準拠しアカウント停止リスクもありません。

3ステップで連携完了 ​

  1. プロンプトを送信：PC側でメインBotに以下の指示を送信し、通信コンポーネントが自動生成されるのを待ちます。
三步完成接入
text
我想把你接到我的微信上，让我能在微信里直接给你发消息、收到你的回复。请按下面的思路做，每做完一步告诉我结果，需要我操作的地方停下来等我。

1、先调研方案：腾讯「微信ClawBot」插件用的是 iLink 接口（ilinkai.weixin.qq.com）。请确认怎么用 getupdates 长轮询收消息、怎么用 sendmessage 回消息。整个程序只走出站请求，不要开公网端口。

2、在 Grok Bot 里建一个由 webhook 触发的 routine，名字可以叫「微信下旨入口」。建好后告诉我去 routine 面板复制 Webhook URL 和 key，然后弹出加密弹框让我填进去，不要让我在聊天里发明文。

3、在你的云端电脑上写一个小转发程序：收到微信消息后 POST 给这个 routine；你处理完以后，用一个 reply 脚本把回复发回微信，同时在我们的主聊天里同步一份。

4、等我在手机微信里启用 ClawBot 插件以后，生成二维码让我用手机扫码确认，同时给我一个可以在微信里直接打开的备用链接。二维码大约 5 分钟有效。

5、绑定成功后，提醒我先在 ClawBot 对话里发一句话，因为回复要用到这条消息带的 context_token。

6、规则：只认绑定的这一个人，别人的消息不处理；回复一律用纯文本，不要用 Markdown，因为微信不渲染 Markdown。

7、最后告诉我：云端电脑重启以后，怎么把转发程序重新拉起来；如果遇到错误码 -14（凭证过期），提醒我重新扫码。
  1. キーの設定：メインBotの「微信下旨入口」ルーティンを開き、Webhookの POST to と key をコピーして暗号化ボックスに送信します。
  2. 紐付けとアクティベーション：
    • WeChatのバージョンは iOS ≥ 8.0.70、Android ≥ 8.0.69 である必要があります。「設定 - プラグイン」で「微信ClawBot」を有効化します。
    • PCのBotに「プラグインを有効にしました」と送信し、WeChatでQRコードをスキャンして認証します（QRコードは5分間有効）。
    • 必ず自分からWeChat ClawBotに最初のメッセージを送信してください（例: 「こんにちは」）。これにより context_token を取得し、返信パケットをアクティベートします。

検収基準 ​

  • 双方向同期：WeChat側で秒単位の高速返信、PC側でリアルタイムにアーカイブ。
  • サブAgentのディスパッチ：WeChatから直接、X（旧Twitter）の検索や動画の文字起こしタスクを指示可能。
  • セキュリティ分離：紐付けされていないWeChatアカウントからは起動不可。

詳細は 『如何把 Grok Bot 接入你的微信？保姆级新手指南来了（附详细提示词）｜Kin』 を参照してください。

WeChatコンテンツの格納：ショートカットでチャット履歴とマルチメディアを連携 ​

ショートカットを利用して一括転送されたZIPパッケージを一時オンラインストレージにアップロードし、Grok BotのWebhookにプッシュして自動アーカイブします。

設定と操作手順 ​

  1. Grok Botのチャットウィンドウでプロンプトを送信し、ルーティンを作成します：
text
帮我创建一个 Webhook 触发的例行任务。快捷指令会用 POST 请求发来一个 JSON，里面只有一个字段 info。info 可能是我输入的文字，也可能是一个文件下载链接，比如微信聊天记录压缩包、截图、录音。收到后：如果是链接就先下载文件再读取，压缩包先解压；然后整理出要点，收录进知识库，最后给我一份回执，写清楚收录了什么、存在哪里。

詳細ページのRoutineリストで、WebhookのPOST toアドレスとkeyシークレットをコピーします。

  1. ショートカットをインポートします：https://www.icloud.com/shortcuts/2b77155d7c744110a0f0f9ef1bdc42bf。

  2. POST to、key、画像ストレージIDを入力します。filebin.net のファイル保存期間は7日間です。上書きや漏洩を防ぐため、IDは必ず8文字以上のランダム文字列を設定してください（例: kb7x9q2m）。共有する前に必ずこの3項目を空にしてください。

  3. WeChatで複数のチャット履歴を選択し、他のアプリへ一括転送（Combine and Forward）して、ショートカット「ナレッジベースBotへ送信」の「転送を受信」を選択します。転送を受信していない場合はクリップボードを読み取ります。「スクリーンショット」または「音声録音」を選んで直接送信することも可能です。

検収基準 ​

  • マルチメディアの完全な解析：画像、ドキュメント、音声を解凍・分類（例: 13のデザインインスピレーションサイトをWebサイト全体、App、コンポーネント別にインデックス化）。
  • 標準化されたレシート：テーマ要点、ノート保存パス、元のZIPアーカイブパスを明記。

参考：『微信聊天记录打通 Grok Bot：快捷指令进阶版』。

よくある落とし穴とトラブルシューティング ​

1. Feishuの権限設定不足によるグループメッセージ受信不可 ​

  • 落とし穴：個別チャットは正常なのにグループ内で @ メンションしても反応がなくログも出ない。初回設定時に選んだ7つの権限で「グループ内のすべての@Botメッセージの取得」が漏れていることが原因です。
  • 解決策：SDK経由でQRコードスキャン用の権限追加リンクを生成し、管理者が承認して14項目に拡張します。アプリを再リリースする必要はありません。

2. Feishuグループチャットのフィルタリングルールの誤判定と永続接続切断時の再送 ​

  1. メッセージの取りこぼしと応答の重複：Feishuの @所有人 はmention配列に含まれず、IDを検証しないと全Botが一斉に応答してしまいます。スクリプト側でターゲットIDを厳密に判定し、「@自己」または「@所有人」にのみ応答するようにしてください。
  2. 重複返信：ネットワーク復旧後に公式側から自動で再送されるため、絶対に手動で2重送信しないでください。

3. Bot間連携における信頼チェーンと承認カードの欠落 ​

  1. グループ内でBot同士の呼び出しが反応しないのは、Bot間のメッセージがデフォルトで信頼されない設定になっており、個別チャットでの承認待ちで止まっているためです。
  2. 転送レイヤーでホワイトリストを設定して管理者のOpen IDを認識させます。高リスク操作には承認／却下ボタン付きのFeishuカードをプッシュして確認を行います。

4. 仮想マシンのPython実行環境パスの指定ミス ​

  • スクリプトで lark-oapi が見つからないとエラーが出る場合、通常はデーモンタスクの設定時に誤ってシステムデフォルトの /usr/bin/python3 を使用していることが原因です。
  • 起動スクリプト、Supervisor、定期実行タスクでは、システムのグローバル環境を直接呼び出さず、必ず仮想環境の絶対パス（例: /home/user/venv/bin/python3）をハードコードしてください。

5. WeChat ClawBotのQRコード失効とエラーコード -14 ​

  • QRコードの有効期限は5分間のみです。期限が切れると無効になるため、表示されたらすみやかにスマートフォンでスキャンしてください。
  • バックエンドでエラーコード -14 が出力された場合は認証情報の有効期限切れです。QRコードを再生成し、管理者に再度スキャンしてもらってください。

6. WeChatメッセージフォーマットの乱れとMarkdownレンダリングの失敗 ​

  • WeChatはMarkdownを解釈しないため、アスタリスク、バッククォート、見出し記号などがそのまま露出してしまいます。
  • 連携プロンプトや転送スクリプトにフィルタを追加し、改行を含んだプレーンテキストに統一変換してからWeChatへ送信してください。

7. WeChat一括転送ZIPで未ロードのマルチメディア添付ファイルが欠落する問題 ​

WeChatは元のファイルを常時保存しておらず、タップして読み込んでいないファイルは圧縮ファイルに含まれないため、解凍時に画像が失われます。

  1. 転送する前に、保存したい画像やファイルを1つずつタップして読み込んでおきます。
  2. ローカルに完全に読み込まれたのを確認してから、一括転送してください。

8. 一時オンラインストレージの名前競合とプライバシー漏洩リスク ​

filebin.net にはアカウントシステムがないため、IDが単純すぎると競合が発生し、エラーになったり他人のファイルをダウンロードしてしまったりします。使用時は以下に注意してください：

  • ストレージIDは必ず8文字以上のランダム文字列に設定してください。
  • パスワードや身分証明書などのプライバシー・機密情報は送信しないでください。
  • ショートカットを共有する前に、自身の専用IDとWebhookキーを必ず削除してください。

9. The X Subscription 統合サブスクリプションにおけるクォータ消費防止制御 ​

グループメンバーの雑談によってルーティンが空回りすると、1〜2日で1週間のクォータを使い果たし、Botが応答しなくなります。

2026年10月12日より、The X Subscriptionは共有プールから週単位でクォータを差し引きます。

Plusプラン（$8/月）にはGrok Botが含まれず、Premium（$30/月、4倍クォータ）、Super（$100/月、15倍クォータ）、Ultra（$200/月、50倍クォータ）にのみ含まれます。

消費防止の要点は2点です：

  1. ピンポイントのメンション（@自己）または特定の管理者コマンドの時のみWebhookをトリガーする。
  2. グループ全体の無差別リスニングは厳禁とし、高頻度かつ短サイクルのポーリング設定を避ける。

詳細なルールは 方案与计费 および 例程 を参照してください。

実践事例の振り返り ​

Feishu複数Bot協調（铁柱AGI） ​

パブリックIPがなくても協調動作が可能です。ポイントはアウトバウンドの永続接続を利用してポート開放を不要にすることです。

  1. 一括登録：Feishu Python SDKのQRコードスキャン認証を行い、管理者BotがGitのバックアップリストを読み込んで、チーフエディター、会計、仮想マシンの3つのBotのキーとWebhookを管理。
  2. セキュリティ確認：グループ内では @自己 または @所有人 にのみ応答。機密性の高い操作はBotがカードのボタンをプッシュして手動で承認。

WeChat ClawBot モバイルコンソール（Kin） ​

WeChat内でX（Twitter）運用やテキスト抽出Botを指示。公式プラグインのロングポーリングを利用することでアカウント停止を防止。

  1. 24時間稼働のクラウドPCにプロンプトを送信し、Tencent iLink（ilinkai.weixin.qq.com）を呼び出して getupdates ポーリングと sendmessage スクリプトを疎通。
  2. ポップアップでWebhookとキーを受け渡し、QRコードをスキャンして最初のメッセージを送信し、初期の context_token を取得。
  3. 注意した落とし穴：WeChatへの返信は必ずプレーンテキストに強制変換し、Markdown記号を除去すること。

WeChat画像・テキスト格納パイプライン ​

WeChatのサンドボックスによりアーカイブ全体の直接送信が制限されているため、一時オンラインストレージを中継として利用し制限を回避。

  1. 中継アップロード：MacやiPhoneの「一括転送」機能でチャットのZIPパッケージをエクスポートし、ショートカットが自動で filebin.net にアップロード。
  2. 自動アーカイブ：ショートカットがJSONを組み立ててGrok BotのWebhookに送信し、「13のデザインインスピレーションサイト」などの画像・テキストを解凍・アーカイブ。
  3. 検収基準：パスと要約を含む構造化されたレシートを必ず出力すること。

完了後の検収手順 ​

Feishu ​

  1. メッセージ応答：個別チャットは1秒以内に返信。グループチャットの通常のテキストには無反応、単独で @文章主编 をメンションすると応答、@所有人 で各Botが順次報告。
  2. 権限と自己修復：管理画面で14項目のイベント権限をすべて有効化しカード承認に対応。プロセスを手動で強制終了しても、5〜10秒以内に自動で再起動。

WeChat ​

  1. 環境とハンドシェイク：WeChatがiOS 8.0.70以上またはAndroid 8.0.69以上でプラグインが有効化されていること。スキャン後の最初のメッセージが context_token を用いて返信され、Markdownの乱れがないこと。
  2. 遮断とエラーハンドリング：紐付けされていないアカウントは無視。再起動後に自動復旧し、エラーコード -14 が発生した場合はQRコードの再スキャンを促すこと。

ショートカット ​

  1. 格納操作：Webhook、Bearerキー、8文字以上の画像ストレージIDを入力済みであること。WeChatで添付ファイルをタップして読み込んでから一括転送すること。単独での起動も可能であること。
  2. 出力と照合：レシートには要約、ノートのパス、保存先パスが記載されていること。プランページで使用量を確認し、空回りによる継続的な課金を防ぐこと。

関連リンク（さらに詳しく） ​