managing-provisioning

Stars16

Forks0

UpdatedApril 1, 2026 at 09:12

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.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

TimBeyer

TimBeyer/clawctl

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Network and Computer Systems AdministratorsComputer and Mathematical Occupations·SOC 15-1244

File Explorer

2 files

SKILL.md

readonly

name	managing-provisioning
description	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.

Managing Provisioning

Provisioning installs all system packages, user tools, and OpenClaw inside the VM. It's driven by the claw binary and orchestrated by the host via host-core/src/provision.ts.

Provisioning sequence

Create project directory + git repo on the host
Create/start the Lima VM
Deploy claw binary into the VM
sudo claw provision system — APT packages, Node.js, systemd linger, Tailscale
claw provision tools — Homebrew, 1Password CLI, shell profile
claw provision openclaw — OpenClaw CLI, env vars, gateway stub
claw provision workspace — skills, workspace files
claw doctor — verify provisioning
openclaw onboard — interactive or headless
claw provision bootstrap — post-onboard hooks (AGENTS.md sections)

Key properties

Idempotent — each capability step checks current state before acting; re-running is a fast no-op
Capability-driven — provisioning logic lives in CapabilityDef modules, not in the host or provision commands
Verifiable — claw doctor checks health with lifecycle-aware warnings (availableAfter)
State-tracked — data/capability-state.json records installed versions; supports migrations

Full reference

See references/vm-provisioning.md for the complete documentation including what each phase installs, verification details, re-running provisioning, and troubleshooting.

More from this repository

same repository

adding-cli-commands

TimBeyer/clawctl

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.

2026-04-0116

developing-vm-cli

TimBeyer/clawctl

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.

2026-04-0116

extending-capabilities

TimBeyer/clawctl

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.

2026-04-0116

understanding-architecture

TimBeyer/clawctl

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.

2026-04-0116

name	managing-provisioning
description	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.

Managing Provisioning

Provisioning installs all system packages, user tools, and OpenClaw inside the VM. It's driven by the claw binary and orchestrated by the host via host-core/src/provision.ts.

Provisioning sequence

Create project directory + git repo on the host
Create/start the Lima VM
Deploy claw binary into the VM
sudo claw provision system — APT packages, Node.js, systemd linger, Tailscale
claw provision tools — Homebrew, 1Password CLI, shell profile
claw provision openclaw — OpenClaw CLI, env vars, gateway stub
claw provision workspace — skills, workspace files
claw doctor — verify provisioning
openclaw onboard — interactive or headless
claw provision bootstrap — post-onboard hooks (AGENTS.md sections)

Key properties

Idempotent — each capability step checks current state before acting; re-running is a fast no-op
Capability-driven — provisioning logic lives in CapabilityDef modules, not in the host or provision commands
Verifiable — claw doctor checks health with lifecycle-aware warnings (availableAfter)
State-tracked — data/capability-state.json records installed versions; supports migrations

Full reference

See references/vm-provisioning.md for the complete documentation including what each phase installs, verification details, re-running provisioning, and troubleshooting.