2026 年 1 月底，整個(gè) AI 圈的目光都被一個(gè)名叫 OpenClaw 的項(xiàng)目所吸引，它以極快的速度拿下了超過20萬顆星標(biāo)，成為了GitHub 史上增長(zhǎng)最快的項(xiàng)目之列，截止目前總星標(biāo)數(shù)已經(jīng)來到 238K ，一個(gè)多月整整又翻了 10 倍，這個(gè)數(shù)據(jù)，但凡你做過開源項(xiàng)目，就知道有多么恐怖了！

[圖片上傳失敗...(image-b9038-1772414141922)]

OpenClaw(https://github.com/openclaw/openclaw) 已經(jīng)火了很長(zhǎng)時(shí)間了，記得它剛出來那會(huì)，我就關(guān)注它了，那時(shí)候星標(biāo)數(shù)才20多K，1個(gè)多月過去了足足翻了 10 多倍，可見其火爆程度超出我們想象~

起初 OpenClaw 給我留下印象最深的兩點(diǎn)就是：

• 它可以通過移動(dòng)端聊天軟件來遠(yuǎn)程控制它干活

• 對(duì)外號(hào)稱能 7x24 小時(shí)不停歇的干活

這兩點(diǎn)都跟“干活”有關(guān)，所謂干活就是它能真正幫你產(chǎn)出實(shí)際結(jié)果，有實(shí)際價(jià)值產(chǎn)出的。

這很很吸引我，但我仍然選擇先做個(gè)“等等黨”， 正如我在「狂師.AI 進(jìn)化社」中提到的觀點(diǎn)，AI時(shí)代，每天都有新產(chǎn)品、新技術(shù)冒出來，每一個(gè)都說自己是"現(xiàn)象級(jí)"、"顛覆性"、"革命性"。但對(duì)于普通人學(xué)AI，千萬別沖第一波。（除非是專門搞AI研究或者想蹭新熱點(diǎn)的自媒體知識(shí)博主）

為什么，普通人我不建議沖第一波?
因?yàn)樾庐a(chǎn)品剛出來的時(shí)候，總會(huì)有各種問題和波折。各家都在吹，說法紛紜，都說自己最好最棒。
等你興沖沖地去測(cè)試，媽呀，發(fā)現(xiàn)好像也就那么回事。

[圖片上傳失敗...(image-de2587-1772414141923)]

我的建議：等1周、2周，甚至1個(gè)月。
如果到那時(shí)候，大家還在持續(xù)討論和使用，那才是真正值得下手的時(shí)候。
時(shí)間是最好的過濾器。
能活過一個(gè)月還保持熱度的產(chǎn)品，才值得你投入時(shí)間學(xué)習(xí)。

這不，我這一等就是一個(gè)多月的時(shí)間...

今天不能再等了，這篇文章算是給我第一次使用 OpenClaw 做個(gè)見證，同時(shí)也給自己的學(xué)習(xí)做個(gè)筆記。如果有跟我一樣的朋友想要學(xué)習(xí)如何安裝、部署并配置使用 OpenClaw，看這篇文章就夠了，它向你推薦的是目前為止最佳的方式，且非常詳細(xì)，非常適合新手學(xué)習(xí)。

本文篇教程，非常詳細(xì)，且內(nèi)容較長(zhǎng)，建議先點(diǎn)贊，收藏，慢慢學(xué)習(xí)

在我們正式開始安裝部署之前，請(qǐng)?jiān)试S我再簡(jiǎn)單介紹一下 OpenClaw，即使它現(xiàn)在已經(jīng)非常有名了。

1. OpenClaw 是什么，為什么它突然就火了？

1.1 OpenClaw 是什么？

簡(jiǎn)單來說，它是一個(gè)裝在你本地電腦（或云服務(wù)器）上面的AI私人助理！

[圖片上傳失敗...(image-3ec9ad-1772414141923)]

就像是《鋼鐵俠》里的賈維斯。

大家都知道，鋼鐵俠想要做什么，從來不需要自己去敲鍵盤、查數(shù)據(jù)。他只需要隨口說一句：“賈維斯，幫我分析一下這個(gè)裝甲的受損情況”，或者“把那個(gè)恐怖分子的位置發(fā)給我”。

然后賈維斯就會(huì)立刻去執(zhí)行：掃描裝甲、調(diào)用衛(wèi)星、檢索數(shù)據(jù)庫、把結(jié)果直接展示出來。

OpenClaw 做的就是這件事。

它不是那種只會(huì)陪我們聊天的 AI，而是一個(gè)真正長(zhǎng)了手腳的 AI 助理。它住在我們的電腦里，擁有操作電腦的權(quán)限。

我們給它發(fā)個(gè)指令，它就能像真人一樣，去操作瀏覽器、打開文件夾、運(yùn)行軟件，幫你查資料、寫文檔、整理數(shù)據(jù)，幫我們把活干完。哪怕我們睡覺了，它也可以在后臺(tái) 24 小時(shí)隨時(shí)待命，隨時(shí)召喚。

當(dāng)然上面是為了方便大家理解，較為通俗解釋，

更準(zhǔn)確地說法：

OpenClaw是一個(gè)AI智能體平臺(tái)（Agent Platform），或者說它是一個(gè)自托管的個(gè)人 AI 助手網(wǎng)關(guān)（Gateway），它的作用是作為統(tǒng)一的控制網(wǎng)關(guān)，將你常用的聊天應(yīng)用（WhatsApp、Telegram、Discord、Slack、QQ、企業(yè)微信、飛書 等）連接到 AI 編程工具上。你需要在聊天應(yīng)用中，下發(fā)指令，AI就能幫我們自動(dòng)干活了。

