verbalcoding 0.2.12 → 0.2.13

package/docs/i18n/HARNESS_HERMES.es.md

@@ -0,0 +1,54 @@
+# Hermes Agent — Notas del Harness
+
+<p align="center">
+  <a href="../../README.es.md">README</a> ·
+  <a href="HARNESSES.es.md">Harnesses</a> ·
+  <a href="USAGE.es.md">Uso</a> ·
+  <a href="CONFIGURATION.es.md">Configuración</a>
+</p>
+
+Hermes Agent es el backend por defecto de VerbalCoding y el único harness con un contrato real de reanudación de sesión: el contexto entre turnos se mantiene limpio. Posicionamiento frente al `/voice` integrado de Hermes en [HERMES_VOICE.es.md](./HERMES_VOICE.es.md).
+
+## Instalación
+
+Guía oficial: <https://hermes-agent.nousresearch.com>. Verifica el CLI primero:
+
+```bash
+hermes chat -Q -q "hello"
+```
+
+## Configuración
+
+```bash
+# .env
+AGENT_BACKEND=hermes
+HERMES_COMMAND="hermes chat -Q -q"
+HERMES_HOME=/Users/you/.hermes
+HERMES_PROJECT_CONTEXT="Project session: ..."
+HERMES_TASK_TIMEOUT_MS=0
+HERMES_CHAT_TIMEOUT_MS=45000
+HERMES_WORKDIR=/Users/you/code/your-project
+```
+
+El fichero de sesión vive en `<repo>/.verbalcoding-session` por defecto (sobreescribible con `HERMES_SESSION_FILE`).
+
+## Reanudación de sesión
+
+Hermes es el único adaptador con reanudación. Tras cada turno con éxito, el adaptador escribe el nuevo `session_id` y antepone `--resume <id>` en la siguiente llamada. `!session reset` lo limpia.
+
+Si un turno aborta antes de que Hermes emita `session_id:` en stderr, el adaptador lee `~/.hermes/sessions/session_<id>.json` para recuperar el último mensaje del asistente.
+
+## Progreso detallado
+
+En modo verboso, el adaptador quita el flag `-Q` para que stdout emita previas `┊ <emoji> <tool>`, que se resumen en eventos de progreso (lectura de archivos, búsqueda web, terminal). Sin verboso solo suena la respuesta final del recuadro.
+
+## Frases de voz para cambiar a Hermes
+
+- en: `"switch to Hermes"`, `"ask Hermes ..."`
+- es: `"cambia a Hermes"`, `"pregunta a Hermes"`
+
+## Trampas
+
+- El prefijo TTS en handoff es localizado: `"Hermes says: "` / `"Hermes: "`.
+- `HERMES_HOME` es el botón de aislamiento por proyecto más usado; típicamente `HERMES_HOME=/Users/you/.hermes/profiles/<project>` en el `.env` de instancia.
+- Si verboso está activo pero Hermes termina con caja vacía (timeout), el adaptador rasca el JSON de sesión antes de rendirse.

package/docs/i18n/HARNESS_HERMES.fr.md

