Pliki konfiguracyjne#

vCLU przechowuje konfigurację w kilku miejscach. Większość ustawień konfiguruje się przez panel webowy - ręczna edycja plików jest rzadko potrzebna.

.vclu.json - główne ustawienia#

Plik .vclu.json w katalogu danych vCLU zawiera całą konfigurację systemu. Tworzony jest automatycznie podczas pierwszego uruchomienia (wizard).

Co jest w nim skonfigurowane:

• Hasło dostępu do panelu webowego
• Broker MQTT - port, włączenie/wyłączenie
• HomeKit - integracja z Apple Home, PIN parowania
• MCP - serwer dla agenta AI, boty i ich uprawnienia
• Pluginy - repozytoria i zainstalowane rozszerzenia
• Kontrola dostępu - profile uprawnień dla integracji
• Metryki - zbieranie danych do wykresów
• Backup - automatyczne kopie zapasowe

Większością tych ustawień zarządzasz przez panel webowy (zakładka Ustawienia). Panel automatycznie zapisuje zmiany do .vclu.json.

Katalog clu/ - pliki systemowe#

Katalog clu/ (wewnątrz katalogu danych) zawiera pliki potrzebne do komunikacji z Grenton Object Manager:

• config.txt, CONFIG.JSON - konfiguracja modułów dla OM
• main.lua - identyfikacja vCLU w sieci
• om.lua, user.lua - kod wygenerowany przez Object Manager

Plików w katalogu clu/ nie należy edytować ręcznie. Są generowane automatycznie i nadpisywane przy starcie vCLU lub przez Object Manager.

Katalog modules/ - twój kod#

W katalogu modules/ (wewnątrz clu/) umieszczasz własny kod Lua - automatyzacje, definicje urządzeń, sceny. To jedyne miejsce, które powinieneś edytować.

Możesz to robić na dwa sposoby:

1. Edytor webowy - wbudowany w panel (zakładka Edytor)
2. Agent AI (MCP) - poproś agenta o napisanie automatyzacji

Pliki ładowane są automatycznie: najpierw init.lua, potem pozostałe w kolejności alfabetycznej.

Kiedy edytować .vclu.json ręcznie#

W normalnym użyciu nie musisz otwierać tego pliku. Sytuacje, gdy może to być potrzebne:

• Migracja - przenoszenie konfiguracji między instancjami vCLU
• Debugowanie - sprawdzanie, czy ustawienia są poprawnie zapisane
• Zaawansowane scenariusze - np. konfiguracja kluczy broadcast, zmiana portów
• Reset - zmiana setupCompleted na false aby ponownie uruchomić wizard

Po ręcznej edycji .vclu.json wymagany jest restart vCLU.

Większością ustawień zarządzasz przez panel webowy. Agent AI (MCP) może pomóc w konfiguracji urządzeń i automatyzacji - pracuje w katalogu modules/.