1.2 OpenClaw 它不是什么？

OpenClaw很強(qiáng)大，但它也并非是萬能的，有幾個(gè)新手階段較為常見的誤解，越早澄清越好。

誤解1：它不是ChatGPT、Manus替代品

• 和 ChatGPT 比： ChatGPT 只能動(dòng)嘴，告訴你怎么做，最后干活的還是你自己。

• 和 Manus 比： Manus 雖然也能干活，但它是在云端的一個(gè)沙箱里運(yùn)行的，就像是在別人的電腦上操作，很多本地的文件、特殊的軟件它都碰不到，限制很多。

而 OpenClaw是一個(gè)平臺(tái)，讓你能搭建自己的AI助理，是直接跑在我們的地盤上（電腦或 VPS），這也是未來 AI 發(fā)展的主要形態(tài)！

實(shí)際上，OpenClaw可以接入ChatGPT的API，也可以接入Claude、KIMI、MiniMax等其他模型。它是模型的使用者，不是模型的競(jìng)爭(zhēng)者。

誤解2：它是云端服務(wù)，數(shù)據(jù)存在別人服務(wù)器上

這是OpenClaw最大的特點(diǎn)之一：它是可以直接運(yùn)行在你的個(gè)人電腦上的。

• 你的聊天記錄存在本地

• 你的文件處理在本地完成

• 你的API Key不會(huì)經(jīng)過第三方服務(wù)器

對(duì)于擔(dān)心數(shù)據(jù)隱私的企業(yè)和個(gè)人，這是巨大的優(yōu)勢(shì)。

?? 注意：雖然OpenClaw本身在本地運(yùn)行，但它調(diào)用AI模型時(shí)需要聯(lián)網(wǎng)。你的消息會(huì)發(fā)送到對(duì)應(yīng)的AI服務(wù)商（如OpenAI、KIMI等）。

誤解3：它會(huì)自己上網(wǎng)亂買東西、亂刪文件、瞎搞一通

OpenClaw的設(shè)計(jì)理念是最小權(quán)限原則。默認(rèn)情況下，它什么都不能做。

• 想讓它讀寫文件？你需要明確授權(quán)

• 想讓它發(fā)郵件？你需要配置郵件工具

• 想讓它執(zhí)行命令？你需要開啟沙箱并設(shè)置權(quán)限

而且，高風(fēng)險(xiǎn)操作可以設(shè)置二次確認(rèn)，確保它不會(huì)"自作主張"。

1.3 OpenClaw 它能做什么？

光說概念太虛了，來看三個(gè)真實(shí)的使用場(chǎng)景。

場(chǎng)景一： 你可以在飛書里@OpenClaw機(jī)器人，讓它幫你自動(dòng)整理日?qǐng)?bào)

"幫我整理今天的日?qǐng)?bào)，從項(xiàng)目群提取關(guān)鍵進(jìn)展，從郵件提取待跟進(jìn)事項(xiàng)。"

OpenClaw機(jī)器人會(huì)自動(dòng)執(zhí)行：

1. 讀取指定群聊的今日消息
2. 提取關(guān)鍵信息
3. 按格式生成日?qǐng)?bào)
4. 發(fā)到指定文檔

場(chǎng)景二： 以前你需要寫一篇行業(yè)分析報(bào)告，涉及大量資料搜集，需要在十幾個(gè)網(wǎng)站間來回切換，復(fù)制粘貼到手軟。

現(xiàn)在他告訴OpenClaw，讓它來自動(dòng)幫你查資料寫報(bào)告，

"搜索2026年AI編程助手的市場(chǎng)規(guī)模，整理成表格，包含數(shù)據(jù)來源。"

OpenClaw會(huì)自動(dòng)執(zhí)行：

• 調(diào)用搜索工具查找資料

• 訪問多個(gè)網(wǎng)頁提取信息

• 整理成結(jié)構(gòu)化表格

• 標(biāo)注數(shù)據(jù)來源

而你，從"體力活"中解放出來后，可以更加專注在分析和判斷上。

場(chǎng)景三： 飛書里@它，幫你處理各種繁瑣、重復(fù)的任務(wù)

比如，工作群里經(jīng)常有人問：

• "誰能查一下上個(gè)月的BUG缺陷數(shù)據(jù)？"

• "幫忙翻譯一下這個(gè)英文文檔"

• "把這份PDF轉(zhuǎn)成Markdown"

現(xiàn)在直接在群里@機(jī)器人：

@OpenClaw機(jī)器人 把剛才發(fā)的PDF轉(zhuǎn)成Markdown格式

機(jī)器人立即處理，把結(jié)果發(fā)回群里。

不用麻煩同事，不用切換工具，在聊天中就把事辦了。

簡(jiǎn)單小結(jié)一下，當(dāng)你用好OpenClaw，你將擁有：

一個(gè)能在飛書里@的AI機(jī)器人：

• 私聊問它問題

• 群里@它辦事

• 讓它幫你整理文檔、查資料

一個(gè)可定制的AI助理：

• 根據(jù)你的需求寫Skills

• 連接你的常用工具

• 自動(dòng)化重復(fù)工作

完全掌控的數(shù)據(jù)隱私：

• 所有數(shù)據(jù)存在本地

• 不經(jīng)過第三方服務(wù)器

• 企業(yè)級(jí)安全保障

1.4 為什么2026年它突然火了

AI Agent的概念不是2026年才有的，為什么現(xiàn)在才火？或者說為什么OpenClaw會(huì)爆火?

