更新時間:2026-03-11
適配版本:OpenClaw的新網云主機應用鏡像
本文主要介紹在新網云主機中部署完成 OpenClaw 后,如何配置并接入飛書機器人;
正式為 OpenClaw (Clawdbot) 配置接入飛書機器人前,需完成以下兩項準備:
1. 已擁有有效的飛書賬號;
2. 已購買新網云主機,且主機預裝 OpenClaw 鏡像。
1. 使用飛書賬號登錄飛書開放平臺(開發者后臺 - 飛書開放平臺),登錄后點擊創建企業自建應用;
2. 按要求填寫應用信息,完成后點擊創建進入應用管理頁面:
● 應用名稱:建議填寫如 “OpenClaw 助手”,字符數限制 8/32;
● 應用描述:按需填寫,字符數限制 8/120;
● 應用圖標:支持 JPEG/PNG/SVG/BMP 格式,大小 2MB 以內,分辨率大于 240*240px,無圓角。
1. 在已創建應用的管理頁面左側導航欄,點擊添加應用能力;
2. 在彈出的能力列表中選擇機器人,點擊添加;
提示:添加機器人后可暫不發布,待后續所有配置完成后一并發布。
1. 在應用管理頁面左側導航欄,點擊憑據與基礎信息;
2. 在頁面中找到App ID和App Secret,分別點擊右側復制按鈕,將兩個參數妥善保存至記事本 / 備忘錄(注意數據安全,切勿泄露),后續配置步驟需使用。
通過http://IP:18789/ 打開openclaw管理界面,點擊右上角設置-claw設置;
1. 已獲取有效的 API Key(從對應大模型平臺申請,如 OpenAI 官網、UCloud UModelVerse 控制臺)
2. OpenClaw 網關已啟動(openclaw gateway status 確認狀態為 running)
3. 通過終端命令引導配置,無需手動改文件,步驟如下::
執行模型配置命令:openclaw models add
按終端提示逐步填寫(以 OpenAI 兼容接口為例)
配置項 | 示例值 | 說明 |
模型名稱(自定義) | gpt-4o | 便于識別,如 gemini-pro |
API 類型 | openai(回車默認) | 可選 openai/gemini |
API Base URL | 第三方接口填對應地址 | |
API Key | sk-xxxxxx | 你的平臺 API Key |
默認模型 ID | gpt-4o | 如 gemini-1.5-pro |
最大上下文長度 | 8192(回車默認) | 按需調整,不超模型限制 |
溫度(temperature) | 0.7(回車默認) | 0-2,值越高回復越隨機 |
配置完成后,終端會提示 Model [名稱] added successfully,執行以下命令生效:openclaw gateway restart
4. 通道類型選擇飛書,在輸入框中填寫前文保存的飛書機器人App ID和App Secret;
5. 點擊確定并確認操作,等待數十秒完成配置;
6. 配置完成后查看通道狀態,確保飛書通道顯示運行中。
1. 返回飛書開放平臺的應用管理頁,左側導航欄點擊事件與回調,進入事件配置頁簽;
2. 訂閱方式選擇長連接接收事件,點擊保存;
?? 注意:若點擊保存時報錯未建立長連接,先檢查飛書機器人的 App ID 和 App Secret 是否配置正確;
3. 點擊添加事件,在彈出列表中搜索并添加接收消息(im.message.receive_v1),按頁面指引確認開通對應權限;
4. 若需將機器人添加至群聊使用,可按上述步驟額外添加消息已讀、機器人進群、機器人被移出群等群組相關事件。
1. 在事件與回調頁面,切換至回調配置頁簽;
2. 訂閱方式選擇使用長連接接收回調,直接點擊保存,無需填寫其他地址,配置將自動生效。
1. 在飛書應用管理頁左側導航欄,點擊權限管理進入配置頁面;
2. 可按需單獨開啟權限,也可點擊批量導入權限按鈕,通過彈窗快速導入所需權限;
3. 基礎權限(確保機器人基礎功能運行,建議全部開通):
權限范圍 (Scope) | 權限類型 (Permission) | 功能描述 (Description) |
contact:user.base:readonly | User info | 獲取基礎用戶信息 |
im:message | Messaging | 收發消息 |
im:message.p2p_msg:read only | DM | 讀取機器人的私信消息 |
im:message.group_at_msg:readonly | Group | 接收群內 @ 機器人的消息 |
im:message:send_as_bot | Send | 以機器人身份發送消息 |
im:resource | Media | 上傳/下載圖片/文件 |
4. 可選全功能權限(按需開啟,部分為敏感權限):|
權限范圍 (Scope) | 權限類型 (Permission) | 功能描述 (Description) |
im:message.group_msg | Group | 讀取群內所有消息(敏感) |
im:message:readonly | Read | 獲取消息歷史記錄 |
im:message:update | Edit | 編輯/更新已發送的消息 |
im:message:recall | Recall | 撤回已發送的消息 |
im:message.reactions:read | Reactions | 查看消息的互動反饋 |
提示:需確保消息、機器人、事件訂閱等相關權限均已開啟,后續使用中可根據需求隨時調整權限設置。
1. 在飛書應用管理頁左側導航欄,點擊版本管理與發布;
2. 點擊頁面右上角創建版本,按要求填寫信息:
● 應用版本號:對用戶展示的正式版本號,為必填項;
● 更新說明:內容將顯示在應用的更新日志中,為必填項,字符數限制 0/500;
● 移動端 / 桌面端的默認能力:均選擇機器人;
3. 填寫完成后點擊保存并確認發布;

等待飛書管理員審核,審核通過后,可在版本管理與發布頁面查看已發布的版本號和狀態(飛書個人版通常免審核,提交發布后可直接上線)。
首次與飛書機器人對話時,若機器人返回配對請求消息(含 Feishu user id、Pairing code 及配對命令)
按以下步驟完成配對:
1. 復制機器人回復的最后一行命令行:openclaw pairing approve feishu [配對碼];
2. 登錄新網控制臺,通過SSH/VNC遠程登錄部署 OpenClaw 的輕量應用云主機(SSH 登錄用戶:root,端口:22);
3. 在云主機的遠程終端中粘貼上述復制的命令,按回車執行;
4. 命令執行成功后,終端將提示Approved feishu sender [用戶 ID],即表示配對完成。

完成上述所有配置和配對操作后,即可正常使用飛書機器人,支持兩種交互方式:
1. 單聊交互:直接在飛書向 OpenClaw 機器人發送消息,已支持天氣查詢、新聞獲取、詩詞查詢、圖片 OCR 識別等功能;
2. 群聊交互:將 OpenClaw 機器人添加至飛書群聊,通過 **@機器人 ** 的方式發送指令,即可觸發機器人交互;

更多功能場景可自行探索和解鎖。