菜单
Understand clawctl's architecture and design decisions. Use when exploring the codebase structure, understanding package responsibilities, learning about the VM backend, mount system, onboarding flow, or making cross-cutting changes.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | understanding-architecture |
| description | Understand clawctl's architecture and design decisions. Use when exploring the codebase structure, understanding package responsibilities, learning about the VM backend, mount system, onboarding flow, or making cross-cutting changes. |
clawctl is a CLI for creating and managing OpenClaw gateways on macOS.
Each instance is a Lima VM provisioned and managed from the host.
| Package | Role |
|---|---|
types | Shared types, schemas, constants |
templates | Lima config generators (lima-yaml.ts) |
capabilities | Capability definitions + runner + state tracking |
host-core | Host-side library (drivers, provisioning, registry) |
cli | Host CLI (Ink wizard + commands) |
vm-cli | Guest CLI (claw) — runs inside the VM |
claw) — compiled TypeScript binary in the VM;
same language on both sides; structured JSON outputonComplete callbacksSee references/architecture.md for the complete documentation including directory structure, component relationships, onboarding approach, and error handling.
Add new CLI commands to clawctl. Use when creating a new command, subcommand group, or modifying the CLI surface. Ensures all touchpoints are updated: handler, exports, commander wiring, README, shell completions, and tests.
Develop the guest CLI (claw) that runs inside the VM. Use when working on vm-cli commands, the JSON output protocol, doctor checks, CapabilityContext implementation, or the capability registry.
Write and extend VM provisioning capabilities for clawctl. Use when adding new tools to the VM, modifying the provisioning pipeline, writing CapabilityDef modules, or working with lifecycle hooks and CapabilityContext SDK.
Understand and modify the VM provisioning workflow. Use when working on the host-side provisioning sequence, understanding what each phase installs, debugging provisioning failures, or modifying the idempotency/verification flow.