/.
تستخدم أوامر 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. يتعامل المرسلون غير المخوّلين مع التوجيهات كنص عادي.
الإعداد
boolean
افتراضي:"true"
يفعّل تحليل
/... في رسائل الدردشة. على الواجهات التي لا تتوفر فيها أوامر أصلية
(WhatsApp وWebChat وSignal وiMessage وGoogle Chat وMicrosoft Teams)، تعمل الأوامر
النصية حتى عند تعيينه على false.boolean | "auto"
افتراضي:"\"auto\""
يسجّل الأوامر الأصلية. تلقائي: مفعّل لـ Discord/Telegram؛ ومعطّل لـ Slack؛
ويُتجاهل مع المزوّدين الذين لا يدعمون الأوامر الأصلية. يمكن تجاوزه لكل قناة باستخدام
channels.<provider>.commands.native. في Discord، يتخطى false تسجيل أوامر الشرطة المائلة؛
وقد تظل الأوامر المسجّلة سابقًا ظاهرة حتى تُزال.boolean | "auto"
افتراضي:"\"auto\""
يسجّل أوامر المهارات كأوامر أصلية عند دعم ذلك. تلقائي: مفعّل لـ
Discord/Telegram؛ ومعطّل لـ Slack. يمكن تجاوزه باستخدام
channels.<provider>.commands.nativeSkills.boolean
افتراضي:"false"
يفعّل
! <cmd> لتشغيل أوامر صدفة المضيف (الاسم المستعار /bash <cmd>). يتطلب
قوائم السماح tools.elevated.number
افتراضي:"2000"
مدة انتظار bash قبل الانتقال إلى وضع الخلفية (ينتقل
0 إلى الخلفية
فورًا).boolean
افتراضي:"false"
يفعّل
/config (يقرأ/يكتب openclaw.json). للمالك فقط.boolean
افتراضي:"false"
يفعّل
/mcp (يقرأ/يكتب إعداد MCP المُدار بواسطة OpenClaw ضمن mcp.servers). للمالك فقط.boolean
افتراضي:"false"
يفعّل
/plugins (اكتشاف الإضافات/حالتها بالإضافة إلى التثبيت والتفعيل/التعطيل). عمليات الكتابة للمالك فقط.boolean
افتراضي:"false"
يفعّل
/debug (تجاوزات الإعداد الخاصة بوقت التشغيل فقط). للمالك فقط.boolean
افتراضي:"true"
يفعّل
/restart وطلبات إعادة التشغيل الخارجية SIGUSR1.string[]
قائمة سماح صريحة للمالك لواجهات الأوامر المقتصرة على المالك. منفصلة عن
commands.allowFrom والوصول عبر اقتران الرسائل المباشرة.boolean
افتراضي:"false"
لكل قناة: يتطلب هوية المالك للأوامر المقتصرة على المالك. عندما تكون
true،
يجب أن يطابق المرسل commands.ownerAllowFrom أو يمتلك نطاق operator.admin
الداخلي. إدخال حرف البدل allowFrom غير كافٍ."raw" | "hash"
يتحكم في كيفية ظهور معرّفات المالك في موجّه النظام.
string
سر HMAC المستخدم عندما تكون
commands.ownerDisplay: "hash".object
قائمة سماح لكل مزوّد لتخويل الأوامر. عند إعدادها، تكون
مصدر التخويل الوحيد للأوامر والتوجيهات. استخدم
"*" كإعداد
افتراضي عام؛ وتتجاوزه المفاتيح الخاصة بالمزوّد.boolean
افتراضي:"true"
يفرض قوائم السماح/السياسات للأوامر عندما لا تكون
commands.allowFrom معيّنة.قائمة الأوامر
تأتي الأوامر من ثلاثة مصادر:- الأوامر الأساسية المضمّنة:
src/auto-reply/commands-registry.shared.ts - أوامر dock المُنشأة:
src/auto-reply/commands-registry.data.ts - أوامر الإضافات: استدعاءات الإضافة
registerCommand()
الأوامر الأساسية
الجلسات وعمليات التشغيل
الجلسات وعمليات التشغيل
تستبدل مسارات
/export-session الصريحة الملفات الموجودة داخل
مساحة العمل. احذف المسار لإنشاء اسم ملف آمن من التعارضات.تعترض واجهة Control UI النص المكتوب
/new لإنشاء جلسة
لوحة معلومات جديدة والتبديل إليها، إلا عندما يكون session.dmScope: "main" معدًّا
ويكون الأصل الحالي هو الجلسة الرئيسية للوكيل — في هذه الحالة يعيد /new
ضبط الجلسة الرئيسية في مكانها. يظل النص المكتوب /reset يشغّل إعادة الضبط
الموضعية في Gateway. استخدم /model default عندما تريد مسح
اختيار نموذج مثبّت للجلسة.عناصر التحكم في النموذج والتشغيل
عناصر التحكم في النموذج والتشغيل
سلامة الإطالة / التتبع / السرعة / الاستدلال
سلامة الإطالة / التتبع / السرعة / الاستدلال
/verboseمخصّص لتصحيح الأخطاء — أبقه معطّلًا في الاستخدام العادي.- لا يكشف
/traceإلا أسطر التتبع/تصحيح الأخطاء التي تملكها الإضافة؛ وتظل الرسائل المطوّلة العادية معطّلة. - يحفظ
/fast auto|on|offتجاوزًا للجلسة؛ استخدم خيارinheritفي واجهة الجلسات لمسحه. - يعتمد
/fastعلى المزوّد: يربطه OpenAI/Codex بـservice_tier=priority؛ وتربطه طلبات Anthropic المباشرة بـservice_tier=autoأوstandard_only. - تُعد
/reasoningو/verboseو/traceمحفوفة بالمخاطر في إعدادات المجموعات — فقد تكشف الاستدلال الداخلي أو تشخيصات الإضافات. أبقها معطّلة في الدردشات الجماعية.
تفاصيل تبديل النموذج
تفاصيل تبديل النموذج
- يحفظ
/modelالنموذج الجديد فورًا في الجلسة. - إذا كان الوكيل خاملًا، تستخدمه عملية التشغيل التالية فورًا.
- إذا كانت هناك عملية تشغيل نشطة، يُعلَّم التبديل على أنه معلّق ويُطبّق عند نقطة إعادة المحاولة النظيفة التالية.
الاكتشاف والحالة
الاكتشاف والحالة
Skills، وقوائم السماح، والموافقات
Skills، وقوائم السماح، والموافقات
الوكلاء الفرعيون وACP
الوكلاء الفرعيون وACP
عمليات الكتابة والإدارة الخاصة بالمالك
عمليات الكتابة والإدارة الخاصة بالمالك
الصوت وTTS والتحكم في القناة
الصوت وTTS والتحكم في القناة
أوامر الإرساء
تبدّل أوامر الإرساء مسار الرد للجلسة النشطة إلى قناة مرتبطة أخرى. راجع إرساء القنوات للإعداد واستكشاف الأخطاء وإصلاحها. يتم إنشاؤها من Plugins القنوات التي تدعم الأوامر الأصلية:/dock-discord(الاسم المستعار:/dock_discord)/dock-mattermost(الاسم المستعار:/dock_mattermost)/dock-slack(الاسم المستعار:/dock_slack)/dock-telegram(الاسم المستعار:/dock_telegram)
session.identityLinks. يجب أن يكون المرسل المصدر والنظير الهدف
ضمن مجموعة الهوية نفسها.
أوامر Plugins المضمّنة
خاص بـ QQBot فقط:
/bot-ping، /bot-version، /bot-help، /bot-upgrade، /bot-logs
أوامر المهارات
تُعرض المهارات التي يمكن للمستخدم استدعاؤها في صورة أوامر شرطة مائلة:/skill <name> [input]يعمل دائمًا كنقطة الدخول العامة.- قد تُسجَّل المهارات كأوامر مباشرة (مثل
/proseلـ OpenProse). - يتحكم
commands.nativeSkillsوchannels.<provider>.commands.nativeSkillsفي تسجيل أوامر المهارات الأصلية. - تُعقَّم الأسماء إلى
a-z0-9_(بحد أقصى 32 حرفًا)؛ وتحصل التصادمات على لواحق رقمية.
توجيه أوامر المهارات
توجيه أوامر المهارات
افتراضيًا، تُوجَّه أوامر المهارات إلى النموذج كطلب عادي.يمكن للمهارات إعلان
command-dispatch: tool للتوجيه مباشرة إلى أداة
(بشكل حتمي، من دون مشاركة النموذج). مثال: /prose (Plugin OpenProse)
— راجع OpenProse.وسيطات الأوامر الأصلية
وسيطات الأوامر الأصلية
يستخدم Discord الإكمال التلقائي للخيارات الديناميكية وقوائم الأزرار عند حذف
الوسيطات المطلوبة. يعرض Telegram وSlack قائمة أزرار للأوامر التي تحتوي على
خيارات. تُحل الخيارات الديناميكية وفق نموذج الجلسة الهدف، لذلك تتبع الخيارات
الخاصة بالنموذج، مثل مستويات
/think، تجاوز /model الخاص بالجلسة./tools: ما يمكن للوكيل استخدامه الآن
يجيب /tools عن سؤال في وقت التشغيل: ما الذي يمكن لهذا الوكيل استخدامه الآن في هذه
المحادثة — وليس فهرس إعداد ثابتًا.
/model: اختيار النموذج
/model و/models منتقيًا تفاعليًا يتضمن قوائم منسدلة
لمزوّد الخدمة والنموذج. يراعي المنتقي agents.defaults.models، بما في ذلك
إدخالات provider/*.
/config: كتابة الإعداد على القرص
للمالك فقط. معطّل افتراضيًا — فعّله باستخدام
commands.config: true./config
عبر عمليات إعادة التشغيل.
/mcp: إعداد خادم MCP
للمالك فقط. معطّل افتراضيًا — فعّله باستخدام
commands.mcp: true./mcp الإعداد في إعداد OpenClaw، وليس في إعدادات مشروع الوكيل المضمّن.
يحجب /mcp show الحقول التي تحتوي على بيانات اعتماد، وقيم علامات بيانات
الاعتماد المعروفة، والوسيطات المعروفة ذات الهيئة السرية. عند تشغيله من مجموعة،
يُرسل الإعداد إلى المالك بشكل خاص؛ وإذا لم يتوفر مسار خاص إلى المالك،
يفشل الأمر بصورة مغلقة ويطلب من المالك إعادة المحاولة من محادثة
مباشرة.
/debug: تجاوزات خاصة بوقت التشغيل فقط
للمالك فقط. معطّل افتراضيًا — فعّله باستخدام
commands.debug: true.
تُطبّق التجاوزات فورًا على قراءات الإعداد الجديدة، لكنها لا تكتب على القرص./plugins: إدارة Plugins
عمليات الكتابة للمالك فقط. معطّل افتراضيًا — فعّله باستخدام
commands.plugins: true./plugins enable|disable إعداد Plugin ويعيد تحميل وقت تشغيل Plugins في Gateway
بشكل فوري لدورات الوكيل الجديدة. يعيد /plugins install تشغيل Gateways المُدارة
تلقائيًا لأن وحدات مصدر Plugin قد تغيرت. لا تتطلب عمليات التثبيت الموثوقة من ClawHub
والفهرس الرسمي إقرارًا إضافيًا. تعرض مصادر npm الاعتباطية وgit والأرشيف
وnpm-pack: والمسارات المحلية تحذيرًا بشأن المصدر،
وتتطلب --force في النهاية بعد مراجعة المصدر. تُقر هذه العلامة
بالمصدر وتسمح باستبدال تثبيت موجود؛ لكنها لا تتجاوز
security.installPolicy أو فحوصات أمان أداة التثبيت. لا تزال إصدارات ClawHub التي
تتضمن تحذيرات مخاطر تتطلب العلامة المنفصلة الخاصة بـ shell فقط
--acknowledge-clawhub-risk. كما تظل عمليات التثبيت من السوق والمرتبطة والمثبّتة
خاصة بـ shell فقط.
/trace: مخرجات تتبع Plugin
/trace أسطر تتبع/تصحيح Plugin الخاصة بنطاق الجلسة من دون الوضع
المطوّل الكامل. ولا يحل محل /debug (تجاوزات وقت التشغيل) أو /verbose (مخرجات
الأدوات العادية).
/btw: الأسئلة الجانبية
/btw سؤال جانبي سريع عن سياق الجلسة الحالية. الاسم المستعار: /side.
- يستخدم الجلسة الحالية كسياق خلفي.
- يعمل في جلسات أداة Codex كسلسلة Codex جانبية مؤقتة.
- لا يغيّر سياق الجلسة المستقبلي.
- لا يُكتب في سجل النص.
ملاحظات الواجهات
تحديد نطاق الجلسة لكل واجهة
تحديد نطاق الجلسة لكل واجهة
- الأوامر النصية: تعمل في جلسة المحادثة العادية (تشارك الرسائل الخاصة
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
تفاصيل 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%”) في
/statusلموفّر النموذج الحالي عند تمكين تتبّع الاستخدام. - يمكن أن ترجع أسطر الرموز/ذاكرة التخزين المؤقت في
/statusإلى أحدث إدخال لاستخدام نص الجلسة عندما تكون اللقطة المباشرة للجلسة شحيحة البيانات. - التنفيذ مقابل بيئة التشغيل: يُبلغ
/statusعنExecutionلمسار وضع الحماية الفعلي، وعنRuntimeلتحديد الجهة التي تشغّل الجلسة:OpenClaw DefaultأوOpenAI Codexأو واجهة خلفية لـ CLI أو واجهة خلفية لـ ACP. - الرموز/التكلفة لكل استجابة: يتحكم فيها
/usage off|tokens|full. - يتعلق
/model statusبالنماذج/المصادقة/نقاط النهاية، وليس بالاستخدام.
ذو صلة
Skills
كيفية تسجيل أوامر الشرطة المائلة الخاصة بالمهارات والتحكم في إتاحتها.
إنشاء المهارات
أنشئ مهارة تسجّل أمر الشرطة المائلة الخاص بها.
بالمناسبة
اطرح أسئلة جانبية من دون تغيير سياق الجلسة.
التوجيه
وجّه الوكيل في أثناء التشغيل باستخدام
/steer.