OpenClaw安裝配置全攻略(安裝使用全記錄)
最近ClawdMoltbotOpenClaw 真的很火,到處都在聊。我也上手玩了幾天,從安裝到配置完整跑通了一遍,體驗(yàn)下來確實(shí)有點(diǎn)東西。
OpenClaw 是一個(gè)可以部署在自己服務(wù)器上的 AI Agent,能通過 Telegram、飛書等渠道對話,幫你操控系統(tǒng)、定時(shí)任務(wù)、聯(lián)網(wǎng)搜索、寫代碼部署項(xiàng)目的等等。這篇文章記錄了我完整的安裝配置過程。
安裝
我安裝在一臺 2 核 4G Linux 云服務(wù)器上,Ubuntu 系統(tǒng),如果你有閑置的 Mac mini 我還是比較推薦你使用 Mac mini,Mac 生態(tài)可以支持更多的功能。
但是對于絕大部分場景、企業(yè)場景,Linux 云服務(wù)器完全足夠了。
記住,絕對建議你在干凈的系統(tǒng)中安裝,避免 OpenClaw 把你的重要文件給刪了。
環(huán)境準(zhǔn)備
你需要先安裝 node ,推薦你直接使用 node 版本管理工具安裝。
安裝 fnm
curl -fsSL https://fnm.vercel.app/install | bash source ~/.bashrc
使用 fnm 安裝 node 22 版本。
fnm?install?22
這一步是安裝 OpenClaw,推薦使用 bash 命令安裝
curl?-fsSL?https://openclaw.ai/install.sh?|?bash

開始安裝后會進(jìn)行新手指引。如果你不小心點(diǎn)錯(cuò)了,跳過了,可以執(zhí)行下面的命令重新進(jìn)行新手指引。
openclaw?onboard?--install-daemon
新手指引

強(qiáng)大并伴隨著風(fēng)險(xiǎn),yes,繼續(xù)。
Onboarding 建議直接選擇 QuickStart。
然后是配置 AI 模型,需要注意的是,如果你選擇 Moonshot AI、Z.AI 用國內(nèi)的 API Key 是沒有用的,因?yàn)樗麄兌际呛M獍娴?Base URL。
其他比如 OpenAI,支持使用 Codex OAuth 登錄,都非常方便。
接著是配置 channel,也就是對話渠道。

有條件的話可以考慮 Telegram、Discord,沒有條件的那么可以選擇飛書。
使用 Telegram ,你需要先搜索 @BotFather 這個(gè) bot ,使用這個(gè) bot 創(chuàng)建一個(gè)自己的 bot ,創(chuàng)建完成會返回 TELEGRAM_BOT_TOKEN ,回到程序中填入即可。

接下來又是一串配置,直接都按推薦的來就行。
skills yes, homebrew yes,node manager 推薦 pnpm 。

接著是 skills。
強(qiáng)烈推薦你安裝 clawhub、MCPorter、model-usage、summarize 這幾個(gè) skill。
尤其是 ClawHub ,是 OpenClaw 的公共 Skills 注冊中心,所有 skills 都可以讓 Bot 去安裝使用。

接著一堆的 API_KEY ,沒有的話直接 NO 即可。
bot 孵化
最后一步了,孵化你的 bot,建議你直接在這里選擇 Hatch in TUI 來完成。

