@jstn-sdk/rcs 0.1.0

package/docs/openclaw-integration.fr.md

@@ -0,0 +1,44 @@
+# Guide d’intégration OpenClaw (réglage localisé des prompts)
+
+> [← Back to Docs Home](./index.html) · [Integrations Landing](./integrations.html)
+
+**Language Switcher:** [English](./openclaw-integration.md) | [한국어](./openclaw-integration.ko.md) | [日本語](./openclaw-integration.ja.md) | [简体中文](./openclaw-integration.zh.md) | [繁體中文](./openclaw-integration.zh-TW.md) | [Tiếng Việt](./openclaw-integration.vi.md) | [Español](./openclaw-integration.es.md) | [Português](./openclaw-integration.pt.md) | [Русский](./openclaw-integration.ru.md) | [Türkçe](./openclaw-integration.tr.md) | [Deutsch](./openclaw-integration.de.md) | [Français](./openclaw-integration.fr.md) | [Italiano](./openclaw-integration.it.md) | [Українська](./openclaw-integration.uk.md)
+
+
+Cette page localise la section **« Prompt tuning guide (concise + context-aware) »** de la documentation principale en anglais.
+
+Pour la documentation complète d’intégration (gateways, hooks, vérification), voir le [English guide](./openclaw-integration.md).
+
+## Réglage des prompts (concis et contextuel)
+
+## Où modifier les modèles de prompt
+
+- `notifications.openclaw.hooks["session-start"].instruction`
+- `notifications.openclaw.hooks["session-idle"].instruction`
+- `notifications.openclaw.hooks["ask-user-question"].instruction`
+- `notifications.openclaw.hooks["stop"].instruction`
+- `notifications.openclaw.hooks["session-end"].instruction`
+
+## Tokens de contexte recommandés
+
+- Toujours : `{{sessionId}}`, `{{tmuxSession}}`
+- Selon l’événement : `{{projectName}}`, `{{question}}`, `{{reason}}`
+
+## Stratégie de verbosité
+
+- `minimal` : signaux très courts
+- `session` : contexte opérationnel concis (recommandé)
+- `verbose` : plus de contexte état/action/risque
+
+## Commande de mise à jour rapide (jq)
+
+```bash
+CONFIG_FILE="$HOME/.codex/.rcs-config.json"
+
+jq '.notifications.verbosity = "verbose" |
+    .notifications.openclaw.hooks["session-start"].instruction = "[session-start|exec]\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}}\n요약: 시작 맥락 1문장\n우선순위: 지금 할 일 1~2개\n주의사항: 리스크/의존성(없으면 없음)" |
+    .notifications.openclaw.hooks["session-idle"].instruction = "[session-idle|exec]\nsession={{sessionId}} tmux={{tmuxSession}}\n요약: idle 원인 1문장\n복구계획: 즉시 조치 1~2개\n의사결정: 사용자 입력 필요 여부" |
+    .notifications.openclaw.hooks["ask-user-question"].instruction = "[ask-user-question|exec]\nsession={{sessionId}} tmux={{tmuxSession}} question={{question}}\n핵심질문: 필요한 답변 1문장\n영향: 미응답 시 영향 1문장\n권장응답: 가장 빠른 답변 형태" |
+    .notifications.openclaw.hooks["stop"].instruction = "[session-stop|exec]\nsession={{sessionId}} tmux={{tmuxSession}}\n요약: 중단 사유\n현재상태: 저장/미완료 항목\n재개: 첫 액션 1개" |
+    .notifications.openclaw.hooks["session-end"].instruction = "[session-end|exec]\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}} reason={{reason}}\n성과: 완료 결과 1~2문장\n검증: 확인/테스트 결과\n다음: 후속 액션 1~2개"'   "$CONFIG_FILE" > "$CONFIG_FILE.tmp" && mv "$CONFIG_FILE.tmp" "$CONFIG_FILE"
+```

package/docs/openclaw-integration.it.md

