diff --git a/docs/OPENCLAW-ONE-INSTANCE.md b/docs/OPENCLAW-ONE-INSTANCE.md new file mode 100644 index 0000000..b92b6c1 --- /dev/null +++ b/docs/OPENCLAW-ONE-INSTANCE.md @@ -0,0 +1,58 @@ +# openclaw: один экземпляр, версия закреплена + +**17.10.2026.** Задача владельца: «если их там два — сделай один, самую +свежую версию». + +## Что было + +| | Состояние | +|---|---| +| `openclaw` (новый) | падал в петле, диск был полон, база нечитаема | +| `openclaw-old-20261014-181148` | работал 44 часа, `/healthz` 200 | + +Плюс в `docker-compose.yml` **не было монтирования данных** — поэтому +любой новый контейнер запускался без состояния. + +## Что сделано + +1. **Добавлено монтирование** `- /opt/openclaw:/home/node/.openclaw` — + без него новый контейнер не видит состояние и падает. +2. **Удалён старый контейнер**, данные остались на диске. +3. Поднят **один** контейнер, имя `openclaw`. + +## Почему не на самой свежей версии + +Свежий образ (`70b8dbd`, 4 дня) при запуске с существующим состоянием +**перезапускается по кругу**: 21 перезапуск за 6 минут, код выхода 0. +В журнале прямо сказано, чего не хватает: + +``` +Fix: set commands.ownerAllowFrom to your channel user id, for example +openclaw config set commands.ownerAllowFrom '["telegram:123456789"]' +``` + +Новая версия изменила требования к конфигурации: старый конфиг она не +принимает и завершается. Это **не поломка, а необходимая миграция +настроек**. + +Делать миграцию вслепую на живой службе нельзя — сначала нужно понять, +какие каналы и владельцы должны быть прописаны. Поэтому: + +* экземпляр один и он работает (решение владельца «сделать один» — + выполнено); +* версия **закреплена по digest** в compose, чтобы случайный + `docker compose pull` не подсунул нерабочую версию; +* обновление вынесено в задачу 5.9. + +## Попутно исправлено + +Домен `openclaw.buryans.ru` проксировал на порт 8080, а служба слушает +**18789** — снаружи и дома был `404`. Исправлено в двух местах (VPS и +хост PVE), теперь `200`. + +## Откат + +``` +pct exec 115 -- cp /opt/openclaw/docker-compose.yml.before-pin \ + /opt/openclaw/docker-compose.yml +``` diff --git a/docs/TASKS.md b/docs/TASKS.md index acc661e..fd3989f 100644 --- a/docs/TASKS.md +++ b/docs/TASKS.md @@ -36,9 +36,9 @@ | ЗВОНКИ И МЕДИА | 5 | 0 | 0 | **5** | | СКВОЗНАЯ СВЯЗНОСТЬ | 12 | 3 | 3 | **6** | | УЛУЧШЕНИЕ СЛУЖБ | 10 | 0 | 0 | **10** | -| VPN (этапы 1–4) | 29 | 19 | 4 | **6** | +| VPN (этапы 1–4) | 29 | 20 | 3 | **6** | | РЕЕСТР НАЙДЕННЫХ ПРОБЛЕМ | 17 | 12 | 1 | **4** | -| **ИТОГО** | **90** | **48** | **8** | **34** | +| **ИТОГО** | **90** | **49** | **7** | **34** | --- @@ -50,6 +50,7 @@ + ## 1. ЗАВЕРШИТЬ ОБНОВЛЕНИЯ | № | Задача | Состояние | @@ -119,7 +120,7 @@ | 5.6 | `sonarr`/`radarr`/`prowlarr` — проверить запись в базы | ⬜ | | 5.7 | `npm` — решить судьбу (заменяется на NGINX) | ⬜ | | 5.8 | `dashy` — сделать стартовой страницей со ссылками на всё | ⬜ | -| 5.9 | `openclaw` — определить назначение | ⬜ | +| 5.9 | `openclaw` — обновить до свежей версии (нужна миграция конфигурации) | ⬜ | | 5.10 | `prometheus`/`grafana` — правила тревог и панели на все службы | ⬜ | ## 6. VPN @@ -141,7 +142,7 @@ | VPN-1.8 | **Ключ age**: файл с ключом и инструкцией передан владельцу | 🔶 ждёт записи в Vaultwarden и на флешку | | VPN-1.9 | **Пароль root на PVE** → в Vaultwarden | ⬜ по слову владельца: пароль есть локально, пока не делает | | VPN-1.10 | n8n: двойник compose обезврежен, настоящий в порядке | ✅ | -| VPN-1.11 | `openclaw`: диск освобождён (100%→55%), петля остановлена, состояние сохранено | 🔶 нужно решить, какой экземпляр рабочий | +| VPN-1.11 | `openclaw`: один экземпляр, версия закреплена | ✅ | | VPN-1.12 | Убрать остатки `*-old-*` | ✅ убрано 11, оставлено 3 работающих | ### Этап 2. Больше протоколов diff --git a/ops/maintenance/openclaw-consolidate.sh b/ops/maintenance/openclaw-consolidate.sh new file mode 100755 index 0000000..5a5ae5d --- /dev/null +++ b/ops/maintenance/openclaw-consolidate.sh @@ -0,0 +1,114 @@ +#!/bin/bash +# ============================================================ +# openclaw-consolidate.sh — один экземпляр на свежей версии +# ============================================================ +# ЗАДАЧА ОТ ВЛАДЕЛЬЦА: «если их там два, сделай один, самую свежую +# версию». +# +# ЧТО ЕСТЬ: +# * работает `openclaw-old-20261014-181148` (44 часа, healthy, /healthz 200); +# использует образ ghcr.io/openclaw/openclaw:latest, но СТАРЫЙ +# (3814fb1f62f9, от 11 сентября); +# * в хранилище уже лежит СВЕЖИЙ образ того же тега (70b8dbd23f8d, +# 4 дня назад, 5 ГБ); +# * compose в /opt/openclaw описывает службу, но БЕЗ монтирования — +# поэтому новый контейнер запускался без состояния и падал. +# +# ПЛАН: +# 1. записываю точную конфигурацию рабочего контейнера (для откката); +# 2. добавляю в compose монтирование /opt/openclaw -> /home/node/.openclaw; +# 3. останавливаю и удаляю старый, поднимаю новый из compose; +# 4. проверяю /healthz и порт 18789; +# 5. если не поднялся — возвращаю старый контейнер как был. +# +# Снимок CT 115 уже есть (snap_vm-115-disk-0_pre-update-20261014-180112). +# ============================================================ +set -uo pipefail +CT=115 +OLD=openclaw-old-20261014-181148 +C=/opt/openclaw/docker-compose.yml +STAMP=$(date +%Y%m%d_%H%M%S) + +echo "=== 1. СОХРАНЯЮ КОНФИГУРАЦИЮ РАБОЧЕГО ===" +pct exec $CT -- bash -c "docker inspect $OLD > /root/openclaw-old-inspect-$STAMP.json 2>/dev/null" \ + && echo " конфигурация сохранена в CT: /root/openclaw-old-inspect-$STAMP.json" +pct exec $CT -- bash -c "docker inspect $OLD --format '{{.Image}}'" | tr -d '\r' | sed 's/^/ образ: /' +pct exec $CT -- cp -p "$C" "$C.before-consolidate" && echo " compose сохранён" + +echo +echo "=== 2. ДОБАВЛЯЮ МОНТИРОВАНИЕ В COMPOSE ===" +pct exec $CT -- bash -c "grep -q 'openclaw:/home/node/.openclaw' $C && echo ' уже есть' || true" +if ! pct exec $CT -- grep -q "/home/node/.openclaw" "$C" 2>/dev/null; then + pct exec $CT -- python3 - "$C" <<'PYEOF' +import io, sys +p = sys.argv[1] +t = io.open(p, encoding="utf-8").read() +if "volumes:" not in t: + # добавляю после restart + t = t.replace(" restart: unless-stopped", + " restart: unless-stopped\n volumes:\n - /opt/openclaw:/home/node/.openclaw", 1) + io.open(p, "w", encoding="utf-8").write(t) + print(" монтирование добавлено") +else: + print(" volumes уже есть — проверьте вручную") +PYEOF +else + echo " монтирование уже присутствует" +fi +echo " --- compose теперь ---" +pct exec $CT -- grep -E "image|volumes|/opt/openclaw|security_opt|apparmor|container_name" "$C" | sed 's/^/ /' + +echo +echo "=== 3. ПЕРЕХОЖУ НА ОДИН ЭКЗЕМПЛЯР ===" +echo " --- останавливаю старый ---" +pct exec $CT -- docker stop "$OLD" 2>&1 | sed 's/^/ /' +echo " --- удаляю старый (данные на диске, не в контейнере) ---" +pct exec $CT -- docker rm "$OLD" 2>&1 | sed 's/^/ /' + +echo " --- поднимаю новый из compose ---" +pct exec $CT -- bash -c "cd /opt/openclaw && docker compose up -d 2>&1 | tail -5" | sed 's/^/ /' + +echo +echo "=== 4. ПРОВЕРКА ===" +echo " жду готовности (до 120 с)..." +ok=0 +for i in $(seq 1 24); do + code=$(curl -s -o /dev/null -w '%{http_code}' --max-time 5 "http://192.168.1.115:18789/healthz" 2>/dev/null) + if [ "$code" = "200" ]; then ok=1; echo " /healthz ответил 200 на попытке $i"; break; fi + sleep 5 +done + +pct exec $CT -- docker ps --format ' {{.Names}} | {{.Status}} | {{.Image}}' 2>/dev/null | grep -i openclaw + +if [ "$ok" -eq 1 ]; then + echo + echo " ✅ Новый экземпляр работает" + echo " --- какая версия теперь ---" + pct exec $CT -- docker inspect openclaw --format ' образ: {{.Image}}' 2>/dev/null | head -2 + pct exec $CT -- docker ps --format '{{.Image}}' --filter name=openclaw 2>/dev/null | sed 's/^/ тег: /' +else + echo + echo " ❌ Новый НЕ поднялся — возвращаю прежний" + pct exec $CT -- docker logs openclaw --tail 12 2>&1 | sed 's/^/ /' + pct exec $CT -- docker compose -f /opt/openclaw/docker-compose.yml down 2>&1 | tail -2 | sed 's/^/ /' + pct exec $CT -- bash -c "docker run -d --name openclaw --restart unless-stopped \ + --network host --security-opt apparmor:unconfined \ + -v /opt/openclaw:/home/node/.openclaw \ + -e NODE_ENV=production -e TZ=Europe/Moscow \ + 3814fb1f62f9 2>&1 | tail -2" | sed 's/^/ /' + sleep 20 + code=$(curl -s -o /dev/null -w '%{http_code}' --max-time 8 "http://192.168.1.115:18789/healthz" 2>/dev/null) + echo " откат: /healthz HTTP ${code:-—}" +fi + +echo +echo "=== 5. ИТОГ ===" +pct exec $CT -- docker ps --format ' {{.Names}} | {{.Status}}' 2>/dev/null +echo " --- занятое место в CT ---" +pct exec $CT -- df -h / 2>/dev/null | tail -1 | sed 's/^/ /' +echo +echo " Откат полностью:" +echo " pct exec $CT -- docker rm -f openclaw" +echo " pct exec $CT -- docker run -d --name openclaw --restart unless-stopped --network host \\" +echo " --security-opt apparmor:unconfined -v /opt/openclaw:/home/node/.openclaw \\" +echo " -e NODE_ENV=production -e TZ=Europe/Moscow 3814fb1f62f9" diff --git a/ops/maintenance/openclaw-pin.sh b/ops/maintenance/openclaw-pin.sh new file mode 100755 index 0000000..a8b68e7 --- /dev/null +++ b/ops/maintenance/openclaw-pin.sh @@ -0,0 +1,67 @@ +#!/bin/bash +# ============================================================ +# openclaw-pin.sh — один рабочий экземпляр, версия закреплена +# ============================================================ +# РЕЗУЛЬТАТ РАЗБОРА. +# В CT 115 был один рабочий экземпляр (старый образ) и один падавший +# (без монтирования состояния). Теперь экземпляр ОДИН и он работает. +# +# Почему не на свежей версии: новый образ (70b8dbd, 4 дня) при запуске +# с существующим состоянием перезапускается по кругу — 21 перезапуск, +# код выхода 0. В журнале прямо сказано, чего не хватает: +# «Fix: set commands.ownerAllowFrom to your channel user id» +# То есть новая версия ТРЕБУЕТ переноса настроек, а старый конфиг её не +# устраивает. Это не «сломалось», это «нужна миграция конфигурации» — +# отдельная работа, делать её вслепую на живой службе нельзя. +# +# ЧТО ДЕЛАЮ: +# 1. оставляю ОДИН экземпляр (рабочий, имя openclaw); +# 2. ЗАКРЕПЛЯЮ его образ по digest в compose — чтобы случайный +# `docker compose pull` не подсунул нерабочую версию; +# 3. проверяю здоровье. +# ============================================================ +set -uo pipefail +CT=115 +C=/opt/openclaw/docker-compose.yml +DIGEST="sha256:3814fb1f62f9cfc5944de088c5817c68c88b5d721feebe36420b666a90a61ce7" + +echo "=== 1. СКОЛЬКО ЭКЗЕМПЛЯРОВ ===" +pct exec $CT -- docker ps -a --format ' {{.Names}} | {{.Status}} | {{.Image}}' 2>/dev/null | grep -i openclaw + +echo +echo "=== 2. ЗАКРЕПЛЯЮ ОБРАЗ В COMPOSE ===" +pct exec $CT -- cp -p "$C" "$C.before-pin" 2>/dev/null +if pct exec $CT -- grep -q "sha256:" "$C" 2>/dev/null; then + echo " уже закреплён" +else + pct exec $CT -- sed -i "s|image: ghcr.io/openclaw/openclaw:latest|image: ghcr.io/openclaw/openclaw@$DIGEST|" "$C" + echo " образ заменён на закреплённый digest" +fi +echo " --- compose ---" +pct exec $CT -- grep -E "image|volumes|/opt/openclaw|apparmor" "$C" | sed 's/^/ /' + +echo +echo "=== 3. ПРОВЕРКА ЗДОРОВЬЯ ===" +for i in 1 2 3; do + code=$(curl -s -o /dev/null -w '%{http_code}' --max-time 8 "http://192.168.1.115:18789/healthz" 2>/dev/null) + echo " /healthz (попытка $i): HTTP ${code:-—}" + [ "$code" = "200" ] && break + sleep 5 +done + +echo +echo "=== 4. СОСТОЯНИЕ ===" +pct exec $CT -- docker ps --format ' {{.Names}} | {{.Status}} | {{.Image}}' 2>/dev/null | grep -i openclaw +pct exec $CT -- docker inspect openclaw --format ' перезапусков: {{.RestartCount}}' 2>/dev/null + +echo +echo "=== 5. ДОСТУП СНАРУЖИ ===" +code=$(curl -s -o /dev/null -w '%{http_code}' --max-time 10 -k "https://openclaw.buryans.ru/" 2>/dev/null) +ch=$(curl -s -o /dev/null -w '%{http_code}' --max-time 8 -k --resolve "openclaw.buryans.ru:443:192.168.1.10" "https://openclaw.buryans.ru/" 2>/dev/null) +printf ' openclaw.buryans.ru: снаружи %-5s дома %s\n' "${code:-—}" "${ch:-—}" + +echo +echo "=== 6. МЕСТО ===" +pct exec $CT -- df -h / 2>/dev/null | tail -1 | sed 's/^/ /' +echo +echo " Откат закрепления: pct exec $CT -- cp $C.before-pin $C"