飛書 Channel 設定指南

逐步說明如何建立飛書應用,並將其設定為 OpenClaw 的訊息頻道。

開啟飛書開發者主控台

1
開啟開發者主控台

前往 https://open.feishu.cn/app,並使用您的飛書帳號登入。

建立應用程式

2
建立新的企業應用程式

點選 'Create Enterprise App',填寫應用程式名稱、描述並選擇圖示。

建立新的企業應用程式

取得應用程式憑證

3
複製 App ID 與 App Secret

在 'Credentials & Basic Info' 頁面複製 App ID(格式如 `cli_xxx`)與 App Secret。請妥善保管 App Secret,避免外洩。

複製 App ID 與 App Secret

啟用機器人能力

4
啟用機器人

在 'App Capabilities' > 'Bot' 中啟用機器人能力,讓應用程式可在聊天中以機器人身分運作。

啟用機器人

設定權限

5
匯入必要權限

在 'Permission Management' 點選 'Bulk Import',貼上下方 JSON 以匯入必要的租戶與使用者權限。 ```json { "scopes": { "tenant": [ "contact:contact.base:readonly", "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "cardkit:card:write", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": [ "contact:contact.base:readonly", "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] } } ```

匯入必要權限

在 OpenClaw 中新增飛書頻道

6
新增頻道

登入 OpenClaw 帳戶,前往 'My OpenClaw' → 'Channels',點選 '+ Add Channel'。輸入取得的 Feishu App ID 與 App Secret,儲存並等待設定完成。

新增頻道

設定事件訂閱與回調

7
選擇連線模式

選擇 'Use long connection to receive events'(WebSocket 模式)。注意:OpenClaw 必須先完成 Feishu 頻道設定,否則儲存可能失敗。

選擇連線模式
8
新增訊息接收事件

新增事件 `im.message.receive_v1` 以接收傳入訊息。

新增訊息接收事件

發佈應用程式

9
發佈

填寫版本資訊並儲存,接著發佈應用程式,使其可供您的租戶使用。

發佈

與機器人聊天

10
傳送訊息給機器人

在 Feishu Workbench 找到您建立的機器人並傳送訊息,即可開始聊天。

傳送訊息給機器人