OpenClaw devbox 🦞

OpenClaw 主程序的扩展节点，提供预装多种编程语言与开发工具的远程执行环境。

预装语言与工具

• Python 3（python3、pip、venv）
• Node.js（来自 OpenClaw 基础镜像）
• Go（golang）
• Rust（rustc、cargo）
• C/C++（gcc、g++、make、cmake）
• 开发工具：git、curl、wget、jq、unzip、zip

持久化用户包

用户安装的包在容器重启后仍会保留：

• pip install → ~/.local/
• npm install -g → ~/.npm-global/
• go install → ~/go/
• cargo install → ~/.cargo/

Git 认证（可选）

如需 clone 私有仓库，请在 Zeabur 控制台的 devbox 服务中添加以下环境变量：

• GIT_TOKEN — GitHub personal access token，启动脚本会自动配置 HTTPS 认证。前往 GitHub > Settings > Developer settings > Personal access tokens 生成，需勾选 repo 权限。
• SSH_PRIVATE_KEY — Base64 编码的 SSH 私钥，启动脚本会自动写入 ~/.ssh/id_rsa。 生成密钥并编码：

  ssh-keygen -t ed25519 -f ~/.ssh/openclaw_devbox -N ""
  base64 -i ~/.ssh/openclaw_devbox    # 将此值粘贴到 SSH_PRIVATE_KEY
  

  然后将 ~/.ssh/openclaw_devbox.pub 添加到 GitHub 账号的 Settings > SSH and GPG keys。

使用案例

• 多语言程序执行 — 在对话中请 AI 编写并执行 Python、Go、Rust、C 代码
• 包安装与测试 — 请 AI 安装第三方包并验证功能（安装会持久化，重启后仍保留）
• 数据处理与分析 — 上传数据文件，请 AI 用 Python 或 jq 处理、转换、分析
• Git 操作与项目构建 — Clone 仓库、构建项目、运行测试
• 系统自动化脚本 — 编写和测试 shell script 与自动化工具

前置要求

您需要先有一个运行中的 OpenClaw 实例。如果还没有，请先部署 OpenClaw 主程序模板。

设置步骤

1. 部署前，先从 OpenClaw 服务的操作说明标签页中复制 Gateway Token，方便后续输入
2. 将此模板部署到与您的 OpenClaw 实例相同的 Zeabur 项目
3. 输入 Gateway Token 和 Gateway Host（您的 OpenClaw 实例的 Zeabur 服务名称，例如服务名称为 openclaw，则填入 openclaw）
4. devbox 节点将连接至 OpenClaw 并发送配对请求
5. 在您的 OpenClaw 服务终端中批准配对请求：

   openclaw devices list       # 找到待处理的请求 ID
   openclaw devices approve <requestId>
   

建议资源配置

• CPU：2 vCPU
• 内存：2048 MB

验证

部署后，确认 devbox 节点已出现在 OpenClaw 中：

• 在 OpenClaw 服务终端中执行 openclaw nodes list
• 或在 OpenClaw Web UI 的节点页面中查看
• 或直接在对话中询问："你现在有看到 devbox 的 node 吗？"

架构

• 无对外公开端口 — devbox 通过 WebSocket 主动连接至 OpenClaw gateway
• exec.security 设为 full — 执行命令时无需交互式批准
• 系统运行环境内置于镜像中；用户包存储在持久化磁盘上

疑难排解

• 如果已输入 Gateway Host 但在 openclaw devices list 中看不到等待配对的请求，可能是服务名称填写错误。请前往 Zeabur 控制台中 OpenClaw 服务的网络标签页，查看内网名称。例如内网名称为 openclaw.zeabur.internal，则 Gateway Host 应填入 openclaw（.zeabur.internal 前面的部分）。
• 如果 devbox 服务长时间未成功配对，Zeabur 可能会自动暂停该服务。请在尝试配对前确认 devbox 服务处于运行中状态。