Loboot

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install loboot
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 loboot。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Loboot 是一个用于在 macOS launchd 和 Linux systemd 用户服务上操作 Loboot CLI 的命令行技能。它指导代理检查拥有的定义、验证 TOML 清单、预览更改并通过显式检查控制服务运行时或未来激活。
工作流强调授权、所有权和证据：预览不是实时就绪性检查，接受的管理程序命令并不能证明进程保持存活。使用 Loboot 的 Openclaw Skills 不应将其视为用于定时任务（cron）、系统或启动服务、Windows 或采用不相关的原生服务的工具。

应用场景

list
show
检查 Loboot 拥有的定义，而无需查询原生管理器。
在安装前使用
explain
验证 TOML 清单并查看其渲染的原生定义。
预览授权的服务添加、更新、移除、启动、停止、重启、启用或禁用操作。
在实时用户会话中使用
status
检查观察到的运行时和激活状态。
doctor
诊断本地状态和会话就绪性，同时区分诊断成功与就绪性。
discover
盘点 Loboot 配置的原生目录中的条目，使外部条目保持只读。
使用离线沙箱根目录构建或测试隔离的 Linux 和 macOS 计划。

工作原理

检查安装的 CLI： 从 PATH 解析 loboot，运行 loboot --version，并针对不熟悉或版本敏感的操作查阅已安装的命令帮助。如果 CLI 不存在，请参考官方安装指南；安装此技能不会安装 Loboot。
选择只读检查： 针对请求使用最窄的命令，例如 list、show、explain、discover、status 或 doctor。将定义、运行时和激活信息解释为独立的事实。
解析确切的更改： 确认服务 ID、可执行文件、字面量参数、工作目录、模式、重启策略、平台和作用域。在提议变更之前检查所有权和先决条件。
预览操作： 使用 --dry-run --json 运行请求的变更。检查目标、规范化更改、原生命令、条件分支和前提条件。干跑（dry-run）不进行写入或管理器查询。
仅在授权时应用： 仅当用户授权该确切更改时，才在没有 --dry-run 的情况下执行相同的操作。不要静默添加诸如启用、停止或重启服务等先决条件操作。
验证并报告： 读回定义，并在相关时查询实时状态。报告 CLI 版本、平台和作用域、预览结果、最终定义、观察到的运行时和激活，以及任何未知或跳过的检查。

配置指南

遵循官方安装指南单独安装 Loboot CLI。此技能不作为安装步骤安装 CLI 或修改服务。
确认 loboot 在 PATH 上可用并检查其版本。CLI 版本和帮助输出是文本，包括提供 --json 时。
在使用不熟悉的命令之前阅读已安装的帮助。对于 JSON 响应，检查退出状态、schema_version (loboot.cli/v1) 和 ok；在失败时检查 error.code 和 error.message，并保留未知的字段、状态和警告。
在涉及部分进度、所有权或原生激活的变更或诊断之前，请阅读技能的 references/safety.md 指南。
command -v loboot
loboot --version
loboot --help
loboot list --json
对于新的直接参数（direct-argv）定义，使用绝对可执行文件和工作目录，并使 consequential 默认值明确。将 Loboot 标志保留在 -- 分隔符之前；Loboot 不会扩展 shell 语法或变量。
loboot add ID --cwd /absolute/directory --mode service --restart never -- /absolute/executable ARG
对于离线计划或测试，请提供绝对物理根目录和受支持的平台。--platform 需要 --root；请勿移除根目录以绕过被拒绝的离线操作。
loboot --root /absolute/physical/root --platform linux list --json

数据架构

定义和输入
Loboot 服务 ID 包含 1–63 个小写字母、数字或连字符，且以字母开头。
可重用的 TOML 清单必须提供所有六个字段：id、executable、args、cwd、mode 和 restart。当没有参数时使用 args = []。未知字段是错误，清单设置不能被直接添加选项覆盖。
可执行文件和工作目录必须存在且使用没有符号链接组件的绝对物理路径。参数是字面量的；Loboot 不执行 shell 或变量扩展。
支持的模式包括 service 和 once；once 需要重启策略 never。服务重启策略为 never、on-failure 和 always。
信息 如何检查或解释它
拥有的本地定义 list --json 和 show ID --json；这些并不能证明服务正在运行或已启用。
已验证的清单和渲染的原生定义 explain MANIFEST --json；输入是 TOML 清单，而不是托管的 ID。
配置的原生目录清单 discover --json；仅浅层发现，外部条目保持只读。
观察到的原生状态 status ID --json；独立对待 loaded、running 和 enabled，并将 null 视为未知。
本地和会话诊断 doctor --json；检查 data.state.ok，对于实时就绪性，检查 data.session.checked 和 data.session.available。
文件和沙箱数据
离线根目录隔离了 Loboot 的 state/ 和 native/ 文件并禁止管理器执行。离线 add、update 和 remove 可以写入沙箱文件，除非作为干跑运行。离线运行时和激活操作需要 --dry-run。干跑本身不创建目录、锁、文件或修复。此技能未指定单独生成的报告格式。

高级特性

显式干跑预览：
每个变更都支持 --dry-run ；在应用授权操作之前检查建议的更改和前提条件。
结构化 CLI 响应：
优先选择 --json 进行决策，验证 CLI 架构和成功状态，并根据记录的错误代码进行分支而不是猜测。
分离的服务状态：
独立管理存储的定义、未来激活偏好和当前运行时。
add
创建一个禁用状态的定义而不启动它；
update
需要一个停止的作业且不重启它；
remove
需要一个停止且禁用的作业。
平台感知控制：
考虑不同的 Linux 和 macOS 行为。Linux 可以启动已禁用的服务；macOS 启动或重启需要先启用，禁用加载的作业需要先停止。
离线跨平台测试：
将绝对物理 --root --platform linux --platform macos 结合使用，以将沙箱文件与实时管理器执行隔离。沙箱检查无法证明实时会话就绪性。
以证据为中心的验证：
更改后，读回定义并在适当时候查询状态。如果变更失败或其回复丢失，在重试之前检查当前定义和原生状态，因为另一次启动或重启可以再次执行目标。

name: loboot description: Safely preview, create, inspect, update, remove, start, stop, enable, disable, and diagnose native user services managed by Loboot on macOS launchd or Linux systemd. Use when a request names Loboot or asks to operate its owned definitions, activation preferences, runtime state, offline plans, or discovery; not for cron scheduling, system/boot services, Windows, or adopting unrelated native services. license: MIT-0