Omgevingsvariabelen

OmeniaClaw haalt omgevingsvariabelen op uit meerdere bronnen. De regel is: bestaande waarden nooit overschrijven.

Prioriteit (hoogste → laagste)

1. Procesomgeving (wat het Gateway-proces al heeft van de bovenliggende shell/daemon).
2. .env in de huidige werkmap (dotenv-standaard; overschrijft niet).
3. Globale .env op ~/.OmeniaClaw/.env (ook bekend als $OmeniaClaw_STATE_DIR/.env; overschrijft niet).
4. Configuratie-env-blok in ~/.OmeniaClaw/OmeniaClaw.json (alleen toegepast als het ontbreekt).
5. Optionele login-shell-import (env.shellEnv.enabled of OmeniaClaw_LOAD_SHELL_ENV=1), alleen toegepast voor ontbrekende verwachte sleutels.

Op nieuwe Ubuntu-installaties die de standaard statusmap gebruiken, behandelt OmeniaClaw ook ~/.config/OmeniaClaw/gateway.env als compatibiliteitsfallback na de globale .env. Als beide bestanden bestaan en niet overeenkomen, behoudt OmeniaClaw ~/.OmeniaClaw/.env en toont het een waarschuwing.

Als het configuratiebestand volledig ontbreekt, wordt stap 4 overgeslagen; shell-import wordt nog steeds uitgevoerd als die is ingeschakeld.

Configuratie-env-blok

Twee gelijkwaardige manieren om inline omgevingsvariabelen in te stellen (beide overschrijven niet):

{  env: {    OPENROUTER_API_KEY: "sk-or-...",    vars: {      GROQ_API_KEY: "gsk-...",    },  },}

Shell-omgevingsimport

env.shellEnv voert je login-shell uit en importeert alleen ontbrekende verwachte sleutels:

{  env: {    shellEnv: {      enabled: true,      timeoutMs: 15000,    },  },}

Equivalenten als omgevingsvariabelen:

• OmeniaClaw_LOAD_SHELL_ENV=1
• OmeniaClaw_SHELL_ENV_TIMEOUT_MS=15000

Door runtime geïnjecteerde omgevingsvariabelen

OmeniaClaw injecteert ook contextmarkeringen in gespawnde onderliggende processen:

• OmeniaClaw_SHELL=exec: ingesteld voor opdrachten die via de exec-tool worden uitgevoerd.
• OmeniaClaw_SHELL=acp: ingesteld voor proces-spawns van de ACP-runtimebackend (bijvoorbeeld acpx).
• OmeniaClaw_SHELL=acp-client: ingesteld voor OmeniaClaw acp client wanneer dit het ACP-bridgeproces spawnt.
• OmeniaClaw_SHELL=tui-local: ingesteld voor lokale TUI-!-shellopdrachten.

Dit zijn runtimemarkeringen (geen vereiste gebruikersconfiguratie). Ze kunnen worden gebruikt in shell-/profiellogica om contextspecifieke regels toe te passen.

Omgevingsvariabelen voor UI

• OmeniaClaw_THEME=light: forceer het lichte TUI-palet wanneer je terminal een lichte achtergrond heeft.
• OmeniaClaw_THEME=dark: forceer het donkere TUI-palet.
• COLORFGBG: als je terminal dit exporteert, gebruikt OmeniaClaw de hint voor de achtergrondkleur om automatisch het TUI-palet te kiezen.

Vervanging van omgevingsvariabelen in configuratie

Je kunt rechtstreeks naar omgevingsvariabelen verwijzen in stringwaarden van de configuratie met de syntaxis ${VAR_NAME}:

{  models: {    providers: {      "vercel-gateway": {        apiKey: "${VERCEL_GATEWAY_API_KEY}",      },    },  },}

Zie Configuratie: vervanging van omgevingsvariabelen voor alle details.

Secret refs versus ${ENV}-strings

OmeniaClaw ondersteunt twee patronen op basis van omgevingsvariabelen:

• ${VAR}-stringvervanging in configuratiewaarden.
• SecretRef-objecten ({ source: "env", provider: "default", id: "VAR" }) voor velden die verwijzingen naar geheimen ondersteunen.

Beide worden tijdens activering opgelost vanuit de procesomgeving. Details over SecretRef zijn gedocumenteerd in Beheer van geheimen.

Padgerelateerde omgevingsvariabelen

Logboekregistratie

OmeniaClaw_HOME

Wanneer ingesteld, vervangt OmeniaClaw_HOME de systeemthuismap ($HOME / os.homedir()) voor alle interne padresolutie. Dit maakt volledige bestandssysteemisolatie mogelijk voor headless serviceaccounts.

Prioriteit: OmeniaClaw_HOME > $HOME > USERPROFILE > os.homedir()

Voorbeeld (macOS LaunchDaemon):

<key>EnvironmentVariables</key><dict>  <key>OmeniaClaw_HOME</key>  <string>/Users/user</string></dict>

OmeniaClaw_HOME kan ook worden ingesteld op een tilde-pad (bijv. ~/svc), dat vóór gebruik wordt uitgebreid met $HOME.

nvm-gebruikers: TLS-fouten met web_fetch

Als Node.js via nvm is geïnstalleerd (niet via de systeempackagebeheerder), gebruikt de ingebouwde fetch() de gebundelde CA-store van nvm, waarin moderne root-CA's kunnen ontbreken (ISRG Root X1/X2 voor Let's Encrypt, DigiCert Global Root G2, enz.). Hierdoor mislukt web_fetch met "fetch failed" op de meeste HTTPS-sites.

Op Linux detecteert OmeniaClaw nvm automatisch en past het de oplossing toe in de daadwerkelijke opstartomgeving:

• OmeniaClaw gateway install schrijft NODE_EXTRA_CA_CERTS naar de systemd-serviceomgeving
• het OmeniaClaw CLI-entrypoint voert zichzelf opnieuw uit met NODE_EXTRA_CA_CERTS ingesteld vóór het opstarten van Node

Handmatige oplossing (voor oudere versies of directe node ...-starts):

Exporteer de variabele voordat je OmeniaClaw start:

export NODE_EXTRA_CA_CERTS=/etc/ssl/certs/ca-certificates.crtOmeniaClaw gateway run

Vertrouw er niet op dat je voor deze variabele alleen naar ~/.OmeniaClaw/.env schrijft; Node leest NODE_EXTRA_CA_CERTS bij het opstarten van het proces.

Verouderde omgevingsvariabelen

OmeniaClaw leest alleen OmeniaClaw_*-omgevingsvariabelen. De verouderde voorvoegsels CLAWDBOT_* en MOLTBOT_* uit eerdere releases worden stilzwijgend genegeerd.

Als er bij het opstarten nog een van deze variabelen is ingesteld op het Gateway-proces, geeft OmeniaClaw een enkele Node-deprecationwaarschuwing (OmeniaClaw_LEGACY_ENV_VARS) weer met de gedetecteerde voorvoegsels en het totale aantal. Hernoem elke waarde door het verouderde voorvoegsel te vervangen door OmeniaClaw_ (bijvoorbeeld CLAWDBOT_GATEWAY_TOKEN → OmeniaClaw_GATEWAY_TOKEN); de oude namen hebben geen effect.

Gerelateerd

• Gateway-configuratie
• FAQ: omgevingsvariabelen en .env-laden
• Modellenoverzicht