openclaw crestodian

Crestodian هو مساعد OpenClaw المحلي للإعداد والإصلاح والتكوين. صُمم ليبقى قابلًا للوصول عندما يكون مسار الوكيل المعتاد معطلًا.

تشغيل openclaw دون أمر يبدأ أولًا الإعداد الكلاسيكي عند فقدان ملف التكوين النشط أو عندما لا يحتوي على إعدادات مؤلفة (فارغ أو بيانات وصفية فقط). بعد أن يحتوي ملف التكوين على إعدادات مؤلفة، فإن تشغيل openclaw دون أمر يبدأ Crestodian في طرفية تفاعلية. تشغيل openclaw crestodian يبدأ المساعد نفسه صراحة.

ما يعرضه Crestodian

عند بدء التشغيل، يفتح Crestodian التفاعلي غلاف TUI نفسه المستخدم بواسطة openclaw tui، مع خلفية دردشة Crestodian. يبدأ سجل الدردشة بتحية قصيرة:

• متى تبدأ Crestodian
• النموذج أو مسار المخطط الحتمي الذي يستخدمه Crestodian فعليًا
• صلاحية التكوين والوكيل الافتراضي
• قابلية الوصول إلى Gateway من فحص بدء التشغيل الأول
• إجراء التصحيح التالي الذي يستطيع Crestodian اتخاذه

لا يفرغ الأسرار أو يحمّل أوامر CLI الخاصة بالـ Plugin لمجرد البدء. ما زال TUI يوفر الترويسة العادية، وسجل الدردشة، وسطر الحالة، والتذييل، والإكمال التلقائي، وعناصر التحكم في المحرر.

استخدم status للحصول على الجرد المفصل مع مسار التكوين، ومسارات الوثائق/المصدر، وفحوص CLI المحلية، ووجود مفتاح API، والوكلاء، والنموذج، وتفاصيل Gateway.

يستخدم Crestodian اكتشاف مراجع OpenClaw نفسه الذي يستخدمه الوكلاء العاديون. في نسخة Git، يوجه نفسه إلى docs/ المحلية وشجرة المصدر المحلية. في تثبيت حزمة npm، يستخدم وثائق الحزمة المضمنة ويربط إلى https://github.com/openclaw/openclaw، مع إرشاد صريح لمراجعة المصدر كلما لم تكن الوثائق كافية.

أمثلة

openclawopenclaw crestodianopenclaw crestodian --jsonopenclaw crestodian --message "models"openclaw crestodian --message "validate config"openclaw crestodian --message "setup workspace ~/Projects/work model openai/gpt-5.5" --yesopenclaw crestodian --message "set default model openai/gpt-5.5" --yesopenclaw onboard --modern

داخل TUI الخاص بـ Crestodian:

statushealthdoctordoctor fixvalidate configsetupsetup workspace ~/Projects/work model openai/gpt-5.5config set gateway.port 19001config set-ref gateway.auth.token env OPENCLAW_GATEWAY_TOKENgateway statusrestart gatewayagentscreate agent work workspace ~/Projects/workmodelsset default model openai/gpt-5.5plugins listplugins search slackplugin install clawhub:openclaw-codex-app-serverplugin uninstall openclaw-codex-app-servertalk to work agenttalk to agent for ~/Projects/workauditquit

بدء تشغيل آمن

مسار بدء تشغيل Crestodian صغير عمدًا. يمكنه العمل عندما:

• يكون openclaw.json مفقودًا
• يكون openclaw.json غير صالح
• يكون Gateway متوقفًا
• يكون تسجيل أوامر Plugin غير متاح
• لم يتم تكوين أي وكيل بعد

ما زال openclaw --help وopenclaw --version يستخدمان المسارات السريعة العادية. يخرج openclaw العاري غير التفاعلي برسالة قصيرة بدلًا من طباعة مساعدة الجذر. في تثبيت جديد، تشير الرسالة إلى الإعداد غير التفاعلي؛ وبعد الإعداد، تشير إلى أوامر Crestodian أحادية التنفيذ.

العمليات والموافقة

يستخدم Crestodian عمليات ذات أنواع محددة بدلًا من تحرير التكوين على نحو ارتجالي.

يمكن تشغيل العمليات للقراءة فقط فورًا:

• عرض النظرة العامة
• سرد الوكلاء
• سرد Plugins المثبتة
• البحث في Plugins الخاصة بـ ClawHub
• عرض حالة النموذج/الخلفية
• تشغيل فحوص الحالة أو السلامة
• فحص قابلية الوصول إلى Gateway
• تشغيل doctor دون إصلاحات تفاعلية
• التحقق من صحة التكوين
• عرض مسار سجل التدقيق

تتطلب العمليات الدائمة موافقة محادثية في الوضع التفاعلي ما لم تمرر --yes لأمر مباشر:

• كتابة التكوين
• تشغيل config set
• تعيين قيم SecretRef المدعومة عبر config set-ref
• تشغيل تمهيد الإعداد/التهيئة
• تغيير النموذج الافتراضي
• بدء Gateway أو إيقافه أو إعادة تشغيله
• إنشاء الوكلاء
• تثبيت Plugins من ClawHub أو npm
• إلغاء تثبيت Plugins
• تشغيل إصلاحات doctor التي تعيد كتابة التكوين أو الحالة

تُسجل الكتابات المطبقة في:

~/.openclaw/audit/crestodian.jsonl

لا يخضع الاكتشاف للتدقيق. لا تُسجل إلا العمليات والكتابات المطبقة.

openclaw onboard --modern يبدأ Crestodian كمعاينة الإعداد الحديثة. أما openclaw onboard العادي فما زال يشغل الإعداد الكلاسيكي.

تمهيد الإعداد

setup هو تمهيد الإعداد المعتمد على الدردشة أولًا. يكتب فقط عبر عمليات تكوين ذات أنواع محددة ويطلب الموافقة أولًا.

setupsetup workspace ~/Projects/worksetup workspace ~/Projects/work model openai/gpt-5.5

عندما لا يكون هناك نموذج مكوَّن، يختار الإعداد أول خلفية قابلة للاستخدام بهذا الترتيب ويخبرك بما اختاره:

• النموذج الصريح الموجود، إذا كان مكوّنًا بالفعل
• OPENAI_API_KEY -> openai/gpt-5.5
• ANTHROPIC_API_KEY -> anthropic/claude-opus-4-8
• Claude Code CLI -> claude-cli/claude-opus-4-8
• Codex -> openai/gpt-5.5 عبر حزمة تطبيق خادم Codex

إذا لم يكن أي منها متاحًا، يظل الإعداد يكتب مساحة العمل الافتراضية ويترك النموذج غير مضبوط. ثبّت Codex/Claude Code أو سجّل الدخول إليهما، أو أتح OPENAI_API_KEY/ANTHROPIC_API_KEY، ثم شغّل الإعداد مرة أخرى.

المخطط بمساعدة النموذج

يبدأ Crestodian دائمًا في الوضع الحتمي. بالنسبة إلى الأوامر الغامضة التي لا يفهمها المحلل الحتمي، يمكن لـ Crestodian المحلي إجراء دورة مخطط واحدة محدودة عبر مسارات وقت التشغيل العادية في OpenClaw. يستخدم أولًا نموذج OpenClaw المكوّن. إذا لم يكن هناك نموذج مكوّن قابل للاستخدام بعد، فيمكنه الرجوع إلى أوقات التشغيل المحلية الموجودة بالفعل على الجهاز:

• Claude Code CLI: claude-cli/claude-opus-4-8
• حزمة تطبيق خادم Codex: openai/gpt-5.5

لا يستطيع المخطط بمساعدة النموذج تعديل التكوين مباشرة. يجب أن يترجم الطلب إلى أحد أوامر Crestodian ذات الأنواع المحددة، ثم تُطبق قواعد الموافقة والتدقيق العادية. يطبع Crestodian النموذج الذي استخدمه والأمر المفسر قبل تشغيل أي شيء. دورات مخطط الرجوع بلا تكوين مؤقتة، ومعطلة الأدوات حيث يدعم وقت التشغيل ذلك، وتستخدم مساحة عمل/جلسة مؤقتة.

لا يستخدم وضع الإنقاذ عبر قناة الرسائل المخطط بمساعدة النموذج. يبقى الإنقاذ البعيد حتميًا حتى لا يُستخدم مسار وكيل عادي معطل أو مخترق كمحرر تكوين.

التبديل إلى وكيل

استخدم محددًا بلغة طبيعية لمغادرة Crestodian وفتح TUI العادي:

talk to agenttalk to work agentswitch to main agent

ما زالت openclaw tui وopenclaw chat وopenclaw terminal تفتح TUI الوكيل العادي مباشرة. إنها لا تبدأ Crestodian.

بعد التبديل إلى TUI العادي، استخدم /crestodian للعودة إلى Crestodian. يمكنك تضمين طلب متابعة:

/crestodian/crestodian restart gateway

تترك تبديلات الوكلاء داخل TUI أثرًا يدل على أن /crestodian متاح.

وضع الإنقاذ عبر الرسائل

وضع الإنقاذ عبر الرسائل هو نقطة دخول قناة الرسائل إلى Crestodian. وهو مخصص للحالة التي يكون فيها وكيلك العادي متوقفًا، لكن قناة موثوقة مثل WhatsApp ما زالت تستقبل الأوامر.

أمر النص المدعوم:

• /crestodian <request>

تدفق المشغّل:

You, in a trusted owner DM: /crestodian statusOpenClaw: Crestodian rescue mode. Gateway reachable: no. Config valid: no.You: /crestodian restart gatewayOpenClaw: Plan: restart the Gateway. Reply /crestodian yes to apply.You: /crestodian yesOpenClaw: Applied. Audit entry written.

يمكن أيضًا وضع إنشاء الوكيل في قائمة الانتظار من المطالبة المحلية أو وضع الإنقاذ:

create agent work workspace ~/Projects/work model openai/gpt-5.5/crestodian create agent work workspace ~/Projects/work

وضع الإنقاذ البعيد سطح إداري. يجب التعامل معه كإصلاح تكوين بعيد، لا كدردشة عادية.

عقد الأمان للإنقاذ البعيد:

• معطل عندما يكون وضع العزل نشطًا. إذا كان وكيل/جلسة معزولًا، فيجب أن يرفض Crestodian الإنقاذ البعيد ويوضح أن إصلاح CLI المحلي مطلوب.
• الحالة الفعلية الافتراضية هي auto: السماح بالإنقاذ البعيد فقط في تشغيل YOLO موثوق، حيث يكون لدى وقت التشغيل بالفعل سلطة محلية غير معزولة.
• يتطلب هوية مالك صريحة. يجب ألا يقبل الإنقاذ قواعد مرسل عامة، أو سياسة مجموعة مفتوحة، أو Webhooks غير مصادق عليها، أو قنوات مجهولة.
• رسائل المالك المباشرة فقط افتراضيًا. يتطلب إنقاذ المجموعة/القناة اشتراكًا صريحًا.
• البحث عن Plugin وسرده للقراءة فقط. تثبيت Plugin محلي فقط افتراضيًا لأنه ينزل كودًا قابلًا للتنفيذ. يمكن السماح بإلغاء تثبيت Plugin كعملية إصلاح معتمدة عندما تسمح سياسة الإنقاذ بالكتابات الدائمة.
• لا يستطيع الإنقاذ البعيد فتح TUI المحلي أو التبديل إلى جلسة وكيل تفاعلية. استخدم openclaw المحلي لتسليم الوكيل.
• ما زالت الكتابات الدائمة تتطلب موافقة، حتى في وضع الإنقاذ.
• دقق كل عملية إنقاذ مطبقة. يسجل إنقاذ قناة الرسائل القناة والحساب والمرسل وبيانات تعريف عنوان المصدر. وتسجل العمليات التي تعدل التكوين أيضًا تجزئات التكوين قبل وبعد.
• لا تردد الأسرار أبدًا. يجب أن يبلّغ فحص SecretRef عن التوافر، لا القيم.
• إذا كان Gateway حيًا، ففضّل عمليات Gateway ذات الأنواع المحددة. إذا كان Gateway متوقفًا، فاستخدم فقط سطح الإصلاح المحلي الأدنى الذي لا يعتمد على حلقة الوكيل العادية.

شكل التكوين:

{  "crestodian": {    "rescue": {      "enabled": "auto",      "ownerDmOnly": true,    },  },}

يجب أن يقبل enabled:

• "auto": الافتراضي. السماح فقط عندما يكون وقت التشغيل الفعلي هو YOLO ويكون العزل متوقفًا.
• false: عدم السماح أبدًا بالإنقاذ عبر قناة الرسائل.
• true: السماح صراحة بالإنقاذ عندما تنجح فحوص المالك/القناة. ما زال هذا يجب ألا يتجاوز رفض العزل.

وضع YOLO الافتراضي "auto" هو:

• يحل وضع العزل إلى off
• يحل tools.exec.security إلى full
• يحل tools.exec.ask إلى off

يغطي مسار Docker الإنقاذ البعيد:

pnpm test:docker:crestodian-rescue

يغطي ما يلي رجوع المخطط المحلي بلا تكوين:

pnpm test:docker:crestodian-planner

يفحص اختبار دخان سطح أوامر قناة حي اختياري /crestodian status بالإضافة إلى رحلة موافقة دائمة ذهابًا وإيابًا عبر معالج الإنقاذ:

pnpm test:live:crestodian-rescue-channel

يغطي ما يلي الإعداد بلا تكوين عبر أوامر Crestodian الصريحة:

pnpm test:docker:crestodian-first-run

يبدأ ذلك المسار بدليل حالة فارغ، ويتحقق من نقطة دخول Crestodian الحديثة عبر onboard، ويعيّن النموذج الافتراضي، وينشئ وكيلًا إضافيًا، ويكوّن Discord عبر تمكين Plugin بالإضافة إلى SecretRef للرمز، ويتحقق من صحة التكوين، ويفحص سجل التدقيق. لدى QA Lab أيضًا سيناريو مدعومًا من المستودع لتدفق Ring 0 نفسه:

pnpm openclaw qa suite --scenario crestodian-ring-zero-setup

ذات صلة

• مرجع CLI
• Doctor
• TUI
• العزل
• الأمان