人们对我的 AI 支出大惊小怪。但没人看到的是：让我如此热衷于 OpenClaw 的部分原因在于，我在尝试回答一个问题：如果 token 不计成本，未来我们该如何构建软件？我们持续在云端运行约 100 个 Codex，审查每一个 PR、每一个 issue。如果主分支上修复了一个问题，@clawsweeper 最终会找到那个 6 个月前的 issue，并附上精确的引用来关闭它。我们在每次提交时运行 Codex 来审查安全问题（因为太容易遗漏了）。我们运行 Codex 来去重 issues、发现聚类，并为最紧迫的问题发送报告。我们有能复现复杂环境、启动临时 http://crabbox.sh 机器、登录 Telegram 等应用、录制视频并在 PR 上发布修复前后对比的 agent。有 Codex 监控新 issue，如果符合我们文档化的愿景，就自动为其创建 PR（然后由另一个 Codex 审查）。我们有运行的 Codex 扫描评论中的垃圾信息并封禁用户。有运行的 Codex 实例验证性能基准并在 Discord 中报告回退。我们有 agent 监听会议，并主动开始工作，例如在我们讨论新功能时创建 PR。我们搭建了 http://clawpatch.ai 来将所有项目拆分为功能单元，用于审查和发现 bug 与回退。我们还使用 Vercel 的 deepsec 和 Codex Security 进行同样的拆分，用于发现回退和漏洞。所有这些自动化使我们能够极精简地运行这个项目。

🦀 Crabbox Docs - Crabbox 文档

来源：https://crabbox.sh/

本地开发，远程执行

保持你的编辑器与 git 工作流。Crabbox 将你的脏工作目录同步到租赁的远程机器，并将运行结果流式传回。

代理凭证，非自带凭证

一个 Cloudflare Worker 持有云服务商凭证并序列化租赁状态。你的 CLI 仅携带一个 bearer token。

成本感知的租赁

限 TTL 的机器、月度支出上限，以及 broker 提供的按用户/组织/服务商/实例类型的使用统计。

复用热实例

crabbox warmup 保持一个机器热状态。通过 --id 在多次运行、SSH 和 CI 环境中复用该实例。

多服务商，统一执行

代理 Hetzner / AWS / Azure，委托 E2B / Daytona / Blacksmith / Semaphore，或静态 SSH 目标——支持 Linux、Windows 和 macOS。

与 Actions 协同

actions hydrate 复用仓库的 GitHub Actions 设置步骤，使本地运行落在相同预装环境中。

浏览器中的桌面

crabbox webvnc 将 Linux、macOS 或 Windows 桌面流式传输到浏览器中。驱动 UI 测试、截取屏幕截图、将实时会话交给队友——无需 VPN。

每次运行的证据

crabbox artifacts collect 打包屏幕截图、视频、JUnit 摘要、日志和租赁元数据。将其作为修复前后的证据放在 PR 上，而不是抓取日志输出。

预热一个机器，同步差异，运行测试套件。

# (https://crabbox.sh/#what-crabbox-is)什么是 Crabbox

Crabbox 是一个共享的 agent 工作空间控制平面，面向软件维护者和 AI agent。目标是保持本地开发体验不变——编辑、保存、运行——同时将计算、测试和审查证据迁移到自有或服务商提供的远程容量上。crabbox run 命令租赁一台代理的云机器、复用静态 SSH 主机、或委托给沙盒服务商，同步你本地的跟踪和未忽略文件，远程执行命令，将 stdout 和 stderr 流式传回，然后释放或取消声明目标。后台一个小型 Cloudflare 托管的 broker 持有云服务商凭证、租赁状态、清理、使用和成本护栏，因此单个机器和 CLI 无需处理这些。

# (https://crabbox.sh/#how-it-fits-together)如何工作的

你的笔记本电脑      Cloudflare Worker               云服务商
-------------      -----------------              --------------
crabbox CLI -- HTTPS --> Fleet Durable Object --> Hetzner / AWS / Azure / GCP
                        | 租赁 + 成本状态 |
                        |                 |
                        +------------ SSH + rsync 到租赁的运行器 <--------------+

CLI 是一个 Go 二进制文件。broker 是一个 Cloudflare Worker 加一个单一 Durable Object。代理的 Linux 运行器是标准的 Ubuntu 机器，通过 cloud-init 预装 SSH、Git、rsync、curl、jq 和 /work/crabbox；AWS 还可以代理托管的 Windows/WSL2 和 EC2 Mac 桌面目标，Azure 可以代理原生 Windows SSH/sync/run、桌面/VNC 和 Windows WSL2 目标。静态主机是现有的 SSH 机器，使用 provider: ssh 选择。项目运行时来自 Actions 水化或仓库自有的设置。运行器不持有 broker 凭证——它们是叶节点。

# (https://crabbox.sh/#a-run-end-to-end)一次运行的端到端流程

1. CLI 从标志、环境变量、仓库、用户、默认值加载配置。
2. CLI 生成一个一次性 SSH 密钥和 slug，然后调用 broker 的 POST /v1/leases。
3. Worker 检查活跃租赁和月度支出上限，预留最坏情况下的 TTL 成本，预配服务器，返回主机/端口/用户/工作目录/过期时间/slug。
4. CLI 等待 crabbox-ready，在可能时种子远程 Git，rsync Git 文件列表清单，运行同步护栏和合理性检查，水化配置的基础分支。
5. CLI 通过 SSH 运行命令，流式传输输出，记录运行事件，发送心跳/touch。
6. CLI 释放租赁，除非设置了 --keep；保留的租赁在空闲超时后仍会自动释放，并且 broker 在租赁关闭时释放预留成本。

