@@ -1,6 +1,6 @@
11---
22name: crabbox
3-description: Use Crabbox for OpenClaw remote Linux validation. Default to Blacksmith Testbox; includes direct Blacksmith and owned AWS/Hetzner fallback notes when Crabbox fails.
3+description: Use Crabbox for OpenClaw remote validation across Linux, macOS, Windows, and WSL2. Default to Blacksmith Testbox for broad Linux proof; includes direct Blacksmith and owned AWS/Hetzner fallback notes when Crabbox fails.
44---
5566# Crabbox
@@ -64,7 +64,8 @@ Crabbox supports static SSH targets:
6464- `target=macos` and `target=windows --windows-mode wsl2` use the POSIX SSH,
6565 bash, Git, rsync, and tar contract.
6666- Native Windows uses OpenSSH, PowerShell, Git, and tar; sync is manifest tar
67- archive transfer into `static.workRoot`.
67+ archive transfer into `static.workRoot`. Direct native Windows runs support
68+`--script*`, `--env-from-profile`, `--preflight`, and PowerShell `--shell`.
6869- `crabbox actions hydrate/register` are Linux-only today; use plain
6970`crabbox run` loops for static macOS and Windows hosts.
7071- Live proof needs a reachable, operator-managed SSH host. Without one, verify
@@ -144,8 +145,16 @@ blacksmith testbox list
144145Use these on debugging runs before inventing ad hoc logging:
145146146147- `--preflight`: prints run context, workspace mode, SSH target, remote user/cwd,
147- sudo/apt, Node, pnpm, Docker, and bubblewrap. On `blacksmith-testbox`, this
148- prints a delegated-unsupported note because the workflow owns setup.
148+ and target-specific tool probes. Defaults cover `git`, `tar`, `node`, `npm`,
149+`corepack`, `pnpm`, `yarn`, `bun`, `docker`, plus POSIX
150+`sudo`/`apt`/`bubblewrap` and native Windows
151+`powershell`/`execution_policy`/`longpaths`/`temp`/`pwsh`. Add
152+`--preflight-tools node,bun,docker`, `CRABBOX_PREFLIGHT_TOOLS`, or repo
153+`run.preflightTools` to replace the list. `default` expands built-ins; `none`
154+ prints only the workspace summary. Preflight is diagnostic only; install
155+ toolchains through Actions hydration, images, devcontainer/Nix/mise/asdf, or
156+ the run script. On `blacksmith-testbox`, this prints a delegated-unsupported
157+ note because the workflow owns setup.
149158- `CRABBOX_ENV_ALLOW=NAME,...`: forwards only listed local env vars for direct
150159 providers and prints `set len=N secret=true` style summaries. On
151160`blacksmith-testbox`, env forwarding is unsupported; put secrets in the
@@ -154,11 +163,13 @@ Use these on debugging runs before inventing ad hoc logging:
154163`export NAME=value` / `NAME=value` lines from a local profile without
155164 executing it, then forwards only allowlisted names. `--allow-env` is
156165 repeatable and comma-separated. Profile values override ambient allowlisted
157- env values for that run.
166+ env values for that run. Direct POSIX, WSL2, and native Windows runs are
167+ supported; delegated providers are not.
158168- `--script <file>` / `--script-stdin`: upload a local script into
159169`.crabbox/scripts/` and execute it on the remote box. Shebang scripts execute
160- directly; scripts without a shebang run through `bash`. Arguments after `--`
161- become script args.
170+ directly on POSIX; scripts without a shebang run through `bash`. Native
171+ Windows uploads run through Windows PowerShell, and Crabbox appends `.ps1`
172+ when needed. Arguments after `--` become script args.
162173- `--fresh-pr owner/repo#123|URL|number`: skip dirty local sync and create a
163174 fresh remote checkout of the GitHub PR. Bare numbers use the current repo's
164175 GitHub origin. Add `--apply-local-patch` only when the current local
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。