openclaw

关注公众号 jb51net

关闭
AI > openclaw >

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 如下:

可以在终端中执行以下命令(保持 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 │
└──────────────────────────────────────┴──────────────┴─────────────────────┘

注意事项

复制你要批准的 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内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!