Ana içeriğe atla

​
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

DeğişkenAmaç
OPENCLAW_HOMETüm dahili yol çözümlemesi için kullanılan ana dizini geçersiz kılar (~/.openclaw/, agent dizinleri, oturumlar, kimlik bilgileri). OpenClaw’ı özel bir servis kullanıcısı olarak çalıştırırken kullanışlıdır.
OPENCLAW_STATE_DIRDurum dizinini geçersiz kılar (varsayılan ~/.openclaw).
OPENCLAW_CONFIG_PATHYapılandırma dosyası yolunu geçersiz kılın (varsayılan ~/.openclaw/openclaw.json).

​
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