飞书接入——一站式协作平台 | Easy Understand Hermes Agent

這篇教學將手把手教你如何把 Hermes Agent 接入飛書或 Lark，讓你直接在聊天視窗裡指揮 AI 助手。

準備工作：像「配鑰匙」一樣建立應用程式

要讓 Hermes 在飛書裡「安家」，首先得在飛書開放平台建立一個「應用程式」——你可以把它想像成給機器人配一把專屬鑰匙。

推薦方式（一條指令搞定）：

hermes gateway setup

選擇 Feishu / Lark，然後用手機飛書 App 掃碼，Hermes 會自動幫你建立好應用程式並配好權限，省心省力。

手動建立（備選方案）：

開啟飛書開放平台（https://open.feishu.cn/）或 Lark 國際版控制台
建立一個新應用程式，在「憑證與基礎資訊」裡找到 App ID 和 App Secret（相當於帳號密碼）
開啟「機器人」能力
在「權限管理」裡加入以下權限（可批次匯入）：

必選權限：

權限	用途
`im:message`	接收和讀取訊息
`im:message:send_as_bot`	以機器人身分傳送訊息
`im:resource`	存取使用者傳送的圖片、檔案
`im:chat`	取得群聊資訊

強烈建議加上： im:message.reactions:readonly（接收表情回應）、contact:user.id:readonly（辨識使用者身分）

在「事件與回調」裡訂閱 im.message.receive_v1 事件（這是接收訊息的「開關」）
發布應用程式版本——不發布的話權限不會生效喔！

選擇連線方式：像選「電話線」還是「對講機」

WebSocket 模式（推薦）：Hermes 主動連上飛書的伺服器，不需要公網位址，適合個人電腦或內網伺服器使用。

FEISHU_CONNECTION_MODE=websocket

Webhook 模式：適合已有公網伺服器的使用者，飛書會把訊息「推」到你的伺服器上。

FEISHU_CONNECTION_MODE=webhook

設定 Hermes：填寫「通訊錄」

把以下設定加到 ~/.hermes/.env 檔案裡：

FEISHU_APP_ID=cli_xxx
FEISHU_APP_SECRET=secret_xxx
FEISHU_DOMAIN=feishu        # 國內版用 feishu，國際版用 lark
FEISHU_CONNECTION_MODE=websocket

# 強烈建議設定以下兩項：
FEISHU_ALLOWED_USERS=ou_xxx,ou_yyy   # 允許使用的使用者ID白名單
FEISHU_HOME_CHANNEL=oc_xxx           # 接收定時任務結果的群聊ID

啟動閘道

hermes gateway

然後給機器人傳一則訊息試試，通了就大功告成！

安全設定：給門上把鎖

使用者白名單：生產環境務必設定 FEISHU_ALLOWED_USERS，否則任何能接觸到機器人的人都能使用它。

群聊策略：預設只在被 @ 時回覆，可透過 FEISHU_GROUP_POLICY 調整：

allowlist（預設）：只回覆白名單使用者
open：任何人 @ 都回覆
disabled：完全不理會群組訊息

加密驗證（Webhook 模式）：設定 FEISHU_ENCRYPT_KEY 和 FEISHU_VERIFICATION_TOKEN，防止別人偽造訊息。

小總結

接入飛書就像給 Hermes 裝了個「中國本地電話」——掃碼建立應用程式、設定權限、選擇連線方式、設定安全策略，四步就搞定。現在你可以在飛書裡直接和 AI 對話了！

下篇預告：我們將探索 Hermes 的「記憶宮殿」——如何設定長期記憶，讓 AI 真正「記住」你的偏好和對話歷史。