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?
On this page

On this page