# Oh My Openclaw > 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. Use when this capability is needed. - Skill: `tomevault-io/oh-my-openclaw` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/oh-my-openclaw` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/oh-my-openclaw/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/oh-my-openclaw --- # 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 ```bash 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: ```bash openclaw omoc-setup # Use --force to overwrite existing, --dry-run to preview ``` ### 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: ```json { "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 1. Prometheus creates a strategic plan via user interview 2. Momus reviews and critiques the plan 3. Atlas breaks plan into executable tasks 4. Workers execute tasks with Todo tracking 5. Atlas verifies completion of each task 6. Loop continues until all tasks are done ### `/plan` - Planning Only 1. Prometheus interviews user about the task 2. Creates a phased plan saved to `workspace/plans/` 3. Momus reviews the plan 4. Returns refined plan for user approval ### `/start_work` - Execute Existing Plan 1. Reads plan from `workspace/plans/` 2. Atlas distributes tasks to appropriate workers 3. Workers execute with Todo tracking 4. 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: 1. After completing a task batch, agent reviews remaining todos 2. If incomplete items exist, agent continues without user intervention 3. Loop terminates only when all todos are complete or explicitly cancelled 4. 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] ``` --- > Source: [happycastle114/oh-my-openclaw](https://github.com/happycastle114/oh-my-openclaw) — distributed by [TomeVault](https://tomevault.io).