Ubuntu系統(tǒng)上快速部署OpenClaw的完整教程
一、OpenClaw 是什么?
OpenClaw(社區(qū)俗稱“小龍蝦”)是一款本地優(yōu)先、開(kāi)源、跨平臺(tái)的 AI 智能體執(zhí)行框架,由奧地利開(kāi)發(fā)者 Peter Steinberger 于 2025 年發(fā)布,采用 MIT 開(kāi)源協(xié)議。它的核心價(jià)值不是大模型本身,而是給大模型裝上“手腳”——讓 AI 從“被動(dòng)回答問(wèn)題”升級(jí)為“主動(dòng)完成任務(wù)”,能夠在你的電腦上自主完成文件管理、瀏覽器自動(dòng)化、代碼開(kāi)發(fā)、郵件處理等真實(shí)操作。
OpenClaw 具備四大核心特性:本地優(yōu)先的隱私架構(gòu)(數(shù)據(jù)默認(rèn)存儲(chǔ)在本地)、模型無(wú)關(guān)的開(kāi)放設(shè)計(jì)(兼容 Kimi、OpenAI、Anthropic 等 200+ 主流模型)、安全可控的隔離沙箱(每個(gè)任務(wù)獨(dú)立運(yùn)行)、無(wú)限擴(kuò)展的插件生態(tài)(社區(qū)已貢獻(xiàn)超 5700 個(gè)技能)。上線數(shù)月間,其 GitHub 星標(biāo)已突破 28 萬(wàn),成為當(dāng)下最炙手可熱的開(kāi)源 AI 執(zhí)行工具。
二、環(huán)境準(zhǔn)備
在 Ubuntu 上部署 OpenClaw,首先確保滿足以下最低要求:
| 依賴項(xiàng) | 要求 |
|---|---|
| 操作系統(tǒng) | Ubuntu 22.04+(推薦 24.04) |
| Node.js | ≥ v22.x(建議安裝 24.x) |
| 內(nèi)存 | ≥ 2GB(推薦 4GB+) |
| 磁盤 | ≥ 500MB 可用空間 |
| 網(wǎng)絡(luò) | 需聯(lián)網(wǎng)下載依賴包和調(diào)用云端模型 |
| 可選 | Python 3.10+、Git |
以上要求并不苛刻,普通筆記本電腦甚至云服務(wù)器 2 核 4GB 配置即可流暢運(yùn)行。
三、安裝 Node.js
OpenClaw 是基于 Node.js 的應(yīng)用,這是部署的關(guān)鍵前提。如果你的 Ubuntu 尚未安裝 Node.js 22+,可通過(guò)以下命令快速安裝:
# 添加 NodeSource 官方源(22.x) curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - # 安裝 Node.js sudo apt-get install -y nodejs # 驗(yàn)證安裝 node -v # 應(yīng)輸出 v22.x.x 或 v24.x.x npm -v # 應(yīng)輸出 9.x.x+
提示:如果系統(tǒng)已有舊版 Node.js,建議使用 nvm 管理多版本,或徹底卸載舊版后按上述步驟重裝。Node.js 18/20 版本存在已知兼容性問(wèn)題,務(wù)必使用 22+。
四、一鍵安裝 OpenClaw
官方提供了極為簡(jiǎn)潔的一鍵安裝腳本,自動(dòng)完成 Node.js 檢測(cè)、構(gòu)建工具安裝和 OpenClaw CLI 部署:
curl -fsSL https://openclaw.ai/install.sh | bash
腳本執(zhí)行后會(huì)自動(dòng)下載并安裝所有依賴,約 2-3 分鐘即可完成。安裝成功后,終端會(huì)提示進(jìn)入初始化配置向?qū)А?/p>
注意事項(xiàng)
國(guó)內(nèi)用戶直接安裝可能遇到 npm 下載緩慢或 GitHub 資源超時(shí)的問(wèn)題。建議在安裝前預(yù)先配置鏡像源:
# 配置 npm 淘寶鏡像 npm config set registry https://registry.npmmirror.com # 驗(yàn)證配置 npm config get registry
這樣可顯著提升下載速度,避免安裝中斷。
五、初始化配置向?qū)?/h2>
安裝完成后,首次啟動(dòng)會(huì)自動(dòng)進(jìn)入交互式配置向?qū)?。以下是各步驟的推薦選擇:
第一步:安全確認(rèn)。 向?qū)?huì)顯示安全提示,說(shuō)明 OpenClaw 作為個(gè)人 AI 智能體可能會(huì)執(zhí)行實(shí)際操作。選擇 Yes 并回車確認(rèn)。
第二步:選擇配置模式。 選擇 QuickStart(快速模式),系統(tǒng)會(huì)自動(dòng)配置網(wǎng)關(guān)和默認(rèn)參數(shù),包含端口 18789、綁定地址 127.0.0.1、Token 認(rèn)證,適合新手快速上手。
第三步:模型提供商配置。 選擇你要使用的大模型。推薦新手先選 Qwen 免費(fèi)云端模型跑通流程(后續(xù)可隨時(shí)切換)。如需對(duì)接 Kimi,可訪問(wèn) platform.moonshot.cn 獲取 API Key。選擇 Anthropic 或 OpenAI 也完全支持,只需填入對(duì)應(yīng) API Key 即可。
第四步:渠道與技能配置。 渠道(如 Telegram、Slack)可暫時(shí)跳過(guò),后續(xù)按需配置。技能安裝也建議先選擇 No,待服務(wù)跑通后再根據(jù)實(shí)際需求添加。
第五步:選擇交互方式。 推薦選擇 TUI(終端界面) 或 Web UI,前者在終端中直接使用,后者通過(guò)瀏覽器訪問(wèn) http://localhost:18789 操作。
六、啟動(dòng)與驗(yàn)證
配置完成后,OpenClaw 會(huì)自動(dòng)啟動(dòng)。你也可以通過(guò)以下命令手動(dòng)管理:
# 啟動(dòng) TUI 終端交互界面 openclaw tui # 查看服務(wù)狀態(tài) openclaw status # 查看網(wǎng)關(guān)狀態(tài) openclaw gateway status # 啟動(dòng)/停止網(wǎng)關(guān) openclaw gateway start openclaw gateway stop
打開(kāi)終端輸入 openclaw tui,如果看到聊天界面并能正常對(duì)話,說(shuō)明部署成功!恭喜你,屬于自己的 AI 智能體已經(jīng)可以“干活”了。
七、常見(jiàn)問(wèn)題速查
| 問(wèn)題 | 原因 | 解決方法 |
|---|---|---|
command not found: openclaw | PATH 未配置 | 執(zhí)行 npm config get prefix 獲取路徑并加入環(huán)境變量,然后 source ~/.bashrc 刷新 |
| Gateway 啟動(dòng)失敗 | 端口 18789 被占用 | 執(zhí)行 lsof -ti:18789 | xargs kill -9 釋放端口,或修改配置切換到其他端口 |
| 訪問(wèn)控制臺(tái)提示“缺失訪問(wèn)憑證” | Token 未攜帶 | 執(zhí)行 openclaw token generate 生成新 Token,并在 URL 中追加 ?token=你的Token |
| Node.js 版本不兼容報(bào)錯(cuò) | 版本低于 22.x | 徹底卸載舊版 Node.js,安裝 22.x 或 24.x 版本 |
| 模型調(diào)用報(bào)錯(cuò) | API Key 未配置或無(wú)效 | 檢查 ~/.openclaw/config.yaml 中的 API Key 是否正確,確保模型提供商服務(wù)可用 |
八、進(jìn)階建議
部署成功后,你可以逐步探索更多玩法:通過(guò) openclaw skills 安裝社區(qū)技能包,實(shí)現(xiàn)文件自動(dòng)整理、郵件定時(shí)發(fā)送、網(wǎng)頁(yè)監(jiān)控等自動(dòng)化任務(wù);配置 Telegram 或飛書渠道,實(shí)現(xiàn)“聊天即操作”;接入本地 Ollama 模型,完全離線運(yùn)行,隱私更安全。
以上就是Ubuntu系統(tǒng)上快速部署OpenClaw的完整教程的詳細(xì)內(nèi)容,更多關(guān)于Ubuntu部署OpenClaw的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章