@@ -0,0 +1,54 @@
+# Hermes Agent — Notes Harness
+
+<p align="center">
+  <a href="../../README.fr.md">README</a> ·
+  <a href="HARNESSES.fr.md">Harnesses</a> ·
+  <a href="USAGE.fr.md">Utilisation</a> ·
+  <a href="CONFIGURATION.fr.md">Configuration</a>
+</p>
+
+Hermes Agent est le backend par défaut de VerbalCoding et le seul harness disposant d'un vrai contrat de reprise de session — le contexte entre les tours reste propre. Comparaison avec le `/voice` intégré d'Hermes dans [HERMES_VOICE.fr.md](./HERMES_VOICE.fr.md).
+
+## Installation
+
+Guide officiel : <https://hermes-agent.nousresearch.com>. Vérifiez d'abord le CLI :
+
+```bash
+hermes chat -Q -q "hello"
+```
+
+## Configuration
+
+```bash
+# .env
+AGENT_BACKEND=hermes
+HERMES_COMMAND="hermes chat -Q -q"
+HERMES_HOME=/Users/you/.hermes
+HERMES_PROJECT_CONTEXT="Project session: ..."
+HERMES_TASK_TIMEOUT_MS=0
+HERMES_CHAT_TIMEOUT_MS=45000
+HERMES_WORKDIR=/Users/you/code/your-project
+```
+
+Le fichier de session est dans `<repo>/.verbalcoding-session` par défaut (`HERMES_SESSION_FILE` pour surcharger).
+
+## Reprise de session
+
+Hermes est le seul adaptateur intégré avec reprise. Après chaque tour réussi, l'adaptateur écrit le nouveau `session_id` et préfixe `--resume <id>` au prochain appel. `!session reset` efface.
+
+Si un tour est abort avant que Hermes n'émette `session_id:` sur stderr, l'adaptateur lit `~/.hermes/sessions/session_<id>.json` pour retrouver le dernier message assistant.
+
+## Progression verbeuse
+
+En mode verbeux, l'adaptateur retire `-Q` pour que stdout émette les aperçus `┊ <emoji> <tool>`, résumés en événements de progression (lecture de fichiers, web, terminal). Sans verbeux, seule la réponse finale du cadre est vocale.
+
+## Phrases vocales pour basculer vers Hermes
+
+- en: `"switch to Hermes"`, `"ask Hermes ..."`
+- fr: `"passe à Hermes"`, `"demande à Hermes"`
+
+## Pièges
+
+- Le préfixe TTS de handoff est localisé : `"Hermes says: "` / `"Hermes : "`.
+- `HERMES_HOME` est le bouton d'isolation projet le plus utilisé ; typiquement `HERMES_HOME=/Users/you/.hermes/profiles/<project>` dans `.env`.
+- En verbeux, si Hermes termine sur une boîte vide (timeout), l'adaptateur fouille le JSON de session avant d'abandonner.

package/docs/i18n/HARNESS_HERMES.ja.md

@@ -0,0 +1,57 @@
+# Hermes Agent — ハーネスノート
+
+<p align="center">
+  <a href="../../README.ja.md">README</a> ·
+  <a href="HARNESSES.ja.md">ハーネス</a> ·
+  <a href="USAGE.ja.md">使い方</a> ·
+  <a href="CONFIGURATION.ja.md">設定</a>
+</p>
+
+Hermes Agent は VerbalCoding の既定バックエンドで、真のセッション再開契約を持つ唯一のハーネスです。ターン間のコンテキストがきれいに保たれます。Hermes 内蔵の `/voice` スラッシュコマンドとの位置付け比較は [HERMES_VOICE.ja.md](./HERMES_VOICE.ja.md)。
+
+## インストール
+
+上流の Hermes Agent インストールガイド: <https://hermes-agent.nousresearch.com>
+
+まず CLI 単体で動作確認:
+
+```bash
+hermes chat -Q -q "hello"
+```
+
+## VerbalCoding 設定
+
+```bash
+# .env
+AGENT_BACKEND=hermes
+# 任意
+HERMES_COMMAND="hermes chat -Q -q"           # 既定
+HERMES_HOME=/Users/you/.hermes               # インスタンス別 Hermes ホーム
+HERMES_PROJECT_CONTEXT="Project session: ..."
+HERMES_TASK_TIMEOUT_MS=0                     # 0 = 無制限
+HERMES_CHAT_TIMEOUT_MS=45000
+HERMES_WORKDIR=/Users/you/code/your-project
+```
+
+セッションファイルの既定パスは `<repo>/.verbalcoding-session` (`HERMES_SESSION_FILE` で上書き)。
+
+## セッション再開
+
+Hermes は内蔵アダプタの中で唯一セッション再開をサポートします。ターン成功ごとに新 `session_id` をディスクに書き、次回呼び出しに `--resume <id>` を前置します。`!session reset` (または `!reset-session`) でクリア。
+
+Hermes が stderr に `session_id:` を emit する前にターンが abort された場合、アダプタが `~/.hermes/sessions/session_<id>.json` を直接読み最終応答を復元します。
+
+## 詳細進捗
+
+詳細モードではアダプタが Hermes の `-Q` quiet フラグを外し、stdout に `┊ <emoji> <tool>` のプレビューが流れます。これらは 1 行進捗イベント(ファイル読み込み、Web 検索、ターミナル実行など)に要約されます。詳細オフ時は最終ボックス内応答のみ音声化。
+
+## Hermes へ切り替える音声表現
+
+- en: `"switch to Hermes"`, `"ask Hermes ..."`
+- ja: `"Hermes に切り替えて"`, `"Hermes に聞いて"`
+
+## 罠
+
+- クロスエージェントハンドオフ時の TTS 接頭辞はロケール準拠 (`"Hermes says: "` / `"ヘルメス: "`)。
+- `HERMES_HOME` はプロジェクト別の最も一般的な分離ノブ。インスタンス `.env` は通常 `HERMES_HOME=/Users/you/.hermes/profiles/<project>` を設定。
+- 詳細オン時に Hermes が空ボックスで終了(タイムアウト等)した場合、諦める前にアダプタがセッション JSON を漁って最終応答を取得します。

