در این صفحه

در این صفحه

CLI commands

تکمیل

openclaw completion

اسکریپت‌های تکمیل پوسته را تولید کنید، آن‌ها را در وضعیت OpenClaw کش کنید و در صورت تمایل در پروفایل پوستهٔ خود نصب کنید.

نحوهٔ استفاده

bash
openclaw completion                          # اسکریپت zsh را در خروجی استاندارد چاپ می‌کندopenclaw completion --shell fish             # اسکریپت fish را چاپ می‌کندopenclaw completion --write-state            # اسکریپت‌های همهٔ پوسته‌ها را کش می‌کندopenclaw completion --write-state --install  # کش و سپس در یک مرحله نصب می‌کندopenclaw completion --shell bash --write-state

گزینه‌ها

  • -s, --shell <shell>: پوستهٔ مقصد (zsh، bash، powershell، fish؛ پیش‌فرض: zsh)
  • -i, --install: تکمیل را با افزودن یک خط source برای اسکریپت کش‌شده به پروفایل پوستهٔ خود نصب کنید
  • --write-state: اسکریپت(های) تکمیل را بدون چاپ در خروجی استاندارد در $OPENCLAW_STATE_DIR/completions (پیش‌فرض ~/.openclaw/completions) بنویسید؛ همراه با --shell فقط برای همان پوسته می‌نویسد، در غیر این صورت برای هر چهار پوسته
  • -y, --yes: از اعلان‌های تأیید نصب صرف‌نظر کنید (غیرتعاملی)

روند نصب

--install پروفایل شما را به اسکریپت کش‌شده ارجاع می‌دهد، بنابراین کش باید ابتدا وجود داشته باشد: اگر موجود نباشد، فرمان ناموفق می‌شود و از شما می‌خواهد openclaw completion --write-state را اجرا کنید. برای انجام هر دو کار در یک مرحله، آن را با --write-state --install ترکیب کنید. بدون --shell، ‏--install پوسته را از $SHELL تشخیص می‌دهد (و در صورت ناموفق‌بودن، از zsh استفاده می‌کند).

نصب، یک بلوک کوچک # OpenClaw Completion را در پروفایل پوستهٔ شما می‌نویسد و هر خط قدیمی و کند source <(openclaw completion ...) را با خط source کش‌شده جایگزین می‌کند:

پوسته پروفایل
bash ~/.bashrc (وقتی ~/.bashrc موجود نیست، از ~/.bash_profile استفاده می‌کند)
fish ~/.config/fish/config.fish
powershell ~/.config/powershell/Microsoft.PowerShell_profile.ps1 (در Windows: ‏Documents/PowerShell/Microsoft.PowerShell_profile.ps1، یا Documents/WindowsPowerShell/... برای Windows PowerShell)
zsh ~/.zshrc

نکات

  • بدون --install یا --write-state، فرمان اسکریپت را در خروجی استاندارد چاپ می‌کند.
  • تولید تکمیل، کل درخت فرمان را از پیش بارگیری می‌کند، از جمله فرمان‌های CLI مربوط به Plugin، بنابراین زیرفرمان‌های تودرتو نیز گنجانده می‌شوند.
  • openclaw update پس از به‌روزرسانی موفق، کش تکمیل را به‌طور خودکار تازه‌سازی می‌کند؛ openclaw doctor می‌تواند تنظیمات تکمیل مفقود یا منسوخ را ترمیم کند.

مرتبط

Was this useful?