CubeSandbox 实战教程
打开Terminal 终端,输入ssh连接命令: ssh root@<服务器ip> -p 9888
进入之后输入对应的密码,即可进入环境

一、安装CubeSandbox
在腾讯云 CVM 服务器上部署CubeSandbox之前,需要先安装PVM内核,才能让CubeSandbox 的虚拟机跑在云服务器上。
1. 安装 PVM 内核
在OpenCloudOS 9上,执行:
dnf install -y kernel-6.6.69-1.1.cubesandbox.oc9

2. 切换默认启动内核 + 配置启动参数+ 重启
# 把刚装的 CubeSandbox 内核设为默认启动
grubby --set-default /boot/vmlinuz-6.6.69-1.1.cubesandbox.oc9.x86_64
# 执行成功后会有一行 The default is ... 回显,不是报错
# 配置 PVM 所需的内核启动参数
curl -sL https://cnb.cool/CubeSandbox/CubeSandbox/-/git/raw/master/deploy/pvm/grub/host_grub_config.sh | bash
# 重启进入内核
reboot

重启之后需要重新使用远程命令连接
ssh root@193.112.92.84 -p 9888
3. 重启后验证内核 + 加载 KVM 模块
# 验证内核名含 cubesandbox.oc9
uname -r
# 期望输出 6.6.69-1.1.cubesandbox.oc9.x86_64
# 加载 PVM KVM 模块
modprobe kvm_pvm
# 确认模块已加载
lsmod | grep kvm_pvm
# 设置开机自动加载
echo 'kvm_pvm' > /etc/modules-load.d/kvm-pvm.conf

4. 安装 Cube Sandbox
curl -sL https://cnb.cool/CubeSandbox/CubeSandbox/-/git/raw/master/deploy/one-click/online-install.sh \
| CUBE_PVM_ENABLE=1 MIRROR=cn bash
5. 测试验证能运行
执行以下命令,如果可以正确执行完,并且cubemastercli tpl list看到模板状态为READY,即说明 CubeSandbox 已可正常工作:
cubemastercli tpl create-from-image \
--image cube-sandbox-cn.tencentcloudcr.com/cube-sandbox/sandbox-code:latest \
--writable-layer-size 1G \
--expose-port 49999 \
--expose-port 49983 \
--probe 49999


二、体验CubeSandbox WebUI
CubeSandbox 提供了一个简洁美观的 WebUI,便于管理员管理沙箱实例与模板。本实验后续操作都将在 WebUI 中完成。
| 项目 | 信息 |
|---|---|
| WebUI 地址 | http://<机器ip>:12088 |
| 默认账号 | admin |
| 默认密码 | admin |

登录后,可在首页查看正在运行的沙箱以及已制作的沙箱模板。


三、 体验数字助手
通过"数字助手"功能,亲手体验 CubeSandbox 的快照、克隆、回滚三大能力。
1. 安装****数字助手
进入数字助手页面:

1)配置 LLM 模型服务,设置 AI API key:

在弹窗中填写:
| 字段 | 信息 |
|---|---|
| Provider | OpenAI Compatible |
| LLM Base URL | https://newapi-2607.cubesandbox.com/v1 |
| 模型 ID | hy3-preview |
| LLM API Key | 现场签到处发给您的 Key |
| 凭证交付方式 | 凭证托管(推荐) |

🔐 安全提示:点击保存后,这个 key 将由 CubeEgress 进行托管,沙箱内接触不到真实密钥,确保了密钥的安全。
2)选择助手镜像
关闭弹窗,点击"去应用市场"。

在应用市场中选择 OpenClaw 镜像,安装到数字助手。


等待模板制作完成。在弹窗中为 OpenClaw 实例起一个名字,并将"状态管理模式"设置为 完整快照型。

随后等待数字助手创建完成(需要初始化 OpenClaw 网关,约几秒钟)。

2. 体验三大核心能力:快照、克隆、回滚
实例创建好后,点击卡片底部的 "Gateway 管理" 按钮,跳转到 OpenClaw 的对话 WebUI。在底部模型选择器中选择 hy3-preview 模型。

先发一条消息验证 OpenClaw 是否能正常响应:
但是提问之后一直卡着报错

解决方法:出现这个报错是因为API key无效,需要改过另一个API Key,但是改完之后要把这个个人助手删除之后重新创建才可以生效。

1)****核心功能一:体验快照
让OpenClaw往/root/a.txt写入一段文字,然后创建快照。
发送以下prompt 到 OpenClaw 对话框:
往“/root/a.txt"写入 ”测试消息111“。然后cat 一下文件给我。

可以看到 OpenClaw 已成功创建文件,并且正确写入了内容。
接着,回到 CubeSandbox WebUI,点击实例卡片上的 “管理”,进入"状态管理"页面,点击 “创建存档” 即可为当前 OpenClaw 实例打一份快照。


2)****核心功能二:体验克隆、创建分身
CubeSandbox 支持把同一个实例秒级克隆为多个数字分身,在"状态管理"中点击 “创建分身”。
分身创建完成后,关闭弹窗,可以看到首页看到创建好的“分身”卡片。

点击分身的 “Gateway 管理” 进入它的对话页面,会发现 历史对话记录与原始实例完全一致——这正是"快照-克隆"语义的直观体现。
接下来,在分身里发送:

执行成功后,回到原始实例的对话框里面输入:

可以发现 /root/b.txt 在原始实例中并不存在 ❌。这说明分身和原实例已是完全独立、互不影响的两套环境。
3)****核心功能三:体验回滚
实战中,可能会因为种种原因,OpenClaw 损坏了自身的环境,或者误删了文件。我们可以通过借助 CubeSandbox 的"回滚"功能来恢复,可以一键把实例还原到任意历史快照。
在原始实例的对话框中执行误操作:

随后再确认:
看看/root/a.txt还在不在?
会发现文件已被删除 ❌ 。
接下来体验****回滚:
好在我们前面已经创建过快照,因此可以直接回滚。请回到 CubeSandbox 控制台,点击原始实例的 “管理” 进入状态管理。

可以看到对话历史已经回退到打快照那一刻,“删除 /root/a.txt” 的对话记录也消失了。
最后,在对话框中输入:
帮我看看这个文件/root/a.txt在不在?
OpenClaw 会告诉你——文件已经回来了 ✅。环境被完整复原。

感受:在实践过程中,命令行里的命令要全部一起复制粘贴到终端,不然会报错
更多推荐


所有评论(0)