package/docs/i18n/HARNESS_HERMES.ko.md

@@ -0,0 +1,57 @@
+# Hermes Agent — 하니스 노트
+
+<p align="center">
+  <a href="../../README.ko.md">README</a> ·
+  <a href="HARNESSES.ko.md">하니스</a> ·
+  <a href="USAGE.ko.md">사용법</a> ·
+  <a href="CONFIGURATION.ko.md">설정</a>
+</p>
+
+Hermes Agent는 VerbalCoding의 기본 백엔드이고, 진짜 세션 재개 계약이 있는 유일한 하니스야. 턴 사이 컨텍스트가 깔끔하게 유지돼. Hermes 내장 `/voice` 슬래시 명령과의 포지셔닝 비교는 [HERMES_VOICE.ko.md](./HERMES_VOICE.ko.md).
+
+## 설치
+
+상위 Hermes Agent 설치 가이드: <https://hermes-agent.nousresearch.com>.
+
+CLI 단독 동작부터 확인해줘:
+
+```bash
+hermes chat -Q -q "hello"
+```
+
+## VerbalCoding 설정
+
+```bash
+# .env
+AGENT_BACKEND=hermes
+# 선택
+HERMES_COMMAND="hermes chat -Q -q"           # 기본값
+HERMES_HOME=/Users/you/.hermes               # 인스턴스별 Hermes 홈
+HERMES_PROJECT_CONTEXT="Project session: ..."
+HERMES_TASK_TIMEOUT_MS=0                     # 0 = 무제한
+HERMES_CHAT_TIMEOUT_MS=45000
+HERMES_WORKDIR=/Users/you/code/your-project
+```
+
+세션 파일 기본 위치는 `<repo>/.verbalcoding-session` (덮어쓰려면 `HERMES_SESSION_FILE`).
+
+## 세션 재개
+
+Hermes는 내장 어댑터 중 유일하게 세션 재개를 지원해. 턴이 성공할 때마다 새 `session_id`를 디스크에 쓰고 다음 호출에 `--resume <id>`를 앞에 붙여. `!session reset`(또는 `!reset-session`)으로 그 파일을 지울 수 있어.
+
+Hermes가 stderr에 `session_id:`를 emit하기 전에 턴이 abort되면, 어댑터가 `~/.hermes/sessions/session_<id>.json`을 직접 읽어서 마지막 어시스턴트 메시지를 복구해.
+
+## 상세 진행
+
+상세 모드에서는 어댑터가 Hermes의 `-Q` quiet 플래그를 떼서 stdout으로 `┊ <emoji> <tool>` 미리보기가 흘러나와. 이걸 한 줄짜리 진행 이벤트(파일 읽기, 웹 검색, 터미널 실행 등)로 요약해. 상세 모드가 꺼져 있으면 박스 안의 최종 답변만 음성으로 나가.
+
+## Hermes로 전환하는 음성 표현
+
+- en: `"switch to Hermes"`, `"ask Hermes ..."`
+- ko: `"헤르메스로 전환"`, `"헤르메스한테 물어봐"`
+
+## 함정
+
+- 크로스 에이전트 핸드오프 시 TTS 접두사는 로케일에 맞춰서 `"Hermes says: "` / `"헤르메스: "`로 붙어.
+- `HERMES_HOME`은 프로젝트별 격리에 가장 많이 쓰이는 노브야. 인스턴스 `.env`는 보통 `HERMES_HOME=/Users/you/.hermes/profiles/<project>` 식으로 설정.
+- 상세 모드 켜고도 Hermes가 빈 박스로 끝나는 경우(타임아웃 등), 어댑터가 포기하기 전에 세션 JSON을 긁어서 최종 답변을 찾아내.