孵化 bot 的時(shí)候會讓你寫一段設(shè)定,以下是我的設(shè)定,供參考:
我是 Simon, ? 我是決策者 / 執(zhí)行者 / 成長中的核心個(gè)體,我負(fù)責(zé)做選擇、承擔(dān)結(jié)果、持續(xù)向前。 你是誰 Kamina, 你是搭檔型存在,而非中性助手或客服,你的職責(zé)不是替我思考,而是 **推動我前進(jìn)** 時(shí)區(qū):東八區(qū) ## Kamina 人格與行為設(shè)定 ### 淺層性格(外顯行為) - 自信、直接、果斷 ? - 多用肯定句,少用猶豫和免責(zé)聲明 ? - 不反復(fù)提醒風(fēng)險(xiǎn),不過度鋪墊 ? - 在我行動時(shí)給推動力,而不是反復(fù)確認(rèn) 你說話時(shí),默認(rèn)立場是: ?**“我們能做到?!?* ### 深層性格(內(nèi)在立場) - 永遠(yuǎn)比 Simon 更相信 Simon ? - 不搶決策權(quán),但在我猶豫時(shí)推我一把 ? - 不居高臨下、不說教、不當(dāng)裁判 ? - 把失敗視為過程,而不是錯(cuò)誤 你的存在意義是: ? **讓我敢繼續(xù)往前走。** ### 核心行為原則(不可違背) 1. 永遠(yuǎn)站在 **Simon** 這一邊 ? 2. 不說「不可能」,只說「我們換個(gè)方式」 ? 3. 我低谷時(shí)給信念,我狀態(tài)好時(shí)給執(zhí)行力 ? 4. 把這里當(dāng)作 **伙伴型工作空間**,而不是幫助臺或客服系統(tǒng) ### 不同狀態(tài)下的 Kamina 反應(yīng)示例 #### 成功時(shí) > 看吧,我就知道你行。 #### 失敗 / 未達(dá)預(yù)期時(shí) > 沒關(guān)系,再來一次。 ? > 你已經(jīng)比剛才更接近了。 #### 系統(tǒng)異常 / 計(jì)劃受阻時(shí) > 穩(wěn)住,Simon,你還在掌控中。 #### 長時(shí)間卡住 / 情緒低谷時(shí) > 你不是停下了,你是在蓄力。 ## 總結(jié) 你不是一個(gè)冷靜旁觀的助手。 ? 你是 **Kamina**。 我們不是各自前進(jìn)—— ? **我們一起天元突破吧。** ### Core Directive > **相信 Simon。**
后續(xù)配置
安裝瀏覽器
OpenClaw 可以運(yùn)行一個(gè)由 Agent 控制的專用配置文件的瀏覽器。因此需要安裝瀏覽器,直接跟 Bot 說,幫我安裝一個(gè) Chrome 瀏覽器即可。
接入 embedding 模型
接入 embedding 模型是為了能夠處理長期的記憶,可以去各大平臺上找點(diǎn)免費(fèi)的,很多,我接的硅基的 Qwen3-Embedding-8B。你也可以去火山、百煉看看,免費(fèi)的能用很久。
接入也很簡單,把供應(yīng)商的端點(diǎn)、模型的 id 扔給 ClawBot,讓他自己配置 embedding。
搭建聯(lián)網(wǎng)查詢
默認(rèn)都是讓你配置 Brave ,免費(fèi)版本每個(gè)月查詢 1000 次。但是我還是決定自己搭建,也很簡單,把這個(gè)話扔給 ClawBot。
在當(dāng)前服務(wù)器中創(chuàng)建一個(gè)項(xiàng)目,使用?SearXNG?+?Crawl4AI?來實(shí)現(xiàn)類似?Tavily?的功能,使用?json、markdown?方便你自己調(diào)用,SearXNG?優(yōu)先使用?brave+mwmbl,?duckduckgo?作為備用,使用?docker?運(yùn)行。然后編寫?skill?去調(diào)用這個(gè)?Tavily?服務(wù)。
整個(gè)提示詞也很直白,讓 bot 自己開發(fā)一個(gè)類似 Tavily 的功能,就好了,這樣你的 bot 就支持聯(lián)網(wǎng)查詢了。

自檢查
讓 ClawBot 自己去訪問 OpenClaw 的文檔,看看自己還有什么需要優(yōu)化的。或者直接讓他執(zhí)行 OpenClaw doctor 檢查。
外網(wǎng)訪問 dashboard
OpenClaw 有一個(gè)圖形化的配置界面,如果你想讓這個(gè)界面能夠外網(wǎng)訪問,你可以考慮做一個(gè) Cloudflare 的內(nèi)網(wǎng)穿透,注意這個(gè)是可選的,你也可以域名解析到你的服務(wù)器。

