메뉴
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 페이지를 검토하고 설치를 진행할 수 있습니다.
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.
SOC 직업 분류 기준
| 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.