Skills
أوامر الشرطة المائلة
تتولى Gateway معالجة الأوامر. يجب إرسال معظم الأوامر كرسالة مستقلة تبدأ بـ /. يستخدم أمر محادثة bash الخاص بالمضيف فقط الصيغة ! <cmd> (مع /bash <cmd> كاسم مستعار).
عندما تكون محادثة أو سلسلة محادثات مرتبطة بجلسة ACP، يُوجَّه نص المتابعة العادي إلى حزمة ACP تلك. تبقى أوامر إدارة Gateway محلية: يصل /acp ... دائمًا إلى معالج أوامر OpenClaw ACP، ويبقى /status مع /unfocus محليين كلما كانت معالجة الأوامر مفعّلة للسطح.
يوجد نظامان مرتبطان:
Commands
رسائل /... مستقلة.
Directives
/think، /fast، /verbose، /trace، /reasoning، /elevated، /exec، /model، /queue.
- تُزال التوجيهات من الرسالة قبل أن يراها النموذج.
- في رسائل المحادثة العادية (وليست الرسائل التي تحتوي على توجيهات فقط)، تُعامل باعتبارها "تلميحات مضمنة" ولا تُبقي إعدادات الجلسة.
- في الرسائل التي تحتوي على توجيهات فقط (تحتوي الرسالة على التوجيهات فقط)، تُحفظ في الجلسة وترد بإقرار.
- تُطبَّق التوجيهات فقط على المرسلين المخوّلين. إذا عُيّن
commands.allowFrom، فهو قائمة السماح الوحيدة المستخدمة؛ وإلا يأتي التخويل من قوائم سماح/اقتران القناة إضافة إلىcommands.useAccessGroups. يرى المرسلون غير المخوّلين التوجيهات كنص عادي.
Inline shortcuts
للمرسلين المدرجين في قائمة السماح/المخوّلين فقط: /help، /commands، /status، /whoami (/id).
تعمل فورًا، وتُزال قبل أن يراها النموذج، ويستمر النص المتبقي عبر المسار العادي.
الإعدادات
{
commands: {
native: "auto",
nativeSkills: "auto",
text: true,
bash: false,
bashForegroundMs: 2000,
config: false,
mcp: false,
plugins: false,
debug: false,
restart: true,
ownerAllowFrom: ["discord:123456789012345678"],
ownerDisplay: "raw",
ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
allowFrom: {
"*": ["user1"],
discord: ["user:123"],
},
useAccessGroups: true,
},
}
commands.textbooleanيفعّل تحليل /... في رسائل المحادثة. على الأسطح التي لا تحتوي على أوامر أصلية (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams)، تظل الأوامر النصية تعمل حتى إذا عيّنت هذا إلى false.
commands.nativeboolean | "auto"يسجّل الأوامر الأصلية. تلقائيًا: مفعّل لـ Discord/Telegram؛ معطّل لـ Slack (إلى أن تضيف أوامر الشرطة المائلة)؛ ويتم تجاهله لدى المزوّدين الذين لا يدعمون الدعم الأصلي. عيّن channels.discord.commands.native أو channels.telegram.commands.native أو channels.slack.commands.native للتجاوز لكل مزوّد (قيمة منطقية أو "auto"). على Discord، يتخطى false تسجيل أوامر الشرطة المائلة وتنظيفها أثناء بدء التشغيل؛ وقد تبقى الأوامر المسجلة سابقًا مرئية إلى أن تزيلها من تطبيق Discord. تُدار أوامر Slack في تطبيق Slack ولا تُزال تلقائيًا.
على Discord، قد تتضمن مواصفات الأوامر الأصلية descriptionLocalizations، التي ينشرها OpenClaw بصيغة Discord description_localizations ويدرجها في مقارنات التسوية.
commands.nativeSkillsboolean | "auto"يسجّل أوامر Skills أصليًا عندما يكون ذلك مدعومًا. تلقائيًا: مفعّل لـ Discord/Telegram؛ معطّل لـ Slack (يتطلب Slack إنشاء أمر شرطة مائلة لكل skill). عيّن channels.discord.commands.nativeSkills أو channels.telegram.commands.nativeSkills أو channels.slack.commands.nativeSkills للتجاوز لكل مزوّد (قيمة منطقية أو "auto").
commands.bashbooleanيفعّل ! <cmd> لتشغيل أوامر صدفة المضيف (/bash <cmd> اسم مستعار؛ يتطلب قوائم سماح tools.elevated).
commands.bashForegroundMsnumberيتحكم في مدة انتظار bash قبل التحويل إلى وضع الخلفية (0 ينقلها إلى الخلفية فورًا).
commands.configbooleanيفعّل /config (يقرأ/يكتب openclaw.json).
commands.mcpbooleanيفعّل /mcp (يقرأ/يكتب إعدادات MCP التي يديرها OpenClaw ضمن mcp.servers).
commands.pluginsbooleanيفعّل /plugins (اكتشاف Plugin/حالته إضافة إلى عناصر التحكم في التثبيت والتمكين/التعطيل).
commands.debugbooleanيفعّل /debug (تجاوزات وقت التشغيل فقط).
commands.restartbooleanيفعّل /restart إضافة إلى إجراءات أداة إعادة تشغيل Gateway.
commands.ownerAllowFromstring[]يعيّن قائمة سماح المالك الصريحة لأسطح الأوامر/الأدوات الخاصة بالمالك فقط. هذا هو حساب المشغّل البشري الذي يمكنه الموافقة على الإجراءات الخطرة وتشغيل أوامر مثل /diagnostics و/export-trajectory و/config. وهو منفصل عن commands.allowFrom وعن وصول اقتران الرسائل المباشرة.
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs
.commands.enforceOwnerForCommands" type="boolean" default="false">
لكل قناة: يجعل الأوامر الخاصة بالمالك فقط تتطلب هوية المالك لتعمل على ذلك السطح. عندما تكون true، يجب أن يطابق المرسل إما مرشح مالك محلولًا (مثل إدخال في commands.ownerAllowFrom أو بيانات تعريف مالك أصلية من المزوّد) أو أن يمتلك نطاق operator.admin الداخلي على قناة رسائل داخلية. لا يكفي إدخال بدل في allowFrom الخاصة بالقناة، أو قائمة مرشحي مالك فارغة/غير محلولة — تفشل الأوامر الخاصة بالمالك فقط بوضع مغلق على تلك القناة. اترك هذا معطّلًا إذا أردت أن تكون الأوامر الخاصة بالمالك فقط محكومة بـ ownerAllowFrom وقوائم سماح الأوامر القياسية فقط.
commands.ownerDisplay"raw" | "hash"يتحكم في كيفية ظهور معرّفات المالك في مطالبة النظام.
commands.ownerDisplaySecretstringيعيّن اختياريًا سر HMAC المستخدم عندما تكون commands.ownerDisplay="hash".
commands.allowFromobjectقائمة سماح لكل مزوّد لتخويل الأوامر. عند تكوينها، تكون مصدر التخويل الوحيد للأوامر والتوجيهات (تُتجاهل قوائم سماح/اقتران القنوات وcommands.useAccessGroups). استخدم "*" كافتراضي عام؛ وتتجاوزه المفاتيح الخاصة بالمزوّد.
commands.useAccessGroupsbooleanيفرض قوائم السماح/السياسات للأوامر عندما لا يكون commands.allowFrom معيّنًا.
قائمة الأوامر
مصدر الحقيقة الحالي:
- تأتي الأوامر المضمنة الأساسية من
src/auto-reply/commands-registry.shared.ts - تأتي أوامر الرصيف المولّدة من
src/auto-reply/commands-registry.data.ts - تأتي أوامر Plugin من استدعاءات
registerCommand()الخاصة بالـ Plugin - لا يزال التوفر الفعلي على Gateway لديك يعتمد على أعلام الإعدادات وسطح القناة والـ Plugins المثبتة/الممكّنة
الأوامر الأساسية المضمنة
Sessions and runs
- يبدأ
/new [model]جلسة جديدة؛ و/resetهو اسم إعادة التعيين المستعار. - تعترض Control UI النص المكتوب
/newلإنشاء جلسة لوحة معلومات جديدة والتبديل إليها؛ أما النص المكتوب/resetفيظل يشغّل إعادة التعيين الموضعية في Gateway. - يحافظ
/reset soft [message]على النص الحالي، ويسقط معرّفات جلسات واجهة CLI الخلفية المعاد استخدامها، ويعيد تشغيل تحميل بدء التشغيل/مطالبة النظام في الموضع. - يضغط
/compact [instructions]سياق الجلسة. راجع Compaction. - يجهض
/stopالتشغيل الحالي. - يدير
/session idle <duration|off>و/session max-age <duration|off>انتهاء صلاحية ربط سلسلة المحادثة. - يصدّر
/export-session [path]الجلسة الحالية إلى HTML. الاسم المستعار:/export. - يطلب
/export-trajectory [path]موافقة exec، ثم يصدّر حزمة مسار JSONL للجلسة الحالية. استخدمه عندما تحتاج إلى الخط الزمني للمطالبة والأداة والنص لجلسة OpenClaw واحدة. في محادثات المجموعات، تنتقل مطالبة الموافقة ونتيجة التصدير إلى المالك بشكل خاص. الاسم المستعار:/trajectory.
Model and run controls
- يعيّن
/think <level>مستوى التفكير. تأتي الخيارات من ملف مزوّد النموذج النشط؛ المستويات الشائعة هيoffوminimalوlowوmediumوhigh، مع مستويات مخصصة مثلxhighأوadaptiveأوmaxأو الثنائيةonفقط حيث تكون مدعومة. الأسماء المستعارة:/thinking،/t. - يبدّل
/verbose on|off|fullالإخراج المطوّل. الاسم المستعار:/v. - يبدّل
/trace on|offإخراج تتبع Plugin للجلسة الحالية. - يعرض
/fast [status|on|off]الوضع السريع أو يعيّنه. - يبدّل
/reasoning [on|off|stream]ظهور الاستدلال. الاسم المستعار:/reason. - يبدّل
/elevated [on|off|ask|full]الوضع المرتفع. الاسم المستعار:/elev. - يعرض
/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>افتراضيات exec أو يعيّنها. - يعرض
/model [name|#|status]النموذج أو يعيّنه. - يسرد
/models [provider] [page] [limit=<n>|size=<n>|all]المزوّدين أو النماذج المكوّنة/المتاحة بالمصادقة لمزوّد؛ أضفallلتصفح الفهرس الكامل لذلك المزوّد. - يدير
/queue <mode>سلوك قائمة الانتظار (steer، وqueueالقديم، وfollowup، وcollect، وsteer-backlog، وinterrupt) إضافة إلى خيارات مثلdebounce:0.5s cap:25 drop:summarize؛ يمسح/queue defaultأو/queue resetتجاوز الجلسة. راجع قائمة انتظار الأوامر وقائمة انتظار التوجيه. - يحقن
/steer <message>إرشادًا في التشغيل النشط للجلسة الحالية، بشكل مستقل عن وضع/queue. لا يبدأ تشغيلًا جديدًا عندما تكون الجلسة خاملة. الاسم المستعار:/tell. راجع التوجيه.
Discovery and status
- يعرض
/helpملخص المساعدة القصير. - يعرض
/commandsفهرس الأوامر المولّد. - يعرض
/tools [compact|verbose]ما يمكن للوكيل الحالي استخدامه الآن. - يعرض
/statusحالة التنفيذ/وقت التشغيل، ووقت تشغيل Gateway والنظام، إضافة إلى استخدام/حصة المزوّد عند توفرها. /diagnostics [note]هو تدفق تقرير الدعم الخاص بالمالك فقط لأخطاء Gateway وتشغيلات حزمة Codex. يطلب موافقة exec صريحة كل مرة قبل تشغيلopenclaw gateway diagnostics export --json؛ لا توافق على التشخيصات بقاعدة سماح للجميع. بعد الموافقة، يرسل تقريرًا قابلًا للصق يتضمن مسار الحزمة المحلي، وملخص البيان، وملاحظات الخصوصية، ومعرّفات الجلسات ذات الصلة. في محادثات المجموعات، تنتقل مطالبة الموافقة والتقرير إلى المالك بشكل خاص. عندما تستخدم الجلسة النشطة حزمة OpenAI Codex، ترسل الموافقة نفسها أيضًا ملاحظات Codex ذات الصلة إلى خوادم OpenAI، وتدرج الاستجابة المكتملة معرّفات جلسات OpenClaw، ومعرّفات سلاسل Codex، وأوامرcodex resume <thread-id>. راجع تصدير التشخيصات.- يشغّل
/crestodian <request>مساعد إعداد Crestodian وإصلاحه من رسالة مباشرة مع المالك. - يسرد
/tasksالمهام الخلفية النشطة/الأخيرة للجلسة الحالية. - يشرح
/context [list|detail|json]كيفية تجميع السياق. - يعرض
/whoamiمعرّف المرسل الخاص بك. الاسم المستعار:/id. - يتحكم
/usage off|tokens|full|costفي تذييل الاستخدام لكل استجابة أو يطبع ملخص تكلفة محليًا.
Skills, allowlists, approvals
- يشغّل
/skill <name> [input]Skill حسب الاسم. - يدير
/allowlist [list|add|remove] ...إدخالات قائمة السماح. نص فقط. - يحل
/approve <id> <decision>مطالبات موافقة exec. - يطرح
/btw <question>سؤالًا جانبيًا دون تغيير سياق الجلسة المستقبلي. الاسم المستعار:/side. راجع BTW.
Subagents and ACP
- يدير
/subagents list|kill|log|info|send|steer|spawnتشغيلات الوكلاء الفرعيين للجلسة الحالية. - يدير
/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|helpجلسات ACP وخيارات وقت التشغيل. - يربط
/focus <target>سلسلة Discord الحالية أو موضوع/محادثة Telegram بهدف جلسة. - يزيل
/unfocusالربط الحالي. - يعرض
/agentsالوكلاء المرتبطين بالسلسلة للجلسة الحالية. - يجهض
/kill <id|#|all>وكيلا فرعيا واحدا قيد التشغيل أو جميع الوكلاء الفرعيين قيد التشغيل. - يرسل
/subagents steer <id|#> <message>توجيها إلى وكيل فرعي قيد التشغيل. راجع التوجيه.
Owner-only writes and admin
- يقرأ
/config show|get|set|unsetأو يكتبopenclaw.json. للمالك فقط. يتطلبcommands.config: true. - يقرأ
/mcp show|get|set|unsetأو يكتب إعداد خادم MCP المُدار بواسطة OpenClaw تحتmcp.servers. للمالك فقط. يتطلبcommands.mcp: true. - يفحص
/plugins list|inspect|show|get|install|enable|disableحالة Plugin أو يعدلها./pluginاسم مستعار. الكتابة للمالك فقط. يتطلبcommands.plugins: true. - يدير
/debug show|set|unset|resetتجاوزات الإعداد الخاصة بوقت التشغيل فقط. للمالك فقط. يتطلبcommands.debug: true. - يعيد
/restartتشغيل OpenClaw عند تفعيله. الافتراضي: مفعّل؛ اضبطcommands.restart: falseلتعطيله. - يضبط
/send on|off|inheritسياسة الإرسال. للمالك فقط.
Voice, TTS, channel control
- يتحكم
/tts on|off|status|chat|latest|provider|limit|summary|audio|helpفي TTS. راجع TTS. - يضبط
/activation mention|alwaysوضع تفعيل المجموعة. - يشغل
/bash <command>أمرا في صدفة المضيف. نصي فقط. الاسم المستعار:! <command>. يتطلبcommands.bash: trueبالإضافة إلى قوائم السماحtools.elevated. - يتحقق
!poll [sessionId]من مهمة bash في الخلفية. - يوقف
!stop [sessionId]مهمة bash في الخلفية.
أوامر الإرساء المولّدة
تبدّل أوامر الإرساء مسار رد الجلسة الحالية إلى قناة أخرى مرتبطة. راجع إرساء القنوات للإعداد، والأمثلة، واستكشاف الأخطاء وإصلاحها.
تُنشأ أوامر الإرساء من Plugins القنوات التي تدعم الأوامر الأصلية. المجموعة المضمنة الحالية:
/dock-discord(الاسم المستعار:/dock_discord)/dock-mattermost(الاسم المستعار:/dock_mattermost)/dock-slack(الاسم المستعار:/dock_slack)/dock-telegram(الاسم المستعار:/dock_telegram)
استخدم أوامر الإرساء من دردشة مباشرة لتبديل مسار رد الجلسة الحالية إلى قناة أخرى مرتبطة. يحتفظ الوكيل بسياق الجلسة نفسه، لكن الردود المستقبلية لتلك الجلسة تُسلَّم إلى نظير القناة المحدد.
تتطلب أوامر الإرساء session.identityLinks. يجب أن يكون المرسل المصدر والنظير الهدف ضمن مجموعة الهوية نفسها، على سبيل المثال ["telegram:123", "discord:456"]. إذا أرسل مستخدم Telegram بالمعرّف 123 الأمر /dock_discord، يخزن OpenClaw lastChannel: "discord" وlastTo: "456" في الجلسة النشطة. إذا لم يكن المرسل مرتبطا بنظير Discord، يرد الأمر بتلميح إعداد بدلا من الانتقال إلى الدردشة العادية.
يغيّر الإرساء مسار الجلسة النشطة فقط. لا ينشئ حسابات قنوات، ولا يمنح وصولا، ولا يتجاوز قوائم سماح القنوات، ولا ينقل سجل النص إلى جلسة أخرى. استخدم /dock-telegram أو /dock-slack أو /dock-mattermost أو أمرا آخر مولدا للإرساء لتبديل المسار مرة أخرى.
أوامر Plugins المضمنة
يمكن أن تضيف Plugins المضمنة مزيدا من أوامر الشرطة المائلة. الأوامر المضمنة الحالية في هذا المستودع:
- يبدّل
/dreaming [on|off|status|help]Dreaming الذاكرة. راجع Dreaming. - يدير
/pair [qr|status|pending|approve|cleanup|notify]مسار إقران/إعداد الجهاز. راجع الإقران. - يسلّح
/phone status|arm <camera|screen|writes|all> [duration]|disarmأوامر عقدة الهاتف عالية المخاطر مؤقتا. - يدير
/voice status|list [limit]|set <voiceId|name>إعداد صوت Talk. في Discord، اسم الأمر الأصلي هو/talkvoice. - يرسل
/card ...إعدادات مسبقة لبطاقات LINE الغنية. راجع LINE. - يفحص
/codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skillsويتحكم في مشغل خادم تطبيق Codex المضمن. راجع مشغل Codex. - أوامر QQBot فقط:
/bot-ping/bot-version/bot-help/bot-upgrade/bot-logs
أوامر Skills الديناميكية
تُعرض Skills التي يمكن للمستخدم استدعاؤها أيضا كأوامر شرطة مائلة:
- يعمل
/skill <name> [input]دائما كنقطة دخول عامة. - قد تظهر Skills أيضا كأوامر مباشرة مثل
/proseعندما تسجلها Skill/Plugin. - يتحكم
commands.nativeSkillsوchannels.<provider>.commands.nativeSkillsفي تسجيل أوامر Skills الأصلية. - يمكن لمواصفات الأوامر توفير
descriptionLocalizationsللأسطح الأصلية التي تدعم الأوصاف المترجمة، بما في ذلك Discord.
Argument and parser notes
- تقبل الأوامر علامة
:اختيارية بين الأمر والوسائط (مثل/think: high، و/send: on، و/help:). - يقبل
/new <model>اسما مستعارا للنموذج، أوprovider/model، أو اسم موفر (مطابقة تقريبية)؛ وإذا لم توجد مطابقة، يُعامل النص على أنه متن الرسالة. - للحصول على تفصيل كامل لاستخدام الموفر، استخدم
openclaw status --usage. - يتطلب
/allowlist add|removeالإعدادcommands.config=trueويحترمconfigWritesالخاصة بالقناة. - في القنوات متعددة الحسابات، تحترم أيضا أوامر
/allowlist --account <id>الموجهة للإعداد و/config set channels.<provider>.accounts.<id>...قيمةconfigWritesللحساب الهدف. - يتحكم
/usageفي تذييل الاستخدام لكل رد؛ يطبع/usage costملخص تكلفة محليا من سجلات جلسات OpenClaw. - يكون
/restartمفعلا افتراضيا؛ اضبطcommands.restart: falseلتعطيله. - يقبل
/plugins install <spec>مواصفات Plugin نفسها التي يقبلهاopenclaw plugins install: مسار/أرشيف محلي، حزمة npm، أوgit:<repo>، أوclawhub:<pkg>، ثم يطلب إعادة تشغيل Gateway لأن وحدات مصدر Plugin تغيّرت. - يحدّث
/plugins enable|disableإعداد Plugin ويشغّل إعادة تحميل Plugins في Gateway للدورات الجديدة للوكيل.
Channel-specific behavior
- أمر أصلي خاص بـ Discord فقط: يتحكم
/vc join|leave|statusفي قنوات الصوت (غير متاح كنص). يتطلبjoinخادما وقناة صوت/منصة محددة. يتطلبchannels.discord.voiceوالأوامر الأصلية. - تتطلب أوامر ربط سلاسل Discord (
/focus، و/unfocus، و/agents، و/session idle، و/session max-age) تفعيل روابط السلاسل الفعلية (session.threadBindings.enabledو/أوchannels.discord.threadBindings.enabled). - مرجع أوامر ACP وسلوك وقت التشغيل: وكلاء ACP.
Verbose / trace / fast / reasoning safety
- الغرض من
/verboseهو التصحيح وتوفير رؤية إضافية؛ أبقه متوقفا في الاستخدام العادي. /traceأضيق من/verbose: فهو يكشف فقط أسطر التتبع/التصحيح المملوكة لـ Plugin ويبقي ثرثرة الأدوات التفصيلية العادية متوقفة.- يحفظ
/fast on|offتجاوزا للجلسة. استخدم خيارinheritفي واجهة جلسات المستخدم لمسحه والعودة إلى الإعدادات الافتراضية. - يعتمد
/fastعلى الموفر: تربطه OpenAI/OpenAI Codex بـservice_tier=priorityعلى نقاط نهاية Responses الأصلية، بينما تربطه طلبات Anthropic العامة المباشرة، بما في ذلك الحركة الموثقة عبر OAuth والمُرسلة إلىapi.anthropic.com، بـservice_tier=autoأوstandard_only. راجع OpenAI وAnthropic. - تظل ملخصات فشل الأدوات ظاهرة عند اللزوم، لكن نص الفشل التفصيلي لا يُدرج إلا عندما يكون
/verboseعلىonأوfull. - تُعد
/reasoningو/verboseو/traceمحفوفة بالمخاطر في إعدادات المجموعات: فقد تكشف عن استدلال داخلي، أو مخرجات أدوات، أو تشخيصات Plugin لم تكن تقصد عرضها. يفضل إبقاؤها متوقفة، خصوصا في دردشات المجموعات.
Model switching
- يحفظ
/modelنموذج الجلسة الجديد فورا. - إذا كان الوكيل خاملا، يستخدمه التشغيل التالي على الفور.
- إذا كان هناك تشغيل نشط بالفعل، يضع OpenClaw علامة على التبديل الحي كقيد الانتظار ولا يعيد التشغيل بالنموذج الجديد إلا عند نقطة إعادة محاولة نظيفة.
- إذا كان نشاط الأدوات أو إخراج الرد قد بدأ بالفعل، فقد يبقى التبديل المعلّق في قائمة الانتظار حتى فرصة إعادة محاولة لاحقة أو دور المستخدم التالي.
- في TUI المحلي، يعيد
/crestodian [request]من TUI الوكيل العادي إلى Crestodian. هذا منفصل عن وضع الإنقاذ لقنوات الرسائل ولا يمنح صلاحية إعداد عن بعد.
Fast path and inline shortcuts
- المسار السريع: تُعالج الرسائل التي تحتوي على أوامر فقط من المرسلين المدرجين في قائمة السماح فورا (تتجاوز قائمة الانتظار + النموذج).
- بوابة ذكر المجموعة: تتجاوز الرسائل التي تحتوي على أوامر فقط من المرسلين المدرجين في قائمة السماح متطلبات الذكر.
- الاختصارات المضمنة (للمرسلين المدرجين في قائمة السماح فقط): تعمل بعض الأوامر أيضا عند تضمينها في رسالة عادية وتُزال قبل أن يرى النموذج النص المتبقي.
- مثال: يشغّل
hey /statusردا بالحالة، ويستمر النص المتبقي عبر المسار العادي.
- مثال: يشغّل
- حاليا:
/help، و/commands، و/status، و/whoami(/id). - تُتجاهل الرسائل غير المصرح بها التي تحتوي على أوامر فقط بصمت، وتُعامل رموز
/...المضمنة كنص عادي.
Skill commands and native arguments
- أوامر Skills: تُعرض Skills ذات
user-invocableكأوامر شرطة مائلة. تُنقّى الأسماء إلىa-z0-9_(بحد أقصى 32 حرفا)؛ وتحصل التعارضات على لواحق رقمية (مثل_2).- يشغّل
/skill <name> [input]Skill بالاسم (مفيد عندما تمنع حدود الأوامر الأصلية إنشاء أوامر لكل Skill). - افتراضيا، تُمرر أوامر Skills إلى النموذج كطلب عادي.
- يمكن لـ Skills اختياريا إعلان
command-dispatch: toolلتوجيه الأمر مباشرة إلى أداة (حتمي، بلا نموذج). - مثال:
/prose(OpenProse plugin) — راجع OpenProse.
- يشغّل
- وسائط الأوامر الأصلية: يستخدم Discord الإكمال التلقائي للخيارات الديناميكية (وقوائم الأزرار عند حذف الوسائط المطلوبة). يعرض Telegram وSlack قائمة أزرار عندما يدعم أمر ما الاختيارات وتحذف الوسيطة. تُحل الاختيارات الديناميكية مقابل نموذج الجلسة الهدف، لذلك تتبع الخيارات الخاصة بالنموذج مثل مستويات
/thinkتجاوز/modelلتلك الجلسة.
/tools
يجيب /tools عن سؤال وقت التشغيل، وليس سؤال إعداد: ما الذي يمكن لهذا الوكيل استخدامه الآن في هذه المحادثة.
- يكون
/toolsالافتراضي موجزا ومحسنا للمسح السريع. - يضيف
/tools verboseأوصافا قصيرة. - تعرض أسطح الأوامر الأصلية التي تدعم الوسائط مفتاح تبديل الوضع نفسه مثل
compact|verbose. - تكون النتائج محصورة بنطاق الجلسة، لذلك قد يغيّر تغيير الوكيل أو القناة أو السلسلة أو تفويض المرسل أو النموذج الإخراج.
- يتضمن
/toolsالأدوات التي يمكن الوصول إليها فعليا في وقت التشغيل، بما في ذلك الأدوات الأساسية، وأدوات Plugins المتصلة، والأدوات المملوكة للقنوات.
لتحرير الملفات الشخصية والتجاوزات، استخدم لوحة أدوات واجهة التحكم أو أسطح الإعداد/الفهرس بدلا من التعامل مع /tools كفهرس ثابت.
أسطح الاستخدام (ما يظهر وأين)
- يظهر استخدام/حصة المزوّد (مثال: "Claude 80% متبقٍ") في
/statusلمزوّد النموذج الحالي عند تفعيل تتبّع الاستخدام. يطبّع OpenClaw نوافذ المزوّدين إلى% متبقٍ؛ وبالنسبة إلى MiniMax، تُعكس حقول النسبة المئوية الخاصة بالمتبقي فقط قبل العرض، وتفضّل استجاباتmodel_remainsإدخال نموذج الدردشة مع تسمية خطة موسومة بالنموذج. - يمكن أن تعود أسطر الرموز/ذاكرة التخزين المؤقت في
/statusإلى أحدث إدخال استخدام في السجل عندما تكون لقطة الجلسة الحية قليلة البيانات. تظل القيم الحية غير الصفرية الحالية هي المعتمدة، ويمكن لاحتياطي السجل أيضًا استعادة تسمية نموذج وقت التشغيل النشط مع إجمالي أكبر موجّه للمطالبة عندما تكون الإجماليات المخزنة مفقودة أو أصغر. - التنفيذ مقابل وقت التشغيل: يعرض
/statusقيمةExecutionلمسار وضع الحماية الفعّال وقيمةRuntimeلمن يشغّل الجلسة فعليًا:OpenClaw Pi DefaultأوOpenAI Codexأو خلفية CLI أو خلفية ACP. - يتحكم
/usage off|tokens|fullفي الرموز/التكلفة لكل استجابة (تُضاف إلى الردود العادية). - يتعلق
/model statusبـ النماذج/المصادقة/نقاط النهاية، وليس الاستخدام.
اختيار النموذج (/model)
يُنفَّذ /model كتوجيه.
أمثلة:
/model
/model list
/model 3
/model openai/gpt-5.4
/model opus@anthropic:default
/model status
ملاحظات:
- يعرض
/modelو/model listمنتقيًا مرقمًا ومختصرًا (عائلة النموذج + المزوّدون المتاحون). - في Discord، يفتح
/modelو/modelsمنتقيًا تفاعليًا يحتوي على قوائم منسدلة للمزوّد والنموذج مع خطوة Submit. - يختار
/model <#>من ذلك المنتقي (ويفضّل المزوّد الحالي عندما يكون ذلك ممكنًا). - يعرض
/model statusالعرض التفصيلي، بما في ذلك نقطة نهاية المزوّد المهيأة (baseUrl) ووضع API (api) عند توفرهما.
تجاوزات التصحيح
يتيح لك /debug ضبط تجاوزات إعدادات خاصة بوقت التشغيل فقط (في الذاكرة، وليس على القرص). للمالك فقط. معطل افتراضيًا؛ فعّله باستخدام commands.debug: true.
أمثلة:
/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug set channels.whatsapp.allowFrom=["+1555","+4477"]
/debug unset messages.responsePrefix
/debug reset
مخرجات تتبّع Plugin
يتيح لك /trace تبديل أسطر تتبّع/تصحيح Plugin ضمن نطاق الجلسة من دون تشغيل وضع الإسهاب الكامل.
أمثلة:
/trace
/trace on
/trace off
ملاحظات:
- يعرض
/traceمن دون وسيطة حالة التتبّع الحالية للجلسة. - يفعّل
/trace onأسطر تتبّع Plugin للجلسة الحالية. - يعطّلها
/trace offمرة أخرى. - يمكن أن تظهر أسطر تتبّع Plugin في
/statusوكراسلة تشخيص متابعة بعد رد المساعد العادي. - لا يحل
/traceمحل/debug؛ لا يزال/debugيدير تجاوزات الإعدادات الخاصة بوقت التشغيل فقط. - لا يحل
/traceمحل/verbose؛ لا تزال مخرجات الأدوات/الحالة الإسهابية العادية تابعة لـ/verbose.
تحديثات الإعدادات
يكتب /config إلى إعداداتك المخزنة على القرص (openclaw.json). للمالك فقط. معطل افتراضيًا؛ فعّله باستخدام commands.config: true.
أمثلة:
/config show
/config show messages.responsePrefix
/config get messages.responsePrefix
/config set messages.responsePrefix="[openclaw]"
/config unset messages.responsePrefix
تحديثات MCP
يكتب /mcp تعريفات خوادم MCP التي يديرها OpenClaw ضمن mcp.servers. للمالك فقط. معطل افتراضيًا؛ فعّله باستخدام commands.mcp: true.
أمثلة:
/mcp show
/mcp show context7
/mcp set context7={"command":"uvx","args":["context7-mcp"]}
/mcp unset context7
تحديثات Plugin
يتيح /plugins للمشغلين فحص Plugins المكتشفة وتبديل التفعيل في الإعدادات. يمكن للتدفقات للقراءة فقط استخدام /plugin كاسم بديل. معطل افتراضيًا؛ فعّله باستخدام commands.plugins: true.
أمثلة:
/plugins
/plugins list
/plugin show context7
/plugins enable context7
/plugins disable context7
ملاحظات الأسطح
الجلسات لكل سطح
- تعمل الأوامر النصية في جلسة الدردشة العادية (تشارك الرسائل المباشرة
main، وللمجموعات جلستها الخاصة). - تستخدم الأوامر الأصلية جلسات معزولة:
- Discord:
agent:<agentId>:discord:slash:<userId> - Slack:
agent:<agentId>:slack:slash:<userId>(يمكن تهيئة البادئة عبرchannels.slack.slashCommand.sessionPrefix) - Telegram:
telegram:slash:<userId>(تستهدف جلسة الدردشة عبرCommandTargetSessionKey)
- Discord:
- يستهدف
/stopجلسة الدردشة النشطة حتى يتمكن من إيقاف التشغيل الحالي.
تفاصيل Slack
لا يزال channels.slack.slashCommand مدعومًا لأمر واحد بنمط /openclaw. إذا فعّلت commands.native، فيجب إنشاء أمر Slack slash واحد لكل أمر مدمج (بالأسماء نفسها كما في /help). تُسلَّم قوائم وسيطات الأوامر في Slack كأزرار Block Kit مؤقتة.
استثناء Slack الأصلي: سجّل /agentstatus (وليس /status) لأن Slack يحجز /status. لا يزال نص /status يعمل في رسائل Slack.
أسئلة BTW الجانبية
/btw هو سؤال جانبي سريع عن الجلسة الحالية. /side اسم بديل.
بخلاف الدردشة العادية:
- يستخدم الجلسة الحالية كسياق خلفي،
- يعمل كاستدعاء مستقل لمرة واحدة بلا أدوات،
- لا يغير سياق الجلسة المستقبلية،
- لا يُكتب في سجل المحادثة،
- يُسلَّم كنتيجة جانبية حية بدلًا من رسالة مساعد عادية.
وهذا يجعل /btw مفيدًا عندما تريد توضيحًا مؤقتًا بينما تستمر المهمة الرئيسية.
مثال:
/btw what are we doing right now?
/side what changed while the main run continued?
راجع أسئلة BTW الجانبية للاطلاع على السلوك الكامل وتفاصيل تجربة العميل.