package/docs/i18n/HARNESS_HERMES.ru.md

@@ -0,0 +1,54 @@
+# Hermes Agent — Заметки по harness
+
+<p align="center">
+  <a href="../../README.ru.md">README</a> ·
+  <a href="HARNESSES.ru.md">Harness-ы</a> ·
+  <a href="USAGE.ru.md">Использование</a> ·
+  <a href="CONFIGURATION.ru.md">Настройка</a>
+</p>
+
+Hermes Agent — backend VerbalCoding по умолчанию и единственный harness с настоящим контрактом возобновления сессии: контекст между turn-ами держится чисто. Сравнение со встроенным `/voice` Hermes — в [HERMES_VOICE.ru.md](./HERMES_VOICE.ru.md).
+
+## Установка
+
+Официальный гайд: <https://hermes-agent.nousresearch.com>. Сначала проверьте CLI:
+
+```bash
+hermes chat -Q -q "hello"
+```
+
+## Настройка
+
+```bash
+# .env
+AGENT_BACKEND=hermes
+HERMES_COMMAND="hermes chat -Q -q"
+HERMES_HOME=/Users/you/.hermes
+HERMES_PROJECT_CONTEXT="Project session: ..."
+HERMES_TASK_TIMEOUT_MS=0
+HERMES_CHAT_TIMEOUT_MS=45000
+HERMES_WORKDIR=/Users/you/code/your-project
+```
+
+Файл сессии лежит в `<repo>/.verbalcoding-session` (можно переопределить через `HERMES_SESSION_FILE`).
+
+## Возобновление сессии
+
+Hermes — единственный встроенный адаптер с возобновлением. После каждого успешного turn адаптер пишет новый `session_id` на диск и добавляет `--resume <id>` к следующему вызову. `!session reset` очищает файл.
+
+Если turn был abort до того, как Hermes выдал `session_id:` в stderr, адаптер читает `~/.hermes/sessions/session_<id>.json`, чтобы восстановить последний ответ ассистента.
+
+## Подробный прогресс
+
+В подробном режиме адаптер убирает флаг `-Q`, и в stdout начинают идти превью `┊ <emoji> <tool>`. Они сводятся в однострочные события прогресса (чтение файлов, веб-поиск, терминал). Без подробного режима в голос идёт только финальный ответ в рамке.
+
+## Голосовые фразы для переключения на Hermes
+
+- en: `"switch to Hermes"`, `"ask Hermes ..."`
+- ru: `"переключись на Hermes"`, `"спроси Hermes"`
+
+## Подводные камни
+
+- TTS-префикс при handoff локализован: `"Hermes says: "` / `"Hermes: "`.
+- `HERMES_HOME` — самый частый рычаг изоляции проекта; обычно `HERMES_HOME=/Users/you/.hermes/profiles/<project>` в `.env` инстанса.
+- В подробном режиме при пустой рамке от Hermes (таймаут) адаптер залезет в JSON сессии за финальным ответом.

package/docs/i18n/HARNESS_HERMES.zh.md

