Skills
أوامر الشرطة المائلة
يتعامل Gateway مع الأوامر المرسلة كرسائل مستقلة تبدأ بـ /.
تستخدم أوامر bash الخاصة بالمضيف فقط الصيغة ! <cmd> (مع /bash <cmd> كاسم مستعار).
عند ربط محادثة بجلسة ACP، يوجَّه النص العادي إلى حاضنة ACP. تبقى أوامر إدارة Gateway محلية: يصل /acp ... دائما إلى معالج أوامر OpenClaw، ويبقى /status و/unfocus محليين كلما كان التعامل مع الأوامر مفعلا للسطح.
ثلاثة أنواع من الأوامر
رسائل /... مستقلة يتعامل معها Gateway. يجب أن تكون المحتوى الوحيد في الرسالة.
/think، /fast، /verbose، /trace، /reasoning، /elevated،
/exec، /model، /queue — تزال من الرسالة قبل أن يراها النموذج.
تحفظ إعدادات الجلسة عند إرسالها وحدها؛ وتعمل كتلميحات مضمنة عند إرسالها مع نص آخر.
/help، /commands، /status، /whoami — تعمل فورا وتزال قبل أن يرى النموذج النص المتبقي. للمرسلين المصرح لهم فقط.
تفاصيل سلوك التوجيهات
- تزال التوجيهات من الرسالة قبل أن يراها النموذج.
- في رسائل التوجيهات فقط (تكون الرسالة توجيهات فقط)، تحفظ في الجلسة وترد بإقرار.
- في رسائل الدردشة العادية مع نص آخر، تعمل كتلميحات مضمنة ولا تحفظ إعدادات الجلسة.
- تنطبق التوجيهات فقط على المرسلين المصرح لهم. إذا تم ضبط
commands.allowFrom، فهو قائمة السماح الوحيدة المستخدمة؛ وإلا يأتي التفويض من قوائم سماح/اقتران القناة إضافة إلىcommands.useAccessGroups. يرى المرسلون غير المصرح لهم التوجيهات كنص عادي.
الإعدادات
{ 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.textbooleandefault: trueيفعّل تحليل /... في رسائل الدردشة. على الأسطح التي لا تحتوي على أوامر أصلية
(WhatsApp، WebChat، Signal، iMessage، Google Chat، Microsoft Teams)، تعمل الأوامر النصية حتى عند ضبطه على false.
commands.nativeboolean | "auto"default: "auto"يسجل الأوامر الأصلية. تلقائي: مفعّل لـ Discord/Telegram؛ معطل لـ Slack؛
ومتجاهل للموفرين الذين لا يدعمون ذلك أصليا. يمكن تجاوزه لكل قناة باستخدام
channels.<provider>.commands.native. في Discord، تؤدي false إلى تخطي تسجيل أوامر الشرطة المائلة؛ وقد تبقى الأوامر المسجلة سابقا مرئية حتى تزال.
commands.nativeSkillsboolean | "auto"default: "auto"يسجل أوامر Skills أصليا عند دعم ذلك. تلقائي: مفعّل لـ
Discord/Telegram؛ معطل لـ Slack. يمكن تجاوزه باستخدام
channels.<provider>.commands.nativeSkills.
commands.bashbooleandefault: falseيفعّل ! <cmd> لتشغيل أوامر صدفة المضيف (الاسم المستعار /bash <cmd>). يتطلب
قوائم سماح tools.elevated.
commands.bashForegroundMsnumberdefault: 2000مدة انتظار bash قبل التحول إلى وضع الخلفية (0 يضعه في الخلفية فورا).
commands.configbooleandefault: falseيفعّل /config (يقرأ/يكتب openclaw.json). للمالك فقط.
commands.mcpbooleandefault: falseيفعّل /mcp (يقرأ/يكتب إعداد MCP الذي يديره OpenClaw تحت mcp.servers). للمالك فقط.
commands.pluginsbooleandefault: falseيفعّل /plugins (اكتشاف/حالة plugins إضافة إلى التثبيت + التفعيل/التعطيل). الكتابة للمالك فقط.
commands.debugbooleandefault: falseيفعّل /debug (تجاوزات إعدادات وقت التشغيل فقط). للمالك فقط.
commands.restartbooleandefault: trueيفعّل /restart وإجراءات أداة إعادة تشغيل Gateway.
commands.ownerAllowFromstring[]قائمة سماح صريحة للمالك لأسطح الأوامر الخاصة بالمالك فقط. منفصلة عن
commands.allowFrom ووصول اقتران الرسائل المباشرة.
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs
.commands.enforceOwnerForCommands" type="boolean" default="false">
لكل قناة: يتطلب هوية المالك للأوامر الخاصة بالمالك فقط. عند true،
يجب أن يطابق المرسل commands.ownerAllowFrom أو يحمل نطاق operator.admin
الداخلي. إدخال بدل شامل في allowFrom ليس كافيا.
commands.ownerDisplay"raw" | "hash"يتحكم في كيفية ظهور معرفات المالك في موجه النظام.
commands.ownerDisplaySecretstringسر HMAC المستخدم عند commands.ownerDisplay: "hash".
commands.allowFromobjectقائمة سماح لكل موفر لتفويض الأوامر. عند ضبطها، تكون هي
مصدر التفويض الوحيد للأوامر والتوجيهات. استخدم "*" لقيمة افتراضية
عامة؛ وتتجاوزها المفاتيح الخاصة بالموفر.
commands.useAccessGroupsbooleandefault: trueيفرض قوائم السماح/السياسات للأوامر عندما لا يكون commands.allowFrom مضبوطا.
قائمة الأوامر
تأتي الأوامر من ثلاثة مصادر:
- الأوامر المضمنة في النواة:
src/auto-reply/commands-registry.shared.ts - أوامر dock المولدة:
src/auto-reply/commands-registry.data.ts - أوامر Plugin: استدعاءات
registerCommand()في plugin
يعتمد التوفر على أعلام الإعدادات، وسطح القناة، وplugins المثبتة/المفعلة.
أوامر النواة
الجلسات والتشغيلات
| الأمر | الوصف |
|---|---|
/new [model] |
أرشف الجلسة الحالية وابدأ جلسة جديدة |
/reset [soft [message]] |
أعد ضبط الجلسة الحالية في مكانها. يحافظ soft على النص، ويسقط معرفات جلسات واجهة CLI الخلفية المعاد استخدامها، ويعيد تشغيل بدء التشغيل |
/name <title> |
سمّ الجلسة الحالية أو أعد تسميتها. احذف العنوان لرؤية الاسم الحالي واقتراح |
/compact [instructions] |
اضغط سياق الجلسة. راجع Compaction |
/stop |
أوقف التشغيل الحالي |
/session idle <duration|off> |
أدِر انتهاء الخمول لربط الخيط |
/session max-age <duration|off> |
أدِر انتهاء الحد الأقصى للعمر لربط الخيط |
/export-session [path] |
صدّر الجلسة الحالية إلى HTML. الاسم المستعار: /export |
/export-trajectory [path] |
صدّر حزمة مسار JSONL للجلسة الحالية. الاسم المستعار: /trajectory |
النموذج وعناصر التحكم في التشغيل
| الأمر | الوصف |
|---|---|
/think <level|default> |
اضبط مستوى التفكير أو امسح تجاوز الجلسة. الأسماء المستعارة: /thinking، /t |
/verbose on|off|full |
بدّل الإخراج المفصل. الاسم المستعار: /v |
/trace on|off |
بدّل إخراج تتبع plugin للجلسة الحالية |
/fast [status|auto|on|off|default] |
اعرض وضع السرعة أو اضبطه أو امسحه |
/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 أو اضبطها |
/login [codex|openai|openai-codex] |
اقرن تسجيل دخول Codex/OpenAI من دردشة خاصة أو جلسة واجهة ويب. للمالك/المسؤول فقط |
/model [name|#|status] |
اعرض النموذج أو اضبطه |
/models [provider] [page] [limit=<n>|all] |
اسرد الموفرين أو النماذج المضبوطة/المتاحة بالمصادقة |
/queue <mode> |
أدِر سلوك قائمة انتظار التشغيل النشط. راجع قائمة الانتظار وتوجيه قائمة الانتظار |
/steer <message> |
أدخل إرشادا في التشغيل النشط. الاسم المستعار: /tell. راجع التوجيه |
أمان verbose / trace / fast / reasoning
- يستخدم
/verboseللتصحيح — أبقه معطلا في الاستخدام العادي. - يكشف
/traceفقط أسطر التتبع/التصحيح المملوكة لـ plugin؛ ويبقى الكلام التفصيلي العادي معطلا. - يحفظ
/fast auto|on|offتجاوزا للجلسة؛ استخدم خيارinheritفي واجهة الجلسات لمسحه. /fastخاص بالموفر: يربطه OpenAI/Codex بـservice_tier=priority؛ وتربطه طلبات Anthropic المباشرة بـservice_tier=autoأوstandard_only./reasoningو/verboseو/traceمحفوفة بالمخاطر في إعدادات المجموعات — فقد تكشف الاستدلال الداخلي أو تشخيصات plugin. أبقها معطلة في محادثات المجموعات.
تفاصيل تبديل النموذج
- يحفظ
/modelالنموذج الجديد فورا في الجلسة. - إذا كان الوكيل خاملا، يستخدمه التشغيل التالي مباشرة.
- إذا كان هناك تشغيل نشط، يوضع التبديل كقيد الانتظار ويطبق عند نقطة إعادة المحاولة النظيفة التالية.
الاكتشاف والحالة
| الأمر | الوصف |
|---|---|
/help |
اعرض ملخص المساعدة القصير |
/commands |
اعرض كتالوج الأوامر المولد |
/tools [compact|verbose] |
اعرض ما يمكن للوكيل الحالي استخدامه الآن |
/status |
اعرض حالة التنفيذ/وقت التشغيل، وزمن تشغيل Gateway والنظام، وصحة plugin، إضافة إلى استخدام/حصة الموفر |
/status plugins |
اعرض صحة plugin بالتفصيل: أخطاء التحميل، العزل، فشل القنوات، مشكلات الاعتماديات، إشعارات التوافق |
/goal [status|start|pause|resume|complete|block|clear] ... |
أدِر هدف الجلسة الحالية الدائم |
/diagnostics [note] |
تدفق تقرير دعم للمالك فقط. يطلب موافقة exec كل مرة |
/crestodian <request> |
شغّل مساعد إعداد وإصلاح Crestodian من رسالة مباشرة للمالك |
/tasks |
اسرد المهام الخلفية النشطة/الأخيرة للجلسة الحالية |
/context [list|detail|map|json] |
اشرح كيفية تجميع السياق |
/whoami |
اعرض معرف المرسل الخاص بك. الاسم المستعار: /id |
/usage off|tokens|full|reset|cost |
تحكم في تذييل الاستخدام لكل استجابة (reset/inherit/clear/default يمسح تجاوز الجلسة لإعادة وراثة الافتراضي المضبوط) أو اطبع ملخص تكلفة محليا |
Skills، قوائم السماح، الموافقات
| الأمر | الوصف |
|---|---|
/skill <name> [input] |
شغّل Skill بالاسم |
/allowlist [list|add|remove] ... |
أدِر إدخالات قائمة السماح. نص فقط |
/approve <id> <decision> |
حل مطالبات موافقة exec أو plugin |
/btw <question> |
اطرح سؤالا جانبيا دون تغيير سياق الجلسة. الاسم المستعار: /side. راجع بالمناسبة |
الوكلاء الفرعيون وACP
| الأمر | الوصف |
|---|---|
/subagents list|log|info |
فحص تشغيلات الوكلاء الفرعيين للجلسة الحالية |
/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help |
إدارة جلسات ACP وخيارات وقت التشغيل. تتطلب عناصر التحكم في وقت التشغيل مالكًا خارجيًا أو هوية مسؤول Gateway داخلية |
/focus <target> |
ربط سلسلة Discord الحالية أو موضوع Telegram بهدف جلسة |
/unfocus |
إزالة ربط السلسلة الحالية |
/agents |
سرد الوكلاء المرتبطين بالسلاسل للجلسة الحالية |
الكتابات الخاصة بالمالك فقط والإدارة
| الأمر | يتطلب | الوصف |
|---|---|---|
/config show|get|set|unset |
commands.config: true |
قراءة openclaw.json أو الكتابة إليه. للمالك فقط |
/mcp show|get|set|unset |
commands.mcp: true |
قراءة إعدادات خادم MCP المُدارة بواسطة OpenClaw أو الكتابة إليها. للمالك فقط |
/plugins list|inspect|show|get|install|enable|disable |
commands.plugins: true |
فحص حالة Plugin أو تعديلها. الكتابات للمالك فقط. الاسم المستعار: /plugin |
/debug show|set|unset|reset |
commands.debug: true |
تجاوزات إعدادات وقت التشغيل فقط. للمالك فقط |
/restart |
commands.restart: true (افتراضي) |
إعادة تشغيل OpenClaw |
/send on|off|inherit |
المالك | تعيين سياسة الإرسال |
الصوت، TTS، التحكم في القناة
| الأمر | الوصف |
|---|---|
/tts on|off|status|chat|latest|provider|limit|summary|audio|help |
التحكم في TTS. راجع TTS |
/activation mention|always |
تعيين وضع تفعيل المجموعة |
/bash <command> |
تشغيل أمر صدفة على المضيف. الاسم المستعار: ! <command>. يتطلب commands.bash: true |
!poll [sessionId] |
التحقق من مهمة bash في الخلفية |
!stop [sessionId] |
إيقاف مهمة bash في الخلفية |
أوامر Dock
تبدّل أوامر Dock مسار رد الجلسة النشطة إلى قناة مرتبطة أخرى. راجع إرساء القنوات للإعداد واستكشاف الأخطاء وإصلاحها.
مُولّدة من Plugins القنوات التي تدعم الأوامر الأصلية:
/dock-discord(الاسم المستعار:/dock_discord)/dock-mattermost(الاسم المستعار:/dock_mattermost)/dock-slack(الاسم المستعار:/dock_slack)/dock-telegram(الاسم المستعار:/dock_telegram)
تتطلب أوامر Dock وجود session.identityLinks. يجب أن يكون المرسل المصدر والنظير الهدف
ضمن مجموعة الهوية نفسها.
أوامر Plugin المضمّنة
| الأمر | الوصف |
|---|---|
/dreaming [on|off|status|help] |
تبديل Dreaming للذاكرة (المالك أو مسؤول Gateway). راجع Dreaming |
/pair [qr|status|pending|approve|cleanup|notify] |
إدارة إقران الأجهزة. راجع الإقران |
/phone status|arm ...|disarm |
تسليح أوامر عقدة الهاتف عالية الخطورة مؤقتًا |
/voice status|list|set <voiceId> |
إدارة إعداد صوت 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
أوامر Skill
تُعرض Skills التي يمكن للمستخدم استدعاؤها كأوامر بشرطة مائلة:
- يعمل
/skill <name> [input]دائمًا كنقطة دخول عامة. - قد تُسجّل Skills كأوامر مباشرة (مثل
/proseلـ OpenProse). - يتحكم
commands.nativeSkillsوchannels.<provider>.commands.nativeSkillsفي تسجيل أوامر Skills الأصلية. - تُنظَّف الأسماء إلى
a-z0-9_(بحد أقصى 32 حرفًا)؛ وتحصل التصادمات على لاحقات رقمية.
توجيه أمر Skill
افتراضيًا، تُوجَّه أوامر Skills إلى النموذج كطلب عادي.
يمكن لـ Skills إعلان command-dispatch: tool للتوجيه مباشرة إلى أداة
(حتمي، دون تدخل النموذج). مثال: /prose (Plugin OpenProse)
— راجع OpenProse.
وسائط الأوامر الأصلية
يستخدم Discord الإكمال التلقائي للخيارات الديناميكية وقوائم الأزرار عند حذف
الوسائط المطلوبة. يعرض Telegram وSlack قائمة أزرار للأوامر ذات
الاختيارات. تُحل الاختيارات الديناميكية مقابل نموذج الجلسة الهدف، لذا تتبع الخيارات
الخاصة بالنموذج مثل مستويات /think تجاوز /model الخاص بالجلسة.
/tools — ما يمكن للوكيل استخدامه الآن
يجيب /tools عن سؤال وقت التشغيل: ما الذي يمكن لهذا الوكيل استخدامه الآن في هذه
المحادثة — وليس كتالوج إعدادات ثابتًا.
/tools # compact view/tools verbose # with short descriptionsتكون النتائج محددة بنطاق الجلسة. قد يؤدي تغيير الوكيل أو القناة أو السلسلة أو تفويض المرسل أو النموذج إلى تغيير المخرجات. لتحرير الملفات الشخصية والتجاوزات، استخدم لوحة Tools في واجهة التحكم أو أسطح الإعدادات.
/model — اختيار النموذج
/model # show model picker/model list # same/model 3 # select by number from picker/model openai/gpt-5.4/model opus@anthropic:default/model default # clear the session model selection/model status # detailed view with endpoint and API modeعلى Discord، يفتح /model و/models منتقيًا تفاعليًا مع قوائم منسدلة للمزوّد و
النموذج. يحترم المنتقي agents.defaults.models، بما في ذلك
إدخالات provider/*.
/config — كتابات الإعدادات على القرص
/config show/config show messages.responsePrefix/config get messages.responsePrefix/config set messages.responsePrefix="[openclaw]"/config unset messages.responsePrefixتُتحقق الإعدادات قبل الكتابة. تُرفض التغييرات غير الصالحة. تستمر تحديثات /config
بعد إعادة التشغيل.
/mcp — إعداد خادم MCP
/mcp show/mcp show context7/mcp set context7={"command":"uvx","args":["context7-mcp"]}/mcp unset context7يخزّن /mcp الإعدادات في إعدادات OpenClaw، وليس في إعدادات مشروع الوكيل المضمّن.
/debug — تجاوزات وقت التشغيل فقط
/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset/plugins — إدارة Plugin
/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install ./path/to/pluginيحدّث /plugins enable|disable إعدادات Plugin ويعيد تحميل وقت تشغيل Plugin في Gateway
مباشرةً لدورات الوكيل الجديدة. يعيد /plugins install تشغيل Gateways المُدارة
تلقائيًا لأن وحدات مصدر Plugin تغيّرت.
/trace — مخرجات تتبع Plugin
/trace # show current trace state/trace on/trace offيكشف /trace أسطر تتبع/تصحيح Plugin المحددة بنطاق الجلسة دون وضع الإسهاب الكامل.
ولا يحل محل /debug (تجاوزات وقت التشغيل) أو /verbose (مخرجات
الأدوات العادية).
/btw — أسئلة جانبية
/btw سؤال جانبي سريع حول سياق الجلسة الحالية. الاسم المستعار: /side.
/btw what are we doing right now?/side what changed while the main run continued?بخلاف الرسالة العادية:
- يستخدم الجلسة الحالية كسياق خلفية.
- في جلسات حاضنة Codex، يعمل كسلسلة جانبية مؤقتة في Codex.
- لا يغير سياق الجلسة المستقبلي.
- لا يُكتب في سجل النصوص.
راجع أسئلة BTW الجانبية للاطلاع على السلوك الكامل.
ملاحظات السطح
نطاق الجلسة لكل سطح
- الأوامر النصية: تعمل في جلسة الدردشة العادية (تشترك الرسائل الخاصة في
main، وللمجموعات جلساتها الخاصة). - أوامر Discord الأصلية:
agent:<agentId>:discord:slash:<userId> - أوامر Slack الأصلية:
agent:<agentId>:slack:slash:<userId>(يمكن ضبط البادئة عبرchannels.slack.slashCommand.sessionPrefix) - أوامر Telegram الأصلية:
telegram:slash:<userId>(تستهدف جلسة الدردشة عبرCommandTargetSessionKey) /login codexيرسل رموز إقران الأجهزة فقط عبر الدردشة الخاصة أو مسارات استجابة واجهة الويب. تطلب استدعاءات مجموعات/مواضيع Telegram من المالك مراسلة البوت مباشرة بدلًا من ذلك./stopيستهدف جلسة الدردشة النشطة لإجهاض التشغيل الحالي.
تفاصيل Slack
يدعم channels.slack.slashCommand أمرًا واحدًا على نمط /openclaw.
مع commands.native: true، أنشئ أمر Slack بشرطة مائلة واحدًا لكل أمر
مضمّن. سجّل /agentstatus (وليس /status) لأن Slack يحجز
/status. لا يزال نص /status يعمل في رسائل Slack.
المسار السريع والاختصارات المضمنة
- تُعالَج الرسائل التي تحتوي على أوامر فقط من المرسلين المدرجين في قائمة السماح فورًا (تجاوز الطابور + النموذج).
- تعمل الاختصارات المضمنة (
/help,/commands,/status,/whoami) أيضًا داخل الرسائل العادية وتُزال قبل أن يرى النموذج النص المتبقي. - تُتجاهل الرسائل غير المصرح بها التي تحتوي على أوامر فقط بصمت؛ وتُعامل رموز
/...المضمنة كنص عادي.
ملاحظات الوسائط
- تقبل الأوامر
:اختياريًا بين الأمر والوسائط (/think: high,/send: on). - يقبل
/new <model>اسمًا مستعارًا للنموذج، أوprovider/model، أو اسم مزوّد (مطابقة تقريبية)؛ وإذا لم توجد مطابقة، فيُعامل النص كمتن الرسالة. - يتطلب
/allowlist add|removeوجودcommands.config: trueويحترمconfigWritesالخاصة بالقناة.
استخدام المزوّد والحالة
- يظهر استخدام/حصة المزوّد (مثل "Claude 80% left") في
/statusلمزوّد النموذج الحالي عند تفعيل تتبع الاستخدام. - يمكن أن تعود أسطر الرموز/ذاكرة التخزين المؤقت في
/statusإلى أحدث إدخال استخدام في سجل النصوص عندما تكون لقطة الجلسة المباشرة قليلة التفاصيل. - التنفيذ مقابل وقت التشغيل: يبلّغ
/statusعنExecutionلمسار sandbox الفعلي وRuntimeلمن يشغّل الجلسة:OpenClaw DefaultأوOpenAI Codexأو خلفية CLI أو خلفية ACP. - الرموز/التكلفة لكل رد: يتحكم بها
/usage off|tokens|full. - يتعلق
/model statusبالنماذج/المصادقة/نقاط النهاية، وليس الاستخدام.