Ubuntu安裝OpenClaw報(bào)錯(cuò)Gateway service check failed的原因及解決方法
OpenClaw近期受到較多關(guān)注,但在安裝過(guò)程中,用戶常因環(huán)境配置和依賴問(wèn)題導(dǎo)致失敗,這篇文章主要介紹了Ubuntu安裝OpenClaw報(bào)錯(cuò)Gateway service check failed的原因及解決方法,2026-04-24
ubuntu (V100)中 部署openclaw并鏈接飛書的操作方法
本文介紹了在Ubuntu上部署Ollama的大模型推理框架及OpenClaw的方法,包括編譯安裝Ollama、使用OpenClaw的安裝腳本和配置文件等步驟,并簡(jiǎn)要介紹了OpenClaw的工作流程,感興趣2026-03-26
從零開(kāi)始在Ubuntu上部署OpenClaw并搞定局域網(wǎng)訪問(wèn)
這篇文章主要為大家詳細(xì)介紹了如何在Ubuntu上部署OpenClaw并搞定局域網(wǎng)訪問(wèn)功能,文中的示例代碼講解詳細(xì),具有一定的借鑒價(jià)值,有需要的小伙伴可以跟隨小編一起學(xué)習(xí)一下2026-03-20
在Ubuntu上快速部署OpenClaw并接入飛書的完整過(guò)程
OpenClaw是一個(gè)可擴(kuò)展的 AI 助手運(yùn)行框架,核心目標(biāo)是讓助手真正“能做事”,這篇文章主要介紹了在Ubuntu上快速部署OpenClaw并接入飛書的完整過(guò)程,文中通過(guò)圖文介紹的非常詳2026-03-13
windows&ubuntu下OpenClaw保姆級(jí)安裝教程
本文詳細(xì)介紹了OpenClaw在Ubuntu和Windows系統(tǒng)上的安裝步驟,從Node.js環(huán)境準(zhǔn)備到完整配置,幫助開(kāi)發(fā)者快速上手,感興趣的朋友跟隨小編一起看看吧2026-03-12
基于VMware+Ubuntu 24.04環(huán)境完成OpenClaw安裝、配置與使用
本文將基于 VMware + Ubuntu 24.04 環(huán)境,從零開(kāi)始完成 OpenClaw 的安裝、配置,并實(shí)現(xiàn)與飛書機(jī)器人的打通,本文通過(guò)圖文并茂的形式給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工2026-03-09
Ubuntu系統(tǒng)OpenClaw版本降級(jí)的實(shí)例操作
本文主要介紹了如何將OpenClaw從2026.3.2版本降級(jí)到2026.2.3版本,降級(jí)的核心動(dòng)因是新版本存在Bug、兼容性差或功能/性能不符合需求,文章詳細(xì)描述了命令行版本和桌面端版本的2026-03-07








