CLI commands

العملية الخفية

`openclaw daemon`

اسم مستعار قديم لإدارة خدمة Gateway. يُطابق openclaw daemon ... أوامر التحكم في الخدمة نفسها التي يوفّرها openclaw gateway .... يُفضّل استخدام openclaw gateway في الوثائق والأمثلة الحالية.

الاستخدام

bash

openclaw daemon statusopenclaw daemon installopenclaw daemon startopenclaw daemon stopopenclaw daemon restartopenclaw daemon uninstall

الأوامر الفرعية والخيارات

الأمر الفرعي	الخيارات
`status`	`--url`, `--token`, `--password`, `--timeout`, `--no-probe`, `--require-rpc`, `--deep`, `--json`
`install`	`--port`, `--runtime <node\|bun>`, `--token`, `--wrapper <path>`, `--force`, `--json`
`uninstall`	`--json`
`start`	`--json`
`stop`	`--json`، `--disable` (في launchd فقط: تعطيل KeepAlive/RunAtLoad بصورة مستمرة حتى التشغيل التالي)
`restart`	`--force`, `--safe`, `--skip-deferral`, `--wait <duration>`, `--json`

status: يعرض حالة تثبيت الخدمة (launchd/systemd/schtasks) ويتحقق من سلامة Gateway.
install: يثبّت الخدمة؛ ويعيد --force تثبيت التثبيت الموجود أو يستبدله.
restart --safe: يطلب من Gateway قيد التشغيل إجراء فحص تمهيدي للعمل النشط وجدولة إعادة تشغيل واحدة مدمجة بعد انتهاء العمل، ضمن الحد الذي يحدده gateway.reload.deferralTimeoutMs (القيمة الافتراضية 300000 مللي ثانية/5 دقائق؛ اضبطه على 0 للانتظار إلى أجل غير مسمى). عند انتهاء هذه المهلة، تُفرض إعادة التشغيل في جميع الأحوال. يستخدم restart العادي مدير الخدمة مباشرةً؛ أما --force فهو التجاوز الفوري.
restart --safe --skip-deferral: يتجاوز بوابة تأجيل العمل النشط، بحيث يُعاد تشغيل Gateway فورًا حتى عند الإبلاغ عن عوائق. يتطلب --safe.

ملاحظات

يحلّ status مراجع الأسرار SecretRefs للمصادقة المُعدّة من أجل مصادقة الفحص متى أمكن. إذا تعذّر حل SecretRef مطلوب، يُبلغ status --json عن rpc.authWarning؛ مرّر --token/--password صراحةً أو عالج مصدر السر أولًا. تُخفى تحذيرات تعذّر حل المصادقة بمجرد نجاح الفحص من الجوانب الأخرى.
يضيف status --deep فحصًا على مستوى النظام وفق أفضل جهد بحثًا عن خدمات أخرى شبيهة بـ Gateway (ويطبع إرشادات التنظيف؛ وتظل التوصية هي تشغيل Gateway واحد لكل جهاز)، كما يُجري التحقق من الإعدادات في وضع واعٍ بالـ Plugin، ويُظهر تحذيرات بيان Plugin التي يتجاوزها المسار الافتراضي السريع.
في عمليات تثبيت systemd على Linux، تفحص اختبارات انحراف الرمز المميز مصدري الوحدة Environment= وEnvironmentFile= كليهما.
تحلّ اختبارات انحراف الرمز المميز مراجع الأسرار SecretRefs الخاصة بـ gateway.auth.token باستخدام بيئة وقت التشغيل المدمجة (بيئة أمر الخدمة أولًا، ثم بيئة العملية). إذا لم تكن مصادقة الرمز المميز مفعّلة فعليًا (gateway.auth.mode مضبوط على password/none/trusted-proxy، أو غير مضبوط مع إمكانية تغلّب كلمة المرور)، فيُتخطى حل رمز الإعدادات المميز.
يتحقق install من إمكانية حل gateway.auth.token المُدار عبر SecretRef، لكنه لا يحفظ القيمة المحلولة مطلقًا في بيانات بيئة الخدمة الوصفية؛ وإذا تعذّر حلها، يفشل التثبيت بصورة مغلقة وآمنة.
إذا كان كل من gateway.auth.token وgateway.auth.password مُعدًّا وكان gateway.auth.mode غير مضبوط، يحظر install المتابعة حتى تضبط الوضع صراحةً.
على macOS، يُبقي install ملفات plist الخاصة بـ LaunchAgent وملف البيئة/الغلاف المُنشأ مقتصرةً على المالك (الوضع 0600/0700) بدلًا من تضمين الأسرار في EnvironmentVariables.
لتشغيل عدة مثيلات Gateway على مضيف واحد: اعزل المنافذ والإعدادات/الحالة ومساحات العمل. راجع مثيلات Gateway المتعددة.

ذو صلة

Was this useful?