上周心血來潮，想在自己的 Ubuntu 機(jī)器上跑個 OpenClaw 玩玩，結(jié)果這一折騰就是兩小時。中間踩了無數(shù)坑，從 nvm 裝不上、配置文件報(bào)錯，到局域網(wǎng)死活連不上……現(xiàn)在終于跑通了，趕緊把過程記下來，希望能幫到和我一樣的新手。

第一步：裝 nvm 就卡住了

按照官方文檔，第一行 curl -o- https://raw.githubusercontent.com/... 直接就超時了。國內(nèi)這網(wǎng)絡(luò)你懂的，raw.githubusercontent.com 經(jīng)常抽風(fēng)。

試了試網(wǎng)上說的用 jsDelivr 鏡像，居然成功了：

curl -o- https://cdn.jsdelivr.net/gh/nvm-sh/nvm@v0.40.4/install.sh | bash

如果鏡像也不行，其實(shí)還有個笨辦法：在瀏覽器里打開那個地址，把腳本內(nèi)容全選復(fù)制下來，在服務(wù)器上新建個 install.sh 貼進(jìn)去，然后 bash install.sh 一樣能裝。我就是這么干的。

裝完 nvm 記得 source ~/.bashrc 一下，然后用 nvm install 22 裝 Node.js，這一步倒挺順利。

第二步：裝 OpenClaw 倒是一路綠燈

curl -fsSL https://openclaw.ai/install.sh | bash

這個命令跑完，openclaw --version 能輸出版本號，說明裝上了。這時候我天真地以為馬上就能用了。

第三步：配置模型 API，踩了第一個坑

運(yùn)行 openclaw onboard，讓我選模型提供商。我用的是阿里云百煉，想著國內(nèi)服務(wù)延遲低。結(jié)果填完 API Key 和 Base URL 后，一直報(bào) 401 錯誤。

查了半天才發(fā)現(xiàn)，百煉的 API Key 分地域！我創(chuàng)建 key 時選的是北京節(jié)點(diǎn)，但 Base URL 填成了新加坡的 dashscope-intl.aliyuncs.com。改成北京的 https://dashscope.aliyuncs.com/compatible-mode/v1 后立馬好了。

教訓(xùn)： API Key 和 Base URL 的地域必須一致，北京對北京，新加坡對新加坡。

第四步：啟動網(wǎng)關(guān)，又報(bào)錯

配置完模型，運(yùn)行 openclaw gateway start，結(jié)果告訴我 gateway.mode 沒設(shè)置。這個 mode 是啥？文檔里也沒細(xì)說。

試了試 openclaw config set gateway.mode local，然后再重啟網(wǎng)關(guān)，終于不報(bào)這個錯了。但緊接著又提示配置有問題，讓我運(yùn)行 openclaw doctor --fix。

第五步：doctor --fix 也沒完全搞定

doctor 倒是自動修了一些東西，但最后留了個 gateway.port 類型錯誤的提示。打開 ~/.openclaw/openclaw.json 一看，原來 "port": "18789" 寫成了字符串，應(yīng)該是數(shù)字。手動把引號去掉，保存，再重啟網(wǎng)關(guān)，這次終于 openclaw status 顯示網(wǎng)關(guān) running 了。

第六步：想從筆記本訪問，結(jié)果連不上

服務(wù)器上 curl http://127.0.0.1:18789 正常，但在同一局域網(wǎng)的筆記本上 訪問 http://192.168.1.100:18789 死活打不開。

先想到的是防火墻，檢查了一下：

sudo ufw status

果然沒開放 18789 端口，趕緊加上：

sudo ufw allow 18789/tcp

加了之后筆記本還是連不上。用 ss -tlnp | grep 18789 一看，服務(wù)只監(jiān)聽了 127.0.0.1，沒監(jiān)聽 0.0.0.0。也就是說它只接受本機(jī)訪問。

