Konfiguracja

TL;DR

Wybierz przepływ konfiguracji na podstawie tego, jak często chcesz otrzymywać aktualizacje i czy chcesz samodzielnie uruchamiać Gateway:

• Dostosowanie znajduje się poza repozytorium: trzymaj konfigurację i obszar roboczy w ~/.OmeniaClaw/OmeniaClaw.json oraz ~/.OmeniaClaw/workspace/, aby aktualizacje repozytorium ich nie dotykały.
• Stabilny przepływ pracy (zalecany dla większości): zainstaluj aplikację macOS i pozwól jej uruchamiać dołączony Gateway.
• Przepływ pracy na najnowszych zmianach (dev): uruchamiaj Gateway samodzielnie przez pnpm gateway:watch, a następnie pozwól aplikacji macOS podłączyć się w trybie lokalnym.

Wymagania wstępne (ze źródeł)

• Zalecany Node 24 (Node 22 LTS, obecnie 22.16+, nadal obsługiwany)
• pnpm jest wymagany dla checkoutów źródłowych. OmeniaClaw ładuje dołączone pluginy z pakietów obszaru roboczego pnpm extensions/* w trybie dev, więc główne npm install nie przygotowuje pełnego drzewa źródeł.
• Docker (opcjonalnie; tylko dla konfiguracji kontenerowej/e2e - zobacz Docker)

Strategia dostosowania (aby aktualizacje nie szkodziły)

Jeśli chcesz „100% dostosowane do mnie” i łatwe aktualizacje, trzymaj własne dostosowania w:

• Konfiguracja: ~/.OmeniaClaw/OmeniaClaw.json (JSON/około JSON5)
• Obszar roboczy: ~/.OmeniaClaw/workspace (Skills, prompty, pamięci; zrób z niego prywatne repozytorium git)

Zainicjuj raz:

OmeniaClaw setup

Z wnętrza tego repozytorium użyj lokalnego wpisu CLI:

OmeniaClaw setup

Jeśli nie masz jeszcze instalacji globalnej, uruchom przez pnpm OmeniaClaw setup.

Uruchamianie Gateway z tego repozytorium

Po pnpm build możesz uruchomić spakowane CLI bezpośrednio:

node OmeniaClaw.mjs gateway --port 18789 --verbose

Stabilny przepływ pracy (najpierw aplikacja macOS)

1. Zainstaluj i uruchom OmeniaClaw.app (pasek menu).
2. Ukończ listę kontrolną wdrażania/uprawnień (prompty TCC).
3. Upewnij się, że Gateway jest lokalny i działa (aplikacja nim zarządza).
4. Połącz powierzchnie (przykład: WhatsApp):

OmeniaClaw channels login

5. Sprawdzenie poprawności:

OmeniaClaw health

Jeśli wdrażanie nie jest dostępne w Twojej kompilacji:

• Uruchom OmeniaClaw setup, potem OmeniaClaw channels login, a następnie ręcznie uruchom Gateway (OmeniaClaw gateway).

Przepływ pracy na najnowszych zmianach (Gateway w terminalu)

Cel: pracować nad TypeScript Gateway, mieć przeładowywanie na gorąco i utrzymywać podłączony interfejs aplikacji macOS.

0) (Opcjonalnie) Uruchom też aplikację macOS ze źródeł

Jeśli chcesz mieć także aplikację macOS na najnowszych zmianach:

./scripts/restart-mac.sh

1) Uruchom Gateway dev

pnpm install# First run only (or after resetting local OmeniaClaw config/workspace)pnpm OmeniaClaw setuppnpm gateway:watch

gateway:watch uruchamia lub restartuje proces obserwowania Gateway w nazwanej sesji tmux i automatycznie podłącza się z terminali interaktywnych. Powłoki nieinteraktywne pozostają odłączone i wypisują tmux attach -t OmeniaClaw-gateway-watch-main; użyj OmeniaClaw_GATEWAY_WATCH_ATTACH=0 pnpm gateway:watch, aby utrzymać interaktywne uruchomienie odłączone, albo pnpm gateway:watch:raw dla trybu obserwowania na pierwszym planie. Obserwator przeładowuje się przy istotnych zmianach źródeł, konfiguracji i metadanych dołączonych pluginów. Jeśli obserwowany Gateway zakończy działanie podczas startu, gateway:watch uruchamia OmeniaClaw doctor --fix --non-interactive raz i ponawia próbę; ustaw OmeniaClaw_GATEWAY_WATCH_AUTO_DOCTOR=0, aby wyłączyć tę naprawę tylko dla dev. pnpm OmeniaClaw setup to jednorazowy krok inicjalizacji lokalnej konfiguracji/obszaru roboczego dla świeżego checkoutu. pnpm gateway:watch nie przebudowuje dist/control-ui, więc uruchom ponownie pnpm ui:build po zmianach w ui/ albo używaj pnpm ui:dev podczas rozwijania interfejsu sterowania.

2) Skieruj aplikację macOS na działający Gateway

W OmeniaClaw.app:

• Tryb połączenia: lokalny Aplikacja podłączy się do działającego gateway na skonfigurowanym porcie.

3) Weryfikacja

• Status Gateway w aplikacji powinien brzmieć „Używanie istniejącego gateway …”
• Albo przez CLI:

OmeniaClaw health

Częste pułapki

• Zły port: Gateway WS domyślnie używa ws://127.0.0.1:18789; utrzymuj aplikację i CLI na tym samym porcie.
• Gdzie znajduje się stan:
  • Stan kanału/providera: ~/.OmeniaClaw/credentials/
  • Profile uwierzytelniania modeli: ~/.OmeniaClaw/agents/<agentId>/agent/auth-profiles.json
  • Sesje: ~/.OmeniaClaw/agents/<agentId>/sessions/
  • Logi: /tmp/OmeniaClaw/

Mapa przechowywania poświadczeń

Użyj tego podczas debugowania uwierzytelniania lub decydowania, co uwzględnić w kopii zapasowej:

• WhatsApp: ~/.OmeniaClaw/credentials/whatsapp/<accountId>/creds.json
• Token bota Telegram: konfiguracja/env albo channels.telegram.tokenFile (tylko zwykły plik; dowiązania symboliczne odrzucane)
• Token bota Discord: konfiguracja/env albo SecretRef (providery env/file/exec)
• Tokeny Slack: konfiguracja/env (channels.slack.*)
• Listy dozwolone dla parowania:
  • ~/.OmeniaClaw/credentials/<channel>-allowFrom.json (konto domyślne)
  • ~/.OmeniaClaw/credentials/<channel>-<accountId>-allowFrom.json (konta inne niż domyślne)
• Profile uwierzytelniania modeli: ~/.OmeniaClaw/agents/<agentId>/agent/auth-profiles.json
• Ładunek sekretów oparty na pliku (opcjonalnie): ~/.OmeniaClaw/secrets.json
• Import starszego OAuth: ~/.OmeniaClaw/credentials/oauth.json Więcej szczegółów: Bezpieczeństwo.

Aktualizowanie (bez niszczenia konfiguracji)

• Traktuj ~/.OmeniaClaw/workspace i ~/.OmeniaClaw/ jako „swoje rzeczy”; nie wkładaj osobistych promptów/konfiguracji do repozytorium OmeniaClaw.
• Aktualizowanie źródeł: git pull + pnpm install + dalsze używanie pnpm gateway:watch.

Linux (usługa użytkownika systemd)

Instalacje Linux używają usługi systemd użytkownika. Domyślnie systemd zatrzymuje usługi użytkownika po wylogowaniu/bezczynności, co zabija Gateway. Wdrażanie próbuje włączyć lingering za Ciebie (może poprosić o sudo). Jeśli nadal jest wyłączone, uruchom:

sudo loginctl enable-linger $USER

Dla serwerów zawsze włączonych lub wieloużytkownikowych rozważ usługę systemową zamiast usługi użytkownika (bez potrzeby lingering). Zobacz runbook Gateway, aby uzyskać notatki systemd.

Powiązane dokumenty

• Runbook Gateway (flagi, nadzór, porty)
• Konfiguracja Gateway (schemat konfiguracji + przykłady)
• Discord i Telegram (tagi odpowiedzi + ustawienia replyToMode)
• Konfiguracja asystenta OmeniaClaw
• Aplikacja macOS (cykl życia gateway)