@@ -0,0 +1,57 @@
+# Hermes Agent — Harness 说明
+
+<p align="center">
+  <a href="../../README.zh.md">README</a> ·
+  <a href="HARNESSES.zh.md">Harness</a> ·
+  <a href="USAGE.zh.md">使用</a> ·
+  <a href="CONFIGURATION.zh.md">配置</a>
+</p>
+
+Hermes Agent 是 VerbalCoding 的默认后端,也是唯一拥有真正会话续接契约的 harness。turn 之间上下文保持干净。关于 Hermes 内建 `/voice` 的对比,见 [HERMES_VOICE.zh.md](./HERMES_VOICE.zh.md)。
+
+## 安装
+
+参考上游 Hermes Agent 安装指引: <https://hermes-agent.nousresearch.com>。
+
+先确认 CLI 单独可用:
+
+```bash
+hermes chat -Q -q "hello"
+```
+
+## VerbalCoding 配置
+
+```bash
+# .env
+AGENT_BACKEND=hermes
+# 可选
+HERMES_COMMAND="hermes chat -Q -q"           # 默认
+HERMES_HOME=/Users/you/.hermes               # 每实例 Hermes 主目录
+HERMES_PROJECT_CONTEXT="Project session: ..."
+HERMES_TASK_TIMEOUT_MS=0                     # 0 = 不限
+HERMES_CHAT_TIMEOUT_MS=45000
+HERMES_WORKDIR=/Users/you/code/your-project
+```
+
+会话文件默认 `<repo>/.verbalcoding-session` (用 `HERMES_SESSION_FILE` 覆盖)。
+
+## 会话续接
+
+Hermes 是内建适配器中唯一支持会话续接的。每次成功 turn 后适配器将新 `session_id` 写入磁盘,下次调用前置 `--resume <id>`。`!session reset` (或 `!reset-session`) 清除。
+
+若 Hermes 在 stderr 输出 `session_id:` 之前被 abort,适配器会读取 `~/.hermes/sessions/session_<id>.json` 找回最后一条助手消息。
+
+## 详细进度
+
+详细模式下,适配器去掉 Hermes 的 `-Q` 静默标志,stdout 会流出 `┊ <emoji> <tool>` 预览,被汇总为一行进度事件 (文件读取、网页搜索、终端执行等)。非详细模式只把最终框内回答念出。
+
+## 切到 Hermes 的语音表述
+
+- en: `"switch to Hermes"`、`"ask Hermes ..."`
+- zh: `"切到 Hermes"`、`"问 Hermes"`
+
+## 坑
+
+- 跨代理切换时的 TTS 前缀按语言: `"Hermes says: "` / `"Hermes:"`。
+- `HERMES_HOME` 是最常用的项目级隔离开关。实例 `.env` 通常设 `HERMES_HOME=/Users/you/.hermes/profiles/<project>`。
+- 详细模式开启但 Hermes 以空框结束 (超时) 时,适配器会在放弃前抓会话 JSON 找最终回答。

package/docs/i18n/HARNESS_OPENCLAW.es.md

@@ -0,0 +1,41 @@
+# OpenClaw — Notas del Harness
+
+<p align="center">
+  <a href="../../README.es.md">README</a> ·
+  <a href="HARNESSES.es.md">Harnesses</a> ·
+  <a href="USAGE.es.md">Uso</a> ·
+  <a href="CONFIGURATION.es.md">Configuración</a>
+</p>
+
+OpenClaw es un agente de codificación de terminal open source. VerbalCoding lo invoca con `openclaw run`.
+
+## Instalación
+
+```bash
+openclaw run "hello"
+```
+
+## Configuración
+
+```bash
+# .env
+AGENT_BACKEND=openclaw
+OPENCLAW_COMMAND="openclaw run"
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## Frases de voz para cambiar a OpenClaw
+
+- en: `"switch to OpenClaw"`, `"switch to open claw"`
+- es: `"cambia a OpenClaw"`
+
+Alias: `openclaw`, `open claw`.
+
+## Trampas
+
+- **Sin reanudación por defecto.** Añade la flag adecuada en `OPENCLAW_COMMAND` si tu build la soporta.
+- **Progreso detallado.** Igual que OpenCode: keywords + posible LLM summarizer.
+- **Colisión de nombres.** Los alias `openclaw` y la etiqueta `OpenClaw` se distinguen claramente de `claude` / `claude code`; el modo strict del router no los confunde.

package/docs/i18n/HARNESS_OPENCLAW.fr.md

@@ -0,0 +1,41 @@
+# OpenClaw — Notes Harness
+
+<p align="center">
+  <a href="../../README.fr.md">README</a> ·
+  <a href="HARNESSES.fr.md">Harnesses</a> ·
+  <a href="USAGE.fr.md">Utilisation</a> ·
+  <a href="CONFIGURATION.fr.md">Configuration</a>
+</p>
+
+OpenClaw est un agent terminal open source. VerbalCoding l'invoque via `openclaw run`.
+
+## Installation
+
+```bash
+openclaw run "hello"
+```
+
+## Configuration
+
+```bash
+# .env
+AGENT_BACKEND=openclaw
+OPENCLAW_COMMAND="openclaw run"
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## Phrases vocales pour basculer vers OpenClaw
+
+- en: `"switch to OpenClaw"`, `"switch to open claw"`
+- fr: `"passe à OpenClaw"`
+
+Alias : `openclaw`, `open claw`.
+
+## Pièges
+
+- **Pas de reprise par défaut.** Ajoutez le flag adéquat à `OPENCLAW_COMMAND` si la build le supporte.
+- **Progression verbeuse.** Identique à OpenCode.
+- **Collision de noms.** Les alias `openclaw` et l'étiquette `OpenClaw` se distinguent clairement de `claude` / `claude code` ; le mode strict du routeur ne les confond pas.

package/docs/i18n/HARNESS_OPENCLAW.ja.md

@@ -0,0 +1,44 @@
+# OpenClaw — ハーネスノート
+
+<p align="center">
+  <a href="../../README.ja.md">README</a> ·
+  <a href="HARNESSES.ja.md">ハーネス</a> ·
+  <a href="USAGE.ja.md">使い方</a> ·
+  <a href="CONFIGURATION.ja.md">設定</a>
+</p>
+
+OpenClaw はオープンソースのターミナルコーディングエージェント。VerbalCoding は `openclaw run` で呼び出します。
+
+## インストール
+
+上流 OpenClaw インストールガイドに従い、確認:
+
+```bash
+openclaw run "hello"
+```
+
+## VerbalCoding 設定
+
+```bash
+# .env
+AGENT_BACKEND=openclaw
+# 任意
+OPENCLAW_COMMAND="openclaw run"             # 既定
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## OpenClaw へ切り替える音声表現
+
+- en: `"switch to OpenClaw"`, `"ask OpenClaw ..."`, `"switch to open claw"`
+- ja: `"OpenClaw に切り替えて"`
+
+エイリアス: `openclaw`, `open claw`。
+
+## 罠
+
+- **既定コマンドはセッション再開なし。** ビルドが resume フラグをサポートしていれば `OPENCLAW_COMMAND` に追加。
+- **詳細進捗。** OpenCode と同じく、`SMART_PROGRESS_API_KEY` なしではキーワードベースのラベルにフォールバック。
+- **名前衝突。** パーサのエイリアス `openclaw` とラベル `OpenClaw` は `claude` / `claude code` と明確に区別。strict モードのルータが両者を混同しません。

package/docs/i18n/HARNESS_OPENCLAW.ko.md

@@ -0,0 +1,44 @@
+# OpenClaw — 하니스 노트
+
+<p align="center">
+  <a href="../../README.ko.md">README</a> ·
+  <a href="HARNESSES.ko.md">하니스</a> ·
+  <a href="USAGE.ko.md">사용법</a> ·
+  <a href="CONFIGURATION.ko.md">설정</a>
+</p>
+
+OpenClaw는 오픈소스 터미널 코딩 에이전트. VerbalCoding은 `openclaw run`으로 호출해.
+
+## 설치
+
+상위 OpenClaw 설치 가이드를 따르고 확인:
+
+```bash
+openclaw run "hello"
+```
+
+## VerbalCoding 설정
+
+```bash
+# .env
+AGENT_BACKEND=openclaw
+# 선택
+OPENCLAW_COMMAND="openclaw run"             # 기본값
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## OpenClaw로 전환하는 음성 표현
+
+- en: `"switch to OpenClaw"`, `"ask OpenClaw ..."`, `"switch to open claw"`
+- ko: `"openclaw로 전환"`
+
+매처가 받는 별칭: `openclaw`, `open claw`.
+
+## 함정
+
+- **기본 명령에는 세션 재개 없음.** 빌드가 resume 플래그를 지원하면 `OPENCLAW_COMMAND`에 추가.
+- **상세 진행.** OpenCode와 동일 — `SMART_PROGRESS_API_KEY`가 없으면 키워드 기반 라벨로 fallback.
+- **이름 혼동.** 파서 별칭 `openclaw`와 사용자용 라벨 `OpenClaw`는 `claude` / `claude code`와 명확히 구분돼. strict 모드 라우터가 둘을 혼동하지 않아.

package/docs/i18n/HARNESS_OPENCLAW.ru.md

@@ -0,0 +1,41 @@
+# OpenClaw — Заметки по harness
+
+<p align="center">
+  <a href="../../README.ru.md">README</a> ·
+  <a href="HARNESSES.ru.md">Harness-ы</a> ·
+  <a href="USAGE.ru.md">Использование</a> ·
+  <a href="CONFIGURATION.ru.md">Настройка</a>
+</p>
+
+OpenClaw — open-source терминальный кодинг-агент. VerbalCoding вызывает его через `openclaw run`.
+
+## Установка
+
+```bash
+openclaw run "hello"
+```
+
+## Настройка
+
+```bash
+# .env
+AGENT_BACKEND=openclaw
+OPENCLAW_COMMAND="openclaw run"
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## Голосовые фразы для переключения на OpenClaw
+
+- en: `"switch to OpenClaw"`, `"switch to open claw"`
+- ru: `"переключись на OpenClaw"`
+
+Алиасы: `openclaw`, `open claw`.
+
+## Подводные камни
+
+- **По умолчанию нет возобновления.** Если сборка поддерживает — добавьте флаг в `OPENCLAW_COMMAND`.
+- **Подробный прогресс.** Как у OpenCode.
+- **Коллизия имён.** Алиас `openclaw` и метка `OpenClaw` чётко отделены от `claude` / `claude code`; strict-режим маршрутизатора их не путает.

package/docs/i18n/HARNESS_OPENCLAW.zh.md

@@ -0,0 +1,42 @@
+# OpenClaw — Harness 说明
+
+<p align="center">
+  <a href="../../README.zh.md">README</a> ·
+  <a href="HARNESSES.zh.md">Harness</a> ·
+  <a href="USAGE.zh.md">使用</a> ·
+  <a href="CONFIGURATION.zh.md">配置</a>
+</p>
+
+OpenClaw 是开源终端编码代理。VerbalCoding 通过 `openclaw run` 驱动。
+
+## 安装
+
+```bash
+openclaw run "hello"
+```
+
+## VerbalCoding 配置
+
+```bash
+# .env
+AGENT_BACKEND=openclaw
+# 可选
+OPENCLAW_COMMAND="openclaw run"
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## 切到 OpenClaw 的语音表述
+
+- en: `"switch to OpenClaw"`、`"switch to open claw"`
+- zh: `"切到 OpenClaw"`
+
+别名: `openclaw`、`open claw`。
+
+## 坑
+
+- **默认命令无会话续接。** 若构建支持 resume,加入 `OPENCLAW_COMMAND`。
+- **详细进度。** 与 OpenCode 相同 — 无 `SMART_PROGRESS_API_KEY` 时回退到关键字标签。
+- **名称冲突。** 解析器别名 `openclaw` 与用户标签 `OpenClaw` 与 `claude` / `claude code` 明确区分,strict 模式不会混淆。

package/docs/i18n/HARNESS_OPENCODE.es.md

@@ -0,0 +1,41 @@
+# OpenCode — Notas del Harness
+
+<p align="center">
+  <a href="../../README.es.md">README</a> ·
+  <a href="HARNESSES.es.md">Harnesses</a> ·
+  <a href="USAGE.es.md">Uso</a> ·
+  <a href="CONFIGURATION.es.md">Configuración</a>
+</p>
+
+OpenCode es un agente de codificación de terminal open source. VerbalCoding lo invoca con `opencode run`.
+
+## Instalación
+
+```bash
+opencode run "hello"
+```
+
+## Configuración
+
+```bash
+# .env
+AGENT_BACKEND=opencode
+OPENCODE_COMMAND="opencode run"
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## Frases de voz para cambiar a OpenCode
+
+- en: `"switch to OpenCode"`, `"switch to open code"`
+- es: `"cambia a OpenCode"`
+
+Alias: `opencode`, `open code`.
+
+## Trampas
+
+- **Sin reanudación por defecto.** Si tu build soporta resume, añádelo: `OPENCODE_COMMAND="opencode run --resume"`.
+- **Selección de modelo.** Añade `--model` u otras flags en `OPENCODE_COMMAND`.
+- **Progreso detallado.** Coincidencia por keywords sobre stdout/stderr (lectura, búsqueda, terminal). Sin `SMART_PROGRESS_API_KEY`, fallback a labels raw.