CLI commands

TUI

openclaw tui

رابط کاربری ترمینالِ متصل به Gateway را باز کنید، یا آن را در حالت تعبیه‌شده محلی اجرا کنید.

مرتبط:

  • راهنمای TUI: TUI

گزینه‌ها

پرچم پیش‌فرض توضیح
--local false به‌جای Gateway، روی زمان اجرای عاملِ تعبیه‌شده محلی اجرا شود.
--url <url> gateway.remote.url از پیکربندی نشانی WebSocket مربوط به Gateway.
--token <token> (هیچ‌کدام) توکن Gateway در صورت نیاز.
--password <pass> (هیچ‌کدام) گذرواژه Gateway در صورت نیاز.
--session <key> main (یا global وقتی دامنه global است) کلید نشست. داخل فضای کاری یک عامل، مگر با پیشوند مشخص شود، همان عامل را به‌طور خودکار انتخاب می‌کند.
--deliver false پاسخ‌های دستیار را از طریق کانال‌های پیکربندی‌شده تحویل دهد.
--thinking <level> (پیش‌فرض مدل) تنظیم جایگزین سطح تفکر.
--message <text> (هیچ‌کدام) پس از اتصال، یک پیام اولیه ارسال کند.
--timeout-ms <ms> agents.defaults.timeoutSeconds مهلت زمانی عامل. مقدارهای نامعتبر یک هشدار ثبت می‌کنند و نادیده گرفته می‌شوند.
--history-limit <n> 200 تعداد ورودی‌های تاریخچه برای بارگذاری هنگام اتصال.

نام‌های مستعار: openclaw chat و openclaw terminal همان فرمان را با --local ضمنی فراخوانی می‌کنند.

نکته‌ها:

  • chat و terminal نام‌های مستعار openclaw tui --local هستند.
  • --local را نمی‌توان با --url، --token یا --password ترکیب کرد.
  • tui در صورت امکان، SecretRefs احراز هویت Gateway پیکربندی‌شده را برای احراز هویت با توکن/گذرواژه حل می‌کند (ارائه‌دهنده‌های env/file/exec).
  • وقتی از داخل دایرکتوری فضای کاری یک عامل پیکربندی‌شده اجرا شود، TUI آن عامل را به‌طور خودکار به‌عنوان پیش‌فرض کلید نشست انتخاب می‌کند (مگر اینکه --session صراحتاً agent:<id>:... باشد).
  • برای نمایش نام میزبان Gateway در پانوشت برای اتصال‌های غیرمحلیِ مبتنی بر URL، openclaw config set tui.footer.showRemoteHost true را اجرا کنید. برچسب میزبان به‌طور پیش‌فرض خاموش است و هرگز برای اتصال‌های loopback یا اتصال‌های محلی تعبیه‌شده ظاهر نمی‌شود.
  • حالت محلی مستقیماً از زمان اجرای عاملِ تعبیه‌شده استفاده می‌کند. بیشتر ابزارهای محلی کار می‌کنند، اما قابلیت‌های فقط-Gateway در دسترس نیستند.
  • حالت محلی /auth [provider] را داخل سطح فرمان TUI اضافه می‌کند.
  • دروازه‌های تأیید Plugin همچنان در حالت محلی اعمال می‌شوند. ابزارهایی که به تأیید نیاز دارند، تصمیم را در ترمینال درخواست می‌کنند؛ صرفاً به این دلیل که Gateway دخیل نیست، هیچ‌چیز بی‌صدا به‌طور خودکار تأیید نمی‌شود.
  • اهداف نشست در پانوشت ظاهر می‌شوند و می‌توان آن‌ها را با /goal مدیریت کرد.

نمونه‌ها

bash
openclaw chatopenclaw tui --localopenclaw tuiopenclaw tui --url ws://127.0.0.1:18789 --token <token>openclaw tui --session main --deliveropenclaw chat --message "Compare my config to the docs and tell me what to fix"# when run inside an agent workspace, infers that agent automaticallyopenclaw tui --session bugfix

چرخه تعمیر پیکربندی

وقتی پیکربندی فعلی از قبل اعتبارسنجی می‌شود و می‌خواهید عامل تعبیه‌شده آن را بررسی کند، با مستندات مقایسه کند، و از همان ترمینال به تعمیر آن کمک کند، از حالت محلی استفاده کنید:

اگر openclaw config validate از قبل شکست می‌خورد، ابتدا از openclaw configure یا openclaw doctor --fix استفاده کنید. openclaw chat محافظ پیکربندی نامعتبر را دور نمی‌زند.

bash
openclaw chat

سپس داخل TUI:

text
!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctor

اصلاحات هدفمند را با openclaw config set یا openclaw configure اعمال کنید، سپس openclaw config validate را دوباره اجرا کنید. TUI و پیکربندی را ببینید.

مرتبط

Was this useful?
On this page

On this page