我們都很清楚當(dāng)前 大多數(shù)的 AI 工具的核心痛點(diǎn)是： 太被動(dòng)了 。

傳統(tǒng)的對(duì)話模型就像咱們古代的算盤一樣，撥一下才動(dòng)一下，高度依賴 Prompt 的持續(xù)輸入。而 OpenClaw 的突破，在于它直接將產(chǎn)品范式提升到了一個(gè)全新的維度，正如，OpenClaw的創(chuàng)作者 Peter Steinberger 對(duì)其給出的產(chǎn)品定位非常精準(zhǔn)—— “真正會(huì)做事的 AI” 。

更離離不開，當(dāng)前AI大環(huán)境發(fā)展趨勢(shì)的推動(dòng)

一方面，當(dāng)前國(guó)內(nèi)外主流AI大模型能力都到了"可用"的臨界點(diǎn)

2024年的GPT-4和Claude 3已經(jīng)很強(qiáng)，但還不夠穩(wěn)定。2025-2026年的模型（Claude Opus 4.6/Sonnet 4.6、GPT-5.3-Codex、KIMI K2.5等）在理解復(fù)雜指令和穩(wěn)定輸出格式上有了質(zhì)的飛躍。早期的AI Agent更多是極客的玩具，現(xiàn)在它們真的能解決實(shí)際工作問題。

另一方面，AI配套的工程化工具愈發(fā)成熟了

光有聰明的大腦不夠，還需要：

• 穩(wěn)定的消息收發(fā)機(jī)制

• 可靠的工具調(diào)用框架

• 安全的權(quán)限管理系統(tǒng)

• 友好的配置界面

OpenClaw把這些工程難題都解決了，讓普通用戶也能搭起自己的AI助理。

正因如此，剛好有一款如同OpenClaw的產(chǎn)品出現(xiàn)，瞬間讓大家明白，然來，存在腦海里的奇思妙想，真的是可以實(shí)現(xiàn)呢！

這也是未來 AI 發(fā)展的核心形態(tài)，甚至我敢斷言，今年幾大主流 AI 廠商，必然會(huì)圍繞這塊市場(chǎng)展開激烈爭(zhēng)奪。

2. 安裝與部署

2.1 目前可行的部署方案有三種

1. 云廠商一鍵部署

這是非技術(shù)人員，想體驗(yàn)openclaw最推薦使用的方案，5-10 分鐘就能搞定。適合不會(huì)命令行、想 7x24 小時(shí)穩(wěn)定運(yùn)行、需要國(guó)內(nèi)低延遲 IM（飛書/企微/QQ/釘釘）的用戶使用?？梢粤愦a、一鍵鏡像、官方/大廠背書、自動(dòng)續(xù)費(fèi)、帶寬免費(fèi)。月費(fèi)在 9-40 元起。推薦騰訊云（最穩(wěn)）、阿里云（最便宜）。缺點(diǎn)就是需實(shí)名認(rèn)證且數(shù)據(jù)在云端不在本地，數(shù)據(jù)隱私和安全性需要考慮。

2. 本地一鍵安裝部署

適用于有閑置 MacBook 或 Windows 電腦（其實(shí)我覺得未必，如果就一臺(tái)電腦就先用著也完全沒問題），想完全本地運(yùn)行的用戶使用。 速度是最快的、無服務(wù)器費(fèi)用、隱私最高。 缺點(diǎn)就是你的這臺(tái)電腦得常開著（或自己花錢用 Mac Mini 7x24 候著，一次性成本大概在 3-4000 塊錢）。

3. Docker 部署

適用在 VPS / NAS / 本地想跑多實(shí)例，且對(duì)權(quán)限嚴(yán)格的用戶使用。但需懂點(diǎn)兒技術(shù)，懂基本的 Docker 操作的。

4. 部署方式，我的建議，優(yōu)先用本地

本地安裝，其實(shí)也沒有那么復(fù)雜，核心步驟只需要“一行命令，開箱即用”。而你用 VPS 部署，還需要配置服務(wù)器、調(diào)試網(wǎng)絡(luò)、安全規(guī)則等復(fù)雜的步驟，好像這樣就完全偏離了我們利用 AI 來提效的初衷。即使你可以用騰訊云或者阿里云，免去這些復(fù)雜步驟，也看似安全了，但你別忘了你的所有核心數(shù)據(jù)、文件、代碼和隱私始終是存在云端的。

更重要的是，本地運(yùn)行的 OpenClaw 可以直接獲取你的文件系統(tǒng)、本地應(yīng)用和工作流的系統(tǒng)級(jí)權(quán)限。你甚至可以在屏幕上實(shí)時(shí)“監(jiān)工”，看著它一步步執(zhí)行操作，這種所見即所得的直觀反饋，是盯著瀏覽器里枯燥的遠(yuǎn)程終端無法比擬的。

很多人沒意識(shí)到， VPS 部署其實(shí)只解鎖了 OpenClaw 大約 20% 的能力 。像直接控制本地桌面應(yīng)用、接管剪貼板、與系統(tǒng)環(huán)境深度交互等高階 Agent 特性，在云端根本跑不通。云端部署本質(zhì)上可以看做是一個(gè)“ 閹割版 ”，只是能滿足你的快速體驗(yàn)。

所以說 OpenClaw 放棄本地部署，等于自廢 80% 武功！

2.2 本地部署環(huán)境準(zhǔn)備

很多技術(shù)書一上來就列一堆要求，看得人想放棄，所以我們今天，就換個(gè)方式：

