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

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

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

更多功能場(chǎng)景可自行探索和解鎖。