Skip to main content
يتولى 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. يتعامل المرسلون غير المخوّلين مع التوجيهات كنص عادي.

الإعداد

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 النموذج الجديد فورًا في الجلسة.
  • إذا كان الوكيل خاملًا، تستخدمه عملية التشغيل التالية فورًا.
  • إذا كانت هناك عملية تشغيل نشطة، يُعلَّم التبديل على أنه معلّق ويُطبّق عند نقطة إعادة المحاولة النظيفة التالية.

أوامر الإرساء

تبدّل أوامر الإرساء مسار الرد للجلسة النشطة إلى قناة مرتبطة أخرى. راجع إرساء القنوات للإعداد واستكشاف الأخطاء وإصلاحها. يتم إنشاؤها من 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: اختيار النموذج

في Discord، يفتح /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 جانبية مؤقتة.
  • لا يغيّر سياق الجلسة المستقبلي.
  • لا يُكتب في سجل النص.
راجع أسئلة 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 جلسة المحادثة النشطة لإلغاء التشغيل الحالي.
يدعم 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.