Grok Bot 新手指南

繁體中文

简体中文
English
日本語
한국어
Español
Português (Brasil)

繁體中文

简体中文
English
日本語
한국어
Español
Português (Brasil)

外觀

付費答疑群
第三篇 · 進階篇

第 22 章 接入飛書與微信 ​

不用公網 IP 和自建伺服器，就能把 Grok Bot 安全接入飛書與微信。

The X Subscription（2026年10月12日生效）按周扣額度，群聊必須配訊息過濾，否則閒聊會耗光整週額度。

  • 飛書多 Bot 協同：走官方 Python SDK 長連線與「飛書應用管家」模板。
  • 微信 ClawBot 直連：靠官方「微信ClawBot」外掛和 iLink 介面。
  • 微信快捷指令收錄：借蘋果快捷指令與 Webhook 歸檔記錄。

接入飛書與微信

接入通道對比與技術選型 ​

接入通道對比與技術選型

三種接入方式全都不需要公網 IP。

  • 飛書多 Bot 通道：用於團隊辦公與群聊派工。走官方 WebSocket 長連線出站，支援富文字與卡片，群內僅響應 @ 保護額度。
  • 微信 ClawBot 通道：用於個人日常隨身助理與排程。走 iLink 長輪詢，僅支援純文字，靠白名單單聊避免無效喚醒。
  • 微信快捷指令通道：用於圖文與音訊資產入庫。走 Webhook 單向推送並返回回執，按需觸發，無訊息不產生額外消耗。

團隊接入飛書：多 Bot 協同與飛書應用管家 ​

團隊接入飛書：多 Bot 協同與飛書應用管家

飛書長連線與門鈴觸發器機制 ​

走長連線出站，免去公網 IP、證書和開放埠。

  1. 飛書自建應用：負責群聊與單聊收發。
  2. 雲端轉發程式：後臺監聽長連線並轉交。
  3. 門鈴觸發器：喚醒 Bot 並調 SDK 回覆。

怕重複配置，用「飛書應用管家」掃碼自動建應用。

怎麼做：從單 Bot 跑通到多 Bot 協同 ​

掃碼建首個 Bot（文章主編） ​

  1. 私聊讓 Bot 調飛書 SDK 掃碼建應用。該連結為一次性憑證且僅限管理員使用，切勿點他人連結或轉發。
  2. 瀏覽器開啟連結點「建立」並確認許可權，憑證自動回傳。
  3. 收到飛書測試訊息後回覆一條，Bot 自動將你的 Open ID 寫入白名單。

建立門鈴例程 ​

  1. 點選對話頂部的 Bot 名稱，開啟詳情裡的 Details 面板。步驟見 例程。
  2. 在例程建 Webhook 門鈴，獲取 POST to 地址與 key。
  3. 必須在 Bot 彈出的加密輸入框提交憑證，避免明文洩露。單聊發測試文字，Bot 正常回復即跑通。

批次建應用與群聊協同 ​

  1. 匯入模板 https://x.ai/bot/AJpUlCwa8tyMX7L5UHnuY。登記表與恢復指令碼存 Git 私有倉庫，不存明文金鑰。
  2. 向管家下令批次生成掃碼連結（每連結 1 小時有效），掃碼並在加密窗填 key，管家自動拉起轉發。
  3. 建群拉入各 Bot，發 @所有人 確認彙報管轄範圍；@文章主编 調 虚拟机服务管家，服務管家發登記表進群即完成協同。

互動安全 ​

  • 指令來源校驗：僅響應群內白名單管理員的直接指令。
  • 飛書卡片確認：改配置、寫庫或重啟等高危操作推送帶「同意」與「駁回」按鈕的卡片，在飛書內點選即可二次授權。

做到什麼程度算好 ​

  • 端到端耗時低於 1 秒：發訊息基本秒回。
  • 群聊訊息精準分流：閒聊靜默，單獨 @ 誰誰回，@所有人按職責彙報不搶答。
  • 高可用自愈：退出 5 秒內拉起，每 5 分鐘巡檢假死，強殺程序約 9 秒恢復。

