| name | launchagent-manager |
| displayName | 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. |
| version | 1.0.0 |
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 <skill-dir>/scripts/launchagent_manager.py [--list] [--json]
python3 <skill-dir>/scripts/launchagent_manager.py --config [--fix] [--json]
python3 <skill-dir>/scripts/launchagent_manager.py --prune [--dry-run]
python3 <skill-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 <plist>. 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).
