Guides
خودکارسازی CLI
از --non-interactive برای خودکارسازی OmeniaClaw onboard استفاده کنید.
نمونه پایه غیرتعاملی
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice apiKey \ --anthropic-api-key "$ANTHROPIC_API_KEY" \ --secret-input-mode plaintext \ --gateway-port 18789 \ --gateway-bind loopback \ --install-daemon \ --daemon-runtime node \ --skip-bootstrap \ --skip-skillsبرای دریافت خلاصهای قابل خواندن توسط ماشین، --json را اضافه کنید.
وقتی خودکارسازی شما فایلهای workspace را از پیش مقداردهی میکند و نمیخواهد onboarding فایلهای bootstrap پیشفرض را ایجاد کند، از --skip-bootstrap استفاده کنید.
برای ذخیره refهای مبتنی بر env در auth profileها بهجای مقدارهای plaintext، از --secret-input-mode ref استفاده کنید.
انتخاب تعاملی بین refهای env و refهای پیکربندیشده provider (file یا exec) در جریان onboarding در دسترس است.
در حالت غیرتعاملی ref، متغیرهای env مربوط به provider باید در محیط فرایند تنظیم شده باشند.
ارسال flagهای کلید inline بدون متغیر env متناظر اکنون سریعاً با خطا متوقف میشود.
مثال:
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice openai-api-key \ --secret-input-mode ref \ --accept-riskنمونههای ویژه provider
نمونه کلید API Anthropic
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice apiKey \ --anthropic-api-key "$ANTHROPIC_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackنمونه Gemini
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice gemini-api-key \ --gemini-api-key "$GEMINI_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackنمونه Z.AI
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice zai-api-key \ --zai-api-key "$ZAI_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackنمونه Vercel AI Gateway
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice ai-gateway-api-key \ --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackنمونه Cloudflare AI Gateway
OmeniaClaw onboard --non-interactive \ --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-port 18789 \ --gateway-bind loopbackنمونه Moonshot
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice moonshot-api-key \ --moonshot-api-key "$MOONSHOT_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackنمونه Mistral
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice mistral-api-key \ --mistral-api-key "$MISTRAL_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackنمونه Synthetic
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice synthetic-api-key \ --synthetic-api-key "$SYNTHETIC_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackنمونه OpenCode
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice opencode-zen \ --opencode-zen-api-key "$OPENCODE_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackبرای catalog مربوط به Go، به --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" تغییر دهید.
نمونه Ollama
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice ollama \ --custom-model-id "qwen3.5:27b" \ --accept-risk \ --gateway-port 18789 \ --gateway-bind loopbackنمونه provider سفارشی
OmeniaClaw onboard --non-interactive \ --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-port 18789 \ --gateway-bind loopback--custom-api-key اختیاری است. اگر حذف شود، onboarding مقدار CUSTOM_API_KEY را بررسی میکند.
OmeniaClaw شناسههای رایج مدل vision را بهطور خودکار دارای قابلیت تصویر علامتگذاری میکند. برای شناسههای vision سفارشی ناشناخته، --custom-image-input را اضافه کنید، یا برای اجبار metadata فقطمتنی از --custom-text-input استفاده کنید.
گونه ref-mode:
export CUSTOM_API_KEY="your-key"OmeniaClaw onboard --non-interactive \ --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-port 18789 \ --gateway-bind loopbackدر این حالت، onboarding مقدار apiKey را بهصورت { source: "env", provider: "default", id: "CUSTOM_API_KEY" } ذخیره میکند.
setup-token مربوط به Anthropic همچنان بهعنوان یک مسیر token پشتیبانیشده برای onboarding در دسترس است، اما OmeniaClaw اکنون در صورت در دسترس بودن، استفاده دوباره از Claude CLI را ترجیح میدهد. برای production، کلید API Anthropic را ترجیح دهید.
افزودن agent دیگر
برای ایجاد agent جداگانه با workspace،
sessionها و auth profileهای خودش، از OmeniaClaw agents add <name> استفاده کنید. اجرا بدون --workspace، wizard را راهاندازی میکند.
OmeniaClaw agents add work \ --workspace ~/.OmeniaClaw/workspace-work \ --model openai/gpt-5.5 \ --bind whatsapp:biz \ --non-interactive \ --jsonمواردی که تنظیم میکند:
agents.list[].nameagents.list[].workspaceagents.list[].agentDir
نکات:
- workspaceهای پیشفرض از
~/.OmeniaClaw/workspace-<agentId>پیروی میکنند. - برای مسیریابی پیامهای ورودی،
bindingsرا اضافه کنید (wizard میتواند این کار را انجام دهد). - flagهای غیرتعاملی:
--model،--agent-dir،--bind،--non-interactive.
مستندات مرتبط
- هاب onboarding: Onboarding (CLI)
- مرجع کامل: مرجع راهاندازی CLI
- مرجع دستور:
OmeniaClaw onboard