實操參考《Grok Bot 團隊接入飛書保姆級教程（附飛書管家模板）》。

個人接入微信：微信 ClawBot 外掛直連 ​

個人接入微信：微信 ClawBot 外掛直連

走官方 iLink 介面（ilinkai.weixin.qq.com），純出站長輪詢，不開放公網埠，合規且無封號風險。

三步完成接入 ​

  1. 傳送提示詞：電腦端向主 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. 繫結與啟用：
    • 微信版本須滿足 iOS ≥ 8.0.70，Android ≥ 8.0.69，在「設定-外掛」啟用「微信ClawBot」。
    • 對電腦 Bot 發「外掛開好了」，微信掃碼授權（二維碼 5 分鐘內有效）。
    • 必須主動向微信 ClawBot 發首條訊息（如“你好”），獲取 context_token 啟用回包。

驗收標準 ​

  • 雙向同步：微信端秒級回覆，電腦端實時存檔。
  • 子 Agent 排程：在微信直接派發推特檢索、影片轉錄任務。
  • 安全隔離：未繫結的微訊號無法喚醒。

細節見《如何把 Grok Bot 接入你的微信？保姆級新手指南來了（附詳細提示詞）｜Kin》。

微信內容入庫：快捷指令打通聊天記錄與多媒體 ​

透過快捷指令把合併轉發的 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. 微信多選聊天記錄，合併轉發到其他應用，選快捷指令「傳送給知識庫 Bot」中的「接收轉發」。未接收轉發時會讀剪貼簿，也能選「截圖」或「錄音」直傳。

驗收標準 ​

  • 多媒體解析完整：解壓並分類圖片、文件與語音（如 13 個設計靈感網站按整站、App、元件建索引）。
  • 回執規範：標清主題要點、筆記儲存路徑與原始 ZIP 歸檔路徑。

參考：《微信聊天記錄打通 Grok Bot：快捷指令進階版》。

容易踩的坑與排查方案 ​

1. 飛書許可權配置不足導致群訊息無法接收 ​

  • 坑點：單聊正常但群內 @ 沒反應也沒日誌，因初選 7 項許可權，漏了「獲取群組中所有 @機器人的訊息」。
  • 解法：走 SDK 掃碼生成補權連結，管理員確認擴到 14 項，無需重新發版。

2. 飛書群聊過濾規則誤判與長連線斷線重推 ​

  1. 漏訊息與搶答：飛書 @所有人 不在 mention 陣列，不驗 ID 又會全員搶答。指令碼必須卡準目標 ID，只響應「@自己」或「@所有人」。
  2. 重複回覆：網路恢復後官方會自動補推，千萬別手動二次補發。

3. 跨 Bot 呼叫的信任鏈與授權卡片缺失 ​

  1. 群裡 Bot 互調沒反應，是跨 Bot 訊息預設不可信，全卡在私聊等確認。
  2. 轉發層配白名單認管理員 Open ID；高危操作推帶同意/駁回的飛書卡片確認。

4. 虛擬機器 Python 執行環境路徑錯誤 ​

  • 指令碼報錯提示找不到 lark-oapi，通常是配置守護任務時誤用了系統預設的 /usr/bin/python3。
  • 在啟動指令碼、Supervisor 和定時任務裡，必須寫死虛擬環境的絕對路徑（如 /home/user/venv/bin/python3），別直接調系統全域性環境。

5. 微信 ClawBot 二維碼失效與錯誤碼 -14 ​

  • 二維碼只有 5 分鐘有效期，超時會失效，出來後趕緊用手機掃。
  • 後臺報錯誤碼 -14 是憑證過期了，重新生成二維碼讓管理員再掃一次就行。

6. 微信訊息格式混亂與 Markdown 渲染失敗 ​

  • 微信不解析 Markdown，星號、反引號和標題符號都會直接露出來。
  • 在接入提示詞或轉發指令碼里加過濾，統一轉成帶換行的純文字再發給微信。

