> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ortam Değişkenleri

# 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):

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  models: {
    providers: {
      "vercel-gateway": {
        apiKey: "${VERCEL_GATEWAY_API_KEY}",
      },
    },
  },
}
```

Ayrıntılar için [Configuration: Env var substitution](/gateway/configuration#env-var-substitution-in-config) 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):

```xml theme={"theme":{"light":"min-light","dark":"min-dark"}}
<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ı](/gateway/configuration)
* [SSS: env vars ve .env yükleme](/help/faq#env-vars-and-env-loading)
* [Modeller genel bakış](/concepts/models)