← 返回 Skills 市场

Launchagent Manager

Name: Launchagent Manager
Author: austindixson

作者 austindixson · GitHub ↗ · v1.0.0

cross-platform ✓ 安全检测通过

328

总下载

当前安装

版本数

在 OpenClaw 中安装

/install launchagent-manager

功能描述

List, classify, prune LaunchAgents; analyze openclaw.json so the proper gateway LaunchAgent remains connected and tokens match. Keeps only OpenClaw-related a...

使用说明 (SKILL.md)

Launchagent Manager

Description

List, classify, prune LaunchAgents; analyze openclaw.json so the proper gateway LaunchAgent remains connected and tokens match. Keeps only OpenClaw-related agents; can unload/delete others.

LaunchAgent Manager

Manages LaunchAgents in ~/Library/LaunchAgents and analyzes openclaw.json so the gateway LaunchAgent stays correct: loaded when it should be, and tokens matching config vs running gateway.

List/prune: Classify agents as OpenClaw (keep) or other (prune). OpenClaw = Label or path contains "openclaw".
Config check: Read openclaw.json → gateway port, auth mode, token set; find the gateway plist (e.g. ai.openclaw.gateway); report loaded? running? tokens match? (Uses gateway-guard status when available.) Recommends loading the plist or running gateway-guard ensure --apply if needed.
--fix: With --config, can load the gateway plist if not loaded and run gateway-guard ensure --apply if tokens mismatch.

Usage

Ensure gateway stays connected: Run --config to verify the gateway LaunchAgent is loaded and tokens match; use --config --fix to load plist and sync auth.
List what's running: see OpenClaw vs other agents.
Remove non-OpenClaw LaunchAgents: prune so only OpenClaw daemons remain.

python3 \x3Cskill-dir>/scripts/launchagent_manager.py [--list] [--json]
python3 \x3Cskill-dir>/scripts/launchagent_manager.py --config [--fix] [--json]
python3 \x3Cskill-dir>/scripts/launchagent_manager.py --prune [--dry-run]
python3 \x3Cskill-dir>/scripts/launchagent_manager.py --prune --apply [--delete-plists]

--list (default) — List all LaunchAgents; show OpenClaw (kept) vs others (prune targets). Shows loaded/unloaded.
--config — Analyze openclaw.json and gateway LaunchAgent: config path, gateway port, auth, token set; gateway plist label and loaded?; gateway process running?; tokens match (config vs running)? Recommendations if plist not loaded or tokens mismatch. Exit 0 if all ok, 1 if action needed.
--config --fix — If gateway plist not loaded: run launchctl load \x3Cplist>. If tokens don't match: run gateway-guard ensure --apply --json. Requires gateway-guard skill.
--config --json — Machine-readable report: config_path, gateway, gateway_launchagent, gateway_loaded, tokens_match, gateway_running, recommendations.
--json — For --list: { "openclaw": [...], "others": [...] }.
--prune — Operate on non-OpenClaw agents. Without --apply this is a dry-run (show what would be unloaded).
--prune --dry-run — Only show what would be unloaded.
--prune --apply — Unload each non-OpenClaw LaunchAgent. Plist files kept unless --delete-plists.
--prune --apply --delete-plists — Unload and delete plist files (backed up to OPENCLAW_HOME/backups/launchagents).

Safety

Only user domain is touched: ~/Library/LaunchAgents/. System domain is not modified.
OpenClaw detection is conservative: Label com.openclaw.* or any ProgramArgument containing "openclaw" → kept.
With --delete-plists, backups are written to OPENCLAW_HOME/backups/launchagents/ before deletion.

Requirements

macOS (launchctl, plist in user LaunchAgents).
Python 3 with plistlib (standard library).

安全使用建议

This skill appears coherent with its description, but it can stop and delete your user LaunchAgents. Before using destructive flags: 1) run with --prune --dry-run to see what would be unloaded/deleted; 2) verify OPENCLAW_HOME points where you expect (defaults to ~/.openclaw) so backups go to the right place; 3) ensure openclaw.json is valid and reviewed (it may contain tokens) and that gateway-guard is the intended local script if the tool invokes it; 4) review the list output before running --prune --apply or --prune --apply --delete-plists. If you are unsure, avoid --apply/--delete-plists or keep a manual backup of ~/Library/LaunchAgents first.

功能分析

Type: OpenClaw Skill Name: launchagent-manager Version: 1.0.0 The skill 'launchagent-manager' is designed to manage macOS LaunchAgents, specifically focusing on OpenClaw's gateway agent and pruning other user-level agents. The Python script `scripts/launchagent_manager.py` uses standard macOS `launchctl` commands to list, load, and unload LaunchAgents within the user's `~/Library/LaunchAgents` directory. It reads `openclaw.json` to verify gateway configuration and interacts with the `gateway-guard` skill for status and fixes. All actions, including file deletion (with backups to `OPENCLAW_HOME/backups/launchagents`), are explicitly stated in the documentation (`SKILL.md`, `README.md`) and are directly aligned with the skill's purpose. There is no evidence of unauthorized data exfiltration, malicious execution, persistence outside its stated management role, or prompt injection attempts in the markdown files. The code's behavior is transparent and justified by its functionality.

能力评估

✓ Purpose & Capability

Name/description match the implementation: the script scans ~/Library/LaunchAgents, parses plists, reads openclaw.json and can load/unload plists and invoke a local gateway-guard script. It does not request unrelated credentials, binaries, or system-wide config.

ℹ Instruction Scope

SKILL.md and the script legitimately read openclaw.json (including token presence) and local plist files and call launchctl and an optional local gateway-guard script. This is expected for its purpose, but the tool can be destructive (--prune --apply --delete-plists) and will read token-related fields from openclaw.json; run with --dry-run first and review backups before deletion.

✓ Install Mechanism

No install spec; the skill is instruction/script-only. No remote downloads or archive extraction are present, lowering install risk.

✓ Credentials

The skill requires no credentials or declared env vars. It optionally respects OPENCLAW_HOME (default ~/.openclaw) for config and backups, which is proportional to its function. It does not attempt to exfiltrate data or call external endpoints.

✓ Persistence & Privilege

always:false and user-invocable. The script operates in the user LaunchAgents domain only and writes backups under OPENCLAW_HOME; it does not modify other skills or request permanent elevated presence.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install launchagent-manager
安装完成后，直接呼叫该 Skill 的名称或使用 /launchagent-manager 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release of Launchagent Manager. - Lists, classifies, and prunes LaunchAgents in ~/Library/LaunchAgents, keeping only OpenClaw-related agents. - Analyzes openclaw.json to ensure the correct gateway LaunchAgent is connected and tokens match. - Offers --config and --fix options to verify and correct LaunchAgent status and token sync. - Supports prune operations to safely unload or delete non-OpenClaw agents, with dry run and backup options. - Provides both human-readable and machine-readable (--json) output formats for reporting and automation.

元数据

Slug launchagent-manager

版本 1.0.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题