一键部署 OpenClaw Agent 环境

OpenClaw 云桌面,浏览器直连远程桌面,支持 Docker-in-Docker、GPU 加速、中文输入法,开箱即用

$ curl -fsSL https://claw.ihasy.com/openclaw-kasmvnc-zh.sh | bash -s -- install
OpenClaw 桌面环境截图

为什么选择 OpenClaw 云桌面

解决官方 Docker 方案和云厂商部署的核心痛点

🔧

容器内完整生命周期

官方 Docker 方案无 systemd 导致无法容器内重启/升级。本项目通过 systemctl shim 完美解决,支持容器内 restart、upgrade 等全生命周期管理

👁️

可视化桌面环境

云厂商一键部署只有命令行,无法观察 Agent 操作。本项目提供完整 XFCE 桌面,实时查看 OpenClaw 操作浏览器过程

🔒

安全加固

提供 no-dind 变体无需 privileged 权限,移除 SSL 验证绕过,限制 sudo 权限,内置健康检查和漏洞扫描

🌐

浏览器直连桌面

无需安装 VNC 客户端,打开浏览器即可访问完整 Linux 桌面环境

📦

环境隔离

OpenClaw、桌面、依赖全部运行在容器内,不污染宿主机系统

一键部署

一条命令完成安装,支持 install / upgrade / restart / uninstall 全生命周期管理

🎮

GPU 自动检测

安装时自动识别 NVIDIA GPU,有则启用 nvidia runtime,无则跳过

🦞

大规模部署

标准化容器方案使大规模部署龙虾成为可能,统一管理多个 OpenClaw 实例

💻

跨平台支持

Windows (PowerShell) / macOS / Linux 三平台统一体验,行为一致

🐳

Docker-in-Docker

容器内内置 dockerd,OpenClaw 可直接创建和管理子容器,无需额外配置

🌍

多架构支持

支持 amd64 和 arm64 架构,自动构建和测试,确保跨平台兼容性

🔄

CI/CD 自动化

GitHub Actions 自动构建 4 个镜像变体,集成安全扫描和功能测试

快速安装

选择安装方式:一键脚本或 Docker 镜像

irm https://claw.ihasy.com/openclaw-kasmvnc-zh.ps1 | iex
curl -fsSL https://claw.ihasy.com/openclaw-kasmvnc-zh.sh | bash -s -- install
curl -fsSL https://claw.ihasy.com/openclaw-kasmvnc-zh.sh | bash -s -- install

前置条件:Docker(含 Docker Compose v2)· Windows 需 PowerShell 5+ · macOS/Linux 需 Bash

中文版(国内镜像 + DinD)

docker run -d \
  --name openclaw-kasmvnc \
  --privileged \
  --shm-size=2g \
  -p 18789:18789 \
  -p 8443:8444 \
  -e OPENCLAW_GATEWAY_TOKEN=your-token-here \
  -e OPENCLAW_KASMVNC_PASSWORD=your-password-here \
  -v ~/.openclaw:/home/node/.openclaw \
  ddong8/openclaw-kasmvnc:latest

国际版(官方源 + DinD)

docker run -d \
  --name openclaw-kasmvnc \
  --privileged \
  --shm-size=2g \
  -p 18789:18789 \
  -p 8443:8444 \
  -e OPENCLAW_GATEWAY_TOKEN=your-token-here \
  -e OPENCLAW_KASMVNC_PASSWORD=your-password-here \
  -e USE_CN_MIRROR=0 \
  -v ~/.openclaw:/home/node/.openclaw \
  ddong8/openclaw-kasmvnc:latest-intl

无 DinD 版本(更安全)

如果不需要 OpenClaw 管理子容器,使用 no-dind 变体可提高安全性(无需 --privileged):

docker run -d \
  --name openclaw-kasmvnc \
  --shm-size=2g \
  -p 18789:18789 \
  -p 8443:8444 \
  -e OPENCLAW_GATEWAY_TOKEN=your-token-here \
  -e OPENCLAW_KASMVNC_PASSWORD=your-password-here \
  -v ~/.openclaw:/home/node/.openclaw \
  ddong8/openclaw-kasmvnc:latest-no-dind

更多镜像变体和配置请参考 DOCKER.md

推荐配置

使用阿里云百炼 API,接入国产大模型

1. 获取 API Key

前往 阿里云百炼控制台 创建 API Key,用于 OpenClaw 调用大模型。

2. 配置 openclaw.json

安装完成后,编辑 ~/.openclaw/openclaw.json(容器内路径),填入你的 API Key:

{
  "mcpServers": {},
  "providers": {
    "bailian": {
      "name": "阿里云百炼",
      "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
      "apiKey": "sk-your-api-key-here",
      "models": [
        { "name": "qwen3.5-plus", "maxTokens": 41960 },
        { "name": "qwen3-max", "maxTokens": 41960 },
        { "name": "qwen3-coder-next", "maxTokens": 41960 },
        { "name": "qwen3-coder-plus", "maxTokens": 41960 },
        { "name": "MiniMax-M2.5", "maxTokens": 41960 },
        { "name": "glm-5", "maxTokens": 41960 },
        { "name": "glm-4.7", "maxTokens": 41960 },
        { "name": "kimi-k2.5", "maxTokens": 41960 }
      ]
    }
  },
  "selectedProvider": "bailian",
  "selectedModel": "qwen3-coder-plus"
}

⚠ 请将 sk-your-api-key-here 替换为你的真实 API Key

3. 支持的模型

通过百炼 API 可使用以下模型:

模型厂商特点
qwen3.5-plus通义千问最新一代,综合能力强
qwen3-max通义千问旗舰模型,推理能力顶尖
qwen3-coder-next通义千问代码专精,下一代
qwen3-coder-plus通义千问代码专精,性价比高
MiniMax-M2.5MiniMax多模态,长上下文
glm-5智谱 AI最新一代 GLM
glm-4.7智谱 AI稳定可靠
kimi-k2.5月之暗面长文本理解

新人专享福利

阿里云百炼 API 限时优惠 — 大模型入门套餐首购低至 4.5 折

阿里云百炼 API 优惠

4.5 折

大模型入门套餐首购优惠,支持通义千问、GLM、Kimi 等多个国产大模型,新用户专享

立即领取

Docker 镜像变体

4 个预构建镜像变体,满足不同使用场景

镜像标签说明适用场景
latest中文版 + 国内镜像 + DinD国内用户,需要 Docker-in-Docker
latest-intl国际版 + 官方源 + DinD国外用户,需要 Docker-in-Docker
latest-no-dind中文版 + 国内镜像 + 无 DinD国内用户,不需要子容器(更安全)
latest-intl-no-dind国际版 + 官方源 + 无 DinD国外用户,不需要子容器(更安全)

常用命令

全生命周期管理,一个脚本搞定

install
全新安装,构建镜像并启动服务
uninstall
停止并移除容器(加 --purge 删除安装目录)
restart
重启容器,配置修改后执行此命令生效
upgrade
热更新 OpenClaw 到最新版,无需重建镜像
status
查看容器运行状态
logs --tail 200
查看最近 200 行日志,快速定位问题

常见问题

构建失败或需要清除缓存?
使用 --no-cache 参数禁用 Docker 构建缓存:./openclaw-kasmvnc-zh.sh install --no-cache(Windows 用 -NoCache)。
端口被占用怎么办?
安装时指定其他端口:--gateway-port 28789 --https-port 9443(Windows 用 -GatewayPort 28789 -HttpsPort 9443),然后重新 install。
KasmVNC 提示 HTTPS 证书不安全?
默认使用容器自签名证书,属于正常现象。在浏览器选择"继续访问"即可,或自行配置反向代理(Nginx / Caddy)。
中文输入法没有激活?
旧卷配置冲突导致。在宿主机执行 upgrade,然后在 VNC 终端执行 rm -rf ~/.config/fcitx5 ~/.local/share/fcitx5/rime/default.custom.yaml,最后从桌面菜单 Log Out 并刷新页面重新进入。
进入桌面后黑屏?
依次尝试:restartstatuslogs --tail 200upgrade
macOS 上出现 chown: Operation not permitted?
macOS M 系列部分挂载路径会出现此提示,容器运行正常则可安全忽略。
为什么用 Chromium 而不是 Chrome?
三个原因:1) 多架构兼容 — Google 未提供 ARM64 Chrome;2) 版权合规 — Chrome 含闭源插件;3) 依赖纯净 — apt 安装的 Chromium 与系统库无缝兼容。