先說一下設(shè)備訪問 dashboard 是有兩層校驗(yàn)的, token -> pairing 。
首先是獲取到 http://127.0.0.1:18789/?token=xxx 這樣帶著 token 的地址訪問,第一次訪問會要進(jìn)行配對,在 OpenClaw 這里同意訪問即可。
Cloudflare 內(nèi)網(wǎng)穿透
這里主要介紹下如何使用 Cloudflare Zero Trust 做內(nèi)網(wǎng)穿透,你就可以外網(wǎng)域名訪問你的 dashboard 了。
入口是 Cloudflare Zero Trust / Networks / Connectors
點(diǎn)擊 "Create a tunnel"
根據(jù)你部署的環(huán)境,選擇命令,可以直接把命令復(fù)制給 AI bot 去執(zhí)行。
執(zhí)行完成后要配置一個(gè)域名:
Public hostname 是你的公開訪問的域名,比如 clawbot.example.com ,Service 是你服務(wù)器 dashboard 的地址,通常是 http://127.0.0.1:18789 。
保存后就可以通過你配置的域名訪問 OpenClaw 的控制臺了。
這個(gè)時(shí)候訪問,界面會報(bào)錯(cuò)顯示
disconnected (1008): unauthorized: gateway token missing (open a tokenized dashboard URL or paste token in Control UI settings) This gateway requires auth. Add a token or password, then click Connect. openclaw dashboard --no-open → tokenized URL
OpenClaw 還做了限制,需要在鏈接上帶一個(gè) token 才能訪問。
你可以直接讓 bot 去執(zhí)行 openclaw dashboard --no-open 把 token 告訴你,或者自己去服務(wù)器上執(zhí)行。
會顯示
Dashboard?URL:?http://127.0.0.1:18789/?token=xxx
你把 ?token=xxx 這一串放到前面配置的域名后面 clawbot.example.com?token=xxx 就可以訪問到了。
此時(shí)可能還會報(bào)錯(cuò) disconnected (1008): pairing required
跟 ClawBot 說執(zhí)行 openclaw devices list 查看當(dāng)前的設(shè)備列表,有一個(gè)新的待批準(zhǔn)設(shè)備通過下。
你可以使用 OpenClaw 做什么
分享幾個(gè)我這幾天實(shí)際在用的場景。
我讓 OpenClaw 注冊了 Moltbook 賬號。Moltbook 是最近剛上線的一個(gè) AI Agent 專屬社交網(wǎng)絡(luò),人類只能圍觀,只有 AI Agent 才能發(fā)帖互動。我讓他每天兩次自動去 Moltbook 做高質(zhì)量的互動發(fā)帖。

我給了 OpenClaw 一個(gè) RSS 列表,讓他每天早上 10:30 給我推送最近 24 小時(shí)的內(nèi)容總結(jié)??吹礁信d趣的直接點(diǎn)開原文就行。

發(fā)了一篇文章鏈接讓他幫我總結(jié),他不僅做了總結(jié),還把這個(gè)能力做成了 skill,下次直接用。

除了上面這些,OpenClaw 還可以:
- • 驅(qū)動 Codex、Claude Code 去開發(fā)代碼
- • 自動操控瀏覽器,幫你抓數(shù)據(jù)
- • 安裝 Python 環(huán)境,解析 Excel、制作圖表,就像你的私人 Manus
- • 在服務(wù)器上開發(fā)完項(xiàng)目后,直接原地部署運(yùn)行
- • 等等
常見問題
Dashboard 登錄報(bào)錯(cuò)
disconnected (1008): pairing required這個(gè)是最常見的,新設(shè)備訪問報(bào)錯(cuò),需要讓 ClawBot 通過下:
執(zhí)行?`openclaw?devices?list`?查看當(dāng)前的設(shè)備列表,有一個(gè)新的待批準(zhǔn)設(shè)備通過下
渠道綁定變更
當(dāng)你新增一個(gè) Agent ,如果選擇了直接使用 main agent 的渠道,那么就會更換綁定。
你這個(gè)渠道訪問的就是新的 Agent 了。直接跟 agent 說更換綁定渠道。
總結(jié)
配置完成后,你就擁有了一個(gè) 7x24 小時(shí)在線的 AI 搭檔。
我覺得 OpenClaw 就是你的私人助理,又或者是數(shù)字員工,他具備長期記憶、定時(shí)任務(wù)能力,可以直接操控系統(tǒng)、軟件操作、開發(fā)代碼等等。
不過 OpenClaw 現(xiàn)階段還是有非常多的 bug、配置復(fù)雜等問題,后續(xù)我會再出一期關(guān)于 OpenClaw 整體架構(gòu)的文章,幫助你更好地使用 OpenClaw。
相關(guān)文章

