OpenClawDocs
في هذه الصفحة

في هذه الصفحة

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Setup guides and reference

أتمتة CLI

استخدم openclaw onboard --non-interactive لبرمجة الإعداد نصيًا. يتطلب هذا الخيار --accept-risk: إذ يمكن للإعداد غير التفاعلي كتابة بيانات الاعتماد وتهيئة البرنامج الخفي من دون مطالبة بالتأكيد، ولذلك تمثل هذه العلامة إقرارًا صريحًا بالمخاطر.

مثال أساسي للإعداد غير التفاعلي

bash
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 غير التفاعلي، يجب أن يكون متغير بيئة المزوّد معيّنًا مسبقًا في بيئة العملية؛ إذ يفشل تمرير علامة مفتاح مضمّن دون متغير البيئة المطابق له فورًا.
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice openai-api-key \  --secret-input-mode ref

أمثلة خاصة بالمزوّدين

مثال على مفتاح Anthropic API
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY" \  --gateway-bind loopback
مثال على Cloudflare AI Gateway
bash
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
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice gemini-api-key \  --gemini-api-key "$GEMINI_API_KEY" \  --gateway-bind loopback
مثال على Mistral
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY" \  --gateway-bind loopback
مثال على Moonshot
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice moonshot-api-key \  --moonshot-api-key "$MOONSHOT_API_KEY" \  --gateway-bind loopback
مثال على Ollama
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice ollama \  --custom-model-id "qwen3.5:27b" \  --gateway-bind loopback
مثال على OpenCode
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice opencode-zen \  --opencode-zen-api-key "$OPENCODE_API_KEY" \  --gateway-bind loopback

استبدله بـ --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" لاستخدام كتالوج Go.

مثال على Synthetic
bash
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
bash
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
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice zai-api-key \  --zai-api-key "$ZAI_API_KEY" \  --gateway-bind loopback
مثال على مزوّد مخصص
bash
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" }:

bash
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 مدعومة، لكن OpenClaw يفضّل إعادة استخدام Claude CLI عند توفر تسجيل دخول محلي إلى Claude CLI. للاستخدام الإنتاجي، يُفضّل استخدام مفتاح Anthropic API.

إضافة وكيل آخر

ينشئ openclaw agents add <name> وكيلًا منفصلًا له مساحة عمل وجلسات وملفات تعريف مصادقة خاصة به. يؤدي تشغيله دون --workspace (ومن دون أي علامات أخرى) إلى بدء المعالج التفاعلي؛ أما تمرير أي من --workspace أو --model أو --agent-dir أو --bind أو --non-interactive فيشغّله بصورة غير تفاعلية، وعندئذ يصبح --workspace مطلوبًا.

bash
openclaw agents add work \  --workspace ~/.openclaw/workspace-work \  --model openai/gpt-5.6-sol \  --bind whatsapp:biz \  --non-interactive \  --json

مفاتيح التهيئة التي يكتبها (إدخال agents.list[] لمعرّف الوكيل الجديد):

  • name
  • workspace
  • agentDir
  • model (فقط عند تمرير --model)

ملاحظات:

  • مساحة العمل الافتراضية (عند حذف --workspace في المعالج التفاعلي): ~/.openclaw/workspace-<agentId>.
  • يمكن تكرار --bind <channel[:accountId]>؛ أضف ارتباطات لتوجيه الرسائل الواردة إلى الوكيل الجديد (ويمكن للمعالج أيضًا تنفيذ ذلك تفاعليًا).
  • يُطبّع اسم الوكيل إلى معرّف وكيل صالح؛ والاسم main محجوز.

مستندات ذات صلة

Was this useful?