CLI commands
مرجع CLI
openclaw هي نقطة الدخول الرئيسية لـ CLI. لكل أمر أساسي إما صفحة مرجعية
مخصصة أو يتم توثيقه مع الأمر الذي يمثله كاسم بديل؛ يسرد هذا
الفهرس الأوامر، والرايات العامة، وقواعد تنسيق المخرجات التي
تنطبق عبر CLI.
استخدم أوامر الإعداد حسب الغرض:
- يشغّل
openclaw setupوopenclaw onboardمسار التشغيل الأول الموجّه الكامل لـ gateway، ومصادقة النموذج، ومساحة العمل، والقنوات، وSkills، والصحة. - ينشئ
openclaw setup --baselineإعدادات الأساس ومساحة العمل دون المرور بتدفق التهيئة الموجّهة. - يغيّر
openclaw configureأجزاء مستهدفة من إعداد موجود، مثل مصادقة النموذج، أو gateway، أو القنوات، أو Plugins، أو Skills. - يهيئ
openclaw channels addحسابات القنوات بعد وجود الأساس؛ شغّله دون رايات لإعداد القنوات الموجّه أو مع رايات خاصة بالقناة للسكربتات.
صفحات الأوامر
| المجال | الأوامر |
|---|---|
| الإعداد والتهيئة | crestodian · setup · onboard · configure · config · completion · doctor · dashboard |
| إعادة الضبط وإلغاء التثبيت | backup · reset · uninstall · update |
| المراسلة والوكلاء | message · agent · agents · attach · acp · mcp |
| الصحة والجلسات | status · health · sessions |
| Gateway والسجلات | gateway · logs · system |
| النماذج والاستدلال | models · infer · capability (اسم بديل لـ infer) · memory · commitments · wiki |
| الشبكة والعُقد | directory · nodes · devices · node |
| وقت التشغيل وصندوق العزل | 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 وتغيير المنافذ الافتراضية |
--profile <name> |
عزل الحالة ضمن ~/.openclaw-<name> |
--container <name> |
استهداف حاوية مسماة للتنفيذ |
--no-color |
تعطيل ألوان ANSI (يتم احترام NO_COLOR=1 أيضا) |
--update |
اختصار لـ openclaw update (لتثبيتات المصدر فقط) |
-V, --version, -v |
طباعة الإصدار والخروج |
أوضاع الإخراج
- لا تُعرض ألوان ANSI ومؤشرات التقدم إلا في جلسات TTY.
- تُعرض روابط OSC-8 التشعبية كروابط قابلة للنقر حيثما كان ذلك مدعوما؛ وإلا يعود CLI إلى عناوين URL عادية.
- يعطّل
--json(و--plainحيثما كان مدعوما) التنسيق للحصول على إخراج نظيف. - تعرض الأوامر طويلة التشغيل مؤشر تقدم (OSC 9;4 عند دعمه).
مصدر الحقيقة للوحة الألوان: src/terminal/palette.ts.
شجرة الأوامر
شجرة الأوامر الكاملة
openclaw [--dev] [--profile <name>] <command>crestodiansetuponboardconfigureconfig get set unset file schema validatecompletiondoctordashboardbackup create verifysecurity auditsecrets reload audit configure applyresetuninstallupdate wizard statuschannels list status capabilities resolve logs add remove login logoutdirectory self peers list groups list|membersskills search install update list info checkplugins list inspect install uninstall update enable disable doctor marketplace listworkboard list create show dispatchmemory status index searchtranscripts list show pathpath resolve find set validate emitcommitments list dismisswiki status doctor init ingest compile lint search get apply bridge import unsafe-local import 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 cleanuptasks list audit maintenance show notify cancel flow list|show|cancelgateway call usage-cost health 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 scaninfer (alias: 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|providers|status|enable|disable|set-provider video generate|describe|providers web search|fetch|providers embedding create|providers auth add|login|login-github-copilot|setup-token|paste-token auth order get|set|clearsandbox 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 restartapprovals 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 (alias: tui --local)terminal (alias: tui --local)يمكن أن تضيف Plugins أوامر إضافية في المستوى الأعلى، مثل
openclaw workboard أو openclaw voicecall.
أوامر الشرطة المائلة في الدردشة
تدعم رسائل الدردشة أوامر /.... راجع أوامر الشرطة المائلة.
أبرزها:
/status— تشخيصات سريعة./trace— أسطر تتبع/تصحيح Plugin على مستوى الجلسة./config— تغييرات إعدادات محفوظة./debug— تجاوزات إعدادات وقت التشغيل فقط (في الذاكرة، وليس على القرص؛ تتطلبcommands.debug: true).
تتبع الاستخدام
يعرض openclaw status --usage وواجهة التحكم استخدام/حصة المزوّد عندما
تكون بيانات اعتماد OAuth/API متاحة. تأتي البيانات مباشرة من نقاط نهاية
استخدام المزوّد ويتم توحيدها إلى X% left. المزوّدون ذوو نوافذ الاستخدام
الحالية: Anthropic، وGitHub Copilot، وGemini CLI، وOpenAI Codex، وMiniMax،
وXiaomi، وz.ai.
راجع تتبع الاستخدام للتفاصيل.