如果你想體驗(yàn)Openclaw，你只需要三樣?xùn)|西：

1. 一臺(tái)能上網(wǎng)的電腦（Windows/Mac/Linux都行）

2. 一個(gè)AI大模型API Key（別被這個(gè)詞嚇到，就是一串密碼）

3. 10分鐘時(shí)間（和一點(diǎn)點(diǎn)耐心）

沒了。不需要你是程序員，不需要你懂AI，不需要買服務(wù)器。

1. 一臺(tái)能上網(wǎng)的電腦

你完全不需要一上來就采購(gòu)昂貴的新設(shè)備，除非你不在乎錢。你現(xiàn)有的任何設(shè)備包括在那兒吃灰的舊筆記本電腦、或者閑置的舊臺(tái)式機(jī)，都足以成為 OpenClaw 的啟動(dòng)載體。

簡(jiǎn)單說：只要是近5年的電腦，基本都能跑。

如果你確實(shí)需要一臺(tái)新設(shè)備，目前 Mac mini 是當(dāng)之無愧的“ 甜品級(jí) ”神機(jī)。

另外，網(wǎng)絡(luò)要求，也提一下吧，你需要能訪問：

• npm registry（安裝OpenClaw）

• 你選擇的AI服務(wù)商（如KIMI、MiniMax、GLM等）

國(guó)內(nèi)用戶注意：OpenClaw本身不需要FQ，但部分AI服務(wù)商可能需要。

2. 一個(gè)AI大模型API Key

API Key，聽起來很高大上，其實(shí)就是一串密碼。

類比一下：

• 飯店的VIP卡 → 證明你有資格享受服務(wù)

• 小區(qū)的門禁卡 → 證明你有權(quán)限進(jìn)入

• API Key → 證明你有權(quán)限調(diào)用AI服務(wù)

這里補(bǔ)充一下，很多新手容易搞混，AI編程（工具）和大模型本質(zhì)上是兩個(gè)不同的東西，大模型如 GPT、Claude、GLM，是 AI 能力的 “源頭”，而 AI 編程工具如 Claude Code、Cursor、GitHub Copilot是基于大模型封裝的、面向特定場(chǎng)景的專用應(yīng)用。

OpenClaw也是如此，本質(zhì)上，你就可以把它當(dāng)作是一款工具，每次OpenClaw讓AI幫你干活，都要出示這個(gè)Key，AI服務(wù)商根據(jù)Key來：

1. 確認(rèn)你是誰
2. 計(jì)算你用了多少額度
3. 決定是否響應(yīng)你的請(qǐng)求

3. 國(guó)內(nèi)三家Coding Plan（推薦）

對(duì)于國(guó)內(nèi)用戶，我推薦優(yōu)先選擇以下三家。它們都有專門針對(duì)開發(fā)者的 Coding Plan（比單獨(dú)購(gòu)買API調(diào)度額度要?jiǎng)澦悖?/p>

• KIMI Coding Plan（https://www.kimi.com/code）

• MiniMax Coding Plan（https://platform.minimaxi.com/subscribe/coding-plan）

• GLM Coding Plan （https://bigmodel.cn/glm-coding）

這三家，我用的是智譜GLM，為啥呢，因?yàn)槲议_了GLM Coding Pro-包年會(huì)員，且智譜帳號(hào)余額里還躺著一萬多余額呢，大模型額度不用愁了，且今年我要吃定GLM了。

[圖片上傳失敗...(image-25e20d-1772414141923)]

4. 抽10分鐘時(shí)間

這10分鐘你要做什么？確認(rèn)你的電腦系統(tǒng)版本符合要求

2. 選擇一家Coding Plan，完成API Key申請(qǐng)
3. 把Key保存在安全的地方（推薦密碼管理器）
4. 測(cè)試網(wǎng)絡(luò)：訪問你選擇的AI服務(wù)商控制臺(tái)，確認(rèn)能正常打開
5. 依賴環(huán)境檢查 （花時(shí)間最多的地方，也是你要重點(diǎn)檢查的）

無論你是 Mac 還是 Windows 只需預(yù)先安裝好以下環(huán)境依賴工具：

1、Node.js

Node.js是一個(gè)讓JavaScript能在電腦本地運(yùn)行的環(huán)境。簡(jiǎn)單說：

Node.js就像JavaScript的"翻譯官"，讓它能在瀏覽器之外的地方工作。

你不需要深入理解它，只需要確認(rèn)電腦上已經(jīng)安裝了。

沒有安裝的，可以前往 https://nodejs.org/zh-cn 進(jìn)行下載

[圖片上傳失敗...(image-894133-1772414141923)]

安裝完成后，打開你的終端（Terminal），輸入：

node --version

期望看到的結(jié)果：

v22.x.x

判斷標(biāo)準(zhǔn)：

• ? 版本 >= v22：可以繼續(xù)

• ? 版本 < v22：需要升級(jí)

• ? 提示"command not found"：需要安裝

?? Windows用戶注意：官方推薦在WSL2中運(yùn)行OpenClaw，能避免很多奇怪問題。WSL2安裝指南：https://docs.microsoft.com/zh-cn/windows/wsl/install

2、 Git：用于拉取 Github 資源

沒有安裝的，可以前往 https://git-scm.com/install/windows 進(jìn)行下載

[圖片上傳失敗...(image-cf4d70-1772414141923)]

安裝完成后，驗(yàn)證環(huán)境命令（終端/CMD）：

node -v
npm -v
git -v

2.3 OpenClaw 安裝

