Guides
خودکارسازی CLI
برای اسکریپتنویسی راهاندازی از openclaw onboard --non-interactive استفاده کنید. این گزینه به --accept-risk نیاز دارد: راهاندازی غیرتعاملی میتواند اعتبارنامهها و پیکربندی دیمون را بدون درخواست تأیید بنویسد؛ بنابراین این پرچم بهمنزله پذیرش صریح ریسک است.
نمونه پایه غیرتعاملی
openclaw onboard --non-interactive --accept-risk \ --mode local \ --auth-choice apiKey \ --anthropic-api-key "$ANTHROPIC_API_KEY" \ --secret-input-mode plaintext \ --gateway-bind loopback \ --install-daemon \ --daemon-runtime node \ --skip-bootstrap \ --skip-skillsبرای دریافت خلاصهای قابلخواندن توسط ماشین، --json را اضافه کنید.
--gateway-portبهطور پیشفرض18789است؛ فقط برای بازنویسی آن، این گزینه را وارد کنید.--skip-bootstrapاز ایجاد فایلهای پیشفرض فضای کاری جلوگیری میکند و برای خودکارسازیهایی است که فضای کاری خود را از پیش آماده میکنند.--secret-input-mode refبهجای کلید متن ساده، یک ارجاع مبتنی بر متغیر محیطی ({ source: "env", provider: "default", id: "<ENV_VAR>" }) را در نمایه احراز هویت ذخیره میکند. در حالت غیرتعاملیref، متغیر محیطی ارائهدهنده باید از قبل در محیط فرایند تنظیم شده باشد: واردکردن پرچم کلید درونخطی بدون متغیر محیطی متناظر، بلافاصله با خطا متوقف میشود.
openclaw onboard --non-interactive --accept-risk \ --mode local \ --auth-choice openai-api-key \ --secret-input-mode refنمونههای ویژه ارائهدهندگان
نمونه کلید API Anthropic
openclaw onboard --non-interactive --accept-risk \ --mode local \ --auth-choice apiKey \ --anthropic-api-key "$ANTHROPIC_API_KEY" \ --gateway-bind loopbackنمونه Cloudflare AI Gateway
openclaw onboard --non-interactive --accept-risk \ --mode local \ --auth-choice cloudflare-ai-gateway-api-key \ --cloudflare-ai-gateway-account-id "your-account-id" \ --cloudflare-ai-gateway-gateway-id "your-gateway-id" \ --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY" \ --gateway-bind loopbackنمونه Gemini
openclaw onboard --non-interactive --accept-risk \ --mode local \ --auth-choice gemini-api-key \ --gemini-api-key "$GEMINI_API_KEY" \ --gateway-bind loopbackنمونه Mistral
openclaw onboard --non-interactive --accept-risk \ --mode local \ --auth-choice mistral-api-key \ --mistral-api-key "$MISTRAL_API_KEY" \ --gateway-bind loopbackنمونه Moonshot
openclaw onboard --non-interactive --accept-risk \ --mode local \ --auth-choice moonshot-api-key \ --moonshot-api-key "$MOONSHOT_API_KEY" \ --gateway-bind loopbackنمونه Ollama
openclaw onboard --non-interactive --accept-risk \ --mode local \ --auth-choice ollama \ --custom-model-id "qwen3.5:27b" \ --gateway-bind loopbackنمونه OpenCode
openclaw onboard --non-interactive --accept-risk \ --mode local \ --auth-choice opencode-zen \ --opencode-zen-api-key "$OPENCODE_API_KEY" \ --gateway-bind loopbackبرای کاتالوگ Go، آن را با --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" جایگزین کنید.
نمونه Synthetic
openclaw onboard --non-interactive --accept-risk \ --mode local \ --auth-choice synthetic-api-key \ --synthetic-api-key "$SYNTHETIC_API_KEY" \ --gateway-bind loopbackنمونه Vercel AI Gateway
openclaw onboard --non-interactive --accept-risk \ --mode local \ --auth-choice ai-gateway-api-key \ --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \ --gateway-bind loopbackنمونه Z.AI
openclaw onboard --non-interactive --accept-risk \ --mode local \ --auth-choice zai-api-key \ --zai-api-key "$ZAI_API_KEY" \ --gateway-bind loopbackنمونه ارائهدهنده سفارشی
openclaw onboard --non-interactive --accept-risk \ --mode local \ --auth-choice custom-api-key \ --custom-base-url "https://llm.example.com/v1" \ --custom-model-id "foo-large" \ --custom-api-key "$CUSTOM_API_KEY" \ --custom-provider-id "my-custom" \ --custom-compatibility anthropic \ --custom-image-input \ --gateway-bind loopback--custom-api-key اختیاری است؛ برخی نقاط پایانی به احراز هویت نیاز ندارند. اگر حذف شود، فرایند راهاندازی CUSTOM_API_KEY را در متغیرهای محیطی بررسی میکند. --custom-provider-id اختیاری است و در صورت حذف، بهطور خودکار از URL پایه استخراج میشود. مقدار پیشفرض --custom-compatibility برابر با openai است (مقادیر دیگر: openai-responses، anthropic).
OpenClaw پشتیبانی از ورودی تصویر را از الگوهای شناختهشده شناسه مدلهای بینایی استنباط میکند (پسوندهای gpt-4o، claude-3/4، gemini، -vl/vision و موارد مشابه). برای فعالسازی اجباری آن برای یک مدل بینایی ناشناخته، --custom-image-input را اضافه کنید؛ یا برای اجبار به حالت فقطمتنی، --custom-text-input را اضافه کنید.
گونه حالت ارجاع، با ذخیره apiKey بهصورت { source: "env", provider: "default", id: "CUSTOM_API_KEY" }:
export CUSTOM_API_KEY="your-key"openclaw onboard --non-interactive --accept-risk \ --mode local \ --auth-choice custom-api-key \ --custom-base-url "https://llm.example.com/v1" \ --custom-model-id "foo-large" \ --secret-input-mode ref \ --custom-provider-id "my-custom" \ --custom-compatibility anthropic \ --custom-image-input \ --gateway-bind loopbackاحراز هویت با توکن راهاندازی Anthropic همچنان پشتیبانی میشود، اما وقتی ورود محلی Claude CLI موجود باشد، OpenClaw استفاده مجدد از Claude CLI را ترجیح میدهد. برای محیط عملیاتی، کلید API Anthropic را ترجیح دهید.
افزودن عامل دیگر
openclaw agents add <name> عاملی جداگانه با فضای کاری، نشستها و نمایههای احراز هویت مخصوص خود ایجاد میکند. اجرای آن بدون --workspace (و بدون هیچ پرچم دیگری) ویزارد تعاملی را راهاندازی میکند؛ واردکردن هر یک از --workspace، --model، --agent-dir، --bind یا --non-interactive آن را بهصورت غیرتعاملی اجرا میکند و سپس به --workspace نیاز دارد.
openclaw agents add work \ --workspace ~/.openclaw/workspace-work \ --model openai/gpt-5.6-sol \ --bind whatsapp:biz \ --non-interactive \ --jsonکلیدهای پیکربندی که مینویسد (ورودی agents.entries.* برای شناسه عامل جدید):
nameworkspaceagentDirmodel(فقط هنگام واردکردن--model)
نکتهها:
- فضای کاری پیشفرض (وقتی
--workspaceدر ویزارد تعاملی حذف شده باشد):~/.openclaw/workspace-<agentId>. --bind <channel[:accountId]>تکرارپذیر است؛ برای هدایت پیامهای ورودی به عامل جدید، اتصالها را اضافه کنید (ویزارد نیز میتواند این کار را بهصورت تعاملی انجام دهد).- نام عامل به یک شناسه معتبر عامل عادیسازی میشود؛
mainرزروشده است.
مستندات مرتبط
- مرکز راهاندازی: راهاندازی (CLI)
- مرجع کامل: مرجع راهاندازی CLI
- مرجع فرمان:
openclaw onboard