第七步：修改監(jiān)聽地址，又踩了新坑

按照直覺，我應(yīng)該在配置文件里把 bind 改成 0.0.0.0。結(jié)果改完一重啟網(wǎng)關(guān)，直接報(bào)錯說 0.0.0.0 是 legacy 用法，現(xiàn)在要用 lan、loopback 這些模式。

查了下文檔，原來新版 OpenClaw 引入了“綁定模式”的概念。改成 "bind": "lan" 后，網(wǎng)關(guān)重啟，再用 ss 看，終于變成 0.0.0.0:18789 了。

第八步：CORS 和 token 的問題

以為萬事大吉，結(jié)果筆記本瀏覽器訪問時，控制臺報(bào)錯 origin not allowed。這又是瀏覽器的跨域保護(hù)。需要在配置里把筆記本訪問的地址加到 allowedOrigins 里。

我服務(wù)器 IP 是 192.168.1.100，所以在 gateway.controlUi.allowedOrigins 里加上 "http://192.168.1.100:18789"。重啟后，不報(bào) origin 了，但彈出了 unauthorized: gateway token missing。

原來 OpenClaw 默認(rèn)需要設(shè)備認(rèn)證，首次訪問必須帶 token。在服務(wù)器上運(yùn)行 openclaw dashboard，會輸出一個類似 http://127.0.0.1:18789/?token=abc123... 的地址。把 127.0.0.1 換成 192.168.1.100，在筆記本瀏覽器里打開，終于進(jìn)去了！

第九步：為了省事，我把設(shè)備認(rèn)證關(guān)了（風(fēng)險(xiǎn)自擔(dān)）

每次都要找 token 挺麻煩的，反正是家里局域網(wǎng)，我就把兩個安全選項(xiàng)關(guān)了：

openclaw config set gateway.controlUi.allowInsecureAuth true
openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true
systemctl --user restart openclaw-gateway.service

這下直接在筆記本瀏覽器里輸 http://192.168.1.100:18789 就能進(jìn)，不需要 token 了。不過要提醒自己：如果家里有客人用 Wi-Fi，或者電腦中病毒，別人也能訪問我的 OpenClaw，所以平時用完后最好再把這兩個選項(xiàng)關(guān)掉。

總結(jié)

折騰下來，最深的體會是：OpenClaw 的安全機(jī)制設(shè)計(jì)得很嚴(yán)，雖然對新手不太友好，但確實(shí)是為了防止配置不當(dāng)導(dǎo)致的安全問題。尤其是那個“綁定模式”的引入，一開始覺得多此一舉，后來想想，強(qiáng)制用戶明確服務(wù)暴露范圍，其實(shí)是好事。

如果你也想部署，這里有幾個小建議：

• 網(wǎng)絡(luò)問題：提前準(zhǔn)備好 nvm 安裝腳本的鏡像或離線包，省得卡在第一關(guān)。
• API Key 地域：務(wù)必和 Base URL 匹配，百煉用戶特別留意。
• 配置文件：直接改 JSON 比用命令行快，但改完記得用 openclaw config get 檢查一下。
• 局域網(wǎng)訪問：如果只是自己用，SSH 隧道是最簡單安全的方法，不用折騰這些 CORS 和認(rèn)證。命令只有一行：ssh -L 18789:localhost:18789 用戶名@服務(wù)器IP，然后在瀏覽器里打開 http://localhost:18789 就行。

最后，OpenClaw 跑起來后，真的挺有意思的?？梢宰屗鼛臀铱偨Y(jié)網(wǎng)頁、寫郵件，還能接入飛書當(dāng)機(jī)器人。雖然配置過程有點(diǎn)折騰，但看到它跑起來那一刻，還是很有成就感的。

到此這篇關(guān)于從零開始在Ubuntu上部署OpenClaw并搞定局域網(wǎng)訪問的文章就介紹到這了,更多相關(guān)Ubuntu部署OpenClaw內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論