OpenClaw安裝，其實(shí)非常直白，你直接訪問openclaw.ai ，拉到 Quick Start（快速開始）區(qū)域，選擇npm方式安裝

[圖片上傳失敗...(image-8374bd-1772414141923)]

復(fù)制上圖中那行官方提供的全局安裝命令進(jìn)行安裝

npm i -g openclaw

這行命令在做什么？

• npm：Node.js的包管理器
• i為install的簡(jiǎn)寫：安裝
• -g：全局安裝（在任何目錄都能用openclaw命令）

不管你是用 Mac（打開終端）還是 Windows（打開命令行），粘貼、回車，結(jié)束。沒錯(cuò)，這就是全部。我這里以 Windows 系統(tǒng)為例！

[圖片上傳失敗...(image-afc2e5-1772414141923)]

如果碰到網(wǎng)絡(luò)超時(shí)下載中斷或失敗，你可以試著配置 NPM 的國(guó)內(nèi)鏡像（防止網(wǎng)絡(luò)超時(shí)，如果在國(guó)外則不用），執(zhí)行以下命令：

npm config set registry https://registry.npmmirror.com

配置國(guó)內(nèi)鏡像完成后，再次執(zhí)行 npm i -g openclaw 進(jìn)行安裝。

當(dāng)然，還有一種更傻瓜更簡(jiǎn)單的方式，就是交給AI幫你完成安裝，比如用是 OpenCode 把 Github 倉(cāng)庫地址 https://github.com/openclaw/openclaw 復(fù)制給它并告訴它幫我安裝就可以。

如果你也采用 AI 幫你安裝，那在安裝的時(shí)候還有一點(diǎn)需要注意： 當(dāng)系統(tǒng)引導(dǎo)讓你連接并配置通訊軟件的時(shí)候，建議你先不要做選擇任何，跳過即可，因?yàn)楹罄m(xù)咱們會(huì)單獨(dú)配置飛書作為與 OpenClaw 的主要通訊軟件。

安裝完成后，然后到終端/CMD中輸入以下命令來驗(yàn)證 OpenClaw 是否成功安裝，能看到版本號(hào)即代表安裝成功。

openclaw --version

[圖片上傳失敗...(image-21554e-1772414141923)]

期望看到類似輸出：

2026.2.26

? 如果提示"command not found"

可能原因：npm全局路徑未加入系統(tǒng)PATH

解決方法：

1. 重啟終端

2. 如果還不行，檢查npm全局路徑：npm prefix -g

3. 把返回的路徑加入PATH環(huán)境變量

2.4 運(yùn)行向?qū)В簅penclaw onboard

安裝完成后，運(yùn)行初始化向?qū)В?/p>

openclaw onboard
# 或執(zhí)行
openclaw onboard --install-daemon

參數(shù)說明：

• onboard：運(yùn)行初始化向?qū)?/p>

• --install-daemon：同時(shí)安裝后臺(tái)服務(wù)（推薦）

這里為了方便，我們就直接運(yùn)行openclaw onboard

1、啟動(dòng)向?qū)Ш螅ǔＤ銜?huì)先看到：

[圖片上傳失敗...(image-f6cfb6-1772414141923)]

這一步主要是在提醒你，使用 OpenClaw 可能會(huì)有一些風(fēng)險(xiǎn)。請(qǐng)問你是否要繼續(xù)（可以理解為煙盒上的標(biāo)語：吸煙有害健康）。

這里按向左方向鍵 ←，選擇 Yes，按 Enter 回車確認(rèn)；

這里如果你和我的顯示不一樣，直接ctrl+c退出下，重新執(zhí)行

2、選擇yes后，進(jìn)入到選擇模式（Onboarding mode）向?qū)?huì)問你：

[圖片上傳失敗...(image-33ce3e-1772414141923)]

怎么選？

我的建議：第一次選 QuickStart，后面可以隨時(shí)改配置。

3、選擇QuickStart后，進(jìn)入到選模型廠商（Provider）界面，向?qū)?huì)提示你選擇模型提供商：

[圖片上傳失敗...(image-692585-1772414141923)]

根據(jù)你自己已有的模型來選擇即可，比如這里我們以智譜AI為例，選擇Z.AI

[圖片上傳失敗...(image-c9b5e5-1772414141923)]

選擇第2個(gè): Coding-Plan-CN

[圖片上傳失敗...(image-5ba051-1772414141923)]

點(diǎn)擊確認(rèn)，復(fù)制智譜API KEY，粘貼進(jìn)來即可

[圖片上傳失敗...(image-d55456-1772414141923)]

選擇模型，這里我們保持默認(rèn)即可（默認(rèn)為智譜最新的模型：zai/glm-5）

[圖片上傳失敗...(image-57504d-1772414141923)]

4、模型設(shè)置完成之后，在 QuickStart 路徑下，向?qū)?huì)直接進(jìn)入渠道單選列表：

[圖片上傳失敗...(image-692b3f-1772414141923)]

首次建議直接選 Skip for now，為什么先Skip？

這是多輪實(shí)測(cè)驗(yàn)證出的最佳實(shí)踐：

• 先把"TUI里能穩(wěn)定對(duì)話"跑通

• 確認(rèn)模型、鑒權(quán)、Gateway都正常

• 再接入渠道，出錯(cuò)時(shí)能明確判斷是"渠道配置問題"還是"基礎(chǔ)環(huán)境問題"

放心，后面還會(huì)詳細(xì)講飛書如何接入。

5、Channel 之后，向?qū)?huì)進(jìn)入 Skills 檢查與可選安裝：

[圖片上傳失敗...(image-36532-1772414141923)]

