Oh My OpenClaw - Advanced Agents

Standalone OpenClaw plugin that adds specialized agent modes and deep local research commands.

Attribution

Original invention and core inspiration for the Sisyphus-style orchestration patterns comes from YeonGyu Kim (@code-yeongyu), author of oh-my-opencode.

This repository is an independent adaptation for OpenClaw workflows.

Packed Agents

• Planner - task decomposition and execution planning
• Oracle - architecture and technical reasoning
• Librarian - documentation and implementation research
• Explore - codebase mapping and pattern discovery
• Hephaestus - autonomous deep implementation and verification
• Prometheus - strategic planning and acceptance criteria design
• Sisyphus - iterative execution with completion discipline
• Atlas - architecture mapping and dependency cartography

Commands

Agent Modes

• /research <topic> - model-driven iterative local research using your configured openclaw.json model
• /oracle <question> - oracle mode scaffold
• /librarian <question> - librarian mode scaffold
• /explore <question> - explore mode scaffold
• /hephaestus <goal> - deep execution mode
• /prometheus <goal> - strategic planning mode
• /sisyphus <goal> - iterative completion mode
• /atlas <goal> - architecture mapping mode
• /steer <prompt> - detect steering words and recommend the best mode

Auto-Rescue (Session Recovery)

Automatic session recovery and checkpoint management for long-running tasks:

• CLI Commands:

  • openclaw rescue status - Show auto-rescue status
  • openclaw rescue trigger <session-key> - Manually trigger recovery
  • openclaw rescue list - List all rescue records

• Agent Tool:

  • rescue.enable() - Enable monitoring for current session
  • rescue.checkpoint("task description") - Create manual checkpoint
  • rescue.status() - Check monitoring status

Auto-rescue monitors sessions, persists checkpoints every 30s, detects failures, and automatically recovers with preserved context. Escalates after 3 failed attempts.

Steering Words

The plugin now recognizes upstream-style steering keywords plus expanded thesaurus variants.

• Ultrawork family: ultrawork, ulw, ultrathink, deep think, maximum effort, full throttle
• Search family: search, find, locate, lookup, scan, trace, hunt, comb, scour, sift, trawl, where is, show me, list all
• Analyze family: analyze, analyse, investigate, examine, research, audit, evaluate, assess, dissect, deconstruct, appraise, parse, think through, sort out, why is, how does
• Multi-language support includes Korean, Japanese, Chinese, and Vietnamese search/analyze terms from upstream oh-my-opencode patterns.

Install (Safe - Recommended)

The safe installer handles everything automatically with rollback protection:

# Clone the repository
git clone https://github.com/avirweb/oh-my-openclaw.git ~/oh-my-openclaw

# Run the safe installer
bash ~/oh-my-openclaw/scripts/install-safe.sh

What the safe installer does:

1. ✅ Checks prerequisites (openclaw, git, jq)
2. ✅ Backs up your existing ~/.openclaw/openclaw.json
3. ✅ Installs the extension to ~/.openclaw/extensions/oh-my-openclaw/
4. ✅ Updates openclaw.json with plugin configuration
5. ✅ Stops and restarts the OpenClaw gateway
6. ✅ Validates the installation (retries up to 3 times)
7. ✅ Runs post-install tests

Auto-Recovery: If any step fails, the installer automatically:

• Restores your previous openclaw.json configuration
• Rolls back any partial changes
• Reports what went wrong

Non-interactive mode:

bash ~/oh-my-openclaw/scripts/install-safe.sh --yes

Manual Install (Fallback)

openclaw plugins install --link ~/oh-my-openclaw
openclaw plugins enable advanced-agents
openclaw plugins doctor

Versioning

• Semantic version is stored in package.json
• Release notes live in CHANGELOG.md
• Version bump helpers:

npm run version:patch
npm run version:minor
npm run version:major
npm run release:version -- patch

After bumping, update CHANGELOG.md in the same commit.

License

MIT. See LICENSE.