7. 微信合併轉發 ZIP 缺少未載入的多媒體附件 ​

微信不存原檔案，沒點開載入的不會打進壓縮包，解壓就會丟圖片。

  1. 轉發前，逐個點開需要儲存的圖片和檔案。
  2. 等本地完全載入好，再去打包轉發。

8. 臨時網盤的命名衝突與隱私洩露風險 ​

filebin.net 沒賬號體系，ID 太簡單會撞車，導致報錯或下到別人的檔案。用的時候注意：

  • 圖床 ID 必須設為 8 位以上隨機字串。
  • 別傳密碼、身份證等隱私內容。
  • 分享快捷指令前，刪掉自己的專屬 ID 與 Webhook 金鑰。

9. The X Subscription 統一訂閱下的額度防耗控制 ​

群員閒聊會觸發例程空轉，一到兩天就會耗盡周額度導致 Bot 停止響應。

2026 年 10 月 12 日起 The X Subscription 按周從共享池扣額度。

Plus 檔（$8/月）沒有 Grok Bot，只有 Premium（$30/月，4x 額度）、Super（$100/月，15x 額度）與 Ultra（$200/月，50x 額度）包含。

防耗抓兩點：

  1. 僅在精準提及（@自己）或特定管理員指令時觸發 Webhook。
  2. 嚴禁全群無差別監聽，避免配置高頻短週期輪詢。

詳細規則參考 方案與計費 與 例程。

實戰案例覆盤 ​

飛書多 Bot 協同（铁柱AGI） ​

沒公網 IP 也能跑協同，核心是用出站長連線免打洞。

  1. 批次註冊：飛書 Python SDK 掃碼授權，管家 Bot 讀 Git 備份表，託管主編、記賬與虛擬機器 3 個 Bot 的金鑰和 Webhook。
  2. 安全確認：群內僅響應 @自己 或 @所有人。高敏感操作由 Bot 推卡片按鈕人工授權。

微信 ClawBot 隨身臺（Kin） ​

微信內排程推特運營與文案提取 Bot，走官方外掛長輪詢能防封號。

  1. 給 7×24 小時雲電腦發提示詞，調騰訊 iLink（ilinkai.weixin.qq.com）跑通 getupdates 輪詢與 sendmessage 指令碼。
  2. 彈窗交接 Webhook 和金鑰，掃碼發首條訊息拿到初始 context_token。
  3. 踩坑點：微信回覆必須強制轉純文字，剝除 Markdown 符號。

微信圖文歸庫流水線 ​

微信沙盒禁了整包直傳，用臨時網盤當中轉可繞過限制。

  1. 中轉上傳：Mac 或 iPhone 用「合併轉發」匯出聊天 ZIP 包，快捷指令自動傳到 filebin.net。
  2. 自動歸檔：快捷指令拼 JSON 發給 Grok Bot 的 Webhook，解壓歸檔「13 個設計靈感網站」等圖文。
  3. 驗收標準：必須輸出帶路徑與摘要的結構化回執。

做完怎麼驗收 ​

飛書 ​

  1. 訊息響應：私聊 1 秒內回覆；群聊發普通文字靜默，單獨 @文章主编 響應，@所有人 各 Bot 依次彙報。
  2. 許可權與自愈：後臺開齊 14 項事件許可權並支援卡片授權；手動殺掉程序，5 至 10 秒內自動拉起。

微信 ​

  1. 環境與握手：微信高於 iOS 8.0.70 或 Android 8.0.69 並啟用外掛；掃碼首條用 context_token 回覆且無 Markdown 亂碼。
  2. 攔截與報錯：未繫結賬號直接忽略；重啟後自動拉起，遇到錯誤碼 -14 提示重新掃碼。

快捷指令 ​

  1. 入庫操作：填好 Webhook、Bearer 金鑰及 8 位以上圖床 ID；微信先點開載入附件再合併轉發，也能獨立喚醒。
  2. 輸出與對賬：回執須包含提要、筆記路徑與留存路徑；在方案頁核查用量，避免持續空轉扣費。

延伸閱讀 ​