@@ -0,0 +1,44 @@
+# Guida all’integrazione OpenClaw (tuning prompt localizzato)
+
+> [← Back to Docs Home](./index.html) · [Integrations Landing](./integrations.html)
+
+**Language Switcher:** [English](./openclaw-integration.md) | [한국어](./openclaw-integration.ko.md) | [日本語](./openclaw-integration.ja.md) | [简体中文](./openclaw-integration.zh.md) | [繁體中文](./openclaw-integration.zh-TW.md) | [Tiếng Việt](./openclaw-integration.vi.md) | [Español](./openclaw-integration.es.md) | [Português](./openclaw-integration.pt.md) | [Русский](./openclaw-integration.ru.md) | [Türkçe](./openclaw-integration.tr.md) | [Deutsch](./openclaw-integration.de.md) | [Français](./openclaw-integration.fr.md) | [Italiano](./openclaw-integration.it.md) | [Українська](./openclaw-integration.uk.md)
+
+
+Questa pagina localizza la sezione **“Prompt tuning guide (concise + context-aware)”** della documentazione principale in inglese.
+
+Per la guida completa di integrazione (gateway, hook, verifica), vedi [English guide](./openclaw-integration.md).
+
+## Tuning prompt (conciso e context-aware)
+
+## Dove modificare i template dei prompt
+
+- `notifications.openclaw.hooks["session-start"].instruction`
+- `notifications.openclaw.hooks["session-idle"].instruction`
+- `notifications.openclaw.hooks["ask-user-question"].instruction`
+- `notifications.openclaw.hooks["stop"].instruction`
+- `notifications.openclaw.hooks["session-end"].instruction`
+
+## Token di contesto consigliati
+
+- Sempre: `{{sessionId}}`, `{{tmuxSession}}`
+- Per evento: `{{projectName}}`, `{{question}}`, `{{reason}}`
+
+## Strategia di verbosità
+
+- `minimal`: avvisi molto brevi
+- `session`: contesto operativo conciso (consigliato)
+- `verbose`: più contesto su stato/azione/rischio
+
+## Comando rapido di aggiornamento (jq)
+
+```bash
+CONFIG_FILE="$HOME/.codex/.rcs-config.json"
+
+jq '.notifications.verbosity = "verbose" |
+    .notifications.openclaw.hooks["session-start"].instruction = "[session-start|exec]\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}}\n요약: 시작 맥락 1문장\n우선순위: 지금 할 일 1~2개\n주의사항: 리스크/의존성(없으면 없음)" |
+    .notifications.openclaw.hooks["session-idle"].instruction = "[session-idle|exec]\nsession={{sessionId}} tmux={{tmuxSession}}\n요약: idle 원인 1문장\n복구계획: 즉시 조치 1~2개\n의사결정: 사용자 입력 필요 여부" |
+    .notifications.openclaw.hooks["ask-user-question"].instruction = "[ask-user-question|exec]\nsession={{sessionId}} tmux={{tmuxSession}} question={{question}}\n핵심질문: 필요한 답변 1문장\n영향: 미응답 시 영향 1문장\n권장응답: 가장 빠른 답변 형태" |
+    .notifications.openclaw.hooks["stop"].instruction = "[session-stop|exec]\nsession={{sessionId}} tmux={{tmuxSession}}\n요약: 중단 사유\n현재상태: 저장/미완료 항목\n재개: 첫 액션 1개" |
+    .notifications.openclaw.hooks["session-end"].instruction = "[session-end|exec]\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}} reason={{reason}}\n성과: 완료 결과 1~2문장\n검증: 확인/테스트 결과\n다음: 후속 액션 1~2개"'   "$CONFIG_FILE" > "$CONFIG_FILE.tmp" && mv "$CONFIG_FILE.tmp" "$CONFIG_FILE"
+```

package/docs/openclaw-integration.ja.md

