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 آنتروپیک
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 اختیاری است و در صورت حذف، بهطور خودکار از نشانی پایه استخراج میشود. مقدار پیشفرض --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 آنتروپیک را ترجیح دهید.
افزودن عامل دیگر
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.list[] برای شناسه عامل جدید):
nameworkspaceagentDirmodel(فقط هنگامی که--modelوارد شده باشد)
نکتهها:
- فضای کاری پیشفرض (هنگامی که
--workspaceدر راهنمای تعاملی حذف شده باشد):~/.openclaw/workspace-<agentId>. --bind <channel[:accountId]>قابل تکرار است؛ برای هدایت پیامهای ورودی به عامل جدید، اتصالها را اضافه کنید (این کار در راهنما نیز بهصورت تعاملی قابل انجام است).- نام عامل به یک شناسه عامل معتبر نرمالسازی میشود؛
mainرزروشده است.
مستندات مرتبط
- مرکز راهاندازی: راهاندازی (CLI)
- مرجع کامل: مرجع راهاندازی CLI
- مرجع فرمان:
openclaw onboard
