في هذه الصفحة
في هذه الصفحة
CLI commands
مرجع CLI
openclaw هو نقطة الدخول الرئيسية إلى CLI. لكل أمر أساسي
صفحة مرجعية مخصصة أو يُوثَّق مع الأمر الذي يُعد اسمًا مستعارًا له؛ يسرد هذا الفهرس
الأوامر والعلامات العامة وقواعد تنسيق المخرجات التي تنطبق في CLI بأكمله.
أوامر الإعداد حسب الغرض:
openclaw setupوopenclaw onboardيتحققان من الاستدلال أولًا، ثم يشغّلان OpenClaw لإعداد Gateway ومساحة العمل والقنوات والمهارات والحالة الصحية.openclaw setup --baselineينشئ الإعدادات الأساسية ومساحة العمل من دون المرور بتدفق الإعداد الأولي الموجّه.openclaw configureيغيّر أجزاء محددة من إعداد قائم: مصادقة النموذج أو Gateway أو القنوات أو plugins أو المهارات.openclaw channels addيضبط حسابات القنوات بعد وجود الإعدادات الأساسية؛ شغّله دون علامات للإعداد الموجّه، أو مع علامات خاصة بالقنوات لاستخدامه في البرامج النصية.
صفحات الأوامر
| المجال | الأوامر |
|---|---|
| الإعداد والتهيئة الأولية | openclaw · setup · onboard · configure · config · completion · doctor · dashboard |
| إعادة الضبط والنسخ الاحتياطي والترحيل | backup · migrate · reset · uninstall · update |
| المراسلة والوكلاء | message · agent · agents · attach · acp · mcp |
| الحالة الصحية والجلسات | status · health · sessions · audit |
| Gateway والسجلات | gateway · logs · system |
| النماذج والاستدلال | models · promos · infer · capability (اسم مستعار لـ infer) · memory · commitments · wiki |
| الشبكة والعُقد | directory · nodes · devices · node · worker |
| بيئة التشغيل والعزل | approvals · exec-policy (راجع approvals) · sandbox · tui · chat/terminal (اسمان مستعاران لـ tui --local) · browser |
| الأتمتة | cron · tasks · hooks · webhooks · transcripts |
| الاكتشاف والتوثيق | dns · docs |
| الاقتران والقنوات | pairing · qr · channels |
| الأمان وplugins | security · secrets · skills · plugins · proxy |
| الأسماء المستعارة القديمة | daemon (خدمة Gateway) · clawbot (نطاق أسماء) |
| Plugins (اختيارية) | path · policy · voicecall · workboard (إذا كانت مثبّتة) |
العلامات العامة
| العلامة | الغرض |
|---|---|
--dev |
عزل الحالة ضمن ~/.openclaw-dev، واستخدام 19001 منفذًا افتراضيًا لـ Gateway، وإزاحة المنافذ المشتقة |
--profile <name> |
عزل الحالة ضمن ~/.openclaw-<name> (OPENCLAW_STATE_DIR/OPENCLAW_CONFIG_PATH) |
--container <name> |
تشغيل CLI داخل حاوية Podman/Docker قيد التشغيل باسم <name> (الافتراضي: متغير البيئة OPENCLAW_CONTAINER) |
--log-level <level> |
تجاوز مستوى السجل العام لمخرجات الملف ووحدة التحكم |
--no-color |
تعطيل ألوان ANSI (يُراعى أيضًا NO_COLOR=1) |
--update |
اختصار لـ openclaw update؛ يعمل لكل من نسخ المصدر المحلية وعمليات تثبيت الحزم |
-V، --version، -v |
طباعة الإصدار والخروج |
أوضاع الإخراج
- لا تُعرض ألوان ANSI ومؤشرات التقدم إلا في جلسات TTY.
- تُعرض روابط OSC-8 كروابط قابلة للنقر حيثما يكون ذلك مدعومًا؛ وإلا يعود CLI إلى استخدام عناوين URL عادية.
--json(و--plainحيثما يكون مدعومًا) يعطّل التنسيق للحصول على مخرجات نظيفة.- تعرض الأوامر طويلة التشغيل مؤشر تقدم (OSC 9;4 عند دعمه).
لوحة الألوان
يستخدم OpenClaw لوحة ألوان مستوحاة من جراد البحر لمخرجات CLI:
| الرمز | القيمة السداسية | يُستخدم من أجل |
|---|---|---|
accent |
#FF5A2D |
العناوين والتسميات ومواضع الإبراز الأساسية |
accentBright |
#FF7A3D |
أسماء الأوامر والتوكيد |
accentDim |
#D14A22 |
نص الإبراز الثانوي |
info |
#FF8A5B |
القيم المعلوماتية |
success |
#2FBF71 |
حالات النجاح |
warn |
#FFB020 |
التحذيرات وعلامات الخيارات والبدائل |
error |
#E23D2D |
الأخطاء وحالات الفشل |
muted |
#8B7F77 |
تقليل الإبراز والبيانات الوصفية |
المصدر المعتمد للوحة الألوان: packages/terminal-core/src/palette.ts.
شجرة الأوامر
شجرة الأوامر الكاملة
تغطي هذه الخريطة الأوامر الأساسية وأوامرها الفرعية الرئيسية. تتطور الأوامر الفرعية
التي تضيفها plugins (على سبيل المثال ضمن skills وplugins وwiki)
بشكل مستقل؛ شغّل <command> --help للحصول على القائمة الحالية المعتمدة.
يمكن للـ Plugins إضافة أوامر إضافية من المستوى الأعلى، مثل
openclaw workboard أو openclaw voicecall.
أوامر الشرطة المائلة في الدردشة
تدعم رسائل الدردشة أوامر /.... راجع أوامر الشرطة المائلة.
أبرزها:
/status- تشخيصات سريعة./trace- أسطر تتبع/تصحيح أخطاء الـ Plugin ضمن نطاق الجلسة./config- تغييرات إعدادات مستديمة./debug- تجاوزات للإعدادات في وقت التشغيل فقط (في الذاكرة، وليس على القرص؛ تتطلبcommands.debug: true).
تتبع الاستخدام
يعرض openclaw status --usage وواجهة التحكم استخدام المزوّد/الحصة عند
توفر بيانات اعتماد OAuth/API. تأتي البيانات مباشرةً من نقاط نهاية استخدام
المزوّد وتُوحَّد وفق X% left. المزوّدون الذين لديهم نوافذ استخدام
حالية: Anthropic وGemini CLI وGitHub Copilot وMiniMax وOpenAI Codex
وXiaomi وz.ai.
راجع تتبع الاستخدام لمزيد من التفاصيل.