Docker安装OpenClaw大龙虾的详细步骤
脚本之家
现在OpenClaw很火,但是安全隐患也很多,所以为了安全还是搞到虚拟机里玩玩。
一、docker安装Ubuntu系统
1、 使用国内镜像源
"registry-mirrors": [
"https://docker.xuanyuan.me"
]2、拉取 Ubuntu 镜像
docker pull ubuntu:latest
3、创建容器
创建容器,并映射 18789 端口
docker run -itd -p 18789:18789 --name openclaw ubuntu
4、查看运行中的容器
docker ps
5、进入容器
docker exec -it openclaw bash
二、Ubuntu安装必要环境
1、更新软件源
apt-get update
2、安装必要的命令
apt-get install -y curl vim git systemctl
3、安装 Node.js
打开 nodejs.org/en/download ,按网页上提供的命令安装 NodeJS
以下是文章发布时的最新安装命令,跟着复制粘贴去执行即可
# 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、使用国内镜像源
npm config set registry https://registry.npmmirror.com/
2、安装
npm install -g openclaw@latest
3、配置
openclaw onboard --install-daemon
根据你自身情况进行配置即可,命令可以反复去执行进行配置
| 配置项 | 选择/操作 | 配置说明 |
|---|---|---|
| I understand this is powerful and inherently risky. Continue? | 选择 "Yes" | 确认知晓风险并继续部署 |
| Onboarding mode | 选择 “QuickStart” | 快速启动模式,适合新手,简化配置 |
| Model/auth provider | 选免费Qwen / 选"Skip for now" | 推荐先选Qwen(免费),后续可配置火山引擎等其他模型;暂不配置则选Skip |
| Filter models by provider | 选择 "All providers" | 显示所有模型提供商,方便后续切换 |
| Default model | 使用默认配置 | 保持默认,后续可在配置文件中修改 |
| Select channel (QuickStart) | 选择 “Skip for now” | 暂不配置渠道,后续专门配置飞书渠道 |
| Configure skills now? (recommended) | 选择 “No” | 暂不配置技能,后续按需添加 |
| Enable hooks? | 按空格键选中 → 按回车键下一步 | 启用钩子功能,支持命令日志、会话记忆等核心特性 |
| How do you want to hatch your bot? | 选择 "Control UI" | 从终端界面启动机器人,基础交互更便捷 |
4、网关配置
配置文件位置位于: ~/.openclaw/openclaw.json
vim ~/.openclaw/openclaw.json
我们需要在宿主机中访问,则需要修改为 lan
{
gateway: {
mode: "local",
bind: "lan",
port: 18789,
auth: {
mode: "token",
token: "your-token"
},
},
}修改完成后重新网关服务
openclaw gateway restart
OpenClaw 使用 gateway.bind 配置项控制绑定模式,默认的绑定模式为 loopback,仅 127.0.0.1 可访问。调整后支持通过本地地址访问。
5、运行 OpenClaw
openclaw dashboard
输出如下内容
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
在宿主机的浏览器中打开给出网址即可,注意使用带token的地址
四、疑难杂症
1、启动后已断开与网关的连接。
unauthorized: gateway token missing (open the dashboard URL and paste the token in Control UI settings)
根本原因是你的访问连接没有带token,使用带token的地址不会出现上述情况。
2、pairing required
相关 issue 如下:
- https://github.com/openclaw/openclaw/issues/4531#issuecomment-3822813844
- https://github.com/openclaw/openclaw/issues/2284#issuecomment-3801613693
可以在终端中执行以下命令(保持 Gateway 运行):
openclaw devices list
查看待审批设备列表,预期输出示例:
┌──────────────────────────────────────┬──────────────┬─────────────────────┐ │ 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 │ └──────────────────────────────────────┴──────────────┴─────────────────────┘
注意事项:
- 若列表为空,说明请求已过期,需刷新浏览器或重启 CLI 重新触发配对
- Role 列显示设备类型:
browser(浏览器)- 通过网页界面访问的设备node(节点)- macOS/iOS/Android 节点设备cli(命令行)- 通过命令行工具访问的设备
复制你要批准的 Request ID(例如 4f9db1bd-a1cc-4d3f-b643-2c195262464e),执行:
openclaw devices approve 4f9db1bd-a1cc-4d3f-b643-2c195262464e
批准指定设备,成功响应:
✓ Approved device 4f9db1bd-a1cc-4d3f-b643-2c195262464e (browser)
Access granted. Device can now connect to Gateway.
此时返回浏览器/客户端,错误应立即消失,连接自动恢复。重新刷新网页则正常
五、配置千问大模型
在左侧菜单依次选择:Config > Authentication,然后点击下方的 Raw。
复制以下配置信息,替换 "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 保存配置,再点击 Update 使配置生效。刷新网页即可聊天了。
到此这篇关于Docker安装OpenClaw大龙虾的详细步骤的文章就介绍到这了,更多相关Docker安装OpenClaw内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!
