> ## 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.

# متغيرات البيئة

# متغيرات البيئة

يقوم OpenClaw بسحب متغيرات البيئة من مصادر متعددة. القاعدة هي **عدم تجاوز القيم الموجودة مطلقًا**.

## الأسبقية (من الأعلى → الأدنى)

1. **بيئة العملية** (ما يملكه بالفعل مُعالج Gateway من الغلاف/الخدمة الأصلية).
2. **`.env` في دليل العمل الحالي** (إعداد dotenv الافتراضي؛ لا يتجاوز).
3. **`.env` عالمي** في `~/.openclaw/.env` (المعروف أيضًا باسم `$OPENCLAW_STATE_DIR/.env`؛ لا يتجاوز).
4. **كتلة `env` في التهيئة** ضمن `~/.openclaw/openclaw.json` (تُطبَّق فقط إذا كانت القيم مفقودة).
5. **استيراد اختياري من غلاف تسجيل الدخول** (`env.shellEnv.enabled` أو `OPENCLAW_LOAD_SHELL_ENV=1`)، ويُطبَّق فقط للمفاتيح المتوقعة المفقودة.

إذا كان ملف التهيئة مفقودًا بالكامل، يتم تخطي الخطوة 4؛ ولا يزال استيراد الغلاف يعمل إذا كان مُمكّنًا.

## كتلة التهيئة `env`

طريقتان معادلتان لتعيين vars env داخل الخط (كلاهما غير متجاوزتين):

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: {
      GROQ_API_KEY: "gsk-...",
    },
  },
}
```

## استيراد قذيفة

يشغّل `env.shellEnv` غلاف تسجيل الدخول لديك ويستورد فقط المفاتيح المتوقعة **المفقودة**:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: {
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}
```

مكافئات Env :

* `OPENCLAW_LOAD_SHELL_ENV=1`
* `OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000`

## استبدال Env var في التهيئة

يمكنك الإشارة إلى متغيرات البيئة مباشرةً داخل قيم السلاسل النصية في التهيئة باستخدام صيغة `${VAR_NAME}`:

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

راجع [التهيئة: استبدال متغيرات البيئة](/gateway/configuration#env-var-substitution-in-config) للحصول على التفاصيل الكاملة.

## `OPENCLAW_HOME`

| المتغير                | الغرض                                                                                                                                                                |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `OPENCLAW_HOME`        | تجاوز الدليل الرئيسي المستخدم لجميع عمليات حل المسارات الداخلية (`~/.openclaw/`، أدلة الوكلاء، الجلسات، بيانات الاعتماد). مفيد عند تشغيل OpenClaw كمستخدم خدمة مخصص. |
| `OPENCLAW_STATE_DIR`   | تجاوز دليل الحالة (الافتراضي `~/.openclaw`).                                                                                                                         |
| `OPENCLAW_CONFIG_PATH` | تجاوز مسار ملف الإعدادات (الافتراضي `~/.openclaw/openclaw.json`).                                                                                                    |

### `OPENCLAW_HOME`

عند تعيينه، يستبدل `OPENCLAW_HOME` دليل المنزل الخاص بالنظام (`$HOME` / `os.homedir()`) لجميع عمليات حل المسارات الداخلية. يتيح ذلك عزلاً كاملاً لنظام الملفات لحسابات الخدمات بدون واجهة (headless).

**الأولوية:** `OPENCLAW_HOME` > `$HOME` > `USERPROFILE` > `os.homedir()`

**مثال** (macOS LaunchDaemon):

```xml theme={"theme":{"light":"min-light","dark":"min-dark"}}
7. <key>EnvironmentVariables</key>
<dict>
  <key>OPENCLAW_HOME</key>
  <string>/Users/kira</string>
</dict>
```

يمكن أيضاً تعيين `OPENCLAW_HOME` إلى مسار يبدأ بالـ tilde (مثل `~/svc`)، حيث يتم توسيعه باستخدام `$HOME` قبل الاستخدام.

## ذات صلة

* [تهيئة Gateway](/gateway/configuration)
* [الأسئلة الشائعة: متغيرات البيئة وتحميل .env](/help/faq#env-vars-and-env-loading)
* [نظرة عامة على النماذج](/concepts/models)