CLI commands
مرجع CLI
openclaw هو نقطة الدخول الرئيسية إلى CLI. لكل أمر أساسي صفحة مرجعية مخصصة أو يكون موثقًا مع الأمر الذي يمثل اسمًا مستعارًا له؛ يسرد هذا الفهرس الأوامر والعلامات العامة وقواعد تنسيق المخرجات التي تنطبق على CLI بأكمله.
أوامر الإعداد حسب الغرض:
- يتحقق
openclaw setupوopenclaw onboardأولًا من الاستدلال، ثم يشغّلان Crestodian لإعداد Gateway ومساحة العمل والقنوات وSkills والسلامة. - ينشئ
openclaw setup --baselineالإعداد الأساسي ومساحة العمل من دون المرور بتدفق الإعداد الأولي الموجّه. - يغيّر
openclaw configureأجزاءً محددة من إعداد موجود: مصادقة النموذج أو Gateway أو القنوات أو Plugins أو Skills. - يضبط
openclaw channels addحسابات القنوات بعد وجود الإعداد الأساسي؛ شغّله من دون علامات للإعداد الموجّه، أو باستخدام علامات خاصة بالقناة للبرامج النصية.
صفحات الأوامر
| المجال | الأوامر |
|---|---|
| الإعداد والتهيئة الأولية | crestodian · 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 |
| بيئة التشغيل وصندوق العزل | 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، وتعيين منفذ Gateway الافتراضي إلى 19001، وإزاحة المنافذ المشتقة |
--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>crestodiansetuponboardconfigureconfig 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 (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|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 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 وGemini CLI وGitHub Copilot وMiniMax وOpenAI Codex
وXiaomi وz.ai.
راجع تتبّع الاستخدام للتفاصيل.