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)

Process environment (Gateway sürecinin üst kabuk/daemon’dan zaten aldığı değerler).
Geçerli çalışma dizinindeki .env (dotenv varsayılanı; geçersiz kılmaz).
~/.openclaw/.env konumundaki genel .env (diğer adıyla $OPENCLAW_STATE_DIR/.env; geçersiz kılmaz).
~/.openclaw/openclaw.json içindeki Config env bloğu (yalnızca eksikse uygulanır).
İ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şken	Amaç
`OPENCLAW_HOME`	Tü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_DIR`	Durum dizinini geçersiz kılar (varsayılan `~/.openclaw`).
`OPENCLAW_CONFIG_PATH`	Yapı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.

Yardım

Topluluk

Ortam ve hata ayıklama

Node çalışma zamanı

Sıkıştırma iç yapısı

Geliştirici kurulumu

Doküman meta bilgisi

Ortam Değişkenleri

Ortam değişkenleri

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

Config `env` bloğu

Shell env içe aktarma

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

Yol ile ilgili ortam değişkenleri

`OPENCLAW_HOME`

İlgili

​Ortam değişkenleri

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

​Config env bloğu

​Shell env içe aktarma

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

​Yol ile ilgili ortam değişkenleri

​OPENCLAW_HOME

​İlgili

Ortam değişkenleri

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

Config `env` bloğu

Shell env içe aktarma

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

Yol ile ilgili ortam değişkenleri

`OPENCLAW_HOME`

İlgili