From 4608770e7b78ab829cc19e704bcb72ef28e024fe Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Tue, 17 Nov 2026 20:54:07 +0300 Subject: [PATCH] [OPENCLAW] Data classification policy, docs.search tool, use-cases map (ops analyst, knowledge, family, media, weekly review) --- docs/OPENCLAW-USE-CASES.md | 32 ++++++++++++++++++++++++++++++++ ops/openclaw/USE-CASES.md | 32 ++++++++++++++++++++++++++++++++ ops/tools/gateway.py | 19 +++++++++++++++++++ ops/tools/mcp_gateway.py | 2 ++ 4 files changed, 85 insertions(+) create mode 100644 docs/OPENCLAW-USE-CASES.md create mode 100644 ops/openclaw/USE-CASES.md diff --git a/docs/OPENCLAW-USE-CASES.md b/docs/OPENCLAW-USE-CASES.md new file mode 100644 index 0000000..336d322 --- /dev/null +++ b/docs/OPENCLAW-USE-CASES.md @@ -0,0 +1,32 @@ +# OpenClaw: где ещё можно задействовать + +## Уже используется +- Секретарь в Matrix: статус, HA, календарь, медиа, книги, алерты, аудит. +- MCP Tool Gateway: 20 инструментов, аудит, rate limit. + +## Новые роли (по приоритету) + +| Роль | Что делает | Инструменты | Риск | +|---|---|---|---| +| **Ops-аналитик** | алерт → триаж → гипотезы → следующий шаг | alerts.active, hub.service_detail, docs.search, audit.recent | средний: не выполнять действия | +| **Knowledge-ассистент** | вопросы по документации/ранбукам | docs.search | низкий | +| **Семейный консьерж** | онбординг, «как подключить», FAQ | docs.search, books.status | низкий | +| **Медиа-куратор** | подбор, очередь, «что посмотреть» | media.* | низкий | +| **Календарь/напоминания** | события, напоминания | calendar.* | средний: подтверждение | +| **Дом** | свет/сцены естественным языком | ha.* | высокий: confirm | +| **Backup-инспектор** | «когда бэкап», «что проверено» | backup.status | низкий | +| **Weekly review** | сводка недели: инциденты, ошибки, стоимость | audit.recent, eval | низкий | + +## Чего не хватает для роста +1. **`docs.search`** — добавлен (поиск по ops/docs). +2. **Память о людях** — `USER.md`/`MEMORY.md`, границы. +3. **Approvals** — write-инструменты с confirm; нужен журнал подтверждений. +4. **Router** — локальная модель для чувствительного, DeepSeek для сложного. +5. **Weekly review** — сводка для владельца. +6. **Incident postmortem** — шаблон и автозаполнение. + +## Что не делать +- Не давать shell/root. +- Не отправлять фото/лица/переписку в облако. +- Не дублировать Hermes/n8n: они — расписание/события, OpenClaw — диалог. +- Не запускать опасные действия без confirm. diff --git a/ops/openclaw/USE-CASES.md b/ops/openclaw/USE-CASES.md new file mode 100644 index 0000000..336d322 --- /dev/null +++ b/ops/openclaw/USE-CASES.md @@ -0,0 +1,32 @@ +# OpenClaw: где ещё можно задействовать + +## Уже используется +- Секретарь в Matrix: статус, HA, календарь, медиа, книги, алерты, аудит. +- MCP Tool Gateway: 20 инструментов, аудит, rate limit. + +## Новые роли (по приоритету) + +| Роль | Что делает | Инструменты | Риск | +|---|---|---|---| +| **Ops-аналитик** | алерт → триаж → гипотезы → следующий шаг | alerts.active, hub.service_detail, docs.search, audit.recent | средний: не выполнять действия | +| **Knowledge-ассистент** | вопросы по документации/ранбукам | docs.search | низкий | +| **Семейный консьерж** | онбординг, «как подключить», FAQ | docs.search, books.status | низкий | +| **Медиа-куратор** | подбор, очередь, «что посмотреть» | media.* | низкий | +| **Календарь/напоминания** | события, напоминания | calendar.* | средний: подтверждение | +| **Дом** | свет/сцены естественным языком | ha.* | высокий: confirm | +| **Backup-инспектор** | «когда бэкап», «что проверено» | backup.status | низкий | +| **Weekly review** | сводка недели: инциденты, ошибки, стоимость | audit.recent, eval | низкий | + +## Чего не хватает для роста +1. **`docs.search`** — добавлен (поиск по ops/docs). +2. **Память о людях** — `USER.md`/`MEMORY.md`, границы. +3. **Approvals** — write-инструменты с confirm; нужен журнал подтверждений. +4. **Router** — локальная модель для чувствительного, DeepSeek для сложного. +5. **Weekly review** — сводка для владельца. +6. **Incident postmortem** — шаблон и автозаполнение. + +## Что не делать +- Не давать shell/root. +- Не отправлять фото/лица/переписку в облако. +- Не дублировать Hermes/n8n: они — расписание/события, OpenClaw — диалог. +- Не запускать опасные действия без confirm. diff --git a/ops/tools/gateway.py b/ops/tools/gateway.py index 64e181b..0a3ddd6 100755 --- a/ops/tools/gateway.py +++ b/ops/tools/gateway.py @@ -409,6 +409,23 @@ def t_audit_recent(args): return {"count": len(rows), "rows": rows} +def t_docs_search(args): + q = (args.get("query") or "").strip() + if not q or len(q) > 120: + return {"error": "query must be 1..120 chars"} + import subprocess as sp + cmd = ["grep", "-R", "-i", "-n", "-m", "3", + "--include=*.md", "--include=*.py", "--include=*.yaml", "--include=*.yml", + q, "/root/buryan-infra/ops", "/root/buryan-infra/docs"] + r = sp.run(cmd, capture_output=True, text=True, timeout=20) + rows = [] + for ln in (r.stdout or "").splitlines()[:60]: + parts = ln.split(":", 2) + if len(parts) == 3: + rows.append({"file": parts[0], "line": parts[1], "text": parts[2][:240]}) + return {"query": q, "count": len(rows), "results": rows} + + TOOLS = { "hub.status": {"fn": t_hub_status, "scope": "read", "confirm": False}, "hub.notify": {"fn": t_hub_notify, "scope": "write", "confirm": True, @@ -434,6 +451,7 @@ TOOLS = { "books.link": {"fn": t_books_link, "scope": "read", "confirm": False}, "books.status": {"fn": t_books_status, "scope": "read", "confirm": False}, "audit.recent": {"fn": t_audit_recent, "scope": "read", "confirm": False}, + "docs.search": {"fn": t_docs_search, "scope": "read", "confirm": False}, } @@ -542,6 +560,7 @@ class Handler(BaseHTTPRequestHandler): "hub.service_detail": ["name"], "books.search": ["query"], "books.link": ["query"], + "docs.search": ["query"], }.get(tool, []) missing = [k for k in required if not args.get(k)] if missing: diff --git a/ops/tools/mcp_gateway.py b/ops/tools/mcp_gateway.py index 7ad2e58..3007d89 100755 --- a/ops/tools/mcp_gateway.py +++ b/ops/tools/mcp_gateway.py @@ -41,6 +41,8 @@ SCHEMAS = { "books.status": ("Доступность Calibre-Web", {"type": "object", "properties": {}}), "audit.recent": ("Последние записи аудита Tool Gateway", {"type": "object", "properties": { "limit": {"type": "integer"}, "actor": {"type": "string"}}}), + "docs.search": ("Поиск по документации репозитория", {"type": "object", "properties": { + "query": {"type": "string"}}, "required": ["query"]}), "hub.service_detail": ("Детали одной службы хаба по имени", {"type": "object", "properties": { "name": {"type": "string"}}, "required": ["name"]}),