Miljøvariabler¶

OpenClaw trækker miljøvariabler fra flere kilder. Reglen er aldrig tilsidesætte eksisterende værdier.

Forrang (højeste → laveste)¶

1. Procesmiljø (det som Gateway-processen allerede har fra den overordnede shell/daemon).
2. .env i den aktuelle arbejdsmappe (dotenv-standard; overskriver ikke).
3. Global .env ved ~/.openclaw/.env (også kendt som $OPENCLAW_STATE_DIR/.env; overskriver ikke).
4. Konfiguration env-blok i ~/.openclaw/openclaw.json (anvendes kun hvis mangler).
5. Valgfri login-shell-import (env.shellEnv.enabled eller OPENCLAW_LOAD_SHELL_ENV=1), anvendes kun for manglende forventede nøgler.

Hvis konfigurationsfilen mangler helt, springes trin 4 over; shell-import kører stadig, hvis den er aktiveret.

Konfiguration env-blok¶

To ækvivalente måder at angive inline-miljøvariabler på (begge overskriver ikke):

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

Shell-miljøimport¶

env.shellEnv kører din login-shell og importerer kun manglende forventede nøgler:

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

Ækvivalenter som miljøvariabler:

• OPENCLAW_LOAD_SHELL_ENV=1
• OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000

Substitution af miljøvariabler i konfiguration¶

Du kan referere til miljøvariabler direkte i konfigurations-strengværdier ved at bruge ${VAR_NAME}-syntaks:

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

Se Konfiguration: Substitution af miljøvariabler for fulde detaljer.

Sti-relaterede miljøvariabler¶

OPENCLAW_HOME¶

Når den er angivet, erstatter OPENCLAW_HOME systemets hjemmemappe ($HOME / os.homedir()) for al intern stiopløsning. Dette muliggør fuld filsystemisolering for headless servicekonti.

Precedence: OPENCLAW_HOME > $HOME > USERPROFILE > os.homedir()

Eksempel (macOS LaunchDaemon):

<key>EnvironmentVariables</key>
<dict>
  <key>OPENCLAW_HOME</key>
  <string>/Users/kira</string>
</dict>

OPENCLAW_HOME kan også angives som en tilde-sti (f.eks. ~/svc), som udvides ved hjælp af $HOME før brug.

Relateret¶

• Gateway-konfiguration
• FAQ: miljøvariabler og .env-indlæsning
• Modeloverblik