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

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

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

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