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

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

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 — подтверждение фактического поведения.