首次建議選 Yes，原因很簡(jiǎn)單：現(xiàn)在就把“能自動(dòng)裝的依賴”裝掉，后面少踩坑。

6、接下來常見會(huì)看到：

[圖片上傳失敗...(image-1e8c86-1772414141923)]

給新手的默認(rèn)建議：

• 如果你只想先跑通主線：可先 Skip for now；

• 如果你準(zhǔn)備立刻玩 Skills：按需勾選安裝項(xiàng)；

• node manager 選你本機(jī)已經(jīng)在用的那個(gè)（不確定就用 npm）。

這里我們?yōu)榱朔奖悖苯影磗pace鍵，選擇第一個(gè)Skip for now 確認(rèn)執(zhí)行。

7、進(jìn)入到下一步，配置 Google Places API Key，用于 OpenClaw 中 goplaces 這個(gè)功能模塊，用于查詢地點(diǎn)信息、地址解析、POI 檢索等地理相關(guān)服務(wù)。

[圖片上傳失敗...(image-f69253-1772414141923)]

還用不到，直接選擇No

8、配置GEMINI_API_KEY for nano-banana-pro，這一步，也暫時(shí)用不到，選擇No(接下來，還有幾步，這里就不貼圖了，都是一些可選項(xiàng)，大家可根據(jù)需求自行選擇)

[圖片上傳失敗...(image-96c3f-1772414141923)]

9、配置 Hooks（建議最小開啟）

[圖片上傳失敗...(image-63db19-1772414141923)]

官方說明里，Hooks 用來“在某些命令觸發(fā)時(shí)自動(dòng)執(zhí)行動(dòng)作”（例如 /new 時(shí)做會(huì)話記憶整理）。

建議的最小策略：

• 首次可先啟用 1 個(gè)最核心 hook（最小可用，優(yōu)先 session-memory，若列表里有）；

• 如果你現(xiàn)在還分不清 hook 的作用，也可以先 Skip for now；

10、在收尾階段，向?qū)?huì)給你一個(gè)啟動(dòng)入口選擇：

[圖片上傳失敗...(image-10e90a-1772414141923)]

如果上述啟動(dòng)，提示Gateway網(wǎng)關(guān)失敗，

可能原因：

• 端口18789被占用

• 權(quán)限不足

• 配置文件錯(cuò)誤

記得，確認(rèn)一下網(wǎng)關(guān)是否有安裝啟動(dòng)

openclaw gateway install
openclaw gateway start

[圖片上傳失敗...(image-18fcc-1772414141923)]

解決方法：

# Linux查看端口占用
lsof -i :18789

# Windows查看端口占用
netstat -ano | findstr :18789

# 或者換端口啟動(dòng)
openclaw gateway start --port 18790

11、openclaw常用命令速查

[圖片上傳失敗...(image-2adc20-1772414141923)]

2.5 OpenClaw測(cè)試檢查

1、檢查openclaw服務(wù)是否一切啟動(dòng)正常

# 查看網(wǎng)關(guān)運(yùn)行狀態(tài)
openclaw gateway status

[圖片上傳失敗...(image-acbc79-1772414141923)]

# 全面診斷檢查（配置、連接、權(quán)限等）
openclaw doctor

# 查看整體狀態(tài)
openclaw status

[圖片上傳失敗...(image-23d1e3-1772414141923)]

2、訪問控制界面

終端環(huán)境（無桌面 / 服務(wù)器，推薦）：

# 通過 TUI 在終端中直接管理
openclaw tui

桌面環(huán)境：

# 啟動(dòng) Web 控制臺(tái)
openclaw dashboard

或在瀏覽器中訪問：http://127.0.0.1:18789/

[圖片上傳失敗...(image-997ee6-1772414141923)]

如需調(diào)試，可在前臺(tái)啟動(dòng)網(wǎng)關(guān)查看實(shí)時(shí)日志：openclaw gateway --port 18789

3、首次對(duì)話，onboard 完成后，建議先在TUI 里完成第一輪 bootstrap 對(duì)話。

這一步建議你主動(dòng)講清楚下面 5 件事：

• 你是誰：怎么稱呼你、你的時(shí)區(qū)和工作語言。

• 你要它扮演什么角色：比如“我的技術(shù)寫作助手”。

• 你平時(shí)的工作場(chǎng)景：常用工具、文件目錄、溝通方式（飛書/郵件等）。

• 你的偏好：回答風(fēng)格、長(zhǎng)度、是否先給結(jié)論。

• 你的邊界：哪些操作必須先確認(rèn)、哪些內(nèi)容不要碰。

這一步做得越清楚，后續(xù)它越像“你自己的實(shí)例”，而不是“一個(gè)通用聊天機(jī)器人”。

4、Bootstrap 后，再發(fā)第一條“低上下文”消息

完成 bootstrap 后，建議先發(fā)一條不依賴你工作背景的消息做冒煙測(cè)試。

比如，如果你想測(cè)“查詢能力”，可以這樣發(fā)一條：

請(qǐng)告訴我武漢今天的天氣，并給出穿衣建議（1 句話）。

按回車發(fā)送。

[圖片上傳失敗...(image-7ac543-1772414141923)]

期望的回復(fù)：

它應(yīng)該直接給出結(jié)構(gòu)化結(jié)果（清單或天氣建議），而不是繼續(xù)做泛泛自我介紹。

如果看到回復(fù)，恭喜你！安裝成功了！

3. OpenClaw接入飛書集成

還記得前面在配置openclaw過程中，我們?cè)贑hannel那一步選擇了Skip。

這不是省略，而是有意為之。

實(shí)測(cè)經(jīng)驗(yàn)告訴我們：

• 先把"TUI里能穩(wěn)定對(duì)話"跑通，確認(rèn)模型、鑒權(quán)、Gateway都正常

• 再做渠道接入，出錯(cuò)時(shí)就能明確判斷是"渠道配置問題"還是"基礎(chǔ)環(huán)境問題"

• 這種"兩段式"路徑成功率更高，也更容易排錯(cuò)

接下來，開始起飛吧~

3.1 飛書接入的整體流程

不管你接的是哪個(gè)聊天軟件，基本都遵循同一條流水線：

1. 平臺(tái)側(cè)建應(yīng)用（拿到憑證）
2. OpenClaw側(cè)配置渠道（openclaw channels add）
3. 啟動(dòng)Gateway并驗(yàn)證收發(fā)
4. 配對(duì)/白名單放行
5. 再做群聊策略、提及策略和風(fēng)控

你可以把這5步理解為"固定骨架"。先把飛書走通，其他渠道請(qǐng)走補(bǔ)充章或官方渠道文檔。

3.2 前提準(zhǔn)備

1、OpenClaw 已安裝并升級(jí)到最新版

openclaw upgrade          # 或 openclaw update
openclaw version          # 確認(rèn) ≥ 2026.2.2

2、安裝官方飛書插件（必須執(zhí)行，即使你覺得已內(nèi)置）

先查看插件列表：

openclaw plugins list

如果存在feishu且狀態(tài)是disabled，啟用它：

[圖片上傳失敗...(image-3937c7-1772414141923)]

執(zhí)行下述命令，啟用它

openclaw plugins enable feishu
openclaw plugins list     # 確認(rèn) feishu 已 loaded

[圖片上傳失敗...(image-a5c325-1772414141923)]

?? 提示：官方文檔也給出openclaw plugins install @openclaw/feishu。但結(jié)合我自己的實(shí)測(cè)，優(yōu)先啟用內(nèi)置插件更穩(wěn)定。

3、準(zhǔn)備飛書賬號(hào)（沒有的自行注冊(cè)一個(gè)）

3.3 在飛書開放平臺(tái)創(chuàng)建應(yīng)用

1、訪問飛書開放平臺(tái)->開發(fā)者后臺(tái)（ https://open.feishu.cn/app ） 登錄你的飛書賬號(hào)（需要有企業(yè)管理員權(quán)限）

[圖片上傳失敗...(image-74a391-1772414141923)]

2、點(diǎn)擊"創(chuàng)建企業(yè)自建應(yīng)用"

• 應(yīng)用名稱：隨便填（如 “OpenClaw 機(jī)器人”）

• 應(yīng)用描述：隨意

• 圖標(biāo)：可選，上傳一個(gè)清晰的圖標(biāo)，點(diǎn)擊 創(chuàng)建

[圖片上傳失敗...(image-5ff6ff-1772414141923)]

3.4 獲取App ID與App Secret

創(chuàng)建完成后，進(jìn)入應(yīng)用詳情頁：

1. 點(diǎn)擊左側(cè)"憑證與基礎(chǔ)信息"

2. 記錄以下信息：

   • App ID（形如cli_xxxxxxxxxxxxxxxx）
   • App Secret（點(diǎn)擊"查看"按鈕顯示，一串長(zhǎng)字符串，務(wù)必復(fù)制后立即保存到密碼管理器，切勿泄露）

   [圖片上傳失敗...(image-518be6-1772414141923)]

?? 重要：App Secret務(wù)必保密，不要截圖外傳，不要發(fā)到群里。泄露了別人就能控制你的機(jī)器人。

3.5 啟用機(jī)器人能力

左側(cè) → 添加應(yīng)用能力 → 選擇 機(jī)器人 → 添加啟用，設(shè)置機(jī)器人名稱（如 “OpenClaw 機(jī)器人”）并保存

[圖片上傳失敗...(image-5b686c-1772414141923)]

設(shè)置機(jī)器人名稱（如 “OpenClaw 機(jī)器人”）并保存

[圖片上傳失敗...(image-bbdba3-1772414141923)]

3.6 權(quán)限配置（批量導(dǎo)入）

這是最容易出錯(cuò)的步驟，仔細(xì)跟著做（關(guān)鍵?。。。?/p>

1. 點(diǎn)擊左側(cè)"權(quán)限管理"
2. 點(diǎn)擊"批量導(dǎo)入權(quán)限"
3. 粘貼以下官方推薦 JSON（直接復(fù)制）：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

[圖片上傳失敗...(image-fe0a3a-1772414141923)]

點(diǎn)擊導(dǎo)入 → 全選 → 粘貼，點(diǎn)擊下一步 → 申請(qǐng)開通 → 保存成功

[圖片上傳失敗...(image-c5d6f7-1772414141923)]

點(diǎn)擊申請(qǐng)開通，基本都是立馬審批通過的

[圖片上傳失敗...(image-f3ceff-1772414141923)]

這些權(quán)限是做什么的？

3.7 首次發(fā)布應(yīng)用

發(fā)布步驟：

1. 點(diǎn)擊左側(cè)"版本管理與發(fā)布"

2. 點(diǎn)擊"創(chuàng)建版本"

3. 填寫版本信息：

   ? 版本號(hào)：1.0.0

   ? 更新說明：初始版本

4. 點(diǎn)擊"保存"

5. 點(diǎn)擊"申請(qǐng)發(fā)布"

