Docker安装OpenClaw大龙虾的详细步骤

OpenClaw最近确实挺火，但安全风险也得认真对待。最好的办法，就是把它塞进虚拟机里运行，既尝了鲜又不影响宿主机环境。下面一步步来，从零开始，在Docker里装个Ubuntu再把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 una vailable.
No GUI detected. Open from your computer:
ssh -N -L 18789:127.0.0.1:18789 user@
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.

此时返回浏览器/客户端，错误应立即消失，连接自动恢复。重新刷新网页则正常

五、配置千问大模型

在左侧菜单依次选择：

> ，然后点击下方的 。

复制以下配置信息，替换 "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
    }
  }
}

单击右上角

保存配置，再点击 使配置生效。刷新网页即可聊天了。