(2026/04/09)
教學:https://docs.openclaw.ai/zh-CN
我第一次養龍蝦(OpenClaw),只是為了嘗鮮而已,所以用最簡單的方式,且完全不花錢,最後只完成一個可對話,沒有任何技能的小助理!
一、OpenClaw的本地部署
環境:在Win11下安裝WSL(微軟給Windows系統內置的Linux運行環境),再安裝Ubuntu作業系統,再安裝OpenClaw
在Win11下,安裝Node.js
目前安裝的版本(node -v)v24.14.1 (版本必需大於v22)
在Win11下,安裝Python
目前安裝的版本(python --version) Python 3.14.4 (版本必需大於v3)
安裝過程
在Win11下,安裝WSL
WSL是微軟給Windows系統內置的Linux運行環境(就不用裝虛擬機或雙系統了)
在下方搜尋欄輸入Windows Powershell (要管理員身份)
輸入 wsl --install,系統會自動安裝WSL (安裝好後要重新開機)
輸入 wsl --status 和 wsl --version,看是否安裝成功
在WSL下,安裝Ubuntu
查詢可下載版本 wsl --list --online
wsl --install Ubuntu 自動安裝Ubuntu最新版本
在Powershell下,使用 wsl -d Ubuntu 來進入Ubuntu系統
在Ubutnu下,安裝OpenClaw
進入OpenClaw官網:https://openclaw.ai
找到這段Linux指令並複製下來:curl -fsSL https://openclaw.ai/install.sh | bash
安裝的OpenClaw是V2026.4.7
模型提供者我選Google
並且去Google AIstudio複製API Key
模型我選Gemma-4-31B
上面PATH的問題是:當你在終端機輸入一個指令時,電腦會去「路徑清單」(也就是 PATH)裡面的資料夾一個一個找。目前你的清單裡少了 /home/wenyu/.npm-global/bin 這個資料夾,所以電腦找不到 OpenClaw。
到此有兩個問題
一是PATH的問題
PATH的問題是:當你在終端機輸入一個指令時,電腦會去「路徑清單」(也就是 PATH)裡面的資料夾一個一個找。目前你的清單裡少了 /home/wenyu/.npm-global/bin 這個資料夾,所以電腦找不到 OpenClaw。
解決:下面這行指令會把正確的路徑加到你的 .bashrc 檔案末尾,這樣以後每次開機都會自動生效
echo 'export PATH="/home/wenyu/.npm-global/bin:$PATH"' >> ~/.bashrc
二是Telegram問題
顯示 OpenClaw 在載入 Telegram 擴充功能(Extension)時,找不到對應的程式原始碼檔案。這通常是因為 npm 安裝包在編譯或發佈時,檔案路徑引用錯誤
既然這個 Telegram 插件壞了,我們直接把它停用
openclaw extensions disable telegram
這隻小龍蝦(OpenClaw)真的太固執了!它的腳(Telegram 外掛)明明斷了(檔案遺失),卻又不讓你用指令去「停用」它,直接動手術把那個壞掉的部位切除。直接刪除壞掉的外掛資料夾
rm -rf /home/wenyu/.npm-global/lib/node_modules/openclaw/dist/extensions/telegram
終於沒有錯誤了,再重跑一次設定
openclaw onboard
模型建議可先選
gemini-flash-latest
gemini-flash-lite-latest
執行OpenClaw
openclaw tui
Gemma4 31模型有問題
改變模型
/model google/gemini-flash-latest
/model gemini-flash-lite-latest
如果要全部重新設定(Setup)
OpenClaw onboard
如果無法選擇其他模型,請下如下指令重新選擇模型(可複選)
OpenClaw config
之前下OpenClaw dashboard
Dashboard URL: http://127.0.0.1:18789/#token=9b4137348bf60d5a726aff97d1
用瀏覽器進入時,一直出現如下問題
原來是時間同步的問題呀,這在 WSL 環境中確實是個隱形的殺手,因為如果 Windows 主機與 WSL 的時間戳記不同步,安全簽章 (Signature) 的效期驗證就會直接失敗,導致這個錯誤。
基本功能完成,以後再陸續加一些skill....