参见 工作原理 (https://crabbox.sh/how-it-works.html) 了解完整描述，包括热机器复用以及代理路径与直接服务商路径。参见 源码映射 (https://crabbox.sh/source-map.html) 当需要将文档行为追溯到代码时。

# (https://crabbox.sh/#install)安装

brew install openclaw/tap/crabbox

验证安装：crabbox --version。

# (https://crabbox.sh/#quick-start)快速开始

# 每台机器登录一次 - 在用户配置中存储 broker token
crabbox login

# 在全新租赁的机器上一次性运行
crabbox run -- pnpm test

# 保持一个热机器用于重复运行；输出包含一个 ID 和 slug
crabbox warmup
crabbox run --id blue-lobster -- pnpm test:changed
crabbox ssh --id blue-lobster
crabbox stop blue-lobster

crabbox doctor 验证本地配置、网络可达性和 SSH 密钥可用性，在投入长时间工作流之前。crabbox usage 按用户、组织、服务商和服务器类型汇总最近支出。

# (https://crabbox.sh/#openclaw-plugin)OpenClaw 插件

该仓库根目录也是一个原生的 OpenClaw 插件包。安装到 OpenClaw 后，它将 Crabbox 操作暴露为 agent 工具：

• crabbox_run
• crabbox_warmup
• crabbox_status
• crabbox_list
• crabbox_stop

该插件使用 argv 数组调用配置好的 crabbox 二进制文件，因此本地 Crabbox 配置、broker 登录、仓库声明和同步行为由 CLI 保留。如果二进制文件不在 PATH 中，配置 plugins.entries.crabbox.config.binary。运行历史检查和审查特意由 Crabbox CLI 和仓库技能处理，而非额外的插件工具。使用 crabbox history、crabbox events --after --limit、crabbox attach、crabbox logs、crabbox results 和 crabbox usage（在具备 shell 能力的 agent 中）。

# (https://crabbox.sh/#where-to-read-next)下一步阅读

根据你的意图选择：

• 从这里开始： 入门指南 (https://crabbox.sh/getting-started.html)、工作原理 (https://crabbox.sh/how-it-works.html)、概念与术语 (https://crabbox.sh/concepts.html)。
• 了解心智模型： 架构 (https://crabbox.sh/architecture.html)、编排器 (https://crabbox.sh/orchestrator.html)。
• 使用 CLI： CLI (https://crabbox.sh/cli.html)、命令 (https://crabbox.sh/commands/index.html)、特性 (https://crabbox.sh/features/index.html)、配置 (https://crabbox.sh/features/configuration.html)、作业 (https://crabbox.sh/features/jobs.html)、Actions 水化 (https://crabbox.sh/features/actions-hydration.html)、浏览器门户 (https://crabbox.sh/features/portal.html)、遥测 (https://crabbox.sh/features/telemetry.html)。
• 选择或添加目标： 服务商参考 (https://crabbox.sh/providers/index.html)、服务商特性概览 (https://crabbox.sh/features/providers.html)、服务商编写 (https://crabbox.sh/features/provider-authoring.html)、服务商后端 (https://crabbox.sh/provider-backends.html)、AWS (https://crabbox.sh/providers/aws.html)、Azure (https://crabbox.sh/providers/azure.html)、Google Cloud (https://crabbox.sh/providers/gcp.html)、Hetzner (https://crabbox.sh/providers/hetzner.html)、Proxmox (https://crabbox.sh/providers/proxmox.html)、静态 SSH (https://crabbox.sh/providers/ssh.html)、Blacksmith Testbox (https://crabbox.sh/providers/blacksmith-testbox.html)、Namespace Devbox (https://crabbox.sh/providers/namespace-devbox.html)、Semaphore (https://crabbox.sh/providers/semaphore.html)、Sprites (https://crabbox.sh/providers/sprites.html)、Daytona (https://crabbox.sh/providers/daytona.html)、Islo (https://crabbox.sh/providers/islo.html)、E2B (https://crabbox.sh/providers/e2b.html)、Modal (https://crabbox.sh/providers/modal.html)、Tensorlake (https://crabbox.sh/providers/tensorlake.html)、交互式桌面与 VNC (https://crabbox.sh/features/interactive-desktop-vnc.html)。
• 运维： 运维 (https://crabbox.sh/operations.html)、可观测性 (https://crabbox.sh/observability.html)、故障排除 (https://crabbox.sh/troubleshooting.html)、性能 (https://crabbox.sh/performance.html)。
• 设置或审计： 基础设施 (https://crabbox.sh/infrastructure.html)、安全 (https://crabbox.sh/security.html)、源码映射 (https://crabbox.sh/source-map.html)、MVP 计划 (https://crabbox.sh/mvp-plan.html)。

# (https://crabbox.sh/#about-these-docs)关于本文档

此目录下的 Markdown 文件是面向用户的文档源。实现事实保留在代码中；源码映射 (https://crabbox.sh/source-map.html) 列出了每个文档行为背后的文件。GitHub Pages 站点 由这些 Markdown 文件通过 scripts/build-docs-site.mjs 生成，并通过 .github/workflows/pages.yml 部署。必须在仓库或组织上启用 Pages 才能使工作流发布。

本地构建文档站点：

npm run docs:check
open dist/docs-site/index.html