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