Qubicl

让任何 AI 智能体在你的机器上拥有一台真实、私密的计算机。

持久化文件。终端访问。网络研究。持久化的浏览器和桌面。 随时可人工接管。无需 Qubicl 账户、云控制平面或 模型锁定。

快速开始 · 为什么选择 Qubicl · 选择计算机 · 连接任意智能体 · 安全边界 · 文档

npm install -g qubicl-cli

Qubicl 将本地 Docker 转变为可供外部 AI 智能体观察的计算机。 智能体继续留在 Codex、Claude、Open WebUI、Cursor、VS Code 或其他 MCP 或 OpenAPI 客户端中。Qubicl 提供它工作的机器。

your model or agent
        │
        │  MCP / OpenAPI / Open Terminal
        ▼
 localhost-only Qubicl gateway
        │
        ├── terminal + managed processes
        ├── durable, host-visible files
        ├── keyless web search + local extraction
        ├── persistent Chromium + desktop
        ├── packaged, operator-controlled skills
        └── live viewer + human takeover

为什么选择 Qubicl

Related MCP server: EdgeBox

快速开始

要求：Linux 搭配 Docker Engine 或 Docker Desktop，macOS 搭配 Docker Desktop，或通过 WSL 2 和 Docker Desktop 运行的 Windows 11——外加 Node.js 22 或 24 以及 Docker Compose 2.24+。不支持原生 Windows 执行和 WSL 1； WSL 安装必须将 Qubicl 状态和计算机主目录保留在 WSL Linux 文件系统的 /home 下。

qubicl setup

设置向导会检查 Docker、比较计算机预设、预览磁盘和 资源使用情况、获取所选镜像，并可创建第一台计算机。 请以普通用户身份运行 Qubicl，切勿使用 sudo。

创建另一台计算机并连接智能体：

qubicl create computer-name --preset computer
qubicl connect computer-name --client codex

connect 会打印客户端配置；它从不编辑客户端文件，也不会 打印 bearer token。对于本地 stdio 客户端，该配置无需 token。

git clone https://github.com/EldanRing/qubicl.git
cd qubicl
npm ci
npm run images:build
npm install -g --prefix "$HOME/.local" ./packages/cli
export PATH="$HOME/.local/bin:$PATH"
qubicl setup

选择计算机

预设共享层，同时暴露不同的能力契约。所选计算机 无法支持的工具不会出现在发现结果中。

每个预设都包含原生无密钥 web_search、本地 web_extract，以及六个 经过验证的 Qubicl 原生技能基线，并带有持久化、智能体可编辑的工作 副本。操作员可以选择每台计算机暴露哪些工具和技能：

qubicl tools computer-name
qubicl skills computer-name

被禁用的工具会从 MCP、OpenAPI 和 Open Terminal 中消失，缓存的调用将默认失败。

连接任意智能体

qubicl connect computer-name --client codex
qubicl connect computer-name --client claude-code
qubicl connect computer-name --client cursor
qubicl connect computer-name --client opencode
qubicl connect computer-name --client openclaw
qubicl connect computer-name --client hermes-agent
qubicl connect computer-name --client open-webui

适配器涵盖 Codex、Claude Code、Claude Desktop、Cursor、VS Code、Open WebUI、 通用 stdio 和 HTTP MCP，以及直接 OpenAPI。静态配置文件可以暴露更小的 文件、语义浏览器、可视化浏览器或桌面目录。

对于 Open WebUI，将生成的配置复制到管理面板 → 设置 → 集成 → Open Terminal。Qubicl 提供原生持久化文件浏览 和搜索、基于文件系统的聊天上传、截图、浏览器工具，以及 显式发布的本地预览，无需加入 Open WebUI 的 Docker 网络。

有关确切说明，请参阅客户端设置。

观看并接管

qubicl view computer-name

观察是被动的。接管控制会围栏智能体工具，并在将键盘和鼠标交给你之前 终止其常规托管命令。持久化浏览器和显式管理的桌面应用保持可见， 因此你可以继续完全相同的任务，而不是重新开始。

当智能体正在操作时，查看器会将 Qubicl 的绿色指针保持在其最新的 桌面或托管浏览器位置，并短暂脉冲显示确切的点击目标。 语义浏览器点击会从页面元素通过 Chromium 和实时 noVNC 画布进行映射， 因此指示器在查看器调整大小和信箱模式时保持对齐。它会在输入分发之前出现， 在查看器重新加载后依然存在，并在智能体失去租约或人工接管时清除。 它仅存在于查看器中——人工输入、网页和智能体截图均不受影响——你可以 从查看器标题栏将其关闭。

如果控制中的查看器消失，Qubicl 会在短暂的重连宽限期后释放被放弃的 控制。操作员始终可以显式恢复：

qubicl control release computer-name

为日常使用而构建

• 通过经过身份验证的回环预览发布由智能体启动的本地 Web 应用。

• 备份、验证、加密、恢复、克隆和检查点持久化主目录。

• 应用 offline、web-only、developer 或自定义出口策略。

• 代理范围受限的凭据，而无需将机密放入工作负载中。

• 导入有边界的 devcontainer 定义，并使用主机中介的 Git 工作流。

• 为编辑器和普通 ssh/scp 启用仅回环 SSH。

• 检查私有的、无内容的审计跟踪，并使用 doctor 诊断拓扑。

• 就地升级计算机，同时保留其 ID、token、策略、资源和主目录。

使用 qubicl help 或 qubicl <command> --help 探索完整的 CLI。

安全边界

Qubicl 将每台计算机都保持在一个明确的 Docker 资源和文件系统 边界内。计算机在无特权模式、无 Docker socket、无主机 命名空间、无任意挂载、无免密提权的情况下运行。网关仅监听 127.0.0.1；Chromium 保留其 Linux 命名空间和渲染器 seccomp-BPF 沙箱；面向模型的文件被限制在持久化主目录中。 控制器和工作负载进程共享计算机容器，因此人工 接管是一种协作式的托管进程围栏，而非敌对代码边界。

Qubicl 是基于 Docker 的计算机，适用于受信任或操作员监督的工作负载， 而不是针对恶意自定义镜像、内核漏洞、Docker 入侵或控制主机账户的 其他用户的 VM 边界。默认的 developer 网络配置文件允许出站访问。 在依赖该边界之前，请阅读完整的 安全模型。

发布状态

Qubicl 0.1.x 是首个公开系列。它已可用于实际使用，但 其接口和状态格式在 1.0 之前可能会演变。首个版本直接测试了 Linux x64、搭载 Docker Desktop 的 Apple Silicon macOS，以及通过 WSL 2 上 Ubuntu 24.04 搭配 Docker Desktop 运行的 Windows 11 x64。Linux ARM64、 Intel macOS、Windows on ARM 和其他 WSL 发行版仍为尽力支持。 不支持原生 Windows 和 WSL 1；Qubicl 计算机在所有主机上都是 Linux 容器。升级前请备份重要的计算机主目录。

文档

许可： 源代码和文档采用 Apache-2.0；指定的 Qubicl 徽标和官方品牌素材采用 CC BY 4.0。有关允许的品牌使用和署名， 请参阅 BRANDING.md。

欢迎贡献——从 CONTRIBUTING.md 开始，并 通过 SECURITY.md 中描述的仓库私有安全报告 表单报告漏洞。