保姆級 OpenClaw （原 Clawdbot）飛書對接教程 手把手教你搭建 AI 助手
OpenClaw 是一款開源的本地 AI 助手,支持在你自己的服務器上部署,通過飛書、WhatsApp、Telegram 等聊天工具交互。與雲端 SaaS 服務不同,OpenClaw 讓你完全掌控數據隱私,可以執行系統命令、瀏覽網頁、管理文件,甚至編寫代碼。本教程將手把手教你在 Linux 系統下安裝 OpenClaw 並對接飛書機器人,打造專屬的智能助理。
注意：本教程在 Linux 系統下進行
如果你需要釘釘教程，可以看OpenClaw（原 Clawdbot）釘釘對接保姆級教程 手把手教你打造自己的 AI 助手
OpenClaw 是什麼？
OpenClaw(原名 Clawdbot,後更名為 Moltbot,現正式命名為 OpenClaw)是一個運行在你本地環境的高權限 AI 智能體。它的核心特性包括：
- 本地部署：運行在你的服務器或電腦上,數據完全自主可控
- 多平台支持：支持飛書、WhatsApp、Telegram、Discord、Slack 等主流聊天工具
- 瀏覽器控制：可以瀏覽網頁、填寫表單、提取數據
- 系統訪問：讀寫文件、執行 Shell 命令、運行腳本
- 持久化記憶：記住你的偏好和上下文,成為真正屬於你的 AI
- 插件擴展：支持社區技能插件,甚至可以自己編寫插件
無論是郵件管理、日程安排、數據查詢還是代碼編寫,OpenClaw 都能成為你的得力助手。
準備工作
首先準備一台閒置的雲服務器或 VPS（推薦使用香港或海外節點）。由於 OpenClaw 運行時權限較大，出於安全考慮，不建議在本地或工作機上安裝，推薦在一台獨立的空服務器上部署。準備完成後，登錄到服務器。
安裝
如果你不想安裝，可以直接使用阿里雲的Openclaw 一鍵部署 (原 Clawdbot)，部署之後可以直接跳到對接飛書。
第一步安裝 Git
# 安裝 Git
sudo apt update
sudo apt install git -y
第二步安裝 Node.js
# 安裝 NVM
# 國內使用 gitee 的鏡像源
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
# 國外使用
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
# 重新加載環境變量
source ~/.bashrc
# 安裝 Node.js 22
nvm install 22
# 查看 nodejs 版本
node -v # 輸出 v22 即可，版本只要 22 就行
安裝 Openclaw
# 使用官方腳本安裝
curl -fsSL https://openclaw.bot/install.sh | bash
服務器在國內，如果安裝失敗的話，可能需要解決網絡問題
其他平台安裝方式請參考Openclaw 安裝文檔 (原 Clawdbot)
你會看到如下圖輸出
如果首次安裝，時間會很長，需要耐心等待。
如果最後輸出如下內容：
→ npm install failed; cleaning up and retrying...
新的腳本服務器內存要求變高了，據我使用下來 2G 內存，肯定會 OOM，如果出錯的話，建議使用 swap 把硬盤空間當作交互內存使用。
成功之後會輸出如下圖片
第一個選項選擇 yes, 就是詢問你是否知道風險的。
第二步選擇 QuickStart
第三步選擇模型服務商，這裏選擇 Qwen，免費額度充足，適合入門使用
選擇千問模型後，會提供一個鏈接，複製並在瀏覽器中打開，如下圖
打開瀏覽器後，會看到如下界面。由於我已登錄過，所以顯示賬户信息；如果尚未登錄，按照提示完成登錄即可。
登錄完成後，會出現以下選項，提示選擇對應的千問模型，如下圖
選擇默認模型即可。接下來會提示選擇 channel，這裏先跳過，後續再添加
繼續下面選擇 skills，也是選擇 No，如下圖
繼續下面選擇 hooks，也是使用空格選擇 No，如下圖
然後等待安裝完成，最後會出現以下選項，這裏選擇 TUI
如果看到 TUI 聊天界面，説明安裝成功，可以嘗試輸入 Hello 進行測試。
然後直接使用 ctrl+c 先關閉，後面我們再來設置
查看服務
可以使用下面的命令來查看
clawdbot status
會看到如下圖的結果就説明服務啓動了
訪問 Web UI 面板
如何訪問面板？服務監聽在 http://127.0.0.1:18789/ 端口上，我們現在通過 ssh 隧道來訪問，輸入下面的命令
ssh -N -L 18789:127.0.0.1:18789 用户名@服務器IP
# 回車之後
用户名@服務器IP's password: # 輸入密碼
然後在瀏覽器打開 http://127.0.0.1:18789/, 你會看到 Dashboard 了，如下圖
圖中顯示的是未授權狀態，回到服務器，輸入以下命令
clawdbot dashboard
會看到下面的面板數據
複製對應的 Dashboard URL 到瀏覽器打開，即可正常查看聊天記錄。
至此 Openclaw (原 Clawdbot) 已安裝完成，可以正常訪問了。然後聊天框裏面首次輸入 Hello, Clawdbot 會詢問你他應該叫什麼，應該叫你什麼。就是你需要給它設置個名字，還有 bot 改叫你什麼。你可以在聊天框這麼輸入
Name: Openclaw
My Name: Boss
對接飛書
首先安裝飛書插件，輸入以下命令
clawdbot plugins install @m1heng-clawd/feishu
登錄飛書開放平台 https://open.feishu.cn，點擊「開發者後台 -> 創建企業自建應用」，如下圖
然後點擊創建應用，如下
創建完成後，首先到憑據管理中獲取 App ID 和 App Secret，注意保存，後續配置需要使用。
然後添加機器人，如下操作
首先配置個名字
飛書的其他配置先暫停，回到服務器配置 Openclaw 的飛書參數
添加飛書配置
clawdbot config set channels.feishu.appId "飛書 app id"
clawdbot config set channels.feishu.appSecret "飛書 app secret"
clawdbot config set channels.feishu.enabled true
# 推薦使用 websocket
clawdbot config set channels.feishu.connectionMode websocket
clawdbot config set channels.feishu.dmPolicy pairing
clawdbot config set channels.feishu.groupPolicy allowlist
clawdbot config set channels.feishu.requireMention true
配置完成之後，重啓
clawdbot gateway restart
支持羣機器人
如果需要在羣聊中支持。你可以創建飛書羣聊，然後把機器人應用拉進羣裏，但是上面的配置就需要做修改了。
實際上你可以通過跟機器人聊天讓它去改，把下面的命令告訴它，讓它去改就行了。不需要自己去服務器改
# 這個配置兼容上面的配置
clawdbot config set channels.feishu.dmPolicy open
clawdbot config set channels.feishu.groupPolicy open
clawdbot config set channels.feishu.allowFrom ['*']
重啓完成後回到飛書，找到「事件和回調」，選擇長連接模式，如下圖
如果配置成功，説明連接已建立。繼續下面的配置，添加事件，選擇「接收消息」事件
事件添加完成之後，還需要開通權限，有以下權限全部勾選
| 權限 | Scope（範圍） | Description（説明） |
|---|---|---|
| contact:user.base:readonly | 用户信息 | 獲取基礎用户信息 |
| im:message | 消息 全部勾選 | 發送和接收消息 |
如下圖
以上步驟全部完成後，即可與機器人對話。但在此之前需要先創建一個版本
注意：每次修改配置後都需要重新發布版本，建議全部配置完成後再統一發布。
發佈完成後，回到飛書客户端，可以看到應用已上線，點擊打開應用
向機器人發送 Hello，即可收到 Moltbot 的回覆
常見問題 FAQ
OpenClaw 和 Clawdbot、Moltbot 是什麼關係？
OpenClaw 是該項目的最新正式名稱。項目最初叫 Clawdbot，後因商標問題更名為 Moltbot，最終在 2025 年 1 月正式定名為 OpenClaw。三者是同一個項目的不同階段命名。
OpenClaw 支持哪些 AI 模型？
OpenClaw 支持多種 AI 模型服務商，包括 Anthropic Claude、OpenAI GPT、通義千問（Qwen）、KIMI、小米 MiMo 等。本教程使用通義千問是因為其免費額度充足，適合入門學習。
為什麼安裝時提示 npm install failed？
這通常是服務器內存不足導致的。新版本腳本對內存要求較高，2G 內存可能會出現 OOM（內存溢出）。建議配置 swap 交換空間，將硬盤空間作為虛擬內存使用。
OpenClaw 可以在 Windows 或 macOS 上運行嗎？
可以。OpenClaw 支持 Mac、Windows 和 Linux 系統。本教程以 Linux 為例，其他系統的安裝方式可參考官方文檔。
飛書機器人配置後無法收到消息怎麼辦？
請檢查以下幾點：
- 確認飛書插件已正確安裝（
clawdbot plugins install @m1heng-clawd/feishu） - 檢查 App ID 和 App Secret 配置是否正確
- 確認已開通「接收消息」事件權限
- 檢查長連接模式是否配置成功
- 確保應用版本已發佈
OpenClaw 數據安全嗎？
OpenClaw 運行在你自己的服務器上，所有數據都在本地存儲，不會上傳到第三方雲端。但由於它具有系統級權限，建議在獨立的服務器上部署，避免在生產環境或重要數據的機器上運行。
除了飛書，OpenClaw 還支持哪些平台？
OpenClaw 支持多個聊天平台，包括 WhatsApp、Telegram、Discord、Slack、Microsoft Teams、Signal、iMessage、Google Chat、Twitch 等。每個平台需要安裝對應的插件。
OpenClaw 可以做什麼？
OpenClaw 可以執行多種任務：
- 郵件管理和自動回覆
- 日程安排和提醒
- 瀏覽網頁和數據提取
- 文件讀寫和管理
- 執行 Shell 命令
- 編寫和運行代碼
- 數據查詢和分析
如何更新 OpenClaw 到最新版本？
使用以下命令更新：
openclaw update
OpenClaw 命令和 clawdbot 命令有什麼區別？
OpenClaw 更名後，官方推薦使用 openclaw 命令，但為了兼容性，clawdbot 命令仍然可用。兩者功能完全相同，建議新用户直接使用 openclaw 命令。
保姆級 OpenClaw （原 Clawdbot）飛書對接教程 手把手教你搭建 AI 助手
