wb-rules

name: wb-rules description: 'Разрабатывать, объяснять и отлаживать серверные скрипты автоматизации wb-rules на JavaScript на контроллерах Wiren Board: defineRule (whenChanged/when/asSoonAs/cron), virtual devices, timers, modules, PersistentStorage, диагностика через journalctl -u wb-rules, /etc/wb-rules, /var/run/wb-rules, и интеграция с внешними сервисами через MQTT/hooks (/hooks/wake) и POST /tools/invoke (Telegram).'

WB Rules

Короткий workflow

1. Определить тип запроса:

• возможности контроллера/UI/Cloud;
• разработка или объяснение скрипта wb-rules;
• отладка уже работающих правил.

2. Открыть только нужный reference-файл:

• references/wb-software-capabilities.md для возможностей контроллера, web-интерфейса и WB Cloud;
• references/wb-rules-wiki.md для операционных деталей (где лежат скрипты, как смотреть логи, какие страницы считать актуальными);
• references/wb-rules-cheatsheet.md для быстрого поиска сигнатур и параметров API (компактный справочник);
• references/wb-rules-full-guide.md для полных примеров, таблиц типов/параметров и детального описания API;
• references/openclaw-wb-rules-integration.md для двусторонней интеграции OpenClaw и wb-rules (MQTT и hooks).
• references/wb-rules-telegram-notify.md для быстрой отправки Telegram-уведомлений из wb-rules без agent turn и для hybrid-сценариев.

3. Сформировать решение в формате "минимально работающий скрипт + шаги проверки".

Практика разработки правил

• Писать правила с явным триггером (whenChanged, when, asSoonAs, cron), чтобы поведение было предсказуемым.
• Для длительных операций использовать таймеры и неблокирующие вызовы (runShellCommand), не блокировать обработчик правила.
• При необходимости состояния между перезапусками использовать PersistentStorage.
• Для сложных сценариев декомпозировать код на модули и подключать их через require.
• Для интерфейсных сценариев создавать defineVirtualDevice и управлять controls через dev[...].

Проверка и отладка

• Проверять синтаксис и запуск правила на контроллере после деплоя.
• Читать журнал wb-rules: journalctl -u wb-rules.
• Если правило не применяется, проверить файл в /etc/wb-rules/ и активную копию в /var/run/wb-rules/.
• Для спорных мест сверяться с references/wb-rules-cheatsheet.md (быстрый lookup) или references/wb-rules-full-guide.md (детали и примеры) и учитывать ограничения синтаксиса (ES5, не ES6+).

Навигация по references

• references/wb-software-capabilities.md: обзор встроенного ПО, web-интерфейса и ключевых функций контроллера.
• references/wb-rules-wiki.md: где хранить скрипты, как диагностировать, какие официальные страницы открывать в первую очередь.
• references/wb-rules-cheatsheet.md: компактный справочник — все сигнатуры API, типы контролов, параметры, ограничения ES5 на одной странице. Открывать первым для быстрого lookup.
• references/wb-rules-full-guide.md: полное руководство с детальным описанием каждой функции, таблицами параметров и готовыми примерами (термостат, освещение, мониторинг, модули). Открывать для написания нетривиальных скриптов.
• references/openclaw-wb-rules-integration.md: минимальная рабочая схема OpenClaw <-> wb-rules, настройка hooks, примеры curl/wb-rules, throttling и практические ограничения.
• references/wb-rules-telegram-notify.md: direct и hybrid отправка Telegram из wb-rules через POST /tools/invoke, токены, helper-функции и диагностика.