openclaw-admin

Purpose

This skill handles administration of the OpenClaw gateway, enabling tasks like starting, stopping, restarting, updating the gateway, applying configuration patches, tuning compaction settings, and managing agents within the core-openclaw cluster.

When to Use

Use this skill for gateway maintenance, such as during deployments (e.g., applying updates), troubleshooting (e.g., restarting after errors), or configuration adjustments (e.g., tuning compaction for performance). Apply it in production environments where the core-openclaw cluster is active, or for agent lifecycle management in distributed setups.

Key Capabilities

• Gateway lifecycle: Start, stop, restart, or update using CLI commands like openclaw gateway start --cluster core-openclaw --force.
• Configuration patches: Apply JSON Patch documents, e.g., {"op": "replace", "path": "/settings/compaction", "value": {"interval": 60}}.
• Compaction tuning: Adjust settings via flags, such as openclaw compaction tune --threshold 80 --interval 300 to set memory thresholds and intervals.
• Agent management: Add, remove, or list agents with commands like openclaw agent add --name agent1 --cluster core-openclaw.
• Authentication: Requires $OPENCLAW_API_KEY environment variable for all operations.

Usage Patterns

Always set $OPENCLAW_API_KEY before running commands, e.g., export OPENCLAW_API_KEY=your_api_key. For CLI, prefix with openclaw and specify the --cluster core-openclaw flag. Use API endpoints with HTTP requests, including the Authorization: Bearer $OPENCLAW_API_KEY header. In scripts, wrap calls in error checks, e.g., verify the cluster exists before patching configs. For automation, integrate with tools like cron jobs or CI/CD pipelines by calling CLI from bash scripts.