6. 等待企業(yè)管理員審批（如果是你自己的企業(yè)，通常自動(dòng)通過）

[圖片上傳失敗...(image-f86c47-1772414141923)]

填寫版本號(hào) → 填寫更新說明 → 點(diǎn)擊保存，確認(rèn)發(fā)布（首次創(chuàng)建免審核，保存提交后即可上線使用）。

[圖片上傳失敗...(image-55b476-1772414141923)]

審批通過后，應(yīng)用狀態(tài)會(huì)變?yōu)?已發(fā)布"。這時(shí)候才能進(jìn)行下一步。

切記：這一步必須在開啟長(zhǎng)連接之前完成！

實(shí)測(cè)經(jīng)驗(yàn)：如果還沒先發(fā)布應(yīng)用就直接開啟"長(zhǎng)連接訂閱"，通常會(huì)持續(xù)失敗。

3.8 在 OpenClaw 配置飛書通道

推薦使用交互式向?qū)Вㄗ詈?jiǎn)單）：

openclaw channels add

[圖片上傳失敗...(image-a860c0-1772414141923)]

選擇 Feishu / Lark

[圖片上傳失敗...(image-644ee1-1772414141923)]

依次輸入App ID 、App Secret

[圖片上傳失敗...(image-c1ff58-1772414141923)]

選擇飛書域名，這里選擇國(guó)內(nèi)版即可

[圖片上傳失敗...(image-f36f46-1772414141923)]

群聊策略，這里按需選擇即可，這里我選擇Open

[圖片上傳失敗...(image-c1f9ed-1772414141923)]

上述配置好之后，選擇完成（Finish）即可。

配置完成后，查看Channel列表：

openclaw channels list

[圖片上傳失敗...(image-593804-1772414141923)]

3.9 啟動(dòng) Gateway 并配置飛書事件訂閱（關(guān)鍵步驟）

1、啟動(dòng) OpenClaw Gateway（必須先啟動(dòng)！）

openclaw gateway --port 18789 --verbose   # 前臺(tái)運(yùn)行方便看日志
# 或后臺(tái)守護(hù)進(jìn)程（推薦）
openclaw gateway install --daemon
openclaw gateway start

確認(rèn)輸出：

? Gateway started on http://127.0.0.1:18789

[圖片上傳失敗...(image-f5fe28-1772414141923)]

瀏覽器打開http://你的服務(wù)器IP:18789 可查看控制面板。

2、回到飛書開放平臺(tái)配置事件訂閱，在應(yīng)用詳情頁左側(cè) → 點(diǎn)擊左側(cè)"事件與回調(diào)"，在"事件訂閱方式"中，選擇"長(zhǎng)連接"。添加事件：搜索并勾選 im.message.receive_v1，這個(gè)事件表示"收到消息時(shí)通知我"。

[圖片上傳失敗...(image-d9f790-1772414141923)]

保存（此時(shí) Gateway 必須在運(yùn)行，否則保存失?。?/p>

3、創(chuàng)建一個(gè)v1.0.1版本，上述的修改，創(chuàng)建一個(gè)新版本并發(fā)布出來

[圖片上傳失敗...(image-e706fb-1772414141923)]

4、重啟 Gateway（讓配置生效）

openclaw gateway restart
openclaw logs --follow     # 實(shí)時(shí)看日志

3.10 測(cè)試與配對(duì)使用

在飛書里：

1、搜索你的機(jī)器人名稱

[圖片上傳失敗...(image-af1ddb-1772414141923)]

2、進(jìn)入私聊界面，發(fā)送任意消息，比如"你好"，這時(shí)候消息還到不了 OpenClaw，因?yàn)樾枰取芭鋵?duì)”。

[圖片上傳失敗...(image-868521-1772414141923)]

機(jī)器人會(huì)在飛書私聊里直接回一條配對(duì)提示，里面包含一段配對(duì)碼（Pairing code）。

3、在終端審批配對(duì)，讓用戶把飛書私聊里看到的 Pairing code ，然后在終端執(zhí)行：

openclaw pairing list feishu    # 查看待審批
openclaw pairing approve feishu <CODE>

例如：

openclaw pairing approve feishu A1B2C3D4

（把 A1B2C3D4 替換成飛書私聊里看到的真實(shí)配對(duì)碼）

[圖片上傳失敗...(image-778c94-1772414141923)]

4、測(cè)試對(duì)話，直接在你的飛書發(fā)送消息：

你好，請(qǐng)介紹一下你自己

[圖片上傳失敗...(image-9439ae-1772414141923)]

再比如你好，請(qǐng)?jiān)?分鐘后給我發(fā)送一份AI最新資訊晨報(bào) 看到回復(fù)即為成功！

[圖片上傳失敗...(image-392405-1772414141923)]

真的，等了1分鐘，給我發(fā)送了一份AI資訊報(bào)告哦，

5、開啟群聊（可選）

私聊通了之后，可以開啟群聊功能。把機(jī)器人拉進(jìn)群

• 在飛書里創(chuàng)建一個(gè)群

• 點(diǎn)擊"添加機(jī)器人"

• 搜索你的機(jī)器人名稱

• 添加進(jìn)群

在群里發(fā)送，直接@它即可，比如

@OpenClaw機(jī)器人 幫我查看一下C盤空間

[圖片上傳失敗...(image-5059ef-1772414141923)]

它真的可以查詢出我本地電腦的資源信息。

至此，飛書（Feishu）與 OpenClaw 的集成就完成了。

現(xiàn)在，你的「數(shù)字員工」就已經(jīng)成功孵化并隨時(shí)待命了！?。?/strong>