Open source — MIT

Cyclawps The OpenClaw platform engineer

I built a platform engineer because I couldn't be arsed being one. 4 months of operational scars across 11 agents, 91 cron jobs, and 7 Telegram groups — packaged into one command.

$
View on GitHub Read the blog post
Scroll

The problem

Agents can't see
the whole board

OpenClaw agents are bloody good at brute-forcing work. But for the big stuff — upgrades across breaking changes, debugging a 46-job cron cascade, auditing fleet-wide health — they can't see the whole board.

Over 4 months, I kept solving the same operational problems. Upgrade gotchas. Cron failures with shared root causes. Context bloat creeping into agent workspaces. Eventually the knowledge compounded into something reusable — and Cyclawps became a product by accident.


What it does

Three things your agents
can't do alone

These are real operations from a live fleet. Not demos — actual production runs with real numbers.

Use case 01

Upgrades across breaking changes

v2026.3.24 to v2026.4.2. Three intermediate releases, each with infrastructure-specific risks. Cyclawps mapped every release against the live config, identified 3 critical risks before they hit, and orchestrated the whole thing.

17 Tasks
5 Phases
15 Parallel subagents
312 Tool calls
30s Downtime
0 Rollbacks
Use case 02

Cron reliability surgery

46 failing jobs. Cyclawps ran automated probes, categorized failures by type, and found 25 of them sharing a single root cause — skills bypassing message delivery in isolated cron sessions. One fix, single-digit errors after.

46 Failing jobs
25 Shared root cause
107 Jobs audited
Use case 03

Fleet-wide health audits

Context bloat: 117KB stray file in one workspace, 224KB in another. Domain leakage across agent memory files — advisory data showing up in platform agent context. Information staleness affecting decision quality. The kind of drift that doesn't trigger alerts but quietly degrades everything.


Modes

Three modes, one brain

Mode 01

Interactive

Claude Code skill

Type /cyclawps, talk to your platform engineer. Ask anything about your instance.

Mode 02

Plugin

npm package

Install via npm. Get tools, CLI commands, and health checks integrated into your OpenClaw instance.

Mode 03

Agent

autonomous mode

Runs on a heartbeat. Monitors your instance, catches drift, and alerts you when something needs attention.


Inside

What's inside

Everything learned from running an 11-agent production instance across 4 months, packaged as references.

43
Operational gotchas
6
Troubleshooting catalogues
13
Guided workflows
1
Community source index

Provenance

Battle-tested,
not theoretical

Every gotcha was learned the hard way. These are real incidents from a live 11-agent fleet.

01

The 2-Hour Outage

Auto-updater left stale plugin paths. Gateway entered a crash loop. Config validation caught it -- eventually. Now it catches it before deploy.

02

46 Cron Jobs Down at Once

Skills calling the message tool internally fail in isolated cron sessions. Entire automation fleet went offline. One root cause, 46 casualties.

03

All Agents Lost Their Identity

66 symlinks silently failed. Every agent responded as a generic assistant for 2 days before anyone noticed. Identity files must be real files, not symlinks.

04

The Fabricated Numbers

65K chars of tool results pushed real data out of the attention window. Reports showed 0 customers when the actual count was 16. Context window management is not optional.

05

Telegram Ghost Town

Outbound handler failed to register after a cold start. Error caching made it permanent. All channels went silent until a full gateway restart.

30+ incidents documented. 43 gotchas extracted. Zero left to surprise you.


FAQ

Questions

cyCLAWps is a free, open-source portable platform engineer for OpenClaw. It bundles 43 operational gotchas, 6 troubleshooting catalogues, 13 guided workflows, and community sources into one skill that handles config, cron, channels, and debugging.
The docs tell you how things should work. cyCLAWps knows how they actually break. It bundles gotchas learned from 30+ production incidents, pattern-matches against your actual config, and generates fixes specific to your instance.
Yes. cyCLAWps detects fresh installs and runs a guided first-run workflow: gateway verification, first agent setup, channel binding, and a health check to confirm everything works.
cyCLAWps generates config patches and recommendations. It never writes to openclaw.json directly unless you explicitly approve. Every change follows the backup-edit-validate-deploy protocol.
Yes. The interactive mode requires Claude Code, but the plugin and agent modes work standalone. Install the npm package or configure the agent in your openclaw.json.

Clone it, try /cyclawps,
tell me what breaks.

$ openclaw plugins install cyclawps

Free. Open source. MIT licensed. No account, no API key, no sign-up.

Or ask your agent: "Set up cyclawps for me"

View on GitHub Read the blog post