Auto-sync 2026-09-26 13:30:02
This commit is contained in:
parent
b79b782ddc
commit
721281312e
4 changed files with 246 additions and 135 deletions
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
id: concept-git-backup-recovery-protocol
|
||||
pageType: concept
|
||||
updatedAt: 2026-09-24T21:02:00+03:00
|
||||
updatedAt: 2026-09-26T16:15:48+03:00
|
||||
sourceIds:
|
||||
- source.agents
|
||||
- source.memory
|
||||
|
|
@ -10,36 +10,46 @@ tags:
|
|||
- recovery
|
||||
- state-git
|
||||
- config-git
|
||||
- obsidian-git
|
||||
- disaster-recovery
|
||||
- openclaw
|
||||
claims:
|
||||
- text: "Канонический операционный документ Git backup/recovery —
|
||||
/home/owner/.openclaw/workspace/OPENCLAW-GIT-BACKUP-RECOVERY.md:
|
||||
main-agent ОБЯЗАН читать его перед любой задачей backup/rollback/restore/recovery
|
||||
(Mandatory Reference Rule) и НЕ воспроизводить процедуру из памяти"
|
||||
(Mandatory Reference Rule, §20.21) и НЕ воспроизводить процедуру из памяти"
|
||||
status: supported
|
||||
confidence: 0.95
|
||||
evidence:
|
||||
- kind: source-file
|
||||
sourceId: source.agents
|
||||
path: sources/agents.md
|
||||
lines: "AGENTS.md §20.1, §20.12 (lines 437–760)"
|
||||
updatedAt: "2026-09-24T20:57:49.604Z"
|
||||
updatedAt: 2026-09-24T21:02:00+03:00
|
||||
- text: "Двухслойная архитектура: State Git (/home/owner/openclaw-backup/state-repo,
|
||||
приватный Forgejo Sergey/openclaw-clawpi-state, scope --all --include-secrets)
|
||||
+ Config Git (/home/owner/openclaw-backup/repo, Sergey/openclaw-clawpi);
|
||||
слои НЕ равнозначны и НЕ заменяют друг друга; full recovery требует обоих;
|
||||
--include-secrets — политика State Git, НЕ распространяется на Config Git"
|
||||
lines: "AGENTS.md §20.1 (lines 460–482), §20.21 (lines 1146–1174)"
|
||||
updatedAt: "2026-09-26T11:54:39.969Z"
|
||||
updatedAt: 2026-09-26T16:15:48+03:00
|
||||
- text: "Трёхслойная архитектура: State Git (/home/owner/openclaw-backup/state-repo,
|
||||
приватный Forgejo Sergey/openclaw-clawpi-state, native openclaw backup git
|
||||
с scope --all --include-secrets --push) + Config Git (/home/owner/openclaw-backup/repo,
|
||||
Sergey/openclaw-clawpi, отдельные credentials OPENCLAW_CONFIG_GIT_TOKEN +
|
||||
временный GIT_ASKPASS) + Obsidian Git (/home/owner/obsidian-vault,
|
||||
Sergey/obsidian-vault); три независимых репозитория с независимыми
|
||||
lifecycle/recovery-механизмами; НЕ объединяются в один backup repository;
|
||||
успешный backup одного слоя НЕ является успехом остальных; --include-secrets —
|
||||
политика только State Git; статус по §20.23 (2026-09-26): все слои ACTIVE"
|
||||
status: supported
|
||||
confidence: 0.95
|
||||
evidence:
|
||||
- kind: source-file
|
||||
sourceId: source.agents
|
||||
path: sources/agents.md
|
||||
lines: "AGENTS.md §20.2–20.3 (lines 459–508)"
|
||||
updatedAt: "2026-09-24T20:57:49.604Z"
|
||||
updatedAt: 2026-09-24T21:02:00+03:00
|
||||
lines: "AGENTS.md §20.2 (lines 484–515), §20.3 (lines 517–561), §20.5 (lines 599–653), §20.7 (lines 683–734), §20.23 (lines 1226–1260)"
|
||||
updatedAt: "2026-09-26T11:54:39.969Z"
|
||||
- kind: source-file
|
||||
sourceId: source.memory
|
||||
path: sources/memory.md
|
||||
lines: "MEMORY.md §3, lines 52–58 (OpenClaw Git Backup / Recovery)"
|
||||
updatedAt: "2026-09-26T11:56:18.417Z"
|
||||
updatedAt: 2026-09-26T16:15:48+03:00
|
||||
- text: "24h автоматический State Git backup ACTIVE — production-механизм,
|
||||
отключать только по явному приказу пользователя; 'автоматизация включена' ≠
|
||||
'backup успешен': здоровье доказывают 'backup created + pushed=true'
|
||||
|
|
@ -51,185 +61,286 @@ claims:
|
|||
- kind: source-file
|
||||
sourceId: source.agents
|
||||
path: sources/agents.md
|
||||
lines: "AGENTS.md §20.4 (lines 510–536)"
|
||||
updatedAt: "2026-09-24T20:57:49.604Z"
|
||||
lines: "AGENTS.md §20.4 (lines 563–597)"
|
||||
updatedAt: "2026-09-26T11:54:39.969Z"
|
||||
- kind: source-file
|
||||
sourceId: source.memory
|
||||
path: sources/memory.md
|
||||
lines: "MEMORY.md §3, line 30 (OpenClaw Git Backup / Recovery)"
|
||||
updatedAt: "2026-09-24T20:58:10.382Z"
|
||||
updatedAt: 2026-09-24T21:02:00+03:00
|
||||
- text: "Рутинг интентов: 'сделай backup/закоммить состояние' → State Git backup
|
||||
(--all --push) через setup-agent + верификация evaluator-agent; 'покажи backup'
|
||||
→ setup-agent; 'проверь backup' → setup-agent → evaluator-agent;
|
||||
'откати/восстанови' → destructive (exact SHA, верификация снапшота, safety-backup
|
||||
live state, остановка Gateway перед заменой БД, staged restore, post-restore
|
||||
validation, health-check, новый backup после); 'восстанови всю систему' →
|
||||
Config Git + State Git; 'посмотри предыдущий backup' ≠ rollback"
|
||||
lines: "MEMORY.md §3, lines 52–54 (OpenClaw Git Backup / Recovery, State Git)"
|
||||
updatedAt: "2026-09-26T11:56:18.417Z"
|
||||
updatedAt: 2026-09-26T16:15:48+03:00
|
||||
- text: "Obsidian Git (третий независимый слой): host cron */15 →
|
||||
/usr/local/bin/obsidian-docker-sync.sh → Docker obsidian-git-sync
|
||||
(commit+push только при изменениях, лог /home/owner/obsidian-sync.log);
|
||||
SSH Ed25519 Deploy Key /home/owner/.ssh/obsidian-vault-sync (Write Access)
|
||||
+ dedicated known_hosts /home/owner/.ssh/obsidian-vault-known_hosts,
|
||||
IdentitiesOnly=yes, StrictHostKeyChecking=yes, BatchMode=yes;
|
||||
host ~/.git-credentials НЕ используется для аутентификации и НЕ монтируется
|
||||
в Docker-контейнер; concurrency protection — flock /tmp/obsidian-docker-sync.lock
|
||||
(конкурентный запуск завершается без изменений репозитория);
|
||||
НЕ часть native openclaw backup git; независимый lifecycle и recovery"
|
||||
status: supported
|
||||
confidence: 0.95
|
||||
evidence:
|
||||
- kind: source-file
|
||||
sourceId: source.agents
|
||||
path: sources/agents.md
|
||||
lines: "AGENTS.md §20.5–20.8 (lines 538–659)"
|
||||
updatedAt: "2026-09-24T20:57:49.604Z"
|
||||
updatedAt: 2026-09-24T21:02:00+03:00
|
||||
- text: "State Git safety rules (§20.9): никаких ordinary commits и non-backup-файлов
|
||||
(README.md — исторический контент, не трогать), без git reset --hard как замены
|
||||
restore, без замены БД при работающем Gateway, без restore без верификации
|
||||
и safety-copy, без автоудаления истории/legacy-БД, без автореактивации репо,
|
||||
без публичного экспорта, без history rewrite без approval;
|
||||
'non-backup commits' → не создавать новое репо автоматически"
|
||||
lines: "AGENTS.md §20.7 (lines 683–734), §20.8 (lines 736–791), §20.9 (lines 793–833), §20.10 (lines 835–848)"
|
||||
updatedAt: "2026-09-26T11:54:39.969Z"
|
||||
- kind: source-file
|
||||
sourceId: source.memory
|
||||
path: sources/memory.md
|
||||
lines: "MEMORY.md §3, lines 56, 60, 62 (Obsidian Git)"
|
||||
updatedAt: "2026-09-26T11:56:18.417Z"
|
||||
updatedAt: 2026-09-26T16:15:48+03:00
|
||||
- text: "Рутинг интентов (§20.11–20.16): 'сделай backup/закоммить состояние'
|
||||
(default) → State Git backup (--all + push) через setup-agent + верификация
|
||||
evaluator-agent; явный 'Config backup' → Config Git; явный 'сохрани Obsidian'
|
||||
→ Obsidian Git; 'проверь Obsidian backup' → cron → фактическое исполнение
|
||||
скрипта → результат синхронизации → local/remote HEAD (наличие cron-записи
|
||||
само по себе НЕ доказательство); 'полный backup' → все три слоя, каждый слой
|
||||
отчитывается отдельно (SUCCESS/NO CHANGES/FAILED; частичный результат ≠
|
||||
полный успех); 'откати/восстанови' → destructive (exact revision,
|
||||
верификация снапшота, safety-backup live state, остановка Gateway перед
|
||||
заменой БД, staged restore, post-restore validation, health-check, новый
|
||||
backup); 'восстанови всю систему' → State + Config + Obsidian Git
|
||||
(последовательность ТОЛЬКО в каноническом документе);
|
||||
'покажи предыдущий backup' — просмотр, НЕ rollback"
|
||||
status: supported
|
||||
confidence: 0.95
|
||||
evidence:
|
||||
- kind: source-file
|
||||
sourceId: source.agents
|
||||
path: sources/agents.md
|
||||
lines: "AGENTS.md §20.9 (lines 661–692)"
|
||||
updatedAt: "2026-09-24T20:57:49.604Z"
|
||||
updatedAt: 2026-09-24T21:02:00+03:00
|
||||
- text: "Separation of Responsibilities (§20.10): main-agent = оркестрация/рутинг/
|
||||
lines: "AGENTS.md §20.11–20.16 (lines 851–1047)"
|
||||
updatedAt: "2026-09-26T11:54:39.969Z"
|
||||
updatedAt: 2026-09-26T16:15:48+03:00
|
||||
- text: "State Git safety rules (§20.17): никаких ordinary commits и
|
||||
non-backup-файлов, без git reset --hard как замены OpenClaw restore, без
|
||||
замены live-БД при работающем Gateway, без restore без верификации снапшота
|
||||
и без safety-copy live state, без автоудаления backup-истории/legacy-БД, без
|
||||
авторекреации репозитория, без публичного экспорта, без history rewrite без
|
||||
явного user approval; 'non-backup commits' → НЕ создавать новое репо
|
||||
автоматически, следовать канонической процедуре; Obsidian Git safety rules
|
||||
(§20.18): запрет авто-удаления репо/.git, git init, git reset --hard,
|
||||
git push --force, замены Forgejo-репозитория, перезаписи remote-истории;
|
||||
сбой синхронизации НЕ является причиной рекреации репозитория"
|
||||
status: supported
|
||||
confidence: 0.95
|
||||
evidence:
|
||||
- kind: source-file
|
||||
sourceId: source.agents
|
||||
path: sources/agents.md
|
||||
lines: "AGENTS.md §20.17 (lines 1049–1075), §20.18 (lines 1077–1095)"
|
||||
updatedAt: "2026-09-26T11:54:39.969Z"
|
||||
updatedAt: 2026-09-26T16:15:48+03:00
|
||||
- text: "Separation of Responsibilities (§20.19): main-agent = оркестрация/рутинг/
|
||||
approval/отчёты, setup-agent = инфраструктурное исполнение,
|
||||
evaluator-agent = вердикт; main-agent НЕ самоверифицирует инфраструктурный
|
||||
recovery; full procedure НЕ копируется в AGENTS.md/MEMORY.md
|
||||
(context-minimization §20.11)"
|
||||
evaluator-agent = вердикт корректности (authoritative); main-agent НЕ
|
||||
самоверифицирует инфраструктурные изменения; полная процедура НЕ копируется
|
||||
в AGENTS.md/MEMORY.md (context-minimization §20.20) — там только
|
||||
routing/authority/safety-правила и стабильные architectural facts"
|
||||
status: supported
|
||||
confidence: 0.95
|
||||
evidence:
|
||||
- kind: source-file
|
||||
sourceId: source.agents
|
||||
path: sources/agents.md
|
||||
lines: "AGENTS.md §20.10–20.11 (lines 694–732)"
|
||||
updatedAt: "2026-09-24T20:57:49.604Z"
|
||||
updatedAt: 2026-09-24T21:02:00+03:00
|
||||
lines: "AGENTS.md §20.19–20.20 (lines 1097–1144)"
|
||||
updatedAt: "2026-09-26T11:54:39.969Z"
|
||||
updatedAt: 2026-09-26T16:15:48+03:00
|
||||
- text: "Integration test: /home/owner/openclaw-backup/integration-test-git-backups.sh —
|
||||
успех = PASS / FAIL=0 (auth, backup, commit/no-change, push, sync, scheduled
|
||||
mechanisms для обоих слоёв); тест диагностический, НЕ должен менять инфраструктуру;
|
||||
integration-test-run2.log = evidence базового теста, не operational truth"
|
||||
успех = PASS / FAIL=0; валидирует State Git и Config Git (authentication,
|
||||
backup, commit/no-change handling, push, local/remote synchronization,
|
||||
scheduled mechanisms); тест диагностический, НЕ должен менять
|
||||
инфраструктуру/credentials/remotes/automation/историю;
|
||||
integration-test-run2.log = evidence базового теста, не operational truth;
|
||||
Obsidian Git проверяется отдельно из-за независимого lifecycle и
|
||||
synchronization-механизма"
|
||||
status: supported
|
||||
confidence: 0.95
|
||||
evidence:
|
||||
- kind: source-file
|
||||
sourceId: source.agents
|
||||
path: sources/agents.md
|
||||
lines: "AGENTS.md §20.13 (lines 760–766)"
|
||||
updatedAt: "2026-09-24T20:57:49.604Z"
|
||||
updatedAt: 2026-09-24T21:02:00+03:00
|
||||
- text: "Final state (MEMORY.md 2026-09-24): 24h State Git backup active; 24h Config Git
|
||||
backup через systemd --user timer active; полный recovery = State Git + Config Git;
|
||||
интеграционный тест прошёл PASS / FAIL=0; operational truth — Git-репозитории,
|
||||
результаты бэкапов, Config Git timer, State Git automation"
|
||||
status: supported
|
||||
confidence: 0.9
|
||||
evidence:
|
||||
lines: "AGENTS.md §20.22 (lines 1176–1224)"
|
||||
updatedAt: "2026-09-26T11:54:39.969Z"
|
||||
- kind: source-file
|
||||
sourceId: source.memory
|
||||
path: sources/memory.md
|
||||
lines: "MEMORY.md §3, line 30 (OpenClaw Git Backup / Recovery)"
|
||||
updatedAt: "2026-09-24T20:58:10.382Z"
|
||||
updatedAt: 2026-09-24T21:02:00+03:00
|
||||
- text: "КОНТРАДИКЦИЯ (открытый вопрос): AGENTS.md §20.2 помечает Config Git как
|
||||
'ARCHITECTURE DEFINED / CONFIGURATION NOT YET COMPLETED', при этом MEMORY.md,
|
||||
канонический документ (timer IMPLEMENTED/ACTIVE) и live-проверка 2026-09-24
|
||||
(openclaw-config-backup.timer active, config-git-backup.sh существует,
|
||||
последний trigger 2026-09-24 04:35 MSK) указывают на реализованную
|
||||
24h-автоматизацию Config Git; до явного решения владельца Config Git НЕ
|
||||
считается операционным recovery-источником (правило §20.2 в силе)"
|
||||
status: disputed
|
||||
confidence: 0.6
|
||||
lines: "MEMORY.md §3, line 64 (Integration test, Obsidian Git отдельно)"
|
||||
updatedAt: "2026-09-26T11:56:18.417Z"
|
||||
updatedAt: 2026-09-26T16:15:48+03:00
|
||||
- text: "Final state (2026-09-26, AGENTS.md §20.23 + MEMORY.md §3): все три слоя
|
||||
ACTIVE/operational, private Forgejo, независимы — State Git (24h, native
|
||||
openclaw backup git, --all --include-secrets --push), Config Git (24h,
|
||||
systemd --user timer, отдельные credentials), Obsidian Git (cron */15,
|
||||
Docker-синхронизация, SSH Deploy Key); integration test ранее прошёл
|
||||
PASS / FAIL=0 (State+Config); operational truth — Git-репозитории,
|
||||
результаты бэкапов, automation (timer/cron)"
|
||||
status: supported
|
||||
confidence: 0.95
|
||||
evidence:
|
||||
- kind: source-file
|
||||
sourceId: source.agents
|
||||
path: sources/agents.md
|
||||
lines: "AGENTS.md §20.2 (line 473)"
|
||||
updatedAt: "2026-09-24T20:57:49.604Z"
|
||||
lines: "AGENTS.md §20.23 (lines 1226–1260)"
|
||||
updatedAt: "2026-09-26T11:54:39.969Z"
|
||||
- kind: source-file
|
||||
sourceId: source.memory
|
||||
path: sources/memory.md
|
||||
lines: "MEMORY.md §3, line 30"
|
||||
updatedAt: "2026-09-24T20:58:10.382Z"
|
||||
updatedAt: 2026-09-24T21:02:00+03:00
|
||||
lines: "MEMORY.md §3, lines 52–66 (OpenClaw Git Backup / Recovery)"
|
||||
updatedAt: "2026-09-26T11:56:18.417Z"
|
||||
updatedAt: 2026-09-26T16:15:48+03:00
|
||||
- text: "РАЗРЕШЁННОЕ противоречие (было открытым на 2026-09-24): старый AGENTS.md
|
||||
§20.2 помечал Config Git как 'ARCHITECTURE DEFINED / CONFIGURATION NOT YET
|
||||
COMPLETED', при этом MEMORY.md и канонический документ указывали на
|
||||
реализованную 24h-автоматизацию; переписанный AGENTS.md (2026-09-26)
|
||||
разрешает противоречие: §20.5 помечает Config Git IMPLEMENTED / ACTIVE
|
||||
(backup/restore-скрипты, systemd user timer), §20.23 (2026-09-26) помечает
|
||||
все три слоя ACTIVE/operational"
|
||||
status: supported
|
||||
confidence: 0.95
|
||||
evidence:
|
||||
- kind: source-file
|
||||
sourceId: source.agents
|
||||
path: sources/agents.md
|
||||
lines: "AGENTS.md §20.5 (lines 599–653, line 625 IMPLEMENTED / ACTIVE), §20.23 (lines 1238–1241)"
|
||||
updatedAt: "2026-09-26T11:54:39.969Z"
|
||||
- kind: source-file
|
||||
sourceId: source.memory
|
||||
path: sources/memory.md
|
||||
lines: "MEMORY.md §3, line 55 (Config Git, systemd --user timer)"
|
||||
updatedAt: "2026-09-26T11:56:18.417Z"
|
||||
updatedAt: 2026-09-26T16:15:48+03:00
|
||||
---
|
||||
|
||||
# Concept: Git Backup & Recovery Protocol (AGENTS.md §20)
|
||||
|
||||
## Summary
|
||||
Двухслойный Git-бэкап OpenClaw (State Git + Config Git) с жёстким разделением ролей:
|
||||
канонический операционный документ — `OPENCLAW-GIT-BACKUP-RECOVERY.md`; main-agent
|
||||
никогда не исполняет инфраструктурные команды и не самоверифицируется — исполнение
|
||||
делегировано setup-agent, вердикт корректности — evaluator-agent.
|
||||
Трёхслойный Git-бэкап OpenClaw (State Git + Config Git + Obsidian Git) с жёстким
|
||||
разделением ролей: канонический операционный документ — `OPENCLAW-GIT-BACKUP-RECOVERY.md`;
|
||||
main-agent никогда не исполняет инфраструктурные команды и не самоверифицируется —
|
||||
исполнение делегировано setup-agent, вердикт корректности — evaluator-agent.
|
||||
Статус 2026-09-26 (§20.23): все три слоя ACTIVE/operational, private Forgejo, независимы.
|
||||
|
||||
## Description
|
||||
### Архитектура (§20.2–20.3)
|
||||
- **State Git** — бэкап внутреннего состояния OpenClaw (SQLite):
|
||||
### Архитектура (§20.2, 20.3, 20.5, 20.7)
|
||||
Три независимых Git-слоя — три независимых репозитория и три независимых
|
||||
lifecycle/recovery-механизма. Слои MUST NOT объединяться в один backup repository;
|
||||
успешный backup одного слоя MUST NOT сообщаться как успех остальных слоёв.
|
||||
- **State Git** — внутреннее состояние OpenClaw (SQLite):
|
||||
`/home/owner/openclaw-backup/state-repo` → приватный Forgejo
|
||||
`https://git.datacloudport.ru/Sergey/openclaw-clawpi-state.git`.
|
||||
Статус по AGENTS.md: IMPLEMENTED / ACTIVE. Scope: `--all --include-secrets`
|
||||
(политика специфична для State Git; на Config Git распространять нельзя).
|
||||
Репозиторий PRIVATE и содержит credential-bearing backup material.
|
||||
- **Config Git** — конфигурация, credentials, persistent workspace-файлы:
|
||||
`https://git.datacloudport.ru/Sergey/openclaw-clawpi-state.git`. Статус:
|
||||
IMPLEMENTED / ACTIVE. Native `openclaw backup git` с scope
|
||||
`--all --include-secrets --push`; `--include-secrets` — политика ТОЛЬКО State Git,
|
||||
НЕ распространяется на Config/Obsidian Git. Репозиторий PRIVATE и содержит
|
||||
credential-bearing backup material.
|
||||
- **Config Git** — конфигурация, credentials, selected persistent-файлы:
|
||||
`/home/owner/openclaw-backup/repo` → `https://git.datacloudport.ru/Sergey/openclaw-clawpi.git`.
|
||||
Статус по AGENTS.md §20.2: ARCHITECTURE DEFINED / CONFIGURATION NOT YET COMPLETED —
|
||||
**противоречит** MEMORY.md и каноническому документу, где 24h timer
|
||||
`openclaw-config-backup.timer` отмечен IMPLEMENTED/ACTIVE; live-проверка 2026-09-24:
|
||||
timer active (next trigger 2026-09-25 04:31 MSK), `config-git-backup.sh` (600) существует.
|
||||
До явной верификации Config Git НЕ является операционным recovery-источником.
|
||||
- Слой ≠ слой: State Git alone НЕ является полным бэкапом машины/системы.
|
||||
Статус: IMPLEMENTED / ACTIVE (§20.5). Скрипты `config-git-backup.sh` /
|
||||
`config-git-restore.sh`; автоматизация — systemd user timer
|
||||
`openclaw-config-backup.{service,timer}`. Независим от State Git; отдельные
|
||||
credentials (§20.6: `OPENCLAW_CONFIG_GIT_TOKEN` в `/home/owner/.openclaw/.env` +
|
||||
временный `GIT_ASKPASS`, временное auth-состояние чистится после исполнения);
|
||||
НЕ заменяется native State Git backup.
|
||||
- **Obsidian Git** — knowledge vault / Markdown / документация:
|
||||
`/home/owner/obsidian-vault` → `git@git.datacloudport.ru:Sergey/obsidian-vault.git`.
|
||||
Статус: IMPLEMENTED / ACTIVE (§20.7). НЕ является частью State Git и Config Git;
|
||||
MUST NOT добавляться в native `openclaw backup git` pipeline.
|
||||
|
||||
### Автоматический backup (§20.4)
|
||||
24h State Git backup ACTIVE. Ключевое правило: активный scheduler entry — НИКОГДА
|
||||
не доказательство успешного бэкапа; доказательство = `backup created + pushed=true`
|
||||
или валидный `noChanges=true`. Сбой = pipeline degraded до диагностики + успешного прогона.
|
||||
### Автоматический backup (§20.4, 20.5, 20.8)
|
||||
- **State Git**: 24h OpenClaw scheduled backup — production-механизм, отключается
|
||||
только по явному приказу пользователя. Ключевое правило: активный scheduler entry —
|
||||
НИКОГДА не доказательство успешного бэкапа; доказательство = `backup created +
|
||||
pushed=true` или валидный `noChanges=true`. Сбой = pipeline degraded до
|
||||
диагностики + успешного прогона.
|
||||
- **Config Git**: 24h через `systemd --user` timer `openclaw-config-backup.timer`.
|
||||
- **Obsidian Git**: host cron `*/15 * * * *` → `/usr/local/bin/obsidian-docker-sync.sh`
|
||||
→ Docker `obsidian-git-sync` → при изменениях: commit + push (лог
|
||||
`/home/owner/obsidian-sync.log`); без изменений — commit не создаётся
|
||||
(«Нет изменений.»). Concurrency protection: `flock` на
|
||||
`/tmp/obsidian-docker-sync.lock`; конкурентный запуск MUST завершиться без
|
||||
изменений репозитория (§20.10).
|
||||
|
||||
### Рутинг по интентам пользователя (§20.5–20.8)
|
||||
### Безопасность Obsidian Git (§20.9)
|
||||
Dedicated SSH Ed25519 key `/home/owner/.ssh/obsidian-vault-sync` (Forgejo Deploy Key
|
||||
с Write Access); dedicated `known_hosts`
|
||||
`/home/owner/.ssh/obsidian-vault-known_hosts`; `IdentitiesOnly=yes`,
|
||||
`StrictHostKeyChecking=yes`, `BatchMode=yes`; host `~/.git-credentials` MUST NOT
|
||||
использоваться для аутентификации и MUST NOT монтироваться в Docker-контейнер;
|
||||
пароли/токены MUST NOT встроены в `obsidian-docker-sync.sh`.
|
||||
|
||||
### Рутинг по интентам пользователя (§20.11–20.16)
|
||||
| Интент | Маршрут | Ключевые требования |
|
||||
|---|---|---|
|
||||
| «сделай backup» / «закоммить состояние» | main → setup-agent → evaluator-agent | canonical doc → `--all --push` → верификация → отчёт commit/noChanges/pushed |
|
||||
| «покажи backup» | main → setup-agent | история по каноническому документу |
|
||||
| «проверь backup» | main → setup-agent → evaluator-agent | commit ≠ валидность; внешний успех = push; restore-eligibility = прохождение верификации снапшота |
|
||||
| «откати» / «восстанови из backup» | main → setup-agent → evaluator-agent | destructive: явный запрос, exact SHA, верификация снапшота, safety-backup live state, остановка Gateway, staged restore, post-restore validation, health-check, новый backup |
|
||||
| «восстанови всю систему» | main → setup-agent → evaluator-agent | Config Git + State Git; последовательность ТОЛЬКО в каноническом документе |
|
||||
| «сделай backup» / «закоммить состояние» (default) | main → setup-agent → evaluator-agent | canonical doc → State Git `--all` + push → верификация → отчёт |
|
||||
| «Config backup» (явно) | main → setup-agent → evaluator-agent | Config Git по каноническому документу |
|
||||
| «сохрани Obsidian» / «сделай backup Obsidian» (явно) | main → setup-agent → evaluator-agent | Obsidian Git |
|
||||
| «проверь Obsidian backup» | main → setup-agent → evaluator-agent | cron → фактическое исполнение скрипта → результат синхронизации → local HEAD → remote HEAD; наличие cron-записи ≠ успех |
|
||||
| «полный backup» | main → setup-agent → evaluator-agent | все три слоя (State + Config + Obsidian); каждый слой отчитывается отдельно (SUCCESS / NO CHANGES / FAILED); частичный результат ≠ «полный backup успешен» |
|
||||
| «откати» / «восстанови из backup» | main → setup-agent → evaluator-agent | destructive: явный запрос, exact revision, canonical doc, верификация снапшота, safety-copy live state, остановка Gateway, staged restore, post-restore validation, health-check, новый backup |
|
||||
| «восстанови всю систему» | main → setup-agent → evaluator-agent | Full System Recovery = State + Config + Obsidian Git (§20.16); последовательность ТОЛЬКО в каноническом документе |
|
||||
| «покажи/посмотри предыдущий backup» | main → setup-agent | только просмотр; НЕ интерпретировать как rollback |
|
||||
|
||||
«Посмотри предыдущий backup» — просмотр, НЕ rollback; эти действия не тождественны.
|
||||
Backup Verification (§20.14): активный scheduler — недостаточное доказательство;
|
||||
верификация только по фактическому execution evidence: State Git — backup result /
|
||||
pushed=true / noChanges=true; Config Git — исполнение скрипта, commit/no-change,
|
||||
push, local/remote sync; Obsidian Git — исполнение cron, результат скрипта,
|
||||
local/remote HEAD. При проблемах синхронизации авторитетно состояние remote-репозитория.
|
||||
|
||||
### Safety rules State Git (§20.9)
|
||||
Никаких ordinary commits/non-backup-файлов (наследственный README.md — исторический
|
||||
контент, не изменять/не удалять); без `git reset --hard` как замены OpenClaw restore;
|
||||
без деструктивной замены БД при работающем Gateway; без restore без верификации
|
||||
и без safety-copy live state; без автоудаления backup-истории и legacy-БД;
|
||||
без автореактивации репозитория; без публичного экспорта; без history rewrite
|
||||
без явного approval. Отчёт «repository history contains non-backup commits» →
|
||||
НЕ создавать новое репо автоматически, следовать канонической процедуре.
|
||||
### Safety rules (State §20.17, Obsidian §20.18)
|
||||
- **State Git**: никаких ordinary commits и non-backup-файлов; без `git reset --hard`
|
||||
как замены OpenClaw restore; без замены live-БД при работающем Gateway; без restore
|
||||
без верификации снапшота и без safety-copy live state; без автоудаления
|
||||
backup-истории и legacy-БД; без авторекреации репозитория; без публичного экспорта;
|
||||
без history rewrite без явного user approval. Отчёт «repository history contains
|
||||
non-backup commits» → НЕ создавать новое репо автоматически, следовать канонической
|
||||
процедуре.
|
||||
- **Obsidian Git**: MUST NOT автоматически — удалять репозиторий/`.git`, `git init`,
|
||||
`git reset --hard`, `git push --force`, заменять Forgejo-репозиторий, переписывать
|
||||
remote-историю. Сбой синхронизации НЕ является причиной рекреации репозитория:
|
||||
сохранить локальное репо и сначала определить точный сбой.
|
||||
|
||||
### Ответственность и минимизация контекста (§20.10–20.12)
|
||||
- main-agent = оркестрация/рутинг/user approval/отчётность
|
||||
### Ответственность и минимизация контекста (§20.19–20.20)
|
||||
- main-agent = оркестрация/рутинг/user approval/отчётность (НЕ самоверификация
|
||||
инфраструктурных мутаций)
|
||||
- setup-agent = инфраструктурное исполнение (backup/restore/репозиторий)
|
||||
- evaluator-agent = вердикт корректности (authoritative, без самоверификации main)
|
||||
- evaluator-agent = вердикт корректности (authoritative)
|
||||
- Полная процедура НЕ копируется в AGENTS.md / MEMORY.md; там только
|
||||
routing/authority/safety-правила и стабильные final-state-факты.
|
||||
- Mandatory Reference: любой интент backup/snapshot/restore/rollback/recovery →
|
||||
сначала читать `OPENCLAW-GIT-BACKUP-RECOVERY.md`.
|
||||
routing/authority/safety-правила и стабильные architectural facts.
|
||||
|
||||
### Integration test (§20.13)
|
||||
`/home/owner/openclaw-backup/integration-test-git-backups.sh`: успех = `PASS / FAIL=0`
|
||||
(аутентификация, backup, commit/no-change, push, sync, scheduled mechanisms — оба слоя).
|
||||
Тест диагностический: не модифицирует инфраструктуру, credentials, remotes,
|
||||
automation, историю. Детальный вывод `integration-test-run2.log` — evidence успешного
|
||||
базового теста, НЕ operational source of truth.
|
||||
### Mandatory Reference Rule (§20.21)
|
||||
Любой интент backup/snapshot/commit state/restore/rollback/recovery/disaster
|
||||
recovery/recover OpenClaw|database|configuration|Obsidian → сначала читать
|
||||
`OPENCLAW-GIT-BACKUP-RECOVERY.md`.
|
||||
|
||||
### Final state (MEMORY.md, 2026-09-24)
|
||||
State Git: 24h автоматический backup — active. Config Git: 24h автоматический backup
|
||||
через `systemd --user` timer — active (live-подтверждено 2026-09-24). Полный recovery
|
||||
использует оба слоя. Интеграционный тест: PASS / FAIL=0. Operational truth —
|
||||
Git-репозитории, результаты бэкапов OpenClaw, Config Git timer, State Git automation.
|
||||
### Integration test (§20.22)
|
||||
`/home/owner/openclaw-backup/integration-test-git-backups.sh`: успех = `PASS / FAIL=0`.
|
||||
Валидирует State Git и Config Git (аутентификация, backup, commit/no-change handling,
|
||||
push, local/remote synchronization, scheduled mechanisms). Тест диагностический:
|
||||
НЕ модифицирует инфраструктуру, credentials, remotes, automation, историю. Детальный
|
||||
вывод `integration-test-run2.log` — evidence успешного базового теста, НЕ operational
|
||||
source of truth. Obsidian Git проверяется отдельно — независимый lifecycle и
|
||||
synchronization-механизм.
|
||||
|
||||
### Final state (§20.23, 2026-09-26)
|
||||
Все три слоя ACTIVE/operational, private Forgejo, независимы:
|
||||
- **State Git**: ACTIVE, каждые 24h (native OpenClaw backup).
|
||||
- **Config Git**: ACTIVE, systemd user timer.
|
||||
- **Obsidian Git**: ACTIVE, cron */15, Docker-синхронизация, SSH Deploy Key.
|
||||
|
||||
Противоречие 2026-09-24 про Config Git («NOT YET COMPLETED») разрешено: переписанный
|
||||
AGENTS.md §20.5 помечает Config Git IMPLEMENTED / ACTIVE, §20.23 (2026-09-26) — все
|
||||
слои ACTIVE. Operational truth — Git-репозитории, результаты бэкапов,
|
||||
automation (timer/cron).
|
||||
|
||||
## Tags
|
||||
- git-backup
|
||||
- recovery
|
||||
- state-git
|
||||
- config-git
|
||||
- obsidian-git
|
||||
- disaster-recovery
|
||||
- openclaw
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
id: entity-Infrastructure
|
||||
pageType: entity
|
||||
updatedAt: 2026-09-10T04:50:00.000Z
|
||||
updatedAt: 2026-09-26T16:17:10+03:00
|
||||
confidence: 0.9
|
||||
status: active
|
||||
sourceIds:
|
||||
|
|
@ -327,7 +327,7 @@ claims:
|
|||
- Diagnostic Command Convention (§18, AGENTS.md 2026-08-22): read-only verification chains (grep, head, wc, ls, file-existence checks, diff-checks) MUST end with neutral exit (`; true` / `|| true`) so "no match" is valid result not Exec failed; exit codes of mutation/build/deploy/sync commands must NEVER be masked
|
||||
- Ingest self-loop root fix (2026-08-22, user decision): volatile wiki state (page/claim counts, lint counts, last-ingest timestamps, bridge artifact counts) НЕ пишется в MEMORY.md и source-файлы — источник: CHANGELOG.md + concepts/Bridge-Mode.md; правило закреплено: AGENTS.md §16 «Volatile-state ban» + constraint в payload cron wiki-ingest-event; причина: такие записи сами бампали mtime MEMORY.md → cron (30m) видел «изменение источника» → idempotent self-loop (2026-08-22: 6 циклов 00:32→08:09 при semantic delta=0)
|
||||
- north-mini-code-1.0 CANCELLED (2026-08-22, user decision): не устанавливать, не использовать; на Dell Precision 5560 (Ollama, 18 моделей) не установлен; решение закрыло 3-дневное ожидание установки (08-19→08-22) и план 3-модельного coding-теста
|
||||
- OpenClaw Git backup/recovery (AGENTS.md §20, 2026-09-24): два слоя — State Git `/home/owner/openclaw-backup/state-repo` → приватный Forgejo `Sergey/openclaw-clawpi-state` (scope `--all --include-secrets`, 24h автоматический backup ACTIVE) + Config Git `/home/owner/openclaw-backup/repo` → `Sergey/openclaw-clawpi` (24h через `systemd --user` timer `openclaw-config-backup.timer`, live-active 2026-09-24); AGENTS.md §20.2 при этом помечает Config Git «NOT YET COMPLETED» — contradicts MEMORY.md/канон-дока, открытый вопрос; канонический операционный документ — `OPENCLAW-GIT-BACKUP-RECOVERY.md`; интеграционный тест `integration-test-git-backups.sh` (успех = PASS/FAIL=0); full recovery = State + Config Git; детали — concepts/Git-Backup-Recovery-Protocol.md
|
||||
- OpenClaw Git backup/recovery (AGENTS.md §20, трёхслойная архитектура, final state 2026-09-26 по §20.23): State Git `/home/owner/openclaw-backup/state-repo` → приватный Forgejo `Sergey/openclaw-clawpi-state` (native `openclaw backup git`, `--all --include-secrets --push`, 24h автоматический backup ACTIVE) + Config Git `/home/owner/openclaw-backup/repo` → `Sergey/openclaw-clawpi` (24h через `systemd --user` timer, отдельные credentials `OPENCLAW_CONFIG_GIT_TOKEN` + временный `GIT_ASKPASS`) + Obsidian Git `/home/owner/obsidian-vault` → `Sergey/obsidian-vault` (host cron */15 → Docker `obsidian-git-sync`, SSH Ed25519 Deploy Key, dedicated `known_hosts`, host `~/.git-credentials` не монтируется в контейнер); три слоя независимы и НЕ объединяются в один backup repository; противоречие 2026-09-24 про Config Git «NOT YET COMPLETED» разрешено — AGENTS.md §20.5/§20.23 (2026-09-26) помечает Config Git IMPLEMENTED/ACTIVE, все три слоя ACTIVE/operational; канонический операционный документ — `OPENCLAW-GIT-BACKUP-RECOVERY.md`; интеграционный тест `integration-test-git-backups.sh` (успех = PASS/FAIL=0; валидирует State+Config Git, Obsidian Git проверяется отдельно); full recovery = State + Config + Obsidian Git; детали — concepts/Git-Backup-Recovery-Protocol.md
|
||||
- Pi-hole (FTL v6) на clawpi (проверено 2026-08-24): контейнер pihole (docker на clawpi, healthy); Web UI http://192.168.1.20:8080/admin, DNS 192.168.1.20:53; версии Core v6.4.3, Web v6.6, FTL v6.7 (снимок 2026-08-24)
|
||||
- Pi-hole v6 аутентификация: пароль Web UI = env `FTLCONF_webserver_api_password` контейнера (значение НЕ фиксируется в wiki/CHANGELOG/MEMORY.md — файлы синкаются в Nextcloud); хеш `pwhash` (BALLOON-SHA256) в /etc/pihole/pihole.toml; `setupVars.conf` в v6 отсутствует (заменён pihole.toml)
|
||||
- Pi-hole API-логин: POST /api/auth JSON `{"password":"*** env FTLCONF_webserver_api_password>","totp":null}` → session.sid; дальнейшие запросы — с сессионным cookie; проверено 2026-08-24: логин через Web UI (браузер) и API (200 + SID) — работает. Внимание: локальная проверка BALLOON-SHA256 в чистом Python дала ложный NO MATCH (сломанный test-vector в реализации) — верификацию пароля делать только через живой API
|
||||
|
|
|
|||
2
index.md
2
index.md
|
|
@ -4,7 +4,7 @@
|
|||
<!-- openclaw:wiki:index:start -->
|
||||
- Render mode: `native`
|
||||
- Total pages: 79
|
||||
- Claims: 162
|
||||
- Claims: 163
|
||||
- Sources: 36
|
||||
- Entities: 11
|
||||
- Concepts: 13
|
||||
|
|
|
|||
|
|
@ -3,23 +3,23 @@ pageType: report
|
|||
id: report.provenance-coverage
|
||||
title: Provenance Coverage
|
||||
status: active
|
||||
updatedAt: 2026-09-24T21:15:40.281Z
|
||||
updatedAt: 2026-09-26T13:17:28.017Z
|
||||
---
|
||||
|
||||
# Provenance Coverage
|
||||
|
||||
## Generated
|
||||
<!-- openclaw:wiki:provenance-coverage:start -->
|
||||
- Evidence entries: 189
|
||||
- Evidence entries: 194
|
||||
- Claims missing evidence: 0
|
||||
|
||||
### Evidence Classes
|
||||
- source-file: 188
|
||||
- source-file: 193
|
||||
- file: 1
|
||||
|
||||
### Top Evidence Sources
|
||||
- source.memory: 87
|
||||
- source.agents: 30
|
||||
- source.memory: 90
|
||||
- source.agents: 32
|
||||
- source.bridge-workspace-4c6d747f-memory-2d62c497: 22
|
||||
- source.user: 18
|
||||
- source.embedding-trading: 14
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue