Loboot for Openclaw

Loboot helps you safely inspect, preview, and manage Loboot-owned user services on macOS and Linux without confusing stored definitions, activation preferences, and runtime state.

whitekiwi
v0.1.0
Oct 13, 2026
0
50
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install loboot

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install loboot using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Loboot?

Loboot is a command-line skill for operating the Loboot CLI on macOS launchd and Linux systemd user services. It guides agents through inspecting owned definitions, validating TOML manifests, previewing changes, and controlling service runtime or future activation with explicit checks.

The workflow emphasizes authorization, ownership, and evidence: a preview is not a live readiness check, and accepted manager commands do not prove a process stayed alive. Openclaw Skills using Loboot should not treat it as a tool for cron, system or boot services, Windows, or adopting unrelated native services.

Loboot Use Cases

  • Inspect Loboot-owned definitions with list or show without querying the native manager.
  • Validate a TOML manifest and view its rendered native definition with explain before installing it.
  • Preview an authorized service addition, update, removal, start, stop, restart, enable, or disable operation.
  • Check observed runtime and activation state in a live user session with status.
  • Diagnose local state and session readiness with doctor, while distinguishing diagnostic success from readiness.
  • Inventory entries in Loboot’s configured native directory with discover, keeping foreign entries read-only.
  • Build or test isolated Linux and macOS plans using an offline sandbox root.

How Loboot Works

  1. Check the installed CLI: Resolve loboot from PATH, run loboot --version, and consult installed command help for unfamiliar or version-sensitive operations. If the CLI is absent, refer to the official installation guide; installing the skill does not install Loboot.
  2. Choose a read-only inspection: Use the narrowest command for the request, such as list, show, explain, discover, status, or doctor. Interpret definition, runtime, and activation information as separate facts.
  3. Resolve the exact change: Confirm the service ID, executable, literal arguments, working directory, mode, restart policy, platform, and scope. Check ownership and prerequisites before proposing a mutation.
  4. Preview the operation: Run the requested mutation with --dry-run --json. Inspect the target, normalized changes, native commands, conditional branches, and preconditions. Dry-run makes no writes or manager queries.
  5. Apply only with authorization: Execute the same operation without --dry-run only when the user authorized that exact change. Do not silently add prerequisite actions such as enabling, stopping, or restarting a service.
  6. Verify and report: Read back the definition and, when relevant, query live status. Report the CLI version, platform and scope, preview result, final definition, observed runtime and activation, and any unknown or skipped checks.

Loboot Setup

  1. Install the Loboot CLI separately by following the official installation guide. The skill does not install the CLI or modify services as a setup step.
  2. Confirm that loboot is available on PATH and check its version. CLI version and help output are text, including when --json is supplied.
  3. Read installed help before using unfamiliar commands. For JSON responses, check the exit status, schema_version (loboot.cli/v1), and ok; inspect error.code and error.message on failure, and preserve unknown fields, states, and warnings.
  4. Before mutations or diagnoses involving partial progress, ownership, or native activation, read the skill’s references/safety.md guidance.
command -v loboot
loboot --version
loboot --help
loboot list --json

For a new direct-argv definition, use an absolute executable and working directory, and make consequential defaults explicit. Keep Loboot flags before the -- separator; Loboot does not expand shell syntax or variables.

loboot add ID --cwd /absolute/directory --mode service --restart never -- /absolute/executable ARG

For an offline plan or test, provide an absolute physical root and a supported platform. --platform requires --root; do not remove the root to bypass a refused offline operation.

loboot --root /absolute/physical/root --platform linux list --json

Loboot Data Schema & Taxonomy

Definitions and inputs

  • A Loboot service ID contains 1–63 lowercase letters, digits, or hyphens and starts with a letter.
  • A reusable TOML manifest must supply all six fields: id, executable, args, cwd, mode, and restart. Use args = [] when there are no arguments. Unknown fields are errors, and manifest settings cannot be overridden by direct-add options.
  • The executable and working directory must exist and use absolute physical paths with no symlink components. Arguments are literal; Loboot does not perform shell or variable expansion.
  • Supported modes include service and once; once requires restart policy never. Service restart policies are never, on-failure, and always.
Information How to inspect or interpret it
Owned local definitions list --json and show ID --json; these do not prove a service is running or enabled.
Validated manifest and rendered native definition explain MANIFEST --json; input is a TOML manifest, not a managed ID.
Configured native-directory inventory discover --json; shallow discovery only, with foreign entries remaining read-only.
Observed native state status ID --json; treat loaded, running, and enabled independently, and null as unknown.
Local and session diagnostics doctor --json; inspect data.state.ok and, for live readiness, both data.session.checked and data.session.available.

Files and sandbox data

An offline root isolates Loboot’s state/ and native/ files and prohibits manager execution. Offline add, update, and remove can write sandbox files unless run as dry-runs. Offline runtime and activation operations require --dry-run. Dry-run itself creates no directories, locks, files, or repairs. The skill does not specify a separate generated report format.

Loboot Advanced Features

  • Explicit dry-run previews: Every mutation supports --dry-run; inspect proposed changes and preconditions before applying an authorized operation.
  • Structured CLI responses: Prefer --json for decisions, validate the CLI schema and success state, and branch on documented error codes rather than guessing.
  • Separated service state: Manage stored definitions, future activation preferences, and current runtime independently. add creates a disabled definition without starting it; update requires a stopped job and does not restart it; remove requires a stopped and disabled job.
  • Platform-aware controls: Account for differing Linux and macOS behavior. Linux can start a disabled service; macOS start or restart requires enable first, and disabling a loaded job requires stop first.
  • Offline cross-platform testing: Use an absolute physical --root with --platform linux or --platform macos to isolate sandbox files from live manager execution. Sandbox checks cannot certify live session readiness.
  • Evidence-focused verification: After changes, read back definitions and query status when appropriate. If a mutation fails or its reply is lost, inspect current definition and native state before retrying, since another start or restart can execute the target again.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0