---
read_when:
    - ما زلت تستخدم `openclaw daemon ...` في السكربتات
    - تحتاج إلى أوامر دورة حياة الخدمة (install/start/stop/restart/status)
summary: مرجع CLI لـ `openclaw daemon` (اسم مستعار قديم لإدارة خدمة Gateway)
title: الخدمة الخلفية
x-i18n:
    generated_at: "2026-05-11T20:27:17Z"
    model: gpt-5.5
    provider: openai
    source_hash: 0131c3838ac0240f38e755eb779134d19a935821d90bb2898648b947696be12e
    source_path: cli/daemon.md
    workflow: 16
---

# `openclaw daemon`

اسم مستعار قديم لأوامر إدارة خدمة Gateway.

يُطابق `openclaw daemon ...` سطح التحكم في الخدمة نفسه الذي تستخدمه أوامر خدمة `openclaw gateway ...`.

## الاستخدام

```bash
openclaw daemon status
openclaw daemon install
openclaw daemon start
openclaw daemon stop
openclaw daemon restart
openclaw daemon uninstall
```

## الأوامر الفرعية

- `status`: عرض حالة تثبيت الخدمة وفحص سلامة Gateway
- `install`: تثبيت الخدمة (`launchd`/`systemd`/`schtasks`)
- `uninstall`: إزالة الخدمة
- `start`: بدء الخدمة
- `stop`: إيقاف الخدمة
- `restart`: إعادة تشغيل الخدمة

## الخيارات الشائعة

- `status`: `--url`, `--token`, `--password`, `--timeout`, `--no-probe`, `--require-rpc`, `--deep`, `--json`
- `install`: `--port`, `--runtime <node|bun>`, `--token`, `--force`, `--json`
- `restart`: `--safe`, `--skip-deferral`, `--force`, `--wait <duration>`, `--json`
- دورة الحياة (`uninstall|start|stop`): `--json`

ملاحظات:

- يحلّ `status` مراجع الأسرار المكوّنة للمصادقة من أجل مصادقة الفحص عندما يكون ذلك ممكنًا.
- إذا تعذّر حل مرجع سر مطلوب في مسار هذا الأمر، فإن `daemon status --json` يبلّغ عن `rpc.authWarning` عند فشل اتصال الفحص أو المصادقة؛ مرّر `--token`/`--password` صراحةً أو حلّ مصدر السر أولًا.
- إذا نجح الفحص، تُخفى تحذيرات مراجع المصادقة غير المحلولة لتجنّب النتائج الإيجابية الكاذبة.
- يضيف `status --deep` فحصًا على مستوى النظام للخدمة بأفضل جهد. عندما يعثر على خدمات أخرى شبيهة بالبوابة، تطبع المخرجات البشرية تلميحات تنظيف وتحذّر بأن بوابة واحدة لكل جهاز لا تزال هي التوصية المعتادة.
- يشغّل `status --deep` أيضًا التحقق من صحة التكوين في وضع واعٍ بـ Plugin ويعرض تحذيرات بيان Plugin المكوّنة (مثل بيانات تعريف تكوين القناة المفقودة) حتى تلتقطها فحوصات التثبيت والتحديث السريعة. يحافظ `status` الافتراضي على المسار السريع للقراءة فقط الذي يتخطى التحقق من Plugin.
- في تثبيتات Linux systemd، تتضمن فحوصات انحراف الرمز المميز في `status` مصادر الوحدة `Environment=` و`EnvironmentFile=` كليهما.
- تحلّ فحوصات الانحراف مراجع أسرار `gateway.auth.token` باستخدام بيئة التشغيل المدمجة (بيئة أمر الخدمة أولًا، ثم بيئة العملية كخيار احتياطي).
- إذا لم تكن مصادقة الرمز المميز نشطة فعليًا (قيمة `gateway.auth.mode` صريحة هي `password`/`none`/`trusted-proxy`، أو كان الوضع غير مضبوط بحيث يمكن أن تنتصر كلمة المرور ولا يمكن لأي مرشح رمز مميز أن ينتصر)، تتخطى فحوصات انحراف الرمز المميز حل رمز التكوين.
- عندما تتطلب مصادقة الرمز المميز رمزًا ويكون `gateway.auth.token` مُدارًا بمرجع سر، يتحقق `install` من أن مرجع السر قابل للحل لكنه لا يحفظ الرمز المحلول في بيانات تعريف بيئة الخدمة.
- إذا تطلبت مصادقة الرمز المميز رمزًا وكان مرجع سر الرمز المكوّن غير محلول، يفشل التثبيت بطريقة مغلقة.
- إذا كان كل من `gateway.auth.token` و`gateway.auth.password` مكوّنين وكان `gateway.auth.mode` غير مضبوط، يُحظر التثبيت إلى أن يُضبط الوضع صراحةً.
- على macOS، يحافظ `install` على ملفات plist الخاصة بـ LaunchAgent مقصورة على المالك فقط، ويحمّل قيم بيئة الخدمة المُدارة عبر ملف وغلاف مقصورين على المالك بدلًا من تسلسل مفاتيح API أو مراجع بيئة ملفات تعريف المصادقة داخل `EnvironmentVariables`.
- إذا كنت تشغّل عمدًا بوابات متعددة على مضيف واحد، فاعزل المنافذ والتكوين/الحالة ومساحات العمل؛ راجع [/gateway#multiple-gateways-same-host](/ar/gateway#multiple-gateways-same-host).
- يطلب `restart --safe` من Gateway الجاري تشغيله إجراء فحص تمهيدي للعمل النشط وجدولة إعادة تشغيل واحدة مدمجة بعد انتهاء العمل النشط. يحافظ `restart` العادي على سلوك مدير الخدمة الحالي؛ ويبقى `--force` مسار التجاوز الفوري.
- يشغّل `restart --safe --skip-deferral` إعادة التشغيل الآمنة الواعية بـ OpenClaw لكنه يتجاوز بوابة تأجيل العمل النشط بحيث يصدر Gateway إعادة التشغيل فورًا حتى عند الإبلاغ عن عوائق. هذا منفذ خروج للمشغّل عندما يثبت تشغيل مهمة عالق إعادة التشغيل الآمنة؛ ويتطلب `--safe`.

## المفضّل

استخدم [`openclaw gateway`](/ar/cli/gateway) للاطلاع على الوثائق والأمثلة الحالية.

## ذو صلة

- [مرجع CLI](/ar/cli)
- [دليل تشغيل Gateway](/ar/gateway)