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 للحصول على القائمة الحالية المعتمدة.
openclaw [--dev] [--profile <name>] <command>openclawsetuponboardconfigureconfig get set unset file schema validatecompletiondoctordashboardbackup create verifymigrate list plan <provider> apply <provider>security auditsecrets reload audit configure applyresetuninstallupdate wizard status repairchannels list status capabilities resolve logs add remove login logoutdirectory self peers list groups list|membersskills search install update verify workshop list|inspect|propose-create|propose-update|revise|apply|reject|quarantine list info checkplugins list search inspect install uninstall update enable disable doctor build validate init registry marketplace list|entries|refreshworkboard list create show dispatchmemory status index searchtranscripts list show pathpath resolve find set validate emitcommitments list dismisswiki status doctor init compile lint ingest okf import search get apply synthesis|metadata bridge import unsafe-local import chatgpt import|rollback obsidian status|search|open|command|dailymessage send broadcast poll react reactions read edit delete pin unpin pins permissions search thread create|list|reply emoji list|upload sticker send|upload role info|add|remove channel info|list member info voice status event list|create timeout kick banagentagents list add delete bindings bind unbind set-identityattachacpmcp serve list show set unsetstatushealthsessions cleanupaudittasks list audit maintenance show notify cancel flow list|show|cancelgateway call usage-cost health stability diagnostics export status probe discover install uninstall start stop restart rundaemon status install uninstall start stop restartlogssystem event heartbeat last|enable|disable presencemodels list status set set-image aliases list|add|remove fallbacks list|add|remove|clear image-fallbacks list|add|remove|clear scan auth list|add|login|setup-token|paste-token|paste-api-key|login-github-copilot auth order get|set|clearpromos list claim <slug>infer (الاسم البديل: capability) list inspect model run|list|inspect|providers|auth login|logout|status image generate|edit|describe|describe-many|providers audio transcribe|providers tts convert|voices|personas|providers|status|enable|disable|set-provider|set-persona video generate|describe|providers web search|fetch|providers embedding create|providerssandbox list recreate explaincron status list get add edit rm enable disable runs runnodes status describe list pending approve reject rename invoke notify push canvas snapshot|present|hide|navigate|eval canvas a2ui push|reset camera list|snap|clip screen record location getdevices list remove clear approve reject rotate revokenode run status install uninstall stop restartworkerapprovals get set allowlist add|removeexec-policy show preset setbrowser status start stop reset-profile tabs open focus close profiles create-profile delete-profile screenshot snapshot navigate resize click type press hover drag select upload fill dialog wait evaluate console pdfhooks list info check enable disable install updatewebhooks gmail setup|runproxy start run coverage sessions query blob purgepairing list approveqrclawbot qrdocsdns setuptuichat (الاسم البديل: tui --local)terminal (الاسم البديل: tui --local)يمكن للـ 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.
راجع تتبع الاستخدام لمزيد من التفاصيل.