Docker安裝OpenClaw大龍蝦的詳細(xì)步驟
現(xiàn)在OpenClaw很火,但是安全隱患也很多,所以為了安全還是搞到虛擬機(jī)里玩玩。
一、docker安裝Ubuntu系統(tǒng)
1、 使用國(guó)內(nèi)鏡像源
"registry-mirrors": [
"https://docker.xuanyuan.me"
]2、拉取 Ubuntu 鏡像
docker pull ubuntu:latest
3、創(chuàng)建容器
創(chuàng)建容器,并映射 18789 端口
docker run -itd -p 18789:18789 --name openclaw ubuntu
4、查看運(yùn)行中的容器
docker ps
5、進(jìn)入容器
docker exec -it openclaw bash
二、Ubuntu安裝必要環(huán)境
1、更新軟件源
apt-get update
2、安裝必要的命令
apt-get install -y curl vim git systemctl
3、安裝 Node.js
打開(kāi) nodejs.org/en/download ,按網(wǎng)頁(yè)上提供的命令安裝 NodeJS
以下是文章發(fā)布時(shí)的最新安裝命令,跟著復(fù)制粘貼去執(zhí)行即可
# Download and install nvm: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash # in lieu of restarting the shell . "$HOME/.nvm/nvm.sh" # Download and install Node.js: nvm install 24 # Verify the Node.js version: node -v # Should print "v24.13.0". # Verify npm version: npm -v # Should print "11.6.2".
三、安裝OpenClaw
1、使用國(guó)內(nèi)鏡像源
npm config set registry https://registry.npmmirror.com/
2、安裝
npm install -g openclaw@latest
3、配置
openclaw onboard --install-daemon
根據(jù)你自身情況進(jìn)行配置即可,命令可以反復(fù)去執(zhí)行進(jìn)行配置
| 配置項(xiàng) | 選擇/操作 | 配置說(shuō)明 |
|---|---|---|
| I understand this is powerful and inherently risky. Continue? | 選擇 "Yes" | 確認(rèn)知曉風(fēng)險(xiǎn)并繼續(xù)部署 |
| Onboarding mode | 選擇 “QuickStart” | 快速啟動(dòng)模式,適合新手,簡(jiǎn)化配置 |
| Model/auth provider | 選免費(fèi)Qwen / 選"Skip for now" | 推薦先選Qwen(免費(fèi)),后續(xù)可配置火山引擎等其他模型;暫不配置則選Skip |
| Filter models by provider | 選擇 "All providers" | 顯示所有模型提供商,方便后續(xù)切換 |
| Default model | 使用默認(rèn)配置 | 保持默認(rèn),后續(xù)可在配置文件中修改 |
| Select channel (QuickStart) | 選擇 “Skip for now” | 暫不配置渠道,后續(xù)專門配置飛書(shū)渠道 |
| Configure skills now? (recommended) | 選擇 “No” | 暫不配置技能,后續(xù)按需添加 |
| Enable hooks? | 按空格鍵選中 → 按回車鍵下一步 | 啟用鉤子功能,支持命令日志、會(huì)話記憶等核心特性 |
| How do you want to hatch your bot? | 選擇 "Control UI" | 從終端界面啟動(dòng)機(jī)器人,基礎(chǔ)交互更便捷 |
4、網(wǎng)關(guān)配置
配置文件位置位于: ~/.openclaw/openclaw.json
vim ~/.openclaw/openclaw.json
我們需要在宿主機(jī)中訪問(wèn),則需要修改為 lan
{
gateway: {
mode: "local",
bind: "lan",
port: 18789,
auth: {
mode: "token",
token: "your-token"
},
},
}修改完成后重新網(wǎng)關(guān)服務(wù)
openclaw gateway restart
OpenClaw 使用 gateway.bind 配置項(xiàng)控制綁定模式,默認(rèn)的綁定模式為 loopback,僅 127.0.0.1 可訪問(wèn)。調(diào)整后支持通過(guò)本地地址訪問(wèn)。
5、運(yùn)行 OpenClaw
openclaw dashboard
輸出如下內(nèi)容
Dashboard URL: http://127.0.0.1:18789/?token=yourtoken Copy to clipboard unavailable. No GUI detected. Open from your computer: ssh -N -L 18789:127.0.0.1:18789 user@<host> Then open: http://localhost:18789/ http://localhost:18789/?token=yourtoken Docs: https://docs.openclaw.ai/gateway/remote https://docs.openclaw.ai/web/control-ui
在宿主機(jī)的瀏覽器中打開(kāi)給出網(wǎng)址即可,注意使用帶token的地址
四、疑難雜癥
1、啟動(dòng)后已斷開(kāi)與網(wǎng)關(guān)的連接。
unauthorized: gateway token missing (open the dashboard URL and paste the token in Control UI settings)
根本原因是你的訪問(wèn)連接沒(méi)有帶token,使用帶token的地址不會(huì)出現(xiàn)上述情況。
2、pairing required
相關(guān) issue 如下:
- https://github.com/openclaw/openclaw/issues/4531#issuecomment-3822813844
- https://github.com/openclaw/openclaw/issues/2284#issuecomment-3801613693
可以在終端中執(zhí)行以下命令(保持 Gateway 運(yùn)行):
openclaw devices list
查看待審批設(shè)備列表,預(yù)期輸出示例:
┌──────────────────────────────────────┬──────────────┬─────────────────────┐ │ Request ID │ Role │ Created At │ ├──────────────────────────────────────┼──────────────┼─────────────────────┤ │ 4f9db1bd-a1cc-4d3f-b643-2c195262464e │ browser │ 2026-02-11 12:22:01 │ │ b2f8c1de-9b4a-4e7c-8d21-3f5a9b7c2e1f │ node │ 2026-02-11 14:14:40 │ └──────────────────────────────────────┴──────────────┴─────────────────────┘
注意事項(xiàng):
- 若列表為空,說(shuō)明請(qǐng)求已過(guò)期,需刷新瀏覽器或重啟 CLI 重新觸發(fā)配對(duì)
- Role 列顯示設(shè)備類型:
browser(瀏覽器)- 通過(guò)網(wǎng)頁(yè)界面訪問(wèn)的設(shè)備node(節(jié)點(diǎn))- macOS/iOS/Android 節(jié)點(diǎn)設(shè)備cli(命令行)- 通過(guò)命令行工具訪問(wèn)的設(shè)備
復(fù)制你要批準(zhǔn)的 Request ID(例如 4f9db1bd-a1cc-4d3f-b643-2c195262464e),執(zhí)行:
openclaw devices approve 4f9db1bd-a1cc-4d3f-b643-2c195262464e
批準(zhǔn)指定設(shè)備,成功響應(yīng):
? Approved device 4f9db1bd-a1cc-4d3f-b643-2c195262464e (browser)
Access granted. Device can now connect to Gateway.
此時(shí)返回瀏覽器/客戶端,錯(cuò)誤應(yīng)立即消失,連接自動(dòng)恢復(fù)。重新刷新網(wǎng)頁(yè)則正常
五、配置千問(wèn)大模型
在左側(cè)菜單依次選擇:Config > Authentication,然后點(diǎn)擊下方的 Raw。
復(fù)制以下配置信息,替換 "agents": {...}, 部分,并將 DASHSCOPE_API_KEY 替換為你的百煉 API Key。
"models": {
"mode": "merge",
"providers": {
"bailian": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"apiKey": "DASHSCOPE_API_KEY",
"api": "openai-completions",
"models": [
{
"id": "qwen3-max-2026-01-23",
"name": "qwen3-max-thinking",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 262144,
"maxTokens": 65536
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "bailian/qwen3-max-2026-01-23"
},
"models": {
"bailian/qwen3-max-2026-01-23": {
"alias": "qwen3-max-thinking"
}
},
"maxConcurrent": 4,
"subagents": {
"maxConcurrent": 8
}
}
}單擊右上角 Save 保存配置,再點(diǎn)擊 Update 使配置生效。刷新網(wǎng)頁(yè)即可聊天了。
到此這篇關(guān)于Docker安裝OpenClaw大龍蝦的詳細(xì)步驟的文章就介紹到這了,更多相關(guān)Docker安裝OpenClaw內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章

一文教你OpenClaw Docker 部署并調(diào)用本地Qwen3.5 9B模型
本文詳細(xì)介紹了在 Ubuntu 24.04 系統(tǒng)上通過(guò) Docker 部署 Ollama 并運(yùn)行 Qwen3.5-9B的完整流程,同時(shí)對(duì)接 OpenClaw 實(shí)現(xiàn) Web 交互,文中通過(guò)示例代碼介紹的非常詳細(xì),需要的2026-03-12
Windows、macOS、Linux三系統(tǒng)本地部署OpenClaw+避坑指南+Docker一鍵部署,30分鐘搞定
本文給大家分享全網(wǎng)最全的OpenClaw安裝部署教程,覆蓋Windows、macOS、Linux三系統(tǒng)本地部署,并最終提供Docker一鍵部署方案,感興趣的朋友一起看看吧2026-03-10
本文詳細(xì)介紹了在MacBook Air M4芯片上使用Docker部署OpenClaw的過(guò)程,通過(guò)本文的步驟和技巧,讀者可以成功部署并使用OpenClaw作為智能助理,感興趣的朋友跟隨小編一起看看吧2026-03-05




