CLI commands
TUI
openclaw tui
رابط کاربری ترمینالِ متصل به Gateway را باز کنید، یا آن را در حالت محلیِ تعبیهشده اجرا کنید.
راهنمای مرتبط: TUI
گزینهها
| پرچم | پیشفرض | توضیحات |
|---|---|---|
--local |
false |
بهجای Gateway، با محیط اجرای محلیِ تعبیهشدهٔ عامل اجرا شود. |
--url <url> |
gateway.remote.url از پیکربندی |
نشانی WebSocket مربوط به Gateway. |
--token <token> |
(هیچکدام) | توکن Gateway، در صورت نیاز. |
--password <pass> |
(هیچکدام) | گذرواژهٔ Gateway، در صورت نیاز. |
--tls-fingerprint <sha256> |
gateway.remote.tlsFingerprint |
اثر انگشت مورد انتظار گواهی TLS برای یک Gateway سنجاقشده با wss://. |
--session <key> |
main (یا global وقتی دامنه سراسری است) |
کلید نشست. در فضای کاری یک عامل، مگر اینکه پیشوندی تعیین شود، همان عامل بهطور خودکار انتخاب میشود. |
--deliver |
false |
پاسخهای دستیار از طریق کانالهای پیکربندیشده تحویل داده شوند. |
--thinking <level> |
(پیشفرض مدل) | بازنویسی سطح تفکر. |
--message <text> |
(هیچکدام) | پس از اتصال، یک پیام آغازین ارسال شود. |
--timeout-ms <ms> |
agents.defaults.timeoutSeconds |
مهلت زمانی عامل. مقادیر نامعتبر یک هشدار ثبت میکنند و نادیده گرفته میشوند. |
--history-limit <n> |
200 |
تعداد ورودیهای تاریخچه که هنگام اتصال بارگیری میشوند. |
نامهای مستعار openclaw chat و openclaw terminal این فرمان را با فرض ضمنیِ --local فراخوانی میکنند.
نکات
--localرا نمیتوان با--url،--token،--passwordیا--tls-fingerprintترکیب کرد.tuiدر صورت امکان، SecretRefهای پیکربندیشدهٔ احراز هویت Gateway را برای احراز هویت با توکن/گذرواژه برطرف میکند (ارائهدهندگانenv/file/exec).- وقتی هیچ نشانی یا درگاه صریحی مشخص نشده باشد،
tuiاز درگاه فعال محلی Gateway که توسط Gateway در حال اجرا ثبت شده است پیروی میکند.--urlصریح،OPENCLAW_GATEWAY_URL،OPENCLAW_GATEWAY_PORTو پیکربندی Gateway راهدور همچنان اولویت دارند. - وقتی TUI از داخل دایرکتوری فضای کاری پیکربندیشدهٔ یک عامل اجرا شود، آن عامل را بهطور خودکار برای مقدار پیشفرض کلید نشست انتخاب میکند (مگر اینکه
--sessionبهطور صریح بهشکلagent:<id>:...باشد). - برای نمایش نام میزبان Gateway در پاورقیِ اتصالهای غیرمحلیِ مبتنی بر URL، فرمان
openclaw config set tui.footer.showRemoteHost trueرا اجرا کنید. این گزینه بهطور پیشفرض خاموش است و هرگز برای اتصالهای local loopback یا محلیِ تعبیهشده نمایش داده نمیشود. - حالت محلی مستقیماً از محیط اجرای تعبیهشدهٔ عامل استفاده میکند. بیشتر ابزارهای محلی کار میکنند، اما قابلیتهای مختص Gateway در دسترس نیستند.
- حالت محلی
/auth [provider]را به مجموعه فرمانهای TUI اضافه میکند. - دروازههای تأیید Plugin همچنان در حالت محلی اعمال میشوند: ابزارهایی که به تأیید نیاز دارند، تصمیم را در ترمینال درخواست میکنند و هیچچیز بهصورت بیصدا و خودکار تأیید نمیشود.
- اهداف نشست در پاورقی ظاهر میشوند و با
/goalقابل مدیریت هستند.
نمونهها
openclaw chatopenclaw tui --localopenclaw tuiopenclaw tui --url ws://127.0.0.1:18789 --token <token>openclaw tui --session main --deliveropenclaw chat --message "پیکربندی من را با مستندات مقایسه کن و بگو چه چیزهایی را باید اصلاح کنم"# هنگام اجرا در فضای کاری یک عامل، آن عامل را بهطور خودکار تشخیص میدهدopenclaw tui --session bugfixچرخهٔ ترمیم پیکربندی
از حالت محلی استفاده کنید تا عامل تعبیهشده پیکربندی فعلی را بررسی کند، آن را با مستندات مقایسه کند و از همان ترمینال به ترمیم آن کمک کند.
اگر openclaw config validate از قبل با شکست مواجه میشود، ابتدا openclaw configure یا openclaw doctor --fix را اجرا کنید؛ openclaw chat محافظ پیکربندی نامعتبر را دور نمیزند.
openclaw chatسپس درون TUI:
!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?