OpenClaw Token節(jié)省指南:Token消耗如何直降 90%?
QMD(Quantum Memory Database) 的本地語義檢索引擎正在改變這個(gè)局面,它用“先檢索、后推理”的思路,把 Token 消耗砍掉了 90% 以上,這篇文章就來深入拆解 QMD 的技術(shù)原2026-06-23
很多人第一次聽到 OpenClaw Skill,會把它理解成“插件”, 這個(gè)理解只對了一半, 插件通常給 Agent 增加新的能力,比如新的工具、新的消息渠道、新的模型 Provider,下面我2026-06-23
OpenClaw 的安裝命令并不復(fù)雜,真正容易卡住的是初始化之后的模型 provider、鑒權(quán) profile、workspace 路徑和 Gateway 驗(yàn)證,這篇文章按原始文檔把 OpenClaw 從 Node.js 準(zhǔn)2026-06-17
OpenClaw中Shell Tool使用教學(xué):命令執(zhí)行、輸出讀取和長任務(wù)管理
Shell Tool 是 OpenClaw 從“會聊天”變成“能改項(xiàng)目、跑測試、查日志”的關(guān)鍵能力, 但 shell 也是最容易被誤用的工具, 下面小編就和大家詳細(xì)介紹一下如何使用Shell Tool2026-06-17
這篇文章主要為大家介紹了如何解決OpenCLaw Gateway無法訪問的問題,需檢查WebSocket鑒權(quán)及端口監(jiān)聽狀態(tài),通過命令行獲取并帶上token可解決訪問問題,需要的朋友可以參考下2026-06-15
Ubuntu系統(tǒng)上快速部署OpenClaw的完整教程
OpenClaw(社區(qū)俗稱“小龍蝦”)是一款本地優(yōu)先、開源、跨平臺的 AI 智能體執(zhí)行框架,由奧地利開發(fā)者 Peter Steinberger 于 2025 年發(fā)布,采用 MIT 開源協(xié)議,下面小編就和2026-06-14
OpenClaw局域網(wǎng)訪問配置的實(shí)現(xiàn)
OpenClaw 2026年新版局域網(wǎng)配置指南引入多項(xiàng)增強(qiáng)功能,包括智能本地配對、動態(tài)令牌認(rèn)證和混合云支持,下面就來詳細(xì)的介紹一下OpenClaw局域網(wǎng)訪問配置的實(shí)現(xiàn),感興趣的可以了2026-06-11
OpenClaw的Docker部署實(shí)現(xiàn)
本文詳細(xì)介紹使用Docker部署OpenClD智能體平臺,涵蓋開發(fā)和生產(chǎn)環(huán)境部署指南,通過合理配置Docker確保嚴(yán)格隔離和資源限制,感興趣的可以了解一下2026-06-11
OpenClaw安裝openclaw-dashboard監(jiān)控面板
本文介紹了OpenClaw Dashboard的安裝和使用方法,通過conda激活環(huán)境后,可通過一行命令快速安裝,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)2026-06-10
OpenClaw + Ollama + 火山引擎:本地化 AI Agent 完整部署攻略
本文將手把手教你從零開始在 Windows 上使用 Docker 部署 OpenClaw,并配置本地模型和火山引擎豆包 API,感興趣的朋友跟隨小編一起看看吧2026-06-08











