From cc6c8609d6fd7924309ee6e9b7dddde9497fa1c9 Mon Sep 17 00:00:00 2001
From: OpenClaw Assistant <assistant@openclaw.local>
Date: Tue, 3 Mar 2026 01:13:04 +0300
Subject: [PATCH] docs: add OpenClaw and skills command handbook

---
 README-openclaw.md | 92 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 README-openclaw.md

diff --git a/README-openclaw.md b/README-openclaw.md
new file mode 100644
index 0000000..48631ad
--- /dev/null
+++ b/README-openclaw.md
@@ -0,0 +1,92 @@
+# OpenClaw + Skills — рабочая памятка (Виталий)
+
+## 1) Базовая диагностика OpenClaw
+```bash
+openclaw status
+openclaw help
+openclaw gateway --help
+```
+
+## 2) Управление gateway
+```bash
+openclaw gateway status
+openclaw gateway start
+openclaw gateway stop
+openclaw gateway restart
+```
+
+## 3) Сервисы интеграций (systemd user)
+```bash
+systemctl --user status paradizweb-agent.service
+systemctl --user status vk-gateway-endpoint.service
+systemctl --user status vk-gateway-longpoll.service
+
+systemctl --user restart paradizweb-agent.service
+systemctl --user restart vk-gateway-endpoint.service
+systemctl --user restart vk-gateway-longpoll.service
+
+journalctl --user -u paradizweb-agent.service -n 200 --no-pager
+journalctl --user -u vk-gateway-endpoint.service -n 200 --no-pager
+journalctl --user -u vk-gateway-longpoll.service -n 200 --no-pager
+```
+
+## 4) Где что лежит
+- Git workspace: `/home/openclaw/.openclaw/workspace`
+- Runtime OpenClaw: `/home/openclaw/.openclaw`
+- OpenClaw config: `/home/openclaw/.openclaw/openclaw.json`
+- `paradizweb` env: `/home/openclaw/.openclaw/agents/paradizweb/agent/.env`
+- `vk-gateway` env: `/home/openclaw/.openclaw/workspace/skills/vk-gateway/.env`
+
+## 5) Работа со скиллами
+```bash
+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
+```bash
+git -C /home/openclaw/.openclaw/workspace status --short
+git -C /home/openclaw/.openclaw/workspace add -A
+git -C /home/openclaw/.openclaw/workspace commit -m "msg"
+git -C /home/openclaw/.openclaw/workspace push gitea main
+git -C /home/openclaw/.openclaw/workspace remote -v
+```
+
+## 7) Codex account switcher
+```bash
+cd /home/openclaw/.openclaw/workspace/skills/codex-account-switcher-skill
+python3 ./codex-accounts.py list
+python3 ./codex-accounts.py list --json
+python3 ./codex-accounts.py use ilin.vitali
+python3 ./codex-accounts.py remove <account_name>
+python3 ./codex-accounts.py auto --json
+/home/openclaw/.openclaw/workspace/scripts/codex-limit-monitor.sh
+```
+
+## 8) Быстрые тесты Paradiz
+### Web
+```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":"хочу забронировать"}'
+```
+
+### VK endpoint
+```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":"хочу живого менеджера"}'
+```
+
+## 9) Очистка tmp
+```bash
+find /home/openclaw/.openclaw/workspace/tmp -mindepth 1 -maxdepth 1 -exec rm -rf {} +
+```
+
+## 10) Что делать если «не работает»
+1. Проверить `git status` (нет ли незакоммиченных правок)
+2. Перезапустить нужный сервис
+3. Проверить `journalctl` логи
+4. Прогнать ручной `curl` тест