| name | oh-my-openclaw |
| description | Agent orchestration framework for OpenClaw - ports oh-my-opencode patterns (Prometheus planner, Atlas orchestrator, Sisyphus executor) into OpenClaw-native constructs with category-based model routing, wisdom accumulation, and automated task completion loops. |
Oh-My-OpenClaw (OmOC)
Agent orchestration skill that brings structured planning, execution, and knowledge accumulation to OpenClaw.
Overview
Oh-My-OpenClaw ports the proven patterns from oh-my-opencode into OpenClaw-native constructs:
- 3-Layer Agent Architecture: Planning (Prometheus/Metis/Momus) -> Orchestration (Atlas) -> Execution (Sisyphus-Junior/Hephaestus/Oracle/Explore/Librarian)
- Native Multi-Agent: Uses OpenClaw
sessions_spawn for real sub-agent sessions (not just role-switching)
- Category System: Intent-based model routing (quick/deep/ultrabrain/visual-engineering)
- Wisdom Accumulation: File-based notepad system for persistent learnings across sessions
- Ultrawork Mode: One-command full automation from planning to verified completion
- Todo Enforcer: System prompt injection ensuring forced task completion
- Tool Restriction: Native OpenClaw
agents.list[].tools.profile/allow/deny for per-agent access control
Installation
openclaw plugins install @happycastle/oh-my-openclaw
Skills, hooks, and tools are registered automatically. Run openclaw omoc-setup to inject agent configs.
Agent Tool Restrictions
Inject agent configs into your OpenClaw config for sub-agent spawning:
openclaw omoc-setup
Verify Installation
The skill should appear in OpenClaw's available skills list. Test by asking:
"Read the oh-my-openclaw skill and tell me what it does"
Trigger
This skill activates when:
- User invokes
/ultrawork, /plan, or /start_work commands
- User requests complex multi-step task planning
- User asks for agent orchestration or delegation
Architecture
Layer 1: Planning
| Agent | Role | Model Category |
|---|
| Prometheus | Strategic planner - interviews user, creates phased plans | ultrabrain |
| Metis | Gap analyzer - identifies missing context before execution | deep |
| Momus | Plan reviewer - critiques and improves plans | deep |
Layer 2: Orchestration
| Agent | Role | Model Category |
|---|
| Atlas | Task distributor - breaks plan into delegatable units, verifies completion | ultrabrain |
Layer 3: Workers
| Agent | Role | Model Category |
|---|
| Sisyphus-Junior | Primary coder - implements features, fixes bugs | quick |
| Hephaestus | Deep worker - complex refactoring, architecture changes | deep |
| Oracle | Architect/debugger - design decisions, root cause analysis | ultrabrain |
| Explore | Search specialist - codebase exploration, pattern finding | quick |
| Librarian | Documentation specialist - docs, research, knowledge retrieval | quick |
| Multimodal Looker | Visual analyst - screenshots, UI review, PDF quality check | visual-engineering |
Category-to-Model Mapping
Categories map user intent to optimal model selection:
{
"quick": "claude-sonnet-4-6",
"deep": "claude-opus-4-6-thinking",
"ultrabrain": "gpt-5.3-codex",
"visual-engineering": "claude-opus-4-6-thinking"
}
Workflows
/ultrawork - Full Automation Loop
- Prometheus creates a strategic plan via user interview
- Momus reviews and critiques the plan
- Atlas breaks plan into executable tasks
- Workers execute tasks with Todo tracking
- Atlas verifies completion of each task
- Loop continues until all tasks are done
/plan - Planning Only
- Prometheus interviews user about the task
- Creates a phased plan saved to
workspace/plans/
- Momus reviews the plan
- Returns refined plan for user approval
/start_work - Execute Existing Plan
- Reads plan from
workspace/plans/
- Atlas distributes tasks to appropriate workers
- Workers execute with Todo tracking
- Verification loop until completion
tmux/OmO Delegation (Skills)
Coding delegation and multi-session orchestration are handled by dedicated skills (loaded automatically):
| Skill | Purpose |
|---|
opencode-controller | Delegate to OpenCode/OmO via tmux (session mgmt, agent switching, task templates) |
tmux | Multi-session tmux orchestration (parallel coding + verification) |
tmux-agents | Spawn/monitor coding agents (Claude, Codex, Gemini, Ollama) in tmux |
workflow-tool-patterns | OmO tool → OpenClaw tool mapping reference |
workflow-auto-rescue | Checkpoint-based failure recovery |
Wisdom Accumulation
The notepad system persists learnings across sessions:
workspace/notepads/
learnings.md - Technical discoveries and patterns
decisions.md - Architecture and design decisions made
issues.md - Known issues and workarounds
preferences.md - User preferences and conventions
How It Works
- Workers automatically append discoveries to relevant notepads
- Planning agents read notepads before creating plans
- Notepads survive across sessions (file-based persistence)
- Each entry is timestamped and tagged with source context
Todo Enforcer
System prompt injection that ensures task completion:
[SYSTEM DIRECTIVE: OH-MY-OPENCLAW - TODO CONTINUATION]
You MUST continue working on incomplete todos.
- Do NOT stop until all tasks are marked complete
- Do NOT ask for permission to continue
- Mark each task complete immediately when finished
- If blocked, document the blocker and move to next task
Ralph Loop
Self-referential completion mechanism:
- After completing a task batch, agent reviews remaining todos
- If incomplete items exist, agent continues without user intervention
- Loop terminates only when all todos are complete or explicitly cancelled
- Maximum iterations configurable (default: 10)
Built-in Skills
Skills inject specialized knowledge and workflows into agents. Load them via load_skills when delegating tasks.
| Skill | Trigger Keywords | Description |
|---|
| git-master | commit, rebase, squash, blame | Atomic commits, rebase surgery, history archaeology. Auto-detects commit style. |
| frontend-ui-ux | UI, UX, frontend, design, CSS | Designer-turned-developer. Bold aesthetics, distinctive typography, cohesive palettes. |
| comment-checker | comment check, AI slop, code quality | Anti-AI-slop guard. Removes obvious comments, keeps WHY comments. |
| gemini-look-at | look at, PDF, screenshot, diagram, visual | Gemini CLI-based multimodal analysis. Native PDF/image/video analysis via tmux gemini session. |
| web-search | web search, exa, context7, grep.app | OmO web search pattern integration. Exa/Context7/grep.app MCP + web_fetch + web-search-prime. |
Category + Skill Combos
| Combo | Category | Skills | Effect |
|---|
| The Designer | visual-engineering | frontend-ui-ux | Implements aesthetic UI with design-first approach |
| The Maintainer | quick | git-master | Quick fixes with clean atomic commits |
| The Reviewer | deep | comment-checker | Deep code review with AI slop detection |
| The Looker | visual-engineering | gemini-look-at | Gemini CLI for native multimodal analysis of PDF/image/diagram |
| The Researcher | quick | web-search | Web search + code search + documentation search via Exa/Context7/grep.app |
File Structure
oh-my-openclaw/
SKILL.md # This file - main skill instructions
README.md # Project documentation
LICENSE # MIT license
CHANGELOG.md # Version history
config/
categories.json # Category-to-model mapping + tool restrictions + skill triggers
docs/ # Documentation files
plugin/
agents/
prometheus.md # Strategic planner agent profile
metis.md # Pre-planning consultant (intent classification + anti-slop directives)
momus.md # Practical plan reviewer (critical blocker checks)
atlas.md # Task orchestrator agent profile
sisyphus-junior.md # Primary worker agent profile
hephaestus.md # Autonomous deep worker for complex execution
oracle.md # Architect/debugger agent profile
librarian.md # Documentation specialist agent profile
explore.md # Search specialist agent profile
multimodal-looker.md # Visual analysis agent profile
skills/
git-master.md # Git expert skill (commits, rebase, history)
frontend-ui-ux.md # Design-first UI development skill
comment-checker.md # Anti-AI-slop code quality skill
gemini-look-at.md # Gemini CLI multimodal analysis (PDF/image/video)
web-search.md # Web search integration (Exa/Context7/grep.app MCP)
opencode-controller.md # OpenCode/OmO delegation patterns
tmux.md # tmux session orchestration patterns
tmux-agents.md # Agent spawning/monitoring in tmux
workflow-tool-patterns.md # OmO→OpenClaw tool mapping
workflow-auto-rescue.md # Checkpoint-based recovery
workflows/
ultrawork.md # Full automation workflow
plan.md # Planning-only workflow
start-work.md # Execute existing plan workflow
src/ # TypeScript plugin source
dist/ # Compiled plugin
Usage Examples
Quick Task
User: Fix the type error in auth.ts
Agent: [Uses Sisyphus-Junior directly - category: quick]
Complex Feature
User: /ultrawork Add user authentication with OAuth2
Agent: [Prometheus plans -> Momus reviews -> Atlas distributes -> Workers execute]
Research Task
User: /plan Research the best approach for real-time notifications
Agent: [Prometheus + Librarian + Oracle collaborate on research plan]
