Skills

دستورهای اسلش

دستورات توسط Gateway مدیریت می‌شوند. بیشتر دستورات باید به‌صورت یک پیام مستقل ارسال شوند که با / شروع می‌شود. دستور چت bash فقط برای میزبان از ! <cmd> استفاده می‌کند (/bash <cmd> نیز به‌عنوان نام مستعار آن است).

وقتی یک مکالمه یا رشته به یک نشست ACP متصل باشد، متن‌های پیگیری عادی به همان مهار ACP هدایت می‌شوند. دستورات مدیریت Gateway همچنان محلی می‌مانند: /acp ... همیشه به مدیر دستور ACP در OpenClaw می‌رسد، و /status به‌همراه /unfocus هر زمان که مدیریت دستور برای سطح فعال باشد، محلی می‌مانند.

دو سامانه مرتبط وجود دارد:

دستورات

پیام‌های مستقل /....

رهنمودها

/think, /fast, /verbose, /trace, /reasoning, /elevated, /exec, /model, /queue.

رهنمودها پیش از آنکه مدل پیام را ببیند از پیام حذف می‌شوند.
در پیام‌های چت عادی (نه پیام‌هایی که فقط رهنمود دارند)، آن‌ها به‌عنوان «نکات درون‌خطی» در نظر گرفته می‌شوند و تنظیمات نشست را پایدار نمی‌کنند.
در پیام‌هایی که فقط رهنمود دارند (پیام فقط شامل رهنمودها است)، آن‌ها در نشست پایدار می‌شوند و با یک تأیید پاسخ می‌دهند.
رهنمودها فقط برای فرستندگان مجاز اعمال می‌شوند. اگر commands.allowFrom تنظیم شده باشد، تنها فهرست مجاز مورد استفاده همان است؛ در غیر این صورت مجوز از فهرست‌های مجاز/جفت‌سازی کانال به‌همراه commands.useAccessGroups می‌آید. فرستندگان غیرمجاز رهنمودها را به‌صورت متن ساده می‌بینند.

میان‌برهای درون‌خطی

فقط فرستندگان در فهرست مجاز/مجازشده: /help, /commands, /status, /whoami (/id).

آن‌ها بلافاصله اجرا می‌شوند، پیش از آنکه مدل پیام را ببیند حذف می‌شوند، و متن باقی‌مانده از جریان عادی ادامه پیدا می‌کند.

پیکربندی

json5

{  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.discord.commands.native، channels.telegram.commands.native، یا channels.slack.commands.native را تنظیم کنید (بولی یا "auto"). در Discord، مقدار false ثبت و پاک‌سازی فرمان اسلش را هنگام راه‌اندازی رد می‌کند؛ دستوراتی که قبلاً ثبت شده‌اند ممکن است تا وقتی آن‌ها را از برنامه Discord حذف کنید همچنان قابل مشاهده بمانند. دستورات Slack در برنامه Slack مدیریت می‌شوند و به‌طور خودکار حذف نمی‌شوند.

در Discord، مشخصات دستور بومی ممکن است شامل descriptionLocalizations باشد که OpenClaw آن را به‌عنوان description_localizations در Discord منتشر می‌کند و در مقایسه‌های سازگارسازی قرار می‌دهد.

commands.nativeSkillsboolean | "auto"default: "auto"

دستورات skill را، وقتی پشتیبانی شوند، به‌صورت بومی ثبت می‌کند. حالت خودکار: برای Discord/Telegram روشن؛ برای Slack خاموش (Slack نیاز دارد برای هر skill یک فرمان اسلش ایجاد شود). برای بازنویسی به‌ازای هر ارائه‌دهنده، channels.discord.commands.nativeSkills، channels.telegram.commands.nativeSkills، یا channels.slack.commands.nativeSkills را تنظیم کنید (بولی یا "auto").

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 را فعال می‌کند (کشف/وضعیت Plugin به‌همراه کنترل‌های نصب و فعال/غیرفعال‌سازی).

commands.debugbooleandefault: false

/debug را فعال می‌کند (بازنویسی‌های فقط زمان اجرا).

commands.restartbooleandefault: true

/restart را به‌همراه کنش‌های ابزار راه‌اندازی مجدد Gateway فعال می‌کند.

commands.ownerAllowFromstring[]

فهرست مجاز صریح مالک را برای سطح‌های دستور/ابزار فقط مالک تنظیم می‌کند. این همان حساب اپراتور انسانی است که می‌تواند کنش‌های خطرناک را تأیید کند و دستورهایی مانند /diagnostics، /export-trajectory، و /config را اجرا کند. این گزینه از commands.allowFrom و از دسترسی جفت‌سازی پیام خصوصی جدا است.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs .commands.enforceOwnerForCommands" type="boolean" default="false"> به‌ازای هر کانال: باعث می‌شود دستورات فقط مالک برای اجرا روی آن سطح به هویت مالک نیاز داشته باشند. وقتی true باشد، فرستنده باید یا با یک نامزد مالک resolve‌شده مطابقت داشته باشد (برای مثال ورودی‌ای در commands.ownerAllowFrom یا فراداده مالک بومی ارائه‌دهنده) یا روی یک کانال پیام داخلی محدوده داخلی operator.admin داشته باشد. یک ورودی wildcard در allowFrom کانال، یا یک فهرست نامزد مالک خالی/resolveنشده، کافی نیست — دستورات فقط مالک روی آن کانال fail closed می‌شوند. اگر می‌خواهید دستورات فقط مالک فقط با ownerAllowFrom و فهرست‌های مجاز استاندارد دستور کنترل شوند، این گزینه را خاموش بگذارید.

commands.ownerDisplay"raw" | "hash"

کنترل می‌کند شناسه‌های مالک چگونه در system prompt ظاهر شوند.

commands.ownerDisplaySecretstring

به‌صورت اختیاری secret مربوط به HMAC را که هنگام commands.ownerDisplay="hash" استفاده می‌شود تنظیم می‌کند.

commands.allowFromobject

فهرست مجاز به‌ازای هر ارائه‌دهنده برای مجوزدهی دستور. وقتی پیکربندی شود، تنها منبع مجوزدهی برای دستورات و رهنمودها است (فهرست‌های مجاز/جفت‌سازی کانال و commands.useAccessGroups نادیده گرفته می‌شوند). برای پیش‌فرض سراسری از "*" استفاده کنید؛ کلیدهای ویژه ارائه‌دهنده آن را بازنویسی می‌کنند.

commands.useAccessGroupsbooleandefault: true

وقتی commands.allowFrom تنظیم نشده باشد، فهرست‌های مجاز/سیاست‌ها را برای دستورات اعمال می‌کند.

فهرست دستورات

منبع حقیقت فعلی:

موارد داخلی هسته از src/auto-reply/commands-registry.shared.ts می‌آیند
دستورات dock تولیدشده از src/auto-reply/commands-registry.data.ts می‌آیند
دستورات Plugin از فراخوانی‌های registerCommand() در Plugin می‌آیند
دسترس‌پذیری واقعی روی Gateway شما همچنان به پرچم‌های پیکربندی، سطح کانال، و Pluginهای نصب‌شده/فعال بستگی دارد

دستورات داخلی هسته

نشست‌ها و اجراها

/new [model] یک نشست جدید آغاز می‌کند؛ /reset نام مستعار بازنشانی است.
رابط کاربری کنترل، /new تایپ‌شده را برای ایجاد و جابه‌جایی به یک نشست تازه داشبورد می‌گیرد، مگر وقتی session.dmScope: "main" پیکربندی شده باشد و والد فعلی نشست اصلی عامل باشد؛ در این حالت /new نشست اصلی را در همان‌جا بازنشانی می‌کند. /reset تایپ‌شده همچنان بازنشانی درجا توسط Gateway را اجرا می‌کند.
/reset soft [message] رونوشت فعلی را نگه می‌دارد، شناسه‌های نشست backend CLI استفاده‌مجددشده را حذف می‌کند، و بارگذاری راه‌اندازی/system-prompt را درجا دوباره اجرا می‌کند.
/compact [instructions] زمینه نشست را compact می‌کند. Compaction را ببینید.
/stop اجرای فعلی را لغو می‌کند.
/session idle <duration|off> و /session max-age <duration|off> انقضای اتصال رشته را مدیریت می‌کنند.
/export-session [path] نشست فعلی را به HTML صادر می‌کند. نام مستعار: /export.
/export-trajectory [path] تأیید exec را درخواست می‌کند، سپس یک بسته trajectory JSONL برای نشست فعلی صادر می‌کند. وقتی برای یک نشست OpenClaw به prompt، ابزار، و timeline رونوشت نیاز دارید از آن استفاده کنید. در چت‌های گروهی، prompt تأیید و نتیجه صدور به‌صورت خصوصی برای مالک ارسال می‌شود. نام مستعار: /trajectory.

کنترل‌های مدل و اجرا

/think <level|default> سطح thinking را تنظیم می‌کند یا بازنویسی نشست را پاک می‌کند. گزینه‌ها از نمایه ارائه‌دهنده مدل فعال می‌آیند؛ سطح‌های رایج off، minimal، low، medium، و high هستند، و سطح‌های سفارشی مانند xhigh، adaptive، max، یا مقدار دودویی on فقط در جاهایی که پشتیبانی شوند وجود دارند. نام‌های مستعار: /thinking، /t.
/verbose on|off|full خروجی verbose را روشن یا خاموش می‌کند. نام مستعار: /v.
/trace on|off خروجی trace مربوط به Plugin را برای نشست فعلی روشن یا خاموش می‌کند.
/fast [status|on|off|default] حالت fast را نمایش می‌دهد، تنظیم می‌کند، یا پاک می‌کند.
/reasoning [on|off|stream] نمایش reasoning را روشن یا خاموش می‌کند. نام مستعار: /reason.
/elevated [on|off|ask|full] حالت elevated را روشن یا خاموش می‌کند. نام مستعار: /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 را اضافه کنید. ورودی‌های provider/* در agents.defaults.models باعث می‌شوند /model و /models فقط مدل‌های کشف‌شده برای همان ارائه‌دهندگان را نشان دهند.
/queue <mode> رفتار queue را مدیریت می‌کند (steer، queue قدیمی، followup، collect، steer-backlog، interrupt) به‌همراه گزینه‌هایی مانند debounce:0.5s cap:25 drop:summarize؛ /queue default یا /queue reset بازنویسی نشست را پاک می‌کند. صف دستور و صف هدایت را ببینید.
/steer <message> راهنمایی را به اجرای فعال برای نشست فعلی تزریق می‌کند، مستقل از حالت /queue. وقتی نشست idle باشد اجرای جدیدی شروع نمی‌کند. نام مستعار: /tell. Steer را ببینید.

کشف و وضعیت

/help خلاصه کوتاه راهنما را نشان می‌دهد.
/commands کاتالوگ دستور تولیدشده را نشان می‌دهد.
/tools [compact|verbose] نشان می‌دهد عامل فعلی همین حالا از چه چیزهایی می‌تواند استفاده کند.
/status وضعیت اجرا/زمان اجرا، uptime مربوط به Gateway و سیستم، به‌همراه میزان استفاده/quota ارائه‌دهنده را وقتی در دسترس باشد نشان می‌دهد.
/diagnostics [note] جریان گزارش پشتیبانی فقط مالک برای باگ‌های Gateway و اجراهای مهار Codex است. هر بار پیش از اجرای openclaw gateway diagnostics export --json تأیید صریح exec درخواست می‌کند؛ diagnostics را با قاعده allow-all تأیید نکنید. پس از تأیید، گزارشی قابل paste با مسیر بسته محلی، خلاصه manifest، نکات حریم خصوصی، و شناسه‌های نشست مرتبط می‌فرستد. در چت‌های گروهی، prompt تأیید و گزارش به‌صورت خصوصی برای مالک ارسال می‌شوند. وقتی نشست فعال از مهار OpenAI Codex استفاده می‌کند، همان تأیید همچنین بازخورد مرتبط Codex را به سرورهای OpenAI می‌فرستد و پاسخ کامل‌شده شناسه‌های نشست OpenClaw، شناسه‌های thread در Codex، و دستورات codex resume <thread-id> را فهرست می‌کند. صدور Diagnostics را ببینید.
/crestodian <request> راه‌انداز و ابزار کمکی تعمیر Crestodian را از یک پیام خصوصی مالک اجرا می‌کند.
/tasks وظایف پس‌زمینه فعال/اخیر را برای نشست فعلی فهرست می‌کند.
/context [list|detail|map|json] توضیح می‌دهد context چگونه مونتاژ می‌شود. map یک تصویر treemap از context نشست فعلی ارسال می‌کند.
/whoami شناسه فرستنده شما را نشان می‌دهد. نام مستعار: /id.
/usage off|tokens|full|cost footer مربوط به usage در هر پاسخ را کنترل می‌کند یا یک خلاصه هزینه محلی چاپ می‌کند.

Skills، فهرست‌های مجاز، تأییدها

/skill <name> [input] یک skill را با نام اجرا می‌کند.
/allowlist [list|add|remove] ... ورودی‌های فهرست مجاز را مدیریت می‌کند. فقط متنی.
/approve <id> <decision> درخواست‌های تأیید اجرا را حل می‌کند.
/btw <question> یک پرسش جانبی می‌پرسد بدون اینکه زمینهٔ آیندهٔ نشست را تغییر دهد. نام مستعار: /side. BTW را ببینید.

زیرعامل‌ها و 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> پیام هدایت را به یک زیرعامل در حال اجرا می‌فرستد. Steer را ببینید.

نوشتن‌های فقط مالک و مدیریت

/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 سیاست ارسال را تنظیم می‌کند. فقط مالک.

صدا، TTS، کنترل کانال

/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 را متوقف می‌کند.

فرمان‌های dock تولیدشده

فرمان‌های dock مسیر پاسخ نشست فعلی را به کانال پیوندخوردهٔ دیگری تغییر می‌دهند. برای راه‌اندازی، مثال‌ها و عیب‌یابی، Channel docking را ببینید.

فرمان‌های dock از Pluginهای کانال با پشتیبانی فرمان بومی تولید می‌شوند. مجموعهٔ همراه فعلی:

/dock-discord (نام مستعار: /dock_discord)
/dock-mattermost (نام مستعار: /dock_mattermost)
/dock-slack (نام مستعار: /dock_slack)
/dock-telegram (نام مستعار: /dock_telegram)

از فرمان‌های dock در یک گفت‌وگوی مستقیم استفاده کنید تا مسیر پاسخ نشست فعلی را به کانال پیوندخوردهٔ دیگری تغییر دهید. عامل همان زمینهٔ نشست را نگه می‌دارد، اما پاسخ‌های آیندهٔ آن نشست به همتای کانال انتخاب‌شده تحویل داده می‌شوند.

فرمان‌های dock به session.identityLinks نیاز دارند. فرستندهٔ مبدأ و همتای مقصد باید در همان گروه هویتی باشند، برای مثال ["telegram:123", "discord:456"]. اگر یک کاربر Telegram با شناسهٔ 123 فرمان /dock_discord را بفرستد، OpenClaw مقدار lastChannel: "discord" و lastTo: "456" را روی نشست فعال ذخیره می‌کند. اگر فرستنده به یک همتای Discord پیوند نشده باشد، فرمان به‌جای افتادن در گفت‌وگوی عادی، با یک راهنمای راه‌اندازی پاسخ می‌دهد.

dock فقط مسیر نشست فعال را تغییر می‌دهد. حساب‌های کانال ایجاد نمی‌کند، دسترسی اعطا نمی‌کند، فهرست‌های مجاز کانال را دور نمی‌زند، یا تاریخچهٔ رونوشت را به نشست دیگری منتقل نمی‌کند. برای تغییر دوبارهٔ مسیر، از /dock-telegram، /dock-slack، /dock-mattermost یا فرمان dock تولیدشدهٔ دیگری استفاده کنید.

فرمان‌های Plugin همراه

Pluginهای همراه می‌توانند فرمان‌های slash بیشتری اضافه کنند. فرمان‌های همراه فعلی در این مخزن:

/dreaming [on|off|status|help]، Dreaming حافظه را تغییر وضعیت می‌دهد. Dreaming را ببینید.
/pair [qr|status|pending|approve|cleanup|notify] جریان جفت‌سازی/راه‌اندازی دستگاه را مدیریت می‌کند. Pairing را ببینید.
/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 مهار app-server همراه Codex را بررسی و کنترل می‌کند. Codex harness را ببینید.
فرمان‌های فقط QQBot:
- /bot-ping
- /bot-version
- /bot-help
- /bot-upgrade
- /bot-logs

فرمان‌های skill پویا

skillهای قابل فراخوانی توسط کاربر نیز به‌صورت فرمان‌های slash ارائه می‌شوند:

/skill <name> [input] همیشه به‌عنوان نقطهٔ ورود عمومی کار می‌کند.
skillها ممکن است وقتی skill/Plugin آن‌ها را ثبت می‌کند، به‌صورت فرمان‌های مستقیم مانند /prose نیز ظاهر شوند.
ثبت فرمان skill بومی با commands.nativeSkills و channels.<provider>.commands.nativeSkills کنترل می‌شود.
مشخصات فرمان می‌توانند برای سطوح بومی‌ای که از توضیح‌های بومی‌سازی‌شده پشتیبانی می‌کنند، از جمله Discord، descriptionLocalizations ارائه کنند.

نکته‌های آرگومان و پارسر

فرمان‌ها یک : اختیاری بین فرمان و آرگومان‌ها می‌پذیرند (برای نمونه /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>، سپس چون ماژول‌های منبع Plugin تغییر کرده‌اند، درخواست راه‌اندازی دوبارهٔ Gateway می‌دهد.
/plugins enable|disable پیکربندی Plugin را به‌روزرسانی می‌کند و برای نوبت‌های جدید عامل، بارگذاری دوبارهٔ Pluginهای Gateway را آغاز می‌کند.

رفتار ویژهٔ کانال

فرمان بومی فقط Discord: /vc join|leave|status کانال‌های صوتی را کنترل می‌کند (به‌صورت متن در دسترس نیست). join به یک guild و کانال صوتی/استیج انتخاب‌شده نیاز دارد. به channels.discord.voice و فرمان‌های بومی نیاز دارد.
فرمان‌های اتصال رشتهٔ Discord (/focus، /unfocus، /agents، /session idle، /session max-age) نیاز دارند اتصال‌های رشتهٔ مؤثر فعال باشند (session.threadBindings.enabled و/یا channels.discord.threadBindings.enabled).
مرجع فرمان ACP و رفتار زمان اجرا: ACP agents.

ایمنی verbose / trace / fast / reasoning

/verbose برای اشکال‌زدایی و دیدپذیری بیشتر است؛ در استفادهٔ عادی آن را خاموش نگه دارید.
/trace از /verbose محدودتر است: فقط خط‌های trace/debug متعلق به Plugin را آشکار می‌کند و گفت‌وگوی پرجزئیات عادی ابزار را خاموش نگه می‌دارد.
/fast on|off یک بازنویسی نشست را پایدار می‌کند. برای پاک‌کردن آن و بازگشت به پیش‌فرض‌های پیکربندی، از گزینهٔ inherit در رابط کاربری Sessions استفاده کنید.
/fast ویژهٔ ارائه‌دهنده است: OpenAI/OpenAI Codex آن را روی نقاط پایانی بومی Responses به service_tier=priority نگاشت می‌کنند، درحالی‌که درخواست‌های مستقیم عمومی Anthropic، از جمله ترافیک احرازشده با OAuth که به api.anthropic.com فرستاده می‌شود، آن را به service_tier=auto یا standard_only نگاشت می‌کنند. OpenAI و Anthropic را ببینید.
خلاصه‌های شکست ابزار همچنان هنگام مرتبط بودن نشان داده می‌شوند، اما متن تفصیلی شکست فقط وقتی گنجانده می‌شود که /verbose روی on یا full باشد.
/reasoning، /verbose، و /trace در محیط‌های گروهی پرریسک هستند: ممکن است reasoning داخلی، خروجی ابزار، یا عیب‌یابی‌های Plugin را که قصد افشایشان را نداشتید آشکار کنند. ترجیحاً آن‌ها را خاموش بگذارید، به‌ویژه در گفت‌وگوهای گروهی.

تغییر مدل

/model مدل جدید نشست را فوراً پایدار می‌کند.
اگر عامل بیکار باشد، اجرای بعدی بی‌درنگ از آن استفاده می‌کند.
اگر یک اجرا از قبل فعال باشد، OpenClaw یک تغییر زنده را به‌عنوان در انتظار علامت‌گذاری می‌کند و فقط در یک نقطهٔ retry تمیز با مدل جدید دوباره شروع می‌کند.
اگر فعالیت ابزار یا خروجی پاسخ از قبل شروع شده باشد، تغییر در انتظار می‌تواند تا فرصت retry بعدی یا نوبت بعدی کاربر در صف بماند.
در TUI محلی، /crestodian [request] از TUI عادی عامل به Crestodian بازمی‌گردد. این از حالت نجات کانال پیام جداست و اختیار پیکربندی از راه دور اعطا نمی‌کند.

مسیر سریع و میان‌برهای درون‌خطی

مسیر سریع: پیام‌های فقط فرمان از فرستندگان مجاز فوراً پردازش می‌شوند (دورزدن صف + مدل).
دروازه‌گذاری منشن گروه: پیام‌های فقط فرمان از فرستندگان مجاز، الزامات منشن را دور می‌زنند.
میان‌برهای درون‌خطی (فقط فرستندگان مجاز): برخی فرمان‌ها هنگام جاسازی در یک پیام عادی نیز کار می‌کنند و پیش از اینکه مدل متن باقی‌مانده را ببیند حذف می‌شوند.
- مثال: hey /status یک پاسخ وضعیت را فعال می‌کند، و متن باقی‌مانده از جریان عادی ادامه می‌یابد.
در حال حاضر: /help، /commands، /status، /whoami (/id).
پیام‌های فقط فرمانِ غیرمجاز بی‌صدا نادیده گرفته می‌شوند، و توکن‌های درون‌خطی /... به‌عنوان متن ساده در نظر گرفته می‌شوند.

فرمان‌های skill و آرگومان‌های بومی

فرمان‌های skill: skillهای user-invocable به‌صورت فرمان‌های slash ارائه می‌شوند. نام‌ها به a-z0-9_ پاک‌سازی می‌شوند (حداکثر ۳۲ نویسه)؛ برخوردها پسوندهای عددی می‌گیرند (برای نمونه _2).
- /skill <name> [input] یک skill را با نام اجرا می‌کند (وقتی محدودیت‌های فرمان بومی مانع فرمان‌های جداگانه برای هر skill می‌شوند، مفید است).
- به‌صورت پیش‌فرض، فرمان‌های skill به‌عنوان یک درخواست عادی به مدل فرستاده می‌شوند.
- skillها می‌توانند به‌صورت اختیاری command-dispatch: tool را اعلام کنند تا فرمان مستقیماً به یک ابزار مسیریابی شود (قطعی، بدون مدل).
- مثال: /prose (Plugin OpenProse) — OpenProse را ببینید.
آرگومان‌های فرمان بومی: Discord برای گزینه‌های پویا از تکمیل خودکار استفاده می‌کند (و وقتی آرگومان‌های الزامی را حذف کنید، از منوهای دکمه‌ای استفاده می‌کند). Telegram و Slack وقتی یک فرمان از انتخاب‌ها پشتیبانی کند و شما آرگومان را حذف کنید، یک منوی دکمه‌ای نشان می‌دهند. انتخاب‌های پویا در برابر مدل نشست هدف حل می‌شوند، بنابراین گزینه‌های ویژهٔ مدل مانند سطح‌های /think از بازنویسی /model همان نشست پیروی می‌کنند.

`/tools`

/tools به یک پرسش زمان اجرا پاسخ می‌دهد، نه یک پرسش پیکربندی: این عامل همین حالا در این گفت‌وگو از چه چیزهایی می‌تواند استفاده کند.

/tools پیش‌فرض فشرده و برای مرور سریع بهینه شده است.
/tools verbose توضیح‌های کوتاه اضافه می‌کند.
سطوح فرمان بومی که از آرگومان‌ها پشتیبانی می‌کنند، همان کلید تغییر حالت را به‌صورت compact|verbose ارائه می‌کنند.
نتیجه‌ها وابسته به نشست هستند، بنابراین تغییر عامل، کانال، رشته، مجوز فرستنده یا مدل می‌تواند خروجی را تغییر دهد.
/tools شامل ابزارهایی است که واقعاً در زمان اجرا قابل دسترسی هستند، از جمله ابزارهای هسته، ابزارهای Plugin متصل، و ابزارهای متعلق به کانال.

برای ویرایش پروفایل و بازنویسی، به‌جای اینکه /tools را یک کاتالوگ ایستا بدانید، از پنل Tools در رابط کاربری Control یا سطوح پیکربندی/کاتالوگ استفاده کنید.

سطوح استفاده (چه چیزی کجا نشان داده می‌شود)

مصرف/سهمیه ارائه‌دهنده (مثال: «۸۰٪ Claude باقی مانده») وقتی رهگیری مصرف فعال باشد، برای ارائه‌دهنده مدل فعلی در /status نمایش داده می‌شود. OpenClaw پنجره‌های ارائه‌دهنده را به «٪ باقی‌مانده» نرمال‌سازی می‌کند؛ برای MiniMax، فیلدهای درصدیِ فقط-باقی‌مانده پیش از نمایش معکوس می‌شوند، و پاسخ‌های model_remains ورودی مدل چت را همراه با یک برچسب طرحِ دارای تگ مدل ترجیح می‌دهند.
خط‌های توکن/کش در /status می‌توانند وقتی نمای لحظه‌ای نشست زنده کم‌جزئیات است، به آخرین ورودی مصرف رونوشت برگردند. مقدارهای زنده غیرصفر موجود همچنان اولویت دارند، و جایگزینی از رونوشت می‌تواند برچسب مدل runtime فعال را نیز همراه با یک مجموع بزرگ‌ترِ متمرکز بر پرامپت، وقتی مجموع‌های ذخیره‌شده وجود ندارند یا کوچک‌ترند، بازیابی کند.
اجرا در برابر runtime: /status مقدار Execution را برای مسیر sandbox مؤثر و مقدار Runtime را برای چیزی که واقعا نشست را اجرا می‌کند گزارش می‌کند: OpenClaw Pi Default، OpenAI Codex، یک پشتیبان CLI، یا یک پشتیبان ACP.
توکن/هزینه به‌ازای هر پاسخ با /usage off|tokens|full کنترل می‌شود (به پاسخ‌های عادی افزوده می‌شود).
/model status درباره مدل‌ها/احراز هویت/نقاط پایانی است، نه مصرف.

انتخاب مدل (`/model`)

/model به‌صورت یک دستورالعمل پیاده‌سازی شده است.

مثال‌ها:

Code

/model/model list/model 3/model openai/gpt-5.4/model opus@anthropic:default/model status

نکته‌ها:

/model و /model list یک انتخاب‌گر فشرده و شماره‌گذاری‌شده را نمایش می‌دهند (خانواده مدل + ارائه‌دهنده‌های موجود).
در Discord، /model و /models یک انتخاب‌گر تعاملی با فهرست‌های کشویی ارائه‌دهنده و مدل، به‌همراه یک مرحله ارسال باز می‌کنند. این انتخاب‌گر agents.defaults.models را، شامل ورودی‌های provider/*، رعایت می‌کند، بنابراین کشف محدود به ارائه‌دهنده می‌تواند انتخاب‌گر را زیر محدودیت ۲۵ گزینه‌ای مؤلفه‌های Discord نگه دارد.
/model <#> از همان انتخاب‌گر انتخاب می‌کند (و در صورت امکان ارائه‌دهنده فعلی را ترجیح می‌دهد).
/model status نمای جزئیات را نشان می‌دهد، از جمله نقطه پایانی پیکربندی‌شده ارائه‌دهنده (baseUrl) و حالت API (api) وقتی موجود باشند.

بازنویسی‌های اشکال‌زدایی

/debug به شما اجازه می‌دهد بازنویسی‌های پیکربندی فقط در runtime را تنظیم کنید (در حافظه، نه روی دیسک). فقط مالک. به‌صورت پیش‌فرض غیرفعال است؛ با commands.debug: true فعال کنید.

مثال‌ها:

Code

/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset

خروجی رهگیری Plugin

/trace به شما اجازه می‌دهد خط‌های رهگیری/اشکال‌زدایی Plugin در محدوده نشست را بدون روشن کردن حالت کاملا پرجزئیات تغییر وضعیت دهید.

مثال‌ها:

text

/trace/trace on/trace off

نکته‌ها:

/trace بدون آرگومان وضعیت رهگیری نشست فعلی را نشان می‌دهد.
/trace on خط‌های رهگیری Plugin را برای نشست فعلی فعال می‌کند.
/trace off آن‌ها را دوباره غیرفعال می‌کند.
خط‌های رهگیری Plugin می‌توانند در /status و به‌صورت یک پیام تشخیصیِ پیگیری پس از پاسخ عادی دستیار ظاهر شوند.
/trace جایگزین /debug نیست؛ /debug همچنان بازنویسی‌های پیکربندی فقط در runtime را مدیریت می‌کند.
/trace جایگزین /verbose نیست؛ خروجی عادی و پرجزئیات ابزار/وضعیت همچنان متعلق به /verbose است.

به‌روزرسانی‌های پیکربندی

/config در پیکربندی روی دیسک شما (openclaw.json) می‌نویسد. فقط مالک. به‌صورت پیش‌فرض غیرفعال است؛ با commands.config: true فعال کنید.

مثال‌ها:

Code

/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 فعال کنید.

مثال‌ها:

text

/mcp show/mcp show context7/mcp set context7={"command":"uvx","args":["context7-mcp"]}/mcp unset context7

به‌روزرسانی‌های Plugin

/plugins به اپراتورها اجازه می‌دهد Pluginهای کشف‌شده را بررسی کنند و فعال‌بودن آن‌ها را در پیکربندی تغییر دهند. جریان‌های فقط‌خواندنی می‌توانند از /plugin به‌عنوان نام مستعار استفاده کنند. به‌صورت پیش‌فرض غیرفعال است؛ با commands.plugins: true فعال کنید.

مثال‌ها:

text

/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7

Note

/plugins list و /plugins show از کشف واقعی Plugin در برابر فضای کاری فعلی به‌همراه پیکربندی روی دیسک استفاده می‌کنند.
/plugins install از ClawHub، npm، git، دایرکتوری‌های محلی و آرشیوها نصب می‌کند.
/plugins enable|disable فقط پیکربندی Plugin را به‌روزرسانی می‌کند؛ Pluginها را نصب یا حذف نمی‌کند.
تغییرات فعال‌سازی و غیرفعال‌سازی سطح‌های runtime Plugin در Gateway را برای نوبت‌های جدید عامل، با بارگذاری مجدد داغ به‌روزرسانی می‌کنند؛ درخواست نصب به راه‌اندازی دوباره Gateway نیاز دارد، چون ماژول‌های منبع Plugin تغییر کرده‌اند.

نکته‌های سطح

نشست‌ها به‌ازای هر سطح

دستورهای متنی در نشست چت عادی اجرا می‌شوند (پیام‌های مستقیم main را به‌اشتراک می‌گذارند، گروه‌ها نشست خودشان را دارند).
دستورهای بومی از نشست‌های ایزوله استفاده می‌کنند:
- Discord: agent:<agentId>:discord:slash:<userId>
- Slack: agent:<agentId>:slack:slash:<userId> (پیشوند از طریق channels.slack.slashCommand.sessionPrefix قابل پیکربندی است)
- Telegram: telegram:slash:<userId> (از طریق CommandTargetSessionKey نشست چت را هدف می‌گیرد)
/stop نشست چت فعال را هدف می‌گیرد تا بتواند اجرای فعلی را متوقف کند.

جزئیات مخصوص Slack

channels.slack.slashCommand همچنان برای یک دستور تکی به سبک /openclaw پشتیبانی می‌شود. اگر commands.native را فعال کنید، باید برای هر دستور داخلی یک دستور اسلش Slack بسازید (با همان نام‌های /help). منوهای آرگومان دستور برای Slack به‌صورت دکمه‌های موقت Block Kit تحویل داده می‌شوند.

استثنای بومی Slack: /agentstatus را ثبت کنید (نه /status)، چون Slack مقدار /status را رزرو کرده است. متن /status همچنان در پیام‌های Slack کار می‌کند.

پرسش‌های جانبی BTW

/btw یک پرسش جانبی سریع درباره نشست فعلی است. /side یک نام مستعار است.

برخلاف چت عادی:

از نشست فعلی به‌عنوان زمینه پس‌زمینه استفاده می‌کند،
در نشست‌های harness مربوط به Codex، به‌صورت یک رشته جانبی موقت Codex با مجوزهای فعلی Codex و سطح ابزار بومی اجرا می‌شود،
در نشست‌های غیر Codex، رفتار قدیمی‌ترِ فراخوانی جانبی مستقیم و یک‌باره را حفظ می‌کند،
زمینه نشست‌های آینده را تغییر نمی‌دهد،
در تاریخچه رونوشت نوشته نمی‌شود،
به‌جای یک پیام عادی دستیار، به‌صورت یک نتیجه جانبی زنده تحویل داده می‌شود.

این باعث می‌شود /btw زمانی مفید باشد که هنگام ادامه یافتن کار اصلی، یک شفاف‌سازی موقت می‌خواهید.

مثال:

text

/btw what are we doing right now?/side what changed while the main run continued?

برای رفتار کامل و جزئیات تجربه کاربری کلاینت، پرسش‌های جانبی BTW را ببینید.

مرتبط

Was this useful?

پیکربندی

فهرست دستورات

دستورات داخلی هسته

فرمان‌های dock تولیدشده

فرمان‌های Plugin همراه

فرمان‌های skill پویا

/tools

سطوح استفاده (چه چیزی کجا نشان داده می‌شود)

انتخاب مدل (/model)

بازنویسی‌های اشکال‌زدایی

خروجی رهگیری Plugin

به‌روزرسانی‌های پیکربندی

به‌روزرسانی‌های MCP

به‌روزرسانی‌های Plugin

نکته‌های سطح

پرسش‌های جانبی BTW

مرتبط

`/tools`

انتخاب مدل (`/model`)