@@ -0,0 +1,44 @@
+# OpenClaw 統合ガイド（プロンプト調整・ローカライズ版）
+
+> [← Back to Docs Home](./index.html) · [Integrations Landing](./integrations.html)
+
+**Language Switcher:** [English](./openclaw-integration.md) | [한국어](./openclaw-integration.ko.md) | [日本語](./openclaw-integration.ja.md) | [简体中文](./openclaw-integration.zh.md) | [繁體中文](./openclaw-integration.zh-TW.md) | [Tiếng Việt](./openclaw-integration.vi.md) | [Español](./openclaw-integration.es.md) | [Português](./openclaw-integration.pt.md) | [Русский](./openclaw-integration.ru.md) | [Türkçe](./openclaw-integration.tr.md) | [Deutsch](./openclaw-integration.de.md) | [Français](./openclaw-integration.fr.md) | [Italiano](./openclaw-integration.it.md) | [Українська](./openclaw-integration.uk.md)
+
+
+このページは英語版ドキュメントの **「Prompt tuning guide (concise + context-aware)」** セクションをローカライズしたものです。
+
+統合全体（gateway / hooks / 検証手順）は [English guide](./openclaw-integration.md) を参照してください。
+
+## プロンプト調整（簡潔 + コンテキスト重視）
+
+## プロンプトテンプレートの編集箇所
+
+- `notifications.openclaw.hooks["session-start"].instruction`
+- `notifications.openclaw.hooks["session-idle"].instruction`
+- `notifications.openclaw.hooks["ask-user-question"].instruction`
+- `notifications.openclaw.hooks["stop"].instruction`
+- `notifications.openclaw.hooks["session-end"].instruction`
+
+## 推奨コンテキストトークン
+
+- 常時含める: `{{sessionId}}`, `{{tmuxSession}}`
+- イベント依存: `{{projectName}}`, `{{question}}`, `{{reason}}`
+
+## 詳細度（verbosity）戦略
+
+- `minimal`: きわめて短い通知
+- `session`: 簡潔な運用文脈（推奨）
+- `verbose`: 状態・アクション・リスクを詳細化
+
+## クイック更新コマンド（jq）
+
+```bash
+CONFIG_FILE="$HOME/.codex/.rcs-config.json"
+
+jq '.notifications.verbosity = "verbose" |
+    .notifications.openclaw.hooks["session-start"].instruction = "[session-start|exec]\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}}\n요약: 시작 맥락 1문장\n우선순위: 지금 할 일 1~2개\n주의사항: 리스크/의존성(없으면 없음)" |
+    .notifications.openclaw.hooks["session-idle"].instruction = "[session-idle|exec]\nsession={{sessionId}} tmux={{tmuxSession}}\n요약: idle 원인 1문장\n복구계획: 즉시 조치 1~2개\n의사결정: 사용자 입력 필요 여부" |
+    .notifications.openclaw.hooks["ask-user-question"].instruction = "[ask-user-question|exec]\nsession={{sessionId}} tmux={{tmuxSession}} question={{question}}\n핵심질문: 필요한 답변 1문장\n영향: 미응답 시 영향 1문장\n권장응답: 가장 빠른 답변 형태" |
+    .notifications.openclaw.hooks["stop"].instruction = "[session-stop|exec]\nsession={{sessionId}} tmux={{tmuxSession}}\n요약: 중단 사유\n현재상태: 저장/미완료 항목\n재개: 첫 액션 1개" |
+    .notifications.openclaw.hooks["session-end"].instruction = "[session-end|exec]\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}} reason={{reason}}\n성과: 완료 결과 1~2문장\n검증: 확인/테스트 결과\n다음: 후속 액션 1~2개"'   "$CONFIG_FILE" > "$CONFIG_FILE.tmp" && mv "$CONFIG_FILE.tmp" "$CONFIG_FILE"
+```

package/docs/openclaw-integration.ko.md

@@ -0,0 +1,82 @@
+# OpenClaw 통합 가이드 (프롬프트 튜닝 로컬라이즈)
+
+> [← Back to Docs Home](./index.html) · [Integrations Landing](./integrations.html)
+
+**Language Switcher:** [English](./openclaw-integration.md) | [한국어](./openclaw-integration.ko.md) | [日本語](./openclaw-integration.ja.md) | [简体中文](./openclaw-integration.zh.md) | [繁體中文](./openclaw-integration.zh-TW.md) | [Tiếng Việt](./openclaw-integration.vi.md) | [Español](./openclaw-integration.es.md) | [Português](./openclaw-integration.pt.md) | [Русский](./openclaw-integration.ru.md) | [Türkçe](./openclaw-integration.tr.md) | [Deutsch](./openclaw-integration.de.md) | [Français](./openclaw-integration.fr.md) | [Italiano](./openclaw-integration.it.md) | [Українська](./openclaw-integration.uk.md)
+
+
+이 문서는 영문 본문 가이드의 **“Prompt tuning guide (concise + context-aware)”** 섹션을 한국어로 정리한 페이지입니다.
+
+게이트웨이/훅/검증까지 포함한 전체 통합 문서는 [English guide](./openclaw-integration.md)를 참고하세요.
+
+## 프롬프트 튜닝 (간결 + 컨텍스트 인식)
+
+## 프롬프트 템플릿 수정 위치
+
+- `notifications.openclaw.hooks["session-start"].instruction`
+- `notifications.openclaw.hooks["session-idle"].instruction`
+- `notifications.openclaw.hooks["ask-user-question"].instruction`
+- `notifications.openclaw.hooks["stop"].instruction`
+- `notifications.openclaw.hooks["session-end"].instruction`
+
+## 권장 컨텍스트 토큰
+
+- 항상 포함: `{{sessionId}}`, `{{tmuxSession}}`
+- 이벤트별 선택: `{{projectName}}`, `{{question}}`, `{{reason}}`
+
+## verbosity 전략
+
+- `minimal`: 매우 짧은 알림
+- `session`: 간결한 운영 맥락 (권장)
+- `verbose`: 상태/액션/리스크까지 확장
+
+## 프로덕션 구성 모범 사례
+
+### 명령 게이트웨이 설정
+
+clawdbot agent를 사용하는 프로덕션 환경에서는 다음 설정을 권장합니다:
+
+```json
+{
+  "notifications": {
+    "openclaw": {
+      "gateways": {
+        "local": {
+          "type": "command",
+          "command": "(clawdbot agent --session-id rcs-hooks --message {{instruction}} --thinking minimal --deliver --reply-channel discord --reply-to 'channel:1468539002985644084' --timeout 120 --json >>/tmp/rcs-openclaw-agent.jsonl 2>&1 || true)",
+          "timeout": 120000
+        }
+      }
+    }
+  }
+}
+```
+
+**주요 설정 설명:**
+- `|| true`: clawdbot 실패 시 RCS 세션이 차단되지 않도록 합니다
+- `>>/tmp/rcs-openclaw-agent.jsonl`: 구조화된 JSONL 로그를 append 모드로 기록합니다
+- `--reply-to 'channel:CHANNEL_ID'`: 채널 별칭 대신 ID를 사용하여 안정적인 전달을 보장합니다
+- `timeout: 120000`: 2분 타임아웃으로 clawdbot agent 작업이 완료될 시간을 확보합니다
+
+### 로그 확인 명령어
+
+```bash
+# JSONL 로그에서 최근 항목 확인
+tail -n 120 /tmp/rcs-openclaw-agent.jsonl | jq -s '.[] | {timestamp: (.timestamp // .time), status: (.status // .error // "ok")}'
+
+# 오류 검색
+rg '"error"|"failed"|"timeout"' /tmp/rcs-openclaw-agent.jsonl | tail -20
+```
+
+## 빠른 업데이트 명령어 (jq)
+
+```bash
+CONFIG_FILE="$HOME/.codex/.rcs-config.json"
+
+jq '.notifications.verbosity = "verbose" |
+    .notifications.openclaw.hooks["session-start"].instruction = "[session-start|exec]\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}}\n요약: 시작 맥락 1문장\n우선순위: 지금 할 일 1~2개\n주의사항: 리스크/의존성(없으면 없음)" |
+    .notifications.openclaw.hooks["session-idle"].instruction = "[session-idle|exec]\nsession={{sessionId}} tmux={{tmuxSession}}\n요약: idle 원인 1문장\n복구계획: 즉시 조치 1~2개\n의사결정: 사용자 입력 필요 여부" |
+    .notifications.openclaw.hooks["ask-user-question"].instruction = "[ask-user-question|exec]\nsession={{sessionId}} tmux={{tmuxSession}} question={{question}}\n핵심질문: 필요한 답변 1문장\n영향: 미응답 시 영향 1문장\n권장응답: 가장 빠른 답변 형태" |
+    .notifications.openclaw.hooks["stop"].instruction = "[session-stop|exec]\nsession={{sessionId}} tmux={{tmuxSession}}\n요약: 중단 사유\n현재상태: 저장/미완료 항목\n재개: 첫 액션 1개" |
+    .notifications.openclaw.hooks["session-end"].instruction = "[session-end|exec]\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}} reason={{reason}}\n성과: 완료 결과 1~2문장\n검증: 확인/테스트 결과\n다음: 후속 액션 1~2개"'   "$CONFIG_FILE" > "$CONFIG_FILE.tmp" && mv "$CONFIG_FILE.tmp" "$CONFIG_FILE"
+```

package/docs/openclaw-integration.md

@@ -0,0 +1,378 @@
+# OpenClaw / Generic Notification Gateway Integration Guide
+
+This guide covers two supported setup paths:
+
+1. **Explicit OpenClaw schema** (`notifications.openclaw`) — runtime-native shape
+2. **Generic aliases** (`custom_webhook_command`, `custom_cli_command`) — flexible setup for OpenClaw or other services
+
+## Activation gates
+
+```bash
+# Prefer exporting a token env var in your shell profile (avoid hardcoding secrets in JSON):
+export HOOKS_TOKEN="your-openclaw-hooks-token"
+
+# Required for OpenClaw dispatch pipeline
+export RCS_OPENCLAW=1
+
+# Required in addition for command gateways
+export RCS_OPENCLAW_COMMAND=1
+
+# Optional global default for command gateway timeout (ms)
+# Precedence: gateway timeout > env override > 5000 default
+export RCS_OPENCLAW_COMMAND_TIMEOUT_MS=120000
+```
+
+## Prompt tuning guide (concise + context-aware)
+
+For OpenClaw integrations, the most important quality lever is the hook
+`instruction` template under:
+
+- `notifications.openclaw.hooks["session-start"].instruction`
+- `notifications.openclaw.hooks["session-idle"].instruction`
+- `notifications.openclaw.hooks["ask-user-question"].instruction`
+- `notifications.openclaw.hooks["stop"].instruction`
+- `notifications.openclaw.hooks["session-end"].instruction`
+
+### Recommended context tokens
+
+Always include:
+
+- `{{sessionId}}` for cross-log traceability
+- `{{tmuxSession}}` for direct tmux follow-up targeting
+
+Include when relevant:
+
+- `{{projectName}}`
+- `{{question}}` (`ask-user-question`)
+- `{{reason}}` (`session-end`)
+
+### Structured instruction format
+
+For production deployments, use a structured format that clawdbot agents can parse efficiently:
+
+```
+[event|exec]
+project={{projectName}} session={{sessionId}} tmux={{tmuxSession}}
+필드1: 값
+필드2: 값
+```
+
+The `[event|exec]` prefix indicates this is an executable hook that requires agent action.
+Korean field names (요약, 우선순위, 주의사항, 성과, 검증, 다음) provide consistent structure
+for dev teams using Korean as their primary language.
+
+### Verbosity strategy
+
+- `minimal`: very short pings (high signal, low narrative)
+- `session` (**recommended default**): concise operational context
+- `verbose`: richer status + action + risk framing
+
+### Executive-summary verbose profile (example)
+
+Use this profile when you want detailed but quickly scannable notifications:
+
+```json
+{
+  "notifications": {
+    "verbosity": "verbose",
+    "openclaw": {
+      "hooks": {
+        "session-start": {
+          "enabled": true,
+          "gateway": "local",
+          "instruction": "[session-start|exec]\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}}\n요약: 시작 맥락 1문장\n우선순위: 지금 할 일 1~2개\n주의사항: 리스크/의존성(없으면 없음)"
+        },
+        "session-idle": {
+          "enabled": true,
+          "gateway": "local",
+          "instruction": "[session-idle|exec]\nsession={{sessionId}} tmux={{tmuxSession}}\n요약: idle 원인 1문장\n복구계획: 즉시 조치 1~2개\n의사결정: 사용자 입력 필요 여부"
+        },
+        "ask-user-question": {
+          "enabled": true,
+          "gateway": "local",
+          "instruction": "[ask-user-question|exec]\nsession={{sessionId}} tmux={{tmuxSession}} question={{question}}\n핵심질문: 필요한 답변 1문장\n영향: 미응답 시 영향 1문장\n권장응답: 가장 빠른 답변 형태"
+        },
+        "stop": {
+          "enabled": true,
+          "gateway": "local",
+          "instruction": "[session-stop|exec]\nsession={{sessionId}} tmux={{tmuxSession}}\n요약: 중단 사유\n현재상태: 저장/미완료 항목\n재개: 첫 액션 1개"
+        },
+        "session-end": {
+          "enabled": true,
+          "gateway": "local",
+          "instruction": "[session-end|exec]\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}} reason={{reason}}\n성과: 완료 결과 1~2문장\n검증: 확인/테스트 결과\n다음: 후속 액션 1~2개"
+        }
+      }
+    }
+  }
+}
+```
+
+### Quick update command (jq)
+
+```bash
+CONFIG_FILE="$HOME/.codex/.rcs-config.json"
+
+jq '.notifications.verbosity = "verbose" |
+    .notifications.openclaw.hooks["session-start"].instruction = "[session-start|exec]\\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}}\\n요약: 시작 맥락 1문장\\n우선순위: 지금 할 일 1~2개\\n주의사항: 리스크/의존성(없으면 없음)" |
+    .notifications.openclaw.hooks["session-idle"].instruction = "[session-idle|exec]\\nsession={{sessionId}} tmux={{tmuxSession}}\\n요약: idle 원인 1문장\\n복구계획: 즉시 조치 1~2개\\n의사결정: 사용자 입력 필요 여부" |
+    .notifications.openclaw.hooks["ask-user-question"].instruction = "[ask-user-question|exec]\\nsession={{sessionId}} tmux={{tmuxSession}} question={{question}}\\n핵심질문: 필요한 답변 1문장\\n영향: 미응답 시 영향 1문장\\n권장응답: 가장 빠른 답변 형태" |
+    .notifications.openclaw.hooks["stop"].instruction = "[session-stop|exec]\\nsession={{sessionId}} tmux={{tmuxSession}}\\n요약: 중단 사유\\n현재상태: 저장/미완료 항목\\n재개: 첫 액션 1개" |
+    .notifications.openclaw.hooks["session-end"].instruction = "[session-end|exec]\\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}} reason={{reason}}\\n성과: 완료 결과 1~2문장\\n검증: 확인/테스트 결과\\n다음: 후속 액션 1~2개"' \
+  "$CONFIG_FILE" > "$CONFIG_FILE.tmp" && mv "$CONFIG_FILE.tmp" "$CONFIG_FILE"
+```
+
+## Canonical precedence contract
+
+When both explicit OpenClaw config and generic aliases are present:
+
+1. `notifications.openclaw` wins
+2. `custom_webhook_command` / `custom_cli_command` are ignored
+3. RCS emits a warning for clarity
+
+This keeps behavior deterministic and backward compatible.
+
+## Option A: Explicit `notifications.openclaw` (legacy/runtime shape)
+
+```json
+{
+  "notifications": {
+    "enabled": true,
+    "openclaw": {
+      "enabled": true,
+      "gateways": {
+        "local": {
+          "type": "http",
+          "url": "http://127.0.0.1:18789/hooks/agent",
+          "headers": {
+            "Authorization": "Bearer ${HOOKS_TOKEN}"
+          }
+        }
+      },
+      "hooks": {
+        "session-end": {
+          "enabled": true,
+          "gateway": "local",
+          "instruction": "RCS task completed for {{projectPath}}"
+        },
+        "ask-user-question": {
+          "enabled": true,
+          "gateway": "local",
+          "instruction": "RCS needs input: {{question}}"
+        }
+      }
+    }
+  }
+}
+```
+
+## Option B: Generic aliases (`custom_webhook_command` / `custom_cli_command`)
+
+```json
+{
+  "notifications": {
+    "enabled": true,
+    "custom_webhook_command": {
+      "enabled": true,
+      "url": "http://127.0.0.1:18789/hooks/agent",
+      "method": "POST",
+      "headers": {
+        "Authorization": "Bearer ${HOOKS_TOKEN}"
+      },
+      "events": ["session-end", "ask-user-question"],
+      "instruction": "RCS event {{event}} for {{projectPath}}"
+    },
+    "custom_cli_command": {
+      "enabled": true,
+      "command": "~/.local/bin/my-notifier --event {{event}} --text {{instruction}}",
+      "events": ["session-end"],
+      "instruction": "RCS event {{event}} for {{projectPath}}"
+    }
+  }
+}
+```
+
+These aliases are normalized by RCS into internal OpenClaw gateway mappings.
+
+## Option C: Clawdbot agent-command workflow (recommended for dev)
+
+Use this when you want RCS hook events to trigger **agent turns** (not plain
+message/webhook forwarding), e.g. for `#omc-dev`.
+
+> Shell safety: template variables (for example `{{instruction}}`) are interpolated into the
+> command string. Keep templates simple and avoid shell metacharacters in user-derived content.
+> For troubleshooting, temporarily remove output redirection and inspect command output.
+>
+> Command gateway timeout precedence: `gateways.<name>.timeout` > `RCS_OPENCLAW_COMMAND_TIMEOUT_MS` > `5000`.
+> For `clawdbot agent` workflows, use `120000` (2 minutes) to avoid premature timeout.
+>
+> **Production best practices:**
+> - Use `|| true` at the end of the command to prevent RCS hook failures from blocking sessions
+> - Use `.jsonl` extension with append (`>>`) for structured log aggregation
+> - Use `--reply-to 'channel:CHANNEL_ID'` format for reliable Discord delivery (preferred over aliases)
+
+For Korean-first tmux follow-up operations in `#omc-dev`, see the dev guide section below.
+
+```json
+{
+  "notifications": {
+    "enabled": true,
+    "verbosity": "verbose",
+    "events": {
+      "session-start": { "enabled": true },
+      "session-idle": { "enabled": true },
+      "ask-user-question": { "enabled": true },
+      "session-stop": { "enabled": true },
+      "session-end": { "enabled": true }
+    },
+    "openclaw": {
+      "enabled": true,
+      "gateways": {
+        "local": {
+          "type": "command",
+          "command": "(clawdbot agent --session-id rcs-hooks --message {{instruction}} --thinking minimal --deliver --reply-channel discord --reply-to 'channel:1468539002985644084' --timeout 120 --json >>/tmp/rcs-openclaw-agent.jsonl 2>&1 || true)",
+          "timeout": 120000
+        }
+      },
+      "hooks": {
+        "session-start": {
+          "enabled": true,
+          "gateway": "local",
+          "instruction": "[session-start|exec]\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}}\n요약: 시작 맥락 1문장\n우선순위: 지금 할 일 1~2개\n주의사항: 리스크/의존성(없으면 없음)"
+        },
+        "session-idle": {
+          "enabled": true,
+          "gateway": "local",
+          "instruction": "[session-idle|exec]\nsession={{sessionId}} tmux={{tmuxSession}}\n요약: idle 원인 1문장\n복구계획: 즉시 조치 1~2개\n의사결정: 사용자 입력 필요 여부"
+        },
+        "ask-user-question": {
+          "enabled": true,
+          "gateway": "local",
+          "instruction": "[ask-user-question|exec]\nsession={{sessionId}} tmux={{tmuxSession}} question={{question}}\n핵심질문: 필요한 답변 1문장\n영향: 미응답 시 영향 1문장\n권장응답: 가장 빠른 답변 형태"
+        },
+        "stop": {
+          "enabled": true,
+          "gateway": "local",
+          "instruction": "[session-stop|exec]\nsession={{sessionId}} tmux={{tmuxSession}}\n요약: 중단 사유\n현재상태: 저장/미완료 항목\n재개: 첫 액션 1개"
+        },
+        "session-end": {
+          "enabled": true,
+          "gateway": "local",
+          "instruction": "[session-end|exec]\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}} reason={{reason}}\n성과: 완료 결과 1~2문장\n검증: 확인/테스트 결과\n다음: 후속 액션 1~2개"
+        }
+      }
+    }
+  }
+}
+```
+
+## Dev Guide: OpenClaw + Clawdbot Agent (Korean follow-up mode)
+
+Use this profile when `#omc-dev` should receive OpenClaw notifications as
+**actual clawdbot agent turns**, with proactive follow-up behavior.
+
+### 1) Force Korean output in hook instructions
+
+- Write all hook instructions in Korean.
+- Explicitly require Korean in each instruction template.
+- **Prefer `--reply-to 'channel:CHANNEL_ID'` format** over channel aliases for reliability.
+  - Example: `--reply-to 'channel:1468539002985644084'` (for #omc-dev)
+  - Channel aliases like `#omc-dev` may fail if the bot doesn't have the channel cached.
+
+Example instruction style:
+
+```text
+RCS 훅={{event}} 프로젝트={{projectName}} 세션={{sessionId}}.
+반드시 한국어로 응답하세요.
+RCS tmux 세션: {{tmuxSession}}.
+SOUL.md 및 #omc-dev 맥락을 참고해 필요한 후속 액션이 있으면 즉시 안내하세요.
+```
+
+### 2) Track which RCS tmux session emitted the hook
+
+- Include both `{{sessionId}}` and `{{tmuxSession}}` in every hook message.
+- If `{{tmuxSession}}` is present, use that as the primary follow-up target.
+- If missing, derive candidate tmux sessions from `sessionId` and current project path.
+
+Quick checks:
+
+```bash
+tmux ls | grep '^rcs-' || true
+tmux list-panes -a -F '#{session_name}\t#{pane_id}\t#{pane_current_path}' | grep "$(basename "$PWD")" || true
+```
+
+### 3) SOUL.md + #omc-dev follow-up runbook
+
+When a hook suggests active work or pending user action:
+
+1. Read `SOUL.md` and recent `#omc-dev` context.
+2. Follow up in Korean, citing `sessionId` + `tmuxSession`.
+3. If action is required, state concrete next step (for example, reply needed, retry needed, or session check needed).
+4. If delivery looks broken, inspect logs and retry without swallowed output.
+
+Troubleshooting commands:
+
+```bash
+# Inspect structured JSONL logs
+tail -n 120 /tmp/rcs-openclaw-agent.jsonl | jq -s '.[] | {timestamp: (.timestamp // .time), status: (.status // .error // "ok")}'
+
+# Search for errors in logs
+rg '"error"|"failed"|"timeout"' /tmp/rcs-openclaw-agent.jsonl | tail -20
+
+# Manual retry with production-tested settings
+clawdbot agent --session-id rcs-hooks \
+  --message "RCS hook retry 점검: session={{sessionId}} tmux={{tmuxSession}}" \
+  --thinking minimal --deliver --reply-channel discord --reply-to 'channel:1468539002985644084' \
+  --timeout 120 --json
+```
+
+## Verification (required)
+
+### A) Wake smoke test (`/hooks/wake`)
+
+```bash
+curl -sS -X POST http://127.0.0.1:18789/hooks/wake \
+  -H "Authorization: Bearer ${HOOKS_TOKEN}" \
+  -H "Content-Type: application/json" \
+  -d '{"text":"RCS wake smoke test","mode":"now"}'
+```
+
+Expected pass signal: JSON includes `"ok":true`.
+
+### B) Delivery verification (`/hooks/agent`)
+
+```bash
+curl -sS -o /tmp/rcs-openclaw-agent-check.json -w "HTTP %{http_code}\n" \
+  -X POST http://127.0.0.1:18789/hooks/agent \
+  -H "Authorization: Bearer ${HOOKS_TOKEN}" \
+  -H "Content-Type: application/json" \
+  -d '{"message":"RCS delivery verification","instruction":"RCS delivery verification","event":"session-end","sessionId":"manual-check"}'
+```
+
+Expected pass signal: HTTP 2xx + accepted response body.
+
+## Preflight checks
+
+```bash
+# token present
+test -n "$HOOKS_TOKEN" && echo "token ok" || echo "token missing"
+
+# reachability
+curl -sS -o /dev/null -w "HTTP %{http_code}\n" http://127.0.0.1:18789 || echo "gateway unreachable"
+
+# gate checks
+test "$RCS_OPENCLAW" = "1" && echo "RCS_OPENCLAW=1" || echo "missing RCS_OPENCLAW=1"
+test "$RCS_OPENCLAW_COMMAND" = "1" && echo "RCS_OPENCLAW_COMMAND=1" || echo "missing RCS_OPENCLAW_COMMAND=1"
+```
+
+## Pass/Fail Diagnostics
+
+- **401/403**: invalid/missing bearer token.
+- **404**: wrong path; verify `/hooks/agent` and `/hooks/wake`.
+- **5xx**: gateway runtime issue; inspect logs.
+- **Timeout/connection refused**: host/port/firewall issue.
+- **Command gateway disabled**: set both `RCS_OPENCLAW=1` and `RCS_OPENCLAW_COMMAND=1`.
+- **Command killed by `SIGTERM`**: increase `gateways.<name>.timeout` (recommend `120000` for clawdbot agent) or set `RCS_OPENCLAW_COMMAND_TIMEOUT_MS`.
+- **Hook failures blocking sessions**: ensure command ends with `|| true` to prevent RCS from waiting on clawdbot failures.
+- **Missing logs**: use `.jsonl` extension with append (`>>`) for persistent structured logging.
+- **Discord delivery failures**: use `--reply-to 'channel:CHANNEL_ID'` format instead of channel aliases.

package/docs/openclaw-integration.pt.md

@@ -0,0 +1,44 @@
+# Guia de integração OpenClaw (ajuste de prompts localizado)
+
+> [← Back to Docs Home](./index.html) · [Integrations Landing](./integrations.html)
+
+**Language Switcher:** [English](./openclaw-integration.md) | [한국어](./openclaw-integration.ko.md) | [日本語](./openclaw-integration.ja.md) | [简体中文](./openclaw-integration.zh.md) | [繁體中文](./openclaw-integration.zh-TW.md) | [Tiếng Việt](./openclaw-integration.vi.md) | [Español](./openclaw-integration.es.md) | [Português](./openclaw-integration.pt.md) | [Русский](./openclaw-integration.ru.md) | [Türkçe](./openclaw-integration.tr.md) | [Deutsch](./openclaw-integration.de.md) | [Français](./openclaw-integration.fr.md) | [Italiano](./openclaw-integration.it.md) | [Українська](./openclaw-integration.uk.md)
+
+
+Esta página localiza a seção **“Prompt tuning guide (concise + context-aware)”** da documentação principal em inglês.
+
+Para a documentação completa de integração (gateways, hooks, verificação), veja o [English guide](./openclaw-integration.md).
+
+## Ajuste de prompts (conciso + sensível ao contexto)
+
+## Onde editar os templates de prompt
+
+- `notifications.openclaw.hooks["session-start"].instruction`
+- `notifications.openclaw.hooks["session-idle"].instruction`
+- `notifications.openclaw.hooks["ask-user-question"].instruction`
+- `notifications.openclaw.hooks["stop"].instruction`
+- `notifications.openclaw.hooks["session-end"].instruction`
+
+## Tokens de contexto recomendados
+
+- Sempre incluir: `{{sessionId}}`, `{{tmuxSession}}`
+- Conforme evento: `{{projectName}}`, `{{question}}`, `{{reason}}`
+
+## Estratégia de verbosidade
+
+- `minimal`: avisos muito curtos
+- `session`: contexto operacional conciso (recomendado)
+- `verbose`: mais contexto de status/ação/risco
+
+## Comando rápido de atualização (jq)
+
+```bash
+CONFIG_FILE="$HOME/.codex/.rcs-config.json"
+
+jq '.notifications.verbosity = "verbose" |
+    .notifications.openclaw.hooks["session-start"].instruction = "[session-start|exec]\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}}\n요약: 시작 맥락 1문장\n우선순위: 지금 할 일 1~2개\n주의사항: 리스크/의존성(없으면 없음)" |
+    .notifications.openclaw.hooks["session-idle"].instruction = "[session-idle|exec]\nsession={{sessionId}} tmux={{tmuxSession}}\n요약: idle 원인 1문장\n복구계획: 즉시 조치 1~2개\n의사결정: 사용자 입력 필요 여부" |
+    .notifications.openclaw.hooks["ask-user-question"].instruction = "[ask-user-question|exec]\nsession={{sessionId}} tmux={{tmuxSession}} question={{question}}\n핵심질문: 필요한 답변 1문장\n영향: 미응답 시 영향 1문장\n권장응답: 가장 빠른 답변 형태" |
+    .notifications.openclaw.hooks["stop"].instruction = "[session-stop|exec]\nsession={{sessionId}} tmux={{tmuxSession}}\n요약: 중단 사유\n현재상태: 저장/미완료 항목\n재개: 첫 액션 1개" |
+    .notifications.openclaw.hooks["session-end"].instruction = "[session-end|exec]\nproject={{projectName}} session={{sessionId}} tmux={{tmuxSession}} reason={{reason}}\n성과: 완료 결과 1~2문장\n검증: 확인/테스트 결과\n다음: 후속 액션 1~2개"'   "$CONFIG_FILE" > "$CONFIG_FILE.tmp" && mv "$CONFIG_FILE.tmp" "$CONFIG_FILE"
+```