.env-bestanden zijn een bron met een lager vertrouwensniveau: OpenClaw negeert providerreferenties en beschermde runtime-instellingen uit workspace-.env voordat de prioriteitsvolgorde wordt toegepast.
Prioriteitsvolgorde (van hoog naar laag)
- Procesomgeving (wat het Gateway-proces al van de bovenliggende shell/daemon heeft).
.envin de huidige werkmap (dotenv-standaard; overschrijft niets; providerreferenties en beschermde runtime-instellingen worden genegeerd).- Globale
.envop~/.openclaw/.env(ook bekend als$OPENCLAW_STATE_DIR/.env; aanbevolen voor API-sleutels van providers; overschrijft niets). - Configuratieblok
envin~/.openclaw/openclaw.json(alleen toegepast als de waarde ontbreekt). - Optionele import uit de aanmeldingsshell (
env.shellEnv.enabledofOPENCLAW_LOAD_SHELL_ENV=1), alleen toegepast voor ontbrekende verwachte sleutels.
~/.config/openclaw/gateway.env ook als compatibiliteitsterugval na de globale .env. Als beide bestanden bestaan en van elkaar verschillen, behoudt OpenClaw ~/.openclaw/.env en wordt een waarschuwing weergegeven.
Als het configuratiebestand volledig ontbreekt, wordt stap 4 overgeslagen; de shellimport wordt nog steeds uitgevoerd als deze is ingeschakeld.
Ondersteunde variabelen voor beheerders
De onderstaande variabelen vormen het ondersteunde omgevingscontract voor beheerders. Niet-gedocumenteerdeOPENCLAW_*-variabelen zijn interne implementatiedetails en kunnen zonder voorafgaande kennisgeving verdwijnen.
Paden en instanties
Gateway en authenticatie
Providerreferenties
De kern en meegeleverde providerplugins herkennen de volgende variabelen voor referenties en providerselectie. Geef de voorkeur aan de configuratie- of SecretRef-velden van elke provider wanneer je referenties met een beperkt bereik nodig hebt in plaats van één waarde voor het hele proces.AI_GATEWAY_API_KEY, ANTHROPIC_ADMIN_API_KEY, ANTHROPIC_ADMIN_KEY, ANTHROPIC_API_KEY, ANTHROPIC_OAUTH_TOKEN, ARCEEAI_API_KEY, AZURE_OPENAI_API_KEY, AZURE_SPEECH_API_KEY, AZURE_SPEECH_KEY, AZURE_SPEECH_REGION, BASETEN_API_KEY, BRAVE_API_KEY, BYTEPLUS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, CEREBRAS_API_KEY, CHUTES_API_KEY, CHUTES_OAUTH_TOKEN, CLAWROUTER_API_KEY, CLOUDFLARE_AI_GATEWAY_API_KEY, CODEX_API_KEY, COHERE_API_KEY, COMFY_API_KEY, COMFY_CLOUD_API_KEY, COPILOT_GITHUB_TOKEN, DASHSCOPE_API_KEY, DEEPGRAM_API_KEY, DEEPINFRA_API_KEY, DEEPSEEK_API_KEY, ELEVENLABS_API_KEY, EXA_API_KEY, FAL_API_KEY, FAL_KEY, FEATHERLESS_API_KEY, FIRECRAWL_API_KEY, FIREWORKS_API_KEY, GCLOUD_PROJECT, GEMINI_API_KEY, GH_TOKEN, GITHUB_TOKEN, GMI_API_KEY, GOOGLE_API_KEY, GOOGLE_APPLICATION_CREDENTIALS, GOOGLE_CLOUD_API_KEY, GOOGLE_CLOUD_LOCATION, GOOGLE_CLOUD_PROJECT, GRADIUM_API_KEY, GROQ_API_KEY, HF_TOKEN, HUGGINGFACE_HUB_TOKEN, INWORLD_API_KEY, KILOCODE_API_KEY, KIMICODE_API_KEY, KIMI_API_KEY, LITELLM_API_KEY, LM_API_TOKEN, LONGCAT_API_KEY, MINIMAX_API_KEY, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN, MISTRAL_API_KEY, MODELSTUDIO_API_KEY, MODEL_API_KEY, MOONSHOT_API_KEY, NOVITA_API_KEY, NVIDIA_API_KEY, OLLAMA_API_KEY, OPENAI_ADMIN_KEY, OPENAI_API_KEY, OPENCODE_API_KEY, OPENCODE_ZEN_API_KEY, OPENROUTER_API_KEY, PARALLEL_API_KEY, PERPLEXITY_API_KEY, PIXVERSE_API_KEY, QIANFAN_API_KEY, QWEN_API_KEY, QWEN_TOKEN_PLAN_API_KEY, RUNWAYML_API_SECRET, RUNWAY_API_KEY, SENSEAUDIO_API_KEY, SGLANG_API_KEY, SPEECH_KEY, SPEECH_REGION, STEPFUN_API_KEY, SYNTHETIC_API_KEY, TAVILY_API_KEY, TOGETHER_API_KEY, TOKENHUB_API_KEY, TOKENPLAN_API_KEY, VENICE_API_KEY, VLLM_API_KEY, VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, VOLCENGINE_TTS_APPID, VOLCENGINE_TTS_TOKEN, VOYAGE_API_KEY, VYDRA_API_KEY, XAI_API_KEY, XIAOMI_API_KEY, XIAOMI_TOKEN_PLAN_API_KEY, XI_API_KEY, ZAI_API_KEY en Z_AI_API_KEY.
Geïnstalleerde plugins van derden kunnen aanvullende referentievariabelen declareren in hun pluginmanifesten; deze variabelen zijn contracten van de Plugin die ze declareert, niet van de OpenClaw-kern.
Logboekregistratie en diagnostiek
Functie- en runtimeschakelaars
Providerreferenties en workspace-.env
Bewaar API-sleutels van providers niet uitsluitend in een workspace-.env. OpenClaw blokkeert een groot aantal sleutels voor providerreferenties en omleiding van eindpunten uit workspace-.env-bestanden, waaronder elke bekende omgevingsvariabele voor providerauthenticatie (bijvoorbeeld GEMINI_API_KEY, GOOGLE_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, GROQ_API_KEY, DEEPSEEK_API_KEY, PERPLEXITY_API_KEY, BRAVE_API_KEY, TAVILY_API_KEY, EXA_API_KEY, FIRECRAWL_API_KEY), plus elke sleutel die eindigt op _API_HOST, _BASE_URL, _ENDPOINT of _HOMESERVER, en de volledige naamruimten OPENCLAW_*, CLAWHUB_*, ANTHROPIC_API_KEY_* en OPENAI_API_KEY_*.
Gebruik in plaats daarvan een van deze vertrouwde bronnen voor providerreferenties:
- De procesomgeving van de Gateway, zoals een shell, launchd-/systemd-eenheid, containergeheim of CI-geheim.
- Het globale runtime-dotenv-bestand op
~/.openclaw/.envof$OPENCLAW_STATE_DIR/.env. - Het configuratieblok
envin~/.openclaw/openclaw.json. - Optionele import uit de aanmeldingsshell wanneer
env.shellEnv.enabledofOPENCLAW_LOAD_SHELL_ENV=1is ingeschakeld.
.env hebt opgeslagen, verplaats ze dan naar een van de bovenstaande vertrouwde bronnen. Workspace-.env kan nog steeds gewone projectvariabelen leveren die geen referenties, omleidingen van eindpunten, hostoverschrijvingen of OPENCLAW_*-runtime-instellingen zijn.
Zie Workspace-.env-bestanden voor de beveiligingsredenering.
Configuratieblok env
Twee gelijkwaardige manieren om inline omgevingsvariabelen in te stellen (beide overschrijven niets):
env accepteert alleen letterlijke tekenreekswaarden. Het breidt
file:...-waarden niet uit; XAI_API_KEY: "file:secrets/xai-api-key.txt" wordt bijvoorbeeld
als precies die tekenreeks aan providers doorgegeven.
Gebruik voor providersleutels uit bestanden een SecretRef in het referentieveld dat
dit ondersteunt:
Import van shellomgevingsvariabelen
env.shellEnv voert je aanmeldingsshell uit en importeert alleen ontbrekende verwachte sleutels:
OPENCLAW_LOAD_SHELL_ENV=1OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000(standaard15000)
Snapshots van de exec-shell
Op niet-Windows-Gateway-hosts gebruiken bash- en zsh-exec-opdrachten standaard een opstartsnapshot.
Stel OPENCLAW_EXEC_SHELL_SNAPSHOT=0 in de procesomgeving van de Gateway in om dit pad uit te schakelen.
De waarden false, no en off schakelen dit ook uit. exec.env-waarden per aanroep kunnen
snapshots niet in- of uitschakelen en de snapshotcache niet omleiden.
Tijdens runtime geïnjecteerde omgevingsvariabelen
OpenClaw injecteert ook contextmarkeringen in gestarte onderliggende processen:OPENCLAW_SHELL=exec: ingesteld voor opdrachten die via de toolexecworden uitgevoerd.OPENCLAW_SHELL=acp-client: ingesteld vooropenclaw acp clientwanneer deze het ACP-bridgeproces start.OPENCLAW_SHELL=tui-local: ingesteld voor lokale TUI-shellopdrachten van!.OPENCLAW_CLI=1: ingesteld voor onderliggende processen die door het CLI-ingangspunt worden gestart.
UI-omgevingsvariabelen
OPENCLAW_THEME=light: dwing het lichte TUI-palet af wanneer je terminal een lichte achtergrond heeft.OPENCLAW_THEME=dark: dwing het donkere TUI-palet af.COLORFGBG: als je terminal dit exporteert, gebruikt OpenClaw de hint voor de achtergrondkleur om automatisch het TUI-palet te kiezen.
Vervanging van omgevingsvariabelen in de configuratie
Je kunt rechtstreeks naar omgevingsvariabelen verwijzen in tekenreekswaarden van de configuratie met de syntaxis${VAR_NAME}:
Secretrefs versus ${ENV}-tekenreeksen
OpenClaw ondersteunt twee omgevingsgestuurde patronen:
${VAR}-tekenreeksvervanging in configuratiewaarden.- SecretRef-objecten (
{ source: "env", provider: "default", id: "VAR" }) voor velden die geheimreferenties ondersteunen.
env zelf herleidt geen SecretRefs of verkorte
file:...-waarden.
Padgerelateerde omgevingsvariabelen
Downloads van hulptools voor agents
StelOPENCLAW_OFFLINE=1 in om te voorkomen dat OpenClaw de vastgezette
hulpbinaire bestanden fd en ripgrep downloadt. Bestaande hulptools in de toolmap
van OpenClaw en werkende systeembinaire bestanden blijven bruikbaar; een ontbrekende hulptool blijft
niet beschikbaar in plaats van een netwerkverzoek te activeren.
Logboekregistratie
OPENCLAW_HOME
Wanneer dit is ingesteld, vervangt OPENCLAW_HOME de thuismap van het systeem ($HOME / os.homedir()) voor interne standaardpaden van OpenClaw. Dit omvat de standaardstatusmap, het configuratiepad, agentmappen, referenties, de onboardingwerkruimte van het installatieprogramma en de standaardontwikkelcheckout die door openclaw update --channel dev wordt gebruikt.
Voorrang: OPENCLAW_HOME > $HOME > USERPROFILE > terugval naar Termux-thuismap PREFIX op Android > os.homedir()
Voorbeeld (macOS LaunchDaemon):
OPENCLAW_HOME kan ook worden ingesteld op een pad met een tilde (bijv. ~/svc), dat vóór gebruik wordt uitgebreid via dezelfde terugvalketen voor de thuismap van het besturingssysteem.
Expliciete padvariabelen zoals OPENCLAW_STATE_DIR, OPENCLAW_CONFIG_PATH en OPENCLAW_GIT_DIR hebben nog steeds voorrang. Taken voor besturingssysteemaccounts, zoals het detecteren van opstartbestanden voor de shell, het instellen van de pakketbeheerder en het uitbreiden van ~ door de host, kunnen nog steeds de echte systeemthuismap gebruiken.
nvm-gebruikers: TLS-fouten van web_fetch
Als Node.js via nvm is geïnstalleerd (niet via de systeempakketbeheerder), gebruikt de ingebouwdefetch()
de gebundelde CA-opslag 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 op de meeste HTTPS-sites met "fetch failed".
Op Linux detecteert OpenClaw nvm automatisch en past het de oplossing toe in de daadwerkelijke opstartomgeving:
openclaw gateway installschrijftNODE_EXTRA_CA_CERTSnaar de omgeving van de systemd-service- het CLI-ingangspunt
openclawvoert zichzelf opnieuw uit metNODE_EXTRA_CA_CERTSingesteld voordat Node wordt gestart
node ...):
Exporteer de variabele voordat je OpenClaw start:
~/.openclaw/.env schrijft; Node leest
NODE_EXTRA_CA_CERTS bij het opstarten van het proces.
Verouderde omgevingsvariabelen
OpenClaw leest alleenOPENCLAW_*-omgevingsvariabelen. De verouderde voorvoegsels
CLAWDBOT_* en MOLTBOT_* uit eerdere releases worden stilzwijgend
genegeerd.
Als er bij het opstarten nog een of meer zijn ingesteld voor het Gateway-proces, genereert OpenClaw
één Node-verouderingswaarschuwing (OPENCLAW_LEGACY_ENV_VARS) met daarin de
gedetecteerde voorvoegsels en het totale aantal. Hernoem elke waarde door het
verouderde voorvoegsel te vervangen door OPENCLAW_ (bijvoorbeeld CLAWDBOT_GATEWAY_TOKEN naar
OPENCLAW_GATEWAY_TOKEN); de oude namen hebben geen effect.