openclaw/README-openclaw.md

# OpenClaw + Skills — рабочая памятка (Виталий)

Ниже команды с пояснением **что делает каждая**.

---

## 1) Базовая диагностика OpenClaw

### `openclaw status`
Показывает общее состояние OpenClaw: gateway, каналы, подключение, ошибки.

### `openclaw help`
Выводит список доступных CLI-команд OpenClaw.

### `openclaw gateway --help`
Показывает команды именно для управления gateway.

---

## 2) Управление OpenClaw Gateway

### `openclaw gateway status`
Проверяет, запущен ли gateway-сервис.

### `openclaw gateway start`
Запускает gateway, если он остановлен.

### `openclaw gateway stop`
Останавливает gateway.

### `openclaw gateway restart`
Перезапускает gateway (полезно после конфиг-правок).

---

## 3) Сервисы интеграций (systemd user)

### `systemctl --user status paradizweb-agent.service`
Показывает состояние web-агента Paradiz.

### `systemctl --user status vk-gateway-endpoint.service`
Показывает состояние endpoint-сервиса для VK bridge.

### `systemctl --user status vk-gateway-longpoll.service`
Показывает состояние longpoll-воркера VK.

### `systemctl --user restart paradizweb-agent.service`
Перезапускает web-агента Paradiz после правок кода/логики.

### `systemctl --user restart vk-gateway-endpoint.service`
Перезапускает VK endpoint после правок.

### `systemctl --user restart vk-gateway-longpoll.service`
Перезапускает VK longpoll воркер.

### `journalctl --user -u paradizweb-agent.service -n 200 --no-pager`
Показывает последние 200 строк логов web-агента.

### `journalctl --user -u vk-gateway-endpoint.service -n 200 --no-pager`
Показывает последние 200 строк логов VK endpoint.

### `journalctl --user -u vk-gateway-longpoll.service -n 200 --no-pager`
Показывает последние 200 строк логов VK longpoll.

---

## 4) Где что лежит

- Git workspace: `/home/openclaw/.openclaw/workspace` — здесь код и всё, что пушится в Gitea.
- Runtime OpenClaw: `/home/openclaw/.openclaw` — рантайм-файлы и системные конфиги.
- OpenClaw config: `/home/openclaw/.openclaw/openclaw.json` — главный конфиг OpenClaw.
- `paradizweb` env: `/home/openclaw/.openclaw/agents/paradizweb/agent/.env` — переменные web-агента.
- `vk-gateway` env: `/home/openclaw/.openclaw/workspace/skills/vk-gateway/.env` — переменные VK gateway.

---

## 5) Работа со скиллами

### `ls -la /home/openclaw/.openclaw/workspace/skills`
Показывает список установленных скиллов.

### `cat /home/openclaw/.openclaw/workspace/skills/<skill>/SKILL.md`
Открывает инструкцию конкретного скилла.

### `grep -R "ключ" -n /home/openclaw/.openclaw/workspace/skills/<skill>`
Ищет нужные строки/функции внутри скилла.

---

## 6) Git + Gitea

### `git -C /home/openclaw/.openclaw/workspace status --short`
Показывает изменённые файлы.

### `git -C /home/openclaw/.openclaw/workspace add -A`
Добавляет все изменения в staging.

### `git -C /home/openclaw/.openclaw/workspace commit -m "msg"`
Создаёт коммит с текущими изменениями.

### `git -C /home/openclaw/.openclaw/workspace push gitea main`
Пушит коммиты в Gitea (ветка `main`).

### `git -C /home/openclaw/.openclaw/workspace remote -v`
Показывает, куда идёт push/fetch.

---

## 7) Codex account switcher

Рабочая папка:
`/home/openclaw/.openclaw/workspace/skills/codex-account-switcher-skill`

### `python3 ./codex-accounts.py list`
Список сохранённых codex-аккаунтов (кратко).

### `python3 ./codex-accounts.py list --json`
Список аккаунтов в JSON (для скриптов/диагностики).

### `python3 ./codex-accounts.py use ilin.vitali`
Переключает активный codex-аккаунт.

### `python3 ./codex-accounts.py remove <account_name>`
Удаляет аккаунт и связанные локальные артефакты (включая quota-файл).

### `python3 ./codex-accounts.py auto --json`
Выбирает лучший аккаунт по квоте/лимитам и выводит результат JSON.

### `/home/openclaw/.openclaw/workspace/scripts/codex-limit-monitor.sh`
Запускает монитор лимитов и выдаёт отчёт по аккаунтам.

---

## 8) Быстрые тесты Paradiz

### Web endpoint test
```bash
curl -sS -X POST "http://192.168.0.8:8788/chat" \
  -H "Authorization: Bearer $PARADIZWEB_API_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"client_id":"test-1","question":"хочу забронировать"}'
```
Проверяет, отвечает ли web-агент и проходит ли логика диалога.

### VK endpoint test
```bash
curl -sS -X POST http://127.0.0.1:8787/vk/inbound \
  -H 'Content-Type: application/json' \
  --data '{"group_id":24068391,"user_id":999001,"text":"хочу живого менеджера"}'
```
Проверяет обработку входящего сообщения VK в локальном endpoint.

---

## 9) Очистка tmp

### `find /home/openclaw/.openclaw/workspace/tmp -mindepth 1 -maxdepth 1 -exec rm -rf {} +`
Удаляет все файлы/папки внутри `tmp`, оставляя сам каталог.

---

## 10) Быстрый чек-лист «не работает»

1. `git status` — нет ли незакоммиченных правок.
2. `systemctl --user status ...` — сервис точно запущен.
3. `journalctl --user -u ... -n 200` — есть ли явная ошибка в логах.
4. Ручной `curl` тест endpoint — подтверждение фактического поведения.