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

يقوم 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 داخل الخط (كلاهما غير متجاوزتين):

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

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

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

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

مكافئات Env :

• OPENCLAW_LOAD_SHELL_ENV=1
• OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000

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

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

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

راجع التهيئة: استبدال متغيرات البيئة للحصول على التفاصيل الكاملة.

OPENCLAW_HOME¶

2. OPENCLAW_HOME¶

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

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

5. مثال (macOS LaunchDaemon):

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

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

ذات صلة¶

• تهيئة Gateway
• الأسئلة الشائعة: متغيرات البيئة وتحميل .env
• نظرة عامة على النماذج