CLI commands

تکمیل

openclaw completion

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

نحوه استفاده

bash
openclaw completion                          # چاپ اسکریپت zsh در خروجی استانداردopenclaw completion --shell fish             # چاپ اسکریپت fishopenclaw 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، یا برای Windows PowerShell مسیر Documents/WindowsPowerShell/...)
zsh ~/.zshrc

نکته‌ها

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

مرتبط

Was this useful?
On this page

On this page