它是什麼

飛書知識庫「Grok Bot 焚诀」裡、文末署名網名 @cgnot996 的〈Grok Bot 團隊接入飛書保姆級教程〉。目標是把多個 Grok Bot 做成彼此獨立的飛書機器人,拉進同一群裡用 @ 派活。作者的理由是:若本來就深度使用飛書,接入後可以沿用原有工作方式;不是因為 Grok Bot 缺少官方客戶端。同庫〈4.5 連接器、Skill、模板與對外入口〉見 grokbot-connectors-skills-templates-20261113:該頁另寫開放平台建企業自建應用的短步驟,與本卡的掃碼建應用、門鈴觸發器是同一目的的不同寫法。

能用來做什麼

用來理解「一 Bot 一應用、一轉發程式、一門鈴觸發器」的接法,以及作者踩過的權限、@ 過濾與確認坑。這是作者方法,不是官方標準安裝說明。

怎麼用(作者方法,未實測)

整套方案不需要公網 IP 或自備伺服器,向外走飛書長連接。觸發器的作用是:飛書一來消息就叫醒對應 Bot,Bot 再用自己的機器人身分回進會話。

起步(作者敘事,只整理步驟類型,不寫金鑰):

  1. 先讓一個 Bot(作者示例為「文章主編」)呼叫飛書官方 Python SDK 的掃碼建應用功能,在私聊交出一次性建立連結與二維碼。連結只能一人使用;發起方會拿到應用憑證,別人轉來的連結不要點,自己的也不要亂發。
  2. 建好後,應用憑證由系統回傳給該 Bot,作者稱無需人手複製密鑰。此時若門鈴尚未接上,單聊可能先發得出、收不回;作者曾用這條收不到的消息把對方加入白名單。
  3. 門鈴建好後,觸發器的地址與密鑰由人填進加密輸入框,不要出現在普通聊天裡,Bot 也不應直接看見這兩個值。
  4. 單聊雙向跑通後,再另建「飛書應用管家」幫其他 Bot 批量建應用,並維護一張登記表:哪個 Bot 對應哪個應用、密鑰放在哪(只記路徑)、對應哪個門鈴。電腦更新後靠這張表恢復身分;轉發程式啟停交給虛擬機服務管家,思路與 grokbot-vm-backup-restore-20261113 相同。登記表與恢復步驟不放明文密鑰,並與記憶備份放在同一私有 Git 倉。
  5. 管家一次發出的掃碼連結也是一次性、限時(原文稱一小時內)。掃碼前確認飛書切到已綁飛書 CLI 的企業。敏感值同樣只進加密框。
  6. 單聊全通後,再把機器人拉進同一個群,用 @ 分工。Bot 轉達的話不要當成主人本人的指令;需要確認時,直接在飛書裡推帶「同意/駁回」的卡片,不必在飛書與 Grok 客戶端之間切來切去。從飛書轉進來、確認是本人的消息,作者後來改為視同親口說的。

作者公開的模板:https://x.ai/bot/AJpUlCwa8tyMX7L5UHnuY (作者稱已去掉金鑰、個人與企業資訊及自己的 Bot 名單,保留規則與踩坑經驗;虛擬機腳本帶不進模板,導入後會在你自己的環境從頭搭建)。本卡不保證該連結長期有效。作者預告還有與飛書多維表格協作的後續,本輪未收入。

限制與坑

作者寫明的關鍵坑:

  • 權限不夠時,單聊正常、群訊息卻推不過來。原因是漏了「獲取群組中所有 @ 機器人的消息」。後來用 SDK 掃碼接口追加權限,不必重新發版,密鑰也不變。作者後來把預設權限加到 14 項。具體權限名稱以飛書後台當時清單為準。
  • 轉發程式若設成「群裡未 @ 機器人就不轉」,飛書的「@所有人」並不算 @ 該機器人,會被濾掉。若只判斷「有人被 @」,別的 Bot 也會搶答。後來改成只認 @自己或 @所有人。
  • 長連接靜默斷線時,重連後飛書可能補推,不要急著手動補轉,以免回兩遍。轉發程式作者自述有守護循環(退出約 5 秒拉起)與定時巡檢,強殺後約 9 秒自行恢復(作者自述,未獨立實測)。
  • 回訊息要用裝了飛書 SDK 的虛擬環境絕對路徑,不要用系統自帶、沒裝套件的 python3。
  • 已經有其他觸發器的 Bot,接飛書要另建專門的「飛書消息」門鈴,避免把閒聊寫進原有業務觸發器。

文末「GitHub 1400+ Star」「駐場落地百萬級 AI 項目」為作者自述,不當事實。

成本

本篇未列額外訂閱價。飛書應用與長連接本身的費用以飛書當時方案為準,本輪未查。Grok Bot 週額度見 grokbot-quota-saving-checklist-20261113。

更新紀錄

  • 2026-11-13 依瀏覽器公開唯讀全文(sha256=19ea648b1f54809216cfbad858efa32fe7ba2c8a0327a215220ad4078b26e15e)整理為 B 級正式卡。來源:2026-11-12-feishu-grokbot-fenjue