claudecode-omc 4.8.2 → 4.8.4

package/.claude-plugin/marketplace.json

@@ -9,14 +9,14 @@
     {
       "name": "oh-my-claudecode",
       "description": "Claude Code native multi-agent orchestration with intelligent model routing, 28 agent variants, and 32 powerful skills. Zero learning curve. Maximum power.",
-      "version": "4.7.1",
+      "version": "4.8.3",
       "author": {
         "name": "Yeachan Heo",
         "email": "hurrc04@gmail.com"
       },
       "source": "./",
       "category": "productivity",
-      "homepage": "https://github.com/Yeachan-Heo/oh-my-claudecode",
+      "homepage": "https://github.com/materialofair/oh-my-claudecode",
       "tags": [
         "multi-agent",
         "orchestration",
@@ -26,5 +26,5 @@
       ]
     }
   ],
-  "version": "4.7.3"
+  "version": "4.8.3"
 }

package/.claude-plugin/plugin.json

@@ -1,12 +1,12 @@
 {
   "name": "oh-my-claudecode",
-  "version": "4.8.2",
+  "version": "4.8.3",
   "description": "Multi-agent orchestration system for Claude Code",
   "author": {
     "name": "oh-my-claudecode contributors"
   },
-  "repository": "https://github.com/Yeachan-Heo/oh-my-claudecode",
-  "homepage": "https://github.com/Yeachan-Heo/oh-my-claudecode",
+  "repository": "https://github.com/materialofair/oh-my-claudecode",
+  "homepage": "https://github.com/materialofair/oh-my-claudecode",
   "license": "MIT",
   "keywords": [
     "claude-code",

package/README.de.md

@@ -191,6 +191,66 @@ Tag-Verhalten:
 - Discord: unterstützt `@here`, `@everyone`, numerische Benutzer-IDs und `role:<id>`
 - `file`-Callbacks ignorieren Tag-Optionen
 
+### OpenClaw-Integration
+
+Leiten Sie Claude Code Session-Ereignisse an ein [OpenClaw](https://openclaw.ai/)-Gateway weiter, um automatisierte Antworten und Workflows über Ihren OpenClaw-Agenten zu ermöglichen.
+
+**Schnelle Einrichtung (empfohlen):**
+
+```bash
+/oh-my-claudecode:configure-notifications
+# → Bei der Abfrage "openclaw" eingeben → "OpenClaw Gateway" wählen
+```
+
+**Manuelle Einrichtung:** Erstellen Sie `~/.claude/omc_config.openclaw.json`:
+
+```json
+{
+  "enabled": true,
+  "gateways": {
+    "my-gateway": {
+      "url": "https://your-gateway.example.com/wake",
+      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
+      "method": "POST",
+      "timeout": 10000
+    }
+  },
+  "hooks": {
+    "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true },
+    "stop":          { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true }
+  }
+}
+```
+
+**Umgebungsvariablen:**
+
+| Variable | Beschreibung |
+|----------|-------------|
+| `OMC_OPENCLAW=1` | OpenClaw aktivieren |
+| `OMC_OPENCLAW_DEBUG=1` | Debug-Protokollierung aktivieren |
+| `OMC_OPENCLAW_CONFIG=/path/to/config.json` | Konfigurationsdatei-Pfad überschreiben |
+
+**Unterstützte Hook-Ereignisse (6 aktive in bridge.ts):**
+
+| Ereignis | Auslöser | Wichtige Template-Variablen |
+|----------|----------|----------------------------|
+| `session-start` | Session beginnt | `{{sessionId}}`, `{{projectName}}`, `{{projectPath}}` |
+| `stop` | Claude-Antwort abgeschlossen | `{{sessionId}}`, `{{projectName}}` |
+| `keyword-detector` | Bei jeder Prompt-Übermittlung | `{{prompt}}`, `{{sessionId}}` |
+| `ask-user-question` | Claude fordert Benutzereingabe an | `{{question}}`, `{{sessionId}}` |
+| `pre-tool-use` | Vor Tool-Aufruf (hohe Frequenz) | `{{toolName}}`, `{{sessionId}}` |
+| `post-tool-use` | Nach Tool-Aufruf (hohe Frequenz) | `{{toolName}}`, `{{sessionId}}` |
+
+**Reply-Channel-Umgebungsvariablen:**
+
+| Variable | Beschreibung |
+|----------|-------------|
+| `OPENCLAW_REPLY_CHANNEL` | Antwortkanal (z.B. `discord`) |
+| `OPENCLAW_REPLY_TARGET` | Kanal-ID |
+| `OPENCLAW_REPLY_THREAD` | Thread-ID |
+
+Siehe `scripts/openclaw-gateway-demo.mjs` für ein Referenz-Gateway, das OpenClaw-Payloads über ClawdBot an Discord weiterleitet.
+
 ---
 
 ## Dokumentation

package/README.es.md

@@ -232,6 +232,66 @@ Comportamiento de etiquetas:
 - Slack: soporta `<@MEMBER_ID>`, `<!channel>`, `<!here>`, `<!everyone>`, `<!subteam^GROUP_ID>`
 - El callback `file` ignora las opciones de etiquetas
 
+### Integración con OpenClaw
+
+Reenvía eventos de sesión de Claude Code a un gateway de [OpenClaw](https://openclaw.ai/) para habilitar respuestas automatizadas y flujos de trabajo a través de tu agente OpenClaw.
+
+**Configuración rápida (recomendado):**
+
+```bash
+/oh-my-claudecode:configure-notifications
+# → Escribe "openclaw" cuando se te solicite → elige "OpenClaw Gateway"
+```
+
+**Configuración manual:** crea `~/.claude/omc_config.openclaw.json`:
+
+```json
+{
+  "enabled": true,
+  "gateways": {
+    "my-gateway": {
+      "url": "https://your-gateway.example.com/wake",
+      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
+      "method": "POST",
+      "timeout": 10000
+    }
+  },
+  "hooks": {
+    "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true },
+    "stop":          { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true }
+  }
+}
+```
+
+**Variables de entorno:**
+
+| Variable | Descripción |
+|----------|-------------|
+| `OMC_OPENCLAW=1` | Habilitar OpenClaw |
+| `OMC_OPENCLAW_DEBUG=1` | Habilitar registro de depuración |
+| `OMC_OPENCLAW_CONFIG=/path/to/config.json` | Ruta alternativa del archivo de configuración |
+
+**Eventos de hook soportados (6 activos en bridge.ts):**
+
+| Evento | Disparador | Variables de plantilla principales |
+|--------|-----------|-----------------------------------|
+| `session-start` | La sesión comienza | `{{sessionId}}`, `{{projectName}}`, `{{projectPath}}` |
+| `stop` | La respuesta de Claude se completa | `{{sessionId}}`, `{{projectName}}` |
+| `keyword-detector` | Cada envío de prompt | `{{prompt}}`, `{{sessionId}}` |
+| `ask-user-question` | Claude solicita entrada del usuario | `{{question}}`, `{{sessionId}}` |
+| `pre-tool-use` | Antes de la invocación de herramienta (alta frecuencia) | `{{toolName}}`, `{{sessionId}}` |
+| `post-tool-use` | Después de la invocación de herramienta (alta frecuencia) | `{{toolName}}`, `{{sessionId}}` |
+
+**Variables de entorno del canal de respuesta:**
+
+| Variable | Descripción |
+|----------|-------------|
+| `OPENCLAW_REPLY_CHANNEL` | Canal de respuesta (ej. `discord`) |
+| `OPENCLAW_REPLY_TARGET` | ID del canal |
+| `OPENCLAW_REPLY_THREAD` | ID del hilo |
+
+Consulta `scripts/openclaw-gateway-demo.mjs` para un gateway de referencia que retransmite payloads de OpenClaw a Discord a través de ClawdBot.
+
 ---
 
 ## Documentación

package/README.fr.md

@@ -191,6 +191,66 @@ Comportement des tags :
 - Discord : supporte `@here`, `@everyone`, les IDs utilisateur numériques et `role:<id>`
 - Les callbacks de type `file` ignorent les options de tags
 
+### Intégration OpenClaw
+
+Transmettez les événements de session Claude Code vers une passerelle [OpenClaw](https://openclaw.ai/) pour activer des réponses automatisées et des workflows via votre agent OpenClaw.
+
+**Configuration rapide (recommandé) :**
+
+```bash
+/oh-my-claudecode:configure-notifications
+# → Tapez "openclaw" quand demandé → choisir "OpenClaw Gateway"
+```
+
+**Configuration manuelle :** créez `~/.claude/omc_config.openclaw.json` :
+
+```json
+{
+  "enabled": true,
+  "gateways": {
+    "my-gateway": {
+      "url": "https://your-gateway.example.com/wake",
+      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
+      "method": "POST",
+      "timeout": 10000
+    }
+  },
+  "hooks": {
+    "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true },
+    "stop":          { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true }
+  }
+}
+```
+
+**Variables d'environnement :**
+
+| Variable | Description |
+|----------|-------------|
+| `OMC_OPENCLAW=1` | Activer OpenClaw |
+| `OMC_OPENCLAW_DEBUG=1` | Activer la journalisation de débogage |
+| `OMC_OPENCLAW_CONFIG=/path/to/config.json` | Chemin alternatif du fichier de configuration |
+
+**Événements hook pris en charge (6 actifs dans bridge.ts) :**
+
+| Événement | Déclencheur | Variables de template principales |
+|-----------|------------|----------------------------------|
+| `session-start` | La session démarre | `{{sessionId}}`, `{{projectName}}`, `{{projectPath}}` |
+| `stop` | La réponse de Claude est terminée | `{{sessionId}}`, `{{projectName}}` |
+| `keyword-detector` | À chaque soumission de prompt | `{{prompt}}`, `{{sessionId}}` |
+| `ask-user-question` | Claude demande une saisie utilisateur | `{{question}}`, `{{sessionId}}` |
+| `pre-tool-use` | Avant l'invocation d'outil (fréquence élevée) | `{{toolName}}`, `{{sessionId}}` |
+| `post-tool-use` | Après l'invocation d'outil (fréquence élevée) | `{{toolName}}`, `{{sessionId}}` |
+
+**Variables d'environnement du canal de réponse :**
+
+| Variable | Description |
+|----------|-------------|
+| `OPENCLAW_REPLY_CHANNEL` | Canal de réponse (ex. `discord`) |
+| `OPENCLAW_REPLY_TARGET` | ID du canal |
+| `OPENCLAW_REPLY_THREAD` | ID du thread |
+
+Voir `scripts/openclaw-gateway-demo.mjs` pour un gateway de référence qui relaie les payloads OpenClaw vers Discord via ClawdBot.
+
 ---
 
 ## Documentation

package/README.it.md

@@ -191,6 +191,66 @@ Comportamento dei tag:
 - Discord: supporta `@here`, `@everyone`, ID utente numerici e `role:<id>`
 - I callback di tipo `file` ignorano le opzioni dei tag
 
+### Integrazione OpenClaw
+
+Inoltra gli eventi di sessione di Claude Code a un gateway [OpenClaw](https://openclaw.ai/) per abilitare risposte automatizzate e workflow tramite il tuo agente OpenClaw.
+
+**Configurazione rapida (consigliato):**
+
+```bash
+/oh-my-claudecode:configure-notifications
+# → Digita "openclaw" quando richiesto → scegli "OpenClaw Gateway"
+```
+
+**Configurazione manuale:** crea `~/.claude/omc_config.openclaw.json`:
+
+```json
+{
+  "enabled": true,
+  "gateways": {
+    "my-gateway": {
+      "url": "https://your-gateway.example.com/wake",
+      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
+      "method": "POST",
+      "timeout": 10000
+    }
+  },
+  "hooks": {
+    "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true },
+    "stop":          { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true }
+  }
+}
+```
+
+**Variabili d'ambiente:**
+
+| Variabile | Descrizione |
+|-----------|-------------|
+| `OMC_OPENCLAW=1` | Abilita OpenClaw |
+| `OMC_OPENCLAW_DEBUG=1` | Abilita il logging di debug |
+| `OMC_OPENCLAW_CONFIG=/path/to/config.json` | Percorso alternativo del file di configurazione |
+
+**Eventi hook supportati (6 attivi in bridge.ts):**
+
+| Evento | Trigger | Variabili template principali |
+|--------|---------|-------------------------------|
+| `session-start` | La sessione inizia | `{{sessionId}}`, `{{projectName}}`, `{{projectPath}}` |
+| `stop` | La risposta di Claude è completata | `{{sessionId}}`, `{{projectName}}` |
+| `keyword-detector` | A ogni invio di prompt | `{{prompt}}`, `{{sessionId}}` |
+| `ask-user-question` | Claude richiede input dall'utente | `{{question}}`, `{{sessionId}}` |
+| `pre-tool-use` | Prima dell'invocazione dello strumento (alta frequenza) | `{{toolName}}`, `{{sessionId}}` |
+| `post-tool-use` | Dopo l'invocazione dello strumento (alta frequenza) | `{{toolName}}`, `{{sessionId}}` |
+
+**Variabili d'ambiente del canale di risposta:**
+
+| Variabile | Descrizione |
+|-----------|-------------|
+| `OPENCLAW_REPLY_CHANNEL` | Canale di risposta (es. `discord`) |
+| `OPENCLAW_REPLY_TARGET` | ID del canale |
+| `OPENCLAW_REPLY_THREAD` | ID del thread |
+
+Vedi `scripts/openclaw-gateway-demo.mjs` per un gateway di riferimento che inoltra i payload OpenClaw a Discord tramite ClawdBot.
+
 ---
 
 ## Documentazione

package/README.ja.md

@@ -232,6 +232,66 @@ omc config-stop-callback discord --clear-tags
 - Slack: `<@MEMBER_ID>`、`<!channel>`、`<!here>`、`<!everyone>`、`<!subteam^GROUP_ID>` をサポート
 - `file` コールバックはタグオプションを無視
 
+### OpenClaw 連携
+
+Claude Code セッションイベントを [OpenClaw](https://openclaw.ai/) ゲートウェイに転送し、OpenClaw エージェントを通じた自動応答とワークフローを実現します。
+
+**クイックセットアップ（推奨）:**
+
+```bash
+/oh-my-claudecode:configure-notifications
+# → プロンプトで "openclaw" と入力 → "OpenClaw Gateway" を選択
+```
+
+**手動セットアップ:** `~/.claude/omc_config.openclaw.json` を作成します：
+
+```json
+{
+  "enabled": true,
+  "gateways": {
+    "my-gateway": {
+      "url": "https://your-gateway.example.com/wake",
+      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
+      "method": "POST",
+      "timeout": 10000
+    }
+  },
+  "hooks": {
+    "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true },
+    "stop":          { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true }
+  }
+}
+```
+
+**環境変数:**
+
+| 変数 | 説明 |
+|------|------|
+| `OMC_OPENCLAW=1` | OpenClaw を有効化 |
+| `OMC_OPENCLAW_DEBUG=1` | デバッグログを有効化 |
+| `OMC_OPENCLAW_CONFIG=/path/to/config.json` | 設定ファイルパスを変更 |
+
+**サポートされるフックイベント（bridge.ts で 6 つがアクティブ）:**
+
+| イベント | トリガー | 主要テンプレート変数 |
+|---------|---------|-------------------|
+| `session-start` | セッション開始時 | `{{sessionId}}`, `{{projectName}}`, `{{projectPath}}` |
+| `stop` | Claude のレスポンス完了時 | `{{sessionId}}`, `{{projectName}}` |
+| `keyword-detector` | プロンプト送信ごと | `{{prompt}}`, `{{sessionId}}` |
+| `ask-user-question` | Claude がユーザー入力を要求した時 | `{{question}}`, `{{sessionId}}` |
+| `pre-tool-use` | ツール呼び出し前（高頻度） | `{{toolName}}`, `{{sessionId}}` |
+| `post-tool-use` | ツール呼び出し後（高頻度） | `{{toolName}}`, `{{sessionId}}` |
+
+**Reply Channel 環境変数:**
+
+| 変数 | 説明 |
+|------|------|
+| `OPENCLAW_REPLY_CHANNEL` | 応答チャンネル（例: `discord`） |
+| `OPENCLAW_REPLY_TARGET` | チャンネル ID |
+| `OPENCLAW_REPLY_THREAD` | スレッド ID |
+
+OpenClaw ペイロードを ClawdBot 経由で Discord にリレーするリファレンスゲートウェイについては `scripts/openclaw-gateway-demo.mjs` を参照してください。
+
 ---
 
 ## ドキュメント

package/README.ko.md

@@ -237,6 +237,66 @@ omc config-stop-callback discord --clear-tags
 - Slack: `<@MEMBER_ID>`, `<!channel>`, `<!here>`, `<!everyone>`, `<!subteam^GROUP_ID>` 지원
 - `file` 콜백은 태그 옵션을 무시합니다
 
+### OpenClaw 연동
+
+Claude Code 세션 이벤트를 [OpenClaw](https://openclaw.ai/) 게이트웨이로 전달하여 OpenClaw 에이전트를 통한 자동화된 응답 및 워크플로우를 구성할 수 있습니다.
+
+**빠른 설정 (권장):**
+
+```bash
+/oh-my-claudecode:configure-notifications
+# → 프롬프트에서 "openclaw" 입력 → "OpenClaw Gateway" 선택
+```
+
+**수동 설정:** `~/.claude/omc_config.openclaw.json` 파일을 생성합니다:
+
+```json
+{
+  "enabled": true,
+  "gateways": {
+    "my-gateway": {
+      "url": "https://your-gateway.example.com/wake",
+      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
+      "method": "POST",
+      "timeout": 10000
+    }
+  },
+  "hooks": {
+    "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true },
+    "stop":          { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true }
+  }
+}
+```
+
+**환경 변수:**
+
+| 변수 | 설명 |
+|------|------|
+| `OMC_OPENCLAW=1` | OpenClaw 활성화 |
+| `OMC_OPENCLAW_DEBUG=1` | 디버그 로그 활성화 |
+| `OMC_OPENCLAW_CONFIG=/path/to/config.json` | 설정 파일 경로 변경 |
+
+**지원되는 훅 이벤트 (bridge.ts에서 6개 활성):**
+
+| 이벤트 | 트리거 시점 | 주요 템플릿 변수 |
+|--------|------------|-----------------|
+| `session-start` | 세션 시작 시 | `{{sessionId}}`, `{{projectName}}`, `{{projectPath}}` |
+| `stop` | Claude 응답 완료 시 | `{{sessionId}}`, `{{projectName}}` |
+| `keyword-detector` | 프롬프트 제출마다 | `{{prompt}}`, `{{sessionId}}` |
+| `ask-user-question` | Claude가 사용자 입력 요청 시 | `{{question}}`, `{{sessionId}}` |
+| `pre-tool-use` | 툴 호출 전 (빈도 높음) | `{{toolName}}`, `{{sessionId}}` |
+| `post-tool-use` | 툴 호출 후 (빈도 높음) | `{{toolName}}`, `{{sessionId}}` |
+
+**Reply Channel 환경 변수:**
+
+| 변수 | 설명 |
+|------|------|
+| `OPENCLAW_REPLY_CHANNEL` | 응답 채널 (예: `discord`) |
+| `OPENCLAW_REPLY_TARGET` | 채널 ID |
+| `OPENCLAW_REPLY_THREAD` | 스레드 ID |
+
+OpenClaw 페이로드를 ClawdBot을 통해 Discord에 전달하는 레퍼런스 게이트웨이는 `scripts/openclaw-gateway-demo.mjs`를 참고하세요.
+
 ---
 
 ## 문서

package/README.md

@@ -35,8 +35,8 @@ npm install -g claudecode-omc
 **Step 2: Setup**
 
 ```bash
-omc install
-omc setup
+/setup
+/omc-setup
 ```
 
 **Step 3: Build something**
@@ -127,7 +127,7 @@ omc team shutdown auth-review
 
 `/omc-teams` remains as a legacy compatibility skill and now routes to `omc team ...`.
 
-For mixed Codex + Gemini work in one command, use the **`/ccg`** skill (routes via `ask-codex` + `ask-gemini`, then Claude synthesizes):
+For mixed Codex + Gemini work in one command, use the **`/ccg`** skill (routes via `/ask codex` + `/ask gemini`, then Claude synthesizes):
 
 ```bash
 /ccg Review this PR — architecture (Codex) and UI components (Gemini)
@@ -138,14 +138,24 @@ For mixed Codex + Gemini work in one command, use the **`/ccg`** skill (routes v
 | `omc team N:codex "..."`  | N Codex CLI panes  | Code review, security analysis, architecture |
 | `omc team N:gemini "..."` | N Gemini CLI panes | UI/UX design, docs, large-context tasks      |
 | `omc team N:claude "..."` | N Claude CLI panes | General tasks via Claude CLI in tmux         |
-| `/ccg`                    | ask-codex + ask-gemini | Tri-model advisor synthesis             |
+| `/ccg`                    | /ask codex + /ask gemini | Tri-model advisor synthesis           |
 
 Workers spawn on-demand and die when their task completes — no idle resource usage. Requires `codex` / `gemini` CLIs installed and an active tmux session.
 
-> **Note: Package naming** — The project is branded as **oh-my-claudecode** (repo, plugin, commands), and the npm package is published as [`claudecode-omc`](https://www.npmjs.com/package/claudecode-omc). If you install the CLI tools via npm/bun, use `npm install -g claudecode-omc`.
+> **Note: Package naming** — The project is branded as **oh-my-claudecode** (repo, plugin, commands), and the npm package is published as [`claudecode-omc`](https://www.npmjs.com/package/claudecode-omc). If you install or upgrade the CLI tools via npm/bun, use `npm i -g claudecode-omc@latest`.
 
 ### Updating
 
+If you installed OMC via npm, upgrade with the published package name:
+
+```bash
+npm i -g claudecode-omc@latest
+```
+
+> **Package naming note:** the repo, plugin, and commands are branded **oh-my-claudecode**, but the published npm package name is `claudecode-omc`.
+
+If you installed OMC via the Claude Code marketplace/plugin flow, update with:
+
 ```bash
 # 1. Update the marketplace clone
 /plugin marketplace update omc
@@ -193,7 +203,7 @@ Multiple strategies for different use cases — from Team-backed orchestration t
 | ----------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------ |
 | **Team (recommended)**  | Canonical staged pipeline (`team-plan → team-prd → team-exec → team-verify → team-fix`) | Coordinated Claude agents on a shared task list        |
 | **omc team (CLI)**      | tmux CLI workers — real `claude`/`codex`/`gemini` processes in split-panes              | Codex/Gemini CLI tasks; on-demand spawn, die when done |
-| **ccg**                 | Tri-model advisors via ask-codex + ask-gemini, Claude synthesizes                         | Mixed backend+UI work needing both Codex and Gemini    |
+| **ccg**                 | Tri-model advisors via `/ask codex` + `/ask gemini`, Claude synthesizes                   | Mixed backend+UI work needing both Codex and Gemini    |
 | **Autopilot**           | Autonomous execution (single lead agent)                                                | End-to-end feature work with minimal ceremony          |
 | **Ultrawork**           | Maximum parallelism (non-team)                                                          | Burst parallel fixes/refactors where Team isn't needed |
 | **Ralph**               | Persistent mode with verify/fix loops                                                   | Tasks that must complete fully (no silent partials)    |
@@ -208,7 +218,7 @@ Multiple strategies for different use cases — from Team-backed orchestration t
 
 ### Developer Experience
 
-- **Magic keywords** - `ralph`, `ulw`, `team` for explicit control
+- **Magic keywords** - `ralph`, `ulw`, `ralplan`; Team stays explicit via `/team`
 - **HUD statusline** - Real-time orchestration metrics in your status bar
 - **Skill learning** - Extract reusable patterns from your sessions
 - **Analytics & cost tracking** - Understand token usage across all sessions
@@ -219,13 +229,13 @@ Multiple strategies for different use cases — from Team-backed orchestration t
 
 ## Magic Keywords
 
-Optional shortcuts for power users. Natural language works fine without them.
+Optional shortcuts for power users. Natural language works fine without them. Team mode is explicit: use `/team ...` or `omc team ...` rather than a keyword trigger.
 
 | Keyword                | Effect                                 | Example                                        |
 | ---------------------- | -------------------------------------- | ---------------------------------------------- |
 | `team`                 | Canonical Team orchestration           | `/team 3:executor "fix all TypeScript errors"` |
 | `omc team`             | tmux CLI workers (codex/gemini/claude) | `omc team 2:codex "security review"`           |
-| `ccg`                  | ask-codex + ask-gemini synthesis       | `/ccg review this PR`                          |
+| `ccg`                  | `/ask codex` + `/ask gemini` synthesis | `/ccg review this PR`                          |
 | `autopilot`            | Full autonomous execution              | `autopilot: build a todo app`                  |
 | `ralph`                | Persistence mode                       | `ralph: refactor auth`                         |
 | `ulw`                  | Maximum parallelism                    | `ulw fix all errors`                           |
@@ -277,14 +287,14 @@ omc hud
 
 **Requires:** tmux (for session detection)
 
-### Monitoring & Analytics
+### Monitoring & Observability
 
-Use the HUD for live observability and `omc` for cost/session reporting:
+Use the HUD for live observability and the current session/replay artifacts for post-session inspection:
 
-- HUD analytics preset: `/oh-my-claudecode:hud setup` then set `"omcHud": { "preset": "analytics" }`
-- Cost reports: `omc cost daily|weekly|monthly`
-- Session history/backfill: `omc sessions`, `omc backfill`
-- Raw logs: `.omc/state/token-tracking.jsonl`, `.omc/state/agent-replay-*.jsonl`
+- HUD preset: `/oh-my-claudecode:hud setup` then use a supported preset such as `"omcHud": { "preset": "focused" }`
+- Session summaries: `.omc/sessions/*.json`
+- Replay logs: `.omc/state/agent-replay-*.jsonl`
+- Live HUD rendering: `omc hud`
 
 ### Notification Tags (Telegram/Discord/Slack)
 
@@ -309,6 +319,66 @@ Tag behavior:
 - Slack: supports `<@MEMBER_ID>`, `<!channel>`, `<!here>`, `<!everyone>`, `<!subteam^GROUP_ID>`
 - `file` callbacks ignore tag options
 
+### OpenClaw Integration
+
+Forward Claude Code session events to an [OpenClaw](https://openclaw.ai/) gateway to enable automated responses and workflows via your OpenClaw agent.
+
+**Quick setup (recommended):**
+
+```bash
+/oh-my-claudecode:configure-notifications
+# → When prompted, type "openclaw" → choose "OpenClaw Gateway"
+```
+
+**Manual setup:** create `~/.claude/omc_config.openclaw.json`:
+
+```json
+{
+  "enabled": true,
+  "gateways": {
+    "my-gateway": {
+      "url": "https://your-gateway.example.com/wake",
+      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
+      "method": "POST",
+      "timeout": 10000
+    }
+  },
+  "hooks": {
+    "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true },
+    "stop":          { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true }
+  }
+}
+```
+
+**Environment variables:**
+
+| Variable | Description |
+|----------|-------------|
+| `OMC_OPENCLAW=1` | Enable OpenClaw |
+| `OMC_OPENCLAW_DEBUG=1` | Enable debug logging |
+| `OMC_OPENCLAW_CONFIG=/path/to/config.json` | Override config file path |
+
+**Supported hook events (6 active in bridge.ts):**
+
+| Event | Trigger | Key template variables |
+|-------|---------|----------------------|
+| `session-start` | Session begins | `{{sessionId}}`, `{{projectName}}`, `{{projectPath}}` |
+| `stop` | Claude response completes | `{{sessionId}}`, `{{projectName}}` |
+| `keyword-detector` | Every prompt submission | `{{prompt}}`, `{{sessionId}}` |
+| `ask-user-question` | Claude requests user input | `{{question}}`, `{{sessionId}}` |
+| `pre-tool-use` | Before tool invocation (high frequency) | `{{toolName}}`, `{{sessionId}}` |
+| `post-tool-use` | After tool invocation (high frequency) | `{{toolName}}`, `{{sessionId}}` |
+
+**Reply channel environment variables:**
+
+| Variable | Description |
+|----------|-------------|
+| `OPENCLAW_REPLY_CHANNEL` | Reply channel (e.g. `discord`) |
+| `OPENCLAW_REPLY_TARGET` | Channel ID |
+| `OPENCLAW_REPLY_THREAD` | Thread ID |
+
+See `scripts/openclaw-gateway-demo.mjs` for a reference gateway that relays OpenClaw payloads to Discord via ClawdBot.
+
 ---
 
 ## Testing
@@ -381,7 +451,22 @@ See [Testing Documentation](docs/testing/README.md) for details.
 - [Claude Code](https://docs.anthropic.com/claude-code) CLI
 - Claude Max/Pro subscription or Anthropic API key
 
-Optional multi-AI orchestration:
+### Platform & tmux
+
+OMC features like `omc team` and rate-limit detection require **tmux**:
+
+| Platform       | tmux provider                                            | Install                |
+| -------------- | -------------------------------------------------------- | ---------------------- |
+| macOS          | [tmux](https://github.com/tmux/tmux)                    | `brew install tmux`    |
+| Ubuntu/Debian  | tmux                                                     | `sudo apt install tmux`|
+| Fedora         | tmux                                                     | `sudo dnf install tmux`|
+| Arch           | tmux                                                     | `sudo pacman -S tmux`  |
+| Windows        | [psmux](https://github.com/marlocarlo/psmux) (native)   | `winget install psmux` |
+| Windows (WSL2) | tmux (inside WSL)                                        | `sudo apt install tmux`|
+
+> **Windows users:** [psmux](https://github.com/marlocarlo/psmux) provides a native `tmux` binary for Windows with 76 tmux-compatible commands. No WSL required.
+
+### Optional: Multi-AI Orchestration
 
 - [Gemini CLI](https://github.com/google-gemini/gemini-cli)
 - [Codex CLI](https://github.com/openai/codex)