Ortam değişkenleri¶

OpenClaw, ortam değişkenlerini birden fazla kaynaktan alır. Kural şudur: mevcut değerleri asla geçersiz kılma.

Öncelik (en yüksek → en düşük)¶

1. Process environment (Gateway sürecinin üst kabuk/daemon’dan zaten aldığı değerler).
2. Geçerli çalışma dizinindeki .env (dotenv varsayılanı; geçersiz kılmaz).
3. ~/.openclaw/.env konumundaki genel .env (diğer adıyla $OPENCLAW_STATE_DIR/.env; geçersiz kılmaz).
4. ~/.openclaw/openclaw.json içindeki Config env bloğu (yalnızca eksikse uygulanır).
5. İsteğe bağlı login-shell içe aktarma (env.shellEnv.enabled veya OPENCLAW_LOAD_SHELL_ENV=1), yalnızca beklenen anahtarlar eksikse uygulanır.

Yapılandırma dosyası tamamen eksikse, 4. adım atlanır; shell içe aktarma etkinse yine de çalışır.

Config env bloğu¶

Satır içi ortam değişkenlerini ayarlamanın iki eşdeğer yolu (ikisi de geçersiz kılmaz):

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

Shell env içe aktarma¶

env.shellEnv, login shell’inizi çalıştırır ve yalnızca eksik beklenen anahtarları içe aktarır:

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

Ortam değişkeni eşdeğerleri:

• OPENCLAW_LOAD_SHELL_ENV=1
• OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000

Yapılandırmada ortam değişkeni ikamesi¶

Yapılandırmadaki dize değerlerinde ortam değişkenlerine ${VAR_NAME} sözdizimini kullanarak doğrudan başvurabilirsiniz:

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

Ayrıntılar için Configuration: Env var substitution bölümüne bakın.

Yol ile ilgili ortam değişkenleri¶

OPENCLAW_HOME¶

Ayarlandığında, OPENCLAW_HOME tüm dahili yol çözümlemeleri için sistem ana dizininin ($HOME / os.homedir()) yerine kullanılır. Bu, arayüzsüz hizmet hesapları için tam dosya sistemi yalıtımı sağlar.

Öncelik: OPENCLAW_HOME > $HOME > USERPROFILE > os.homedir()

Örnek (macOS LaunchDaemon):

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

OPENCLAW_HOME ayrıca tilde içeren bir yol olarak da ayarlanabilir (ör. ~/svc); bu yol, kullanılmadan önce $HOME kullanılarak genişletilir.

İlgili¶

• Gateway yapılandırması
• SSS: env vars ve .env yükleme
• Modeller genel bakış