附录5:预装 OpenClaw 并具有桌面环境的 Linux 容器

附录5:预装 OpenClaw 并具有桌面环境的 Linux 容器

Tags
AI
Published
Author
一个预装 OpenClaw 并具有桌面环境的 Linux 容器,适配 ModelScope免费容器部署服务,通过浏览器即可畅玩体验 OpenClaw / A Docker container running Debian 12, the KDE desktop environment, and OpenClaw.
TunMax/openclaw_computer 项目构建了一个预装 OpenClaw 的 Linux 容器,配置了中文桌面环境/拼音输入法/Chrome 浏览器,同时为 OpenClaw 配置了默认免费推理的后端和启用了最高权限,免去了繁杂的部署细节,只需提供 ModelScope API Key(免费)就能开箱即用,小白也能轻松上手。
在 ModelScope部署后,相当于拥有了一台带有桌面环境的 Linux 云电脑,相关的硬件配置还不错。ModelScope提供 2核16GB 的基础硬件配置,而且完全免费。

下面以在 ModelScope 部署为例,开始教程:


  1. 打开 ModelScope 官网,登录账户。官网地址:https://www.modelscope.cn/home
    1. notion image
  1. 授权绑定阿里云账号,完成实名认证。
    1. notion image
      notion image
      notion image
      notion image
  1. 回到 ModelScope 网站,点击右上角头像,选择“账号设置”,然后点击左侧的“访问控制”,最后点击“新建访问令牌”并复制此令牌。
    1. notion image
      notion image
      notion image
  1. 在网站右上角搜索框输入“BrianZhou/openclaw_computer”,按回车键确认,随后点击搜索结果中展示的创空间。
    1. notion image
      notion image
  1. 复制该空间,并设置相关参数。“是否公开”选项,选择“非公开”;“ROOT_PASSWD”选项,你可以设置任意值,这是云电脑的密码,电脑待机锁屏时需要该密码解锁,请勿忘记;“MODELSCOPE_API_KEY”选项,粘贴你刚刚复制的令牌(即本教程第 3 步操作里复制的令牌),最后点击“复制创空间”。
    1. notion image
      notion image
      notion image
  1. 等待云电脑部署完成。
    1. notion image
       
  1. 云电脑部署上线后,按照下图操作进入全屏模式(用屏幕左侧工具栏操作)。至此,部署完成。
    1. notion image
      notion image

特别提醒!!!

云电脑成功部署并上线后,如果用户长期未对电脑进行操作,ModelScope 将会自动休眠容器,以此节约宝贵的算力资源。当容器再次被唤醒时,桌面和电脑里的文件可能会丢失,云电脑会恢复到最初创建状态。不过,ModelScope 特别设定了/mnt/workspace这一路径,允许数据的持久化存储,详情可参见官方文档:https://www.modelscope.cn/docs/studios/docker
举个例子,容器重启后你可以告诉 openclaw 从/mnt/workspace路径拷贝之前备份的配置文件夹回/root/.openclaw路径下,然后让他自己重启自己,就能恢复到之前的 openclaw 配置了。

补充信息

支持自定义启动脚本(当前仅限 ModelScope),相关代码需写在 /root/bz-startup/main.sh 文件中切换中英文输入法时使用 Ctrl+Shift 组合键启动后屏幕左侧工具栏有个剪贴板,可以在上面输入或粘贴文字,然后到容器内可以直接粘贴

更新说明

升级操作说明:ModelScope 已经部署容器的用户,需要在“设置”那里点击“深度重启”,然后才会自动拉取最新的容器镜像并部署。

2026-03-08

  1. 现已支持 ModelScope 容器在休眠/重启(含深度重启)后自动恢复 OpenClaw 的配置信息(目录:/root/.openclaw),不用再担心重启后还需要再配置的问题。同时,以下目录及文件也会自动恢复:桌面目录(/root/Desktop)、zsh 历史记录文件(/root/.zsh_history)实现原理:系统会利用 inotifywait 命令实时监控上述文件夹及文件的变化,当发生变化时,会立即使用 rsync 命令将最新版本的文件同步到 ModelScope 的 /mnt/workspace 持久化储存路径下;而在系统刚启动时,会检查 /mnt/workspace 目录下是否存在可恢复的文件夹及文件,如果存在则会执行恢复操作,恢复完成后才会启动 openclaw gateway。
  1. OpenClaw 升级到最新的 2026.3.7 版本
  1. 压缩减小了镜像体积

2026-03-09

  1. 将 npm 仓库官方源更改为国内源(registry.npmmirror.com),npm 下载安装模块速度拉满
  1. OpenClaw 升级到最新的 2026.3.8 版本
  1. 进一步压缩减小了镜像体积

2026-03-10

  1. 新增支持自定义启动脚本,便于在容器休眠/重启后自动恢复指定进程,相关脚本代码需写在 /root/bz-startup/main.sh 文件中。
  1. 新增支持 ModelScope 容器自动实时备份/重启后自动恢复的路径:/root/bz-startup/root/.codex/root/.claude
  1. 修复 ModelScope 用户名称加上创空间英文名称长度超过27个字符时可能导致 OpenClaw 启动失败的问题。