تعديل إعدادات OpenClaw: دليل الإعداد الكامل (2026)
دليل كامل لتعديل إعدادات OpenClaw لكل من WhatsApp و Discord و Telegram و Ollama. انسخ والصق الأوامر لتهيئة القنوات والنماذج والمزودين. حلول لأخطاء الإعدادات الشائعة.
ملخص سريع
مرجع سريع لأوامر إعداد OpenClaw الأكثر شيوعاً:
# فتح محرر الإعدادات
openclaw config edit
# تعيين قيمة محددة
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
# عرض الإعدادات الحالية
openclaw config show
# التحقق من مشاكل الإعدادات وإصلاحها
openclaw doctor
openclaw doctor --fix
# إعادة التعيين للافتراضيات
openclaw config reset
ما هو OpenClaw؟
OpenClaw هو إطار عمل (framework) لمساعد ذكاء اصطناعي مفتوح المصدر يربط نماذج اللغة الكبيرة بقنوات المراسلة مثل WhatsApp و Discord و Telegram و Slack. وهو يدعم العديد من مزودي النماذج — OpenAI و Anthropic و Ollama (النماذج المحلية) و Google وغيرهم — ويمكن توسيعه بمهارات وإضافات مخصصة.
جوهر OpenClaw هو نظام الإعدادات الخاص به. كل شيء تقريباً — القنوات النشطة، النموذج المستخدم، المهارات المحملة — يتم التحكم فيه عبر ملفات الإعداد (config files). إتقان الأمر openclaw config edit هو المفتاح لتشغيل OpenClaw بالطريقة التي تريدها.
openclaw config edit: الأساسيات
فتح محرر الإعدادات
الأمر الأساسي لتهيئة OpenClaw هو:
openclaw config edit
سيقوم هذا بفتح ملف الإعدادات في محرر التيرمينال الافتراضي لديك (عادةً nano أو vim أو أي محرر تم تعيينه في $EDITOR). يوجد ملف الإعدادات عادةً في ~/.openclaw/config.yaml أو ~/.config/openclaw/config.yaml اعتماداً على طريقة التثبيت.
هيكل ملف الإعدادات
ملف إعدادات OpenClaw يأتي بتنسيق YAML ومنظم إلى أقسام:
# Model configuration
model:
provider: openai # openai, anthropic, ollama, google
name: gpt-4o # model identifier string
temperature: 0.7
max_tokens: 4096
# Channel configuration
channels:
whatsapp:
enabled: false
phone_number_id: ""
access_token: ""
discord:
enabled: false
bot_token: ""
telegram:
enabled: false
bot_token: ""
slack:
enabled: false
bot_token: ""
app_token: ""
# Skills and plugins
skills:
- web_search
- calculator
- weather
# Speech-to-text
stt:
provider: whisper
model: whisper-1
# System prompt
system_prompt: "You are a helpful assistant."
تعيين القيم الفردية
بدلاً من تعديل الملف بالكامل، يمكنك تعيين قيم إعداد فردية من سطر الأوامر:
openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5
هذا مفيد للأتمتة أو لإجراء تغييرات سريعة دون فتح المحرر.
إعداد القنوات
يتطلب تكامل WhatsApp حساب Meta Business والوصول إلى WhatsApp Business API.
# تفعيل قناة WhatsApp
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"
# تعيين رابط الـ webhook
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"
Discord
إعداد Discord أبسط — تحتاج فقط إلى bot token من Discord Developer Portal.
openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"
Telegram
يتطلب Telegram الحصول على bot token من @BotFather:
openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"
يدعم Telegram كلاً من وضعي polling و webhook. وضع polling أسهل للتطوير (لا يتطلب رابط URL عام):
openclaw config set channels.telegram.mode polling
للإنتاج (production)، استخدم وضع webhook:
openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"
Slack
تكامل Slack يستخدم Socket Mode (موصى به) أو Events API:
openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"
يُنصح باستخدام Socket Mode لأنه لا يتطلب رابط URL عام.
تهيئة مزودي النماذج
OpenAI
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
قم بتعيين API key الخاص بك كمتغير بيئة (لا تضعه في ملف الإعدادات):
export OPENAI_API_KEY="sk-..."
Anthropic (Claude)
openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
export ANTHROPIC_API_KEY="sk-ant-..."
Ollama (النماذج المحلية)
هنا يبرز دور OpenClaw للمستخدمين المهتمين بالخصوصية. يتيح لك Ollama تشغيل النماذج محلياً دون الحاجة إلى API keys أو خروج البيانات من جهازك.
# قم بتثبيت Ollama أولاً
# https://ollama.ai
# سحب نموذج
ollama pull llama3.3
# تهيئة OpenClaw لاستخدام Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"
ollama serve) وأن base URL مطابق. منفذ Ollama الافتراضي هو 11434.
Google (Gemini)
openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro
export GOOGLE_API_KEY="..."
xAI (Grok)
openclaw config set model.provider openai # يستخدم xAI واجهة برمجة تطبيقات متوافقة مع OpenAI
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"
export OPENAI_API_KEY="xai-..." # استخدم مفتاح xAI مع مزود OpenAI
أخطاء الإعدادات الشائعة وإصلاحها
خطأ: "Unknown config key"
Error: Unknown config key 'chanels.whatsapp.enabled'
هذا يعني عادةً وجود خطأ إملائي في مفتاح الإعداد. تأكد من التهجئة. الأخطاء الشائعة:
chanels←channelsprovidr←providertelgram←telegram
قم بتشغيل
openclaw config show لرؤية جميع المفاتيح الصالحة.
خطأ: "Channel auto-enabled without credentials"
تقوم بعض إصدارات OpenClaw بتفعيل القنوات تلقائياً عند تعيين بيانات الاعتماد، حتى لو لم تقم بتفعيلها صراحةً. قد يسبب هذا فشلاً في بدء التشغيل إذا كانت البيانات غير مكتملة.
الإصلاح:# قم بتعطيل القنوات التي لا تستخدمها صراحةً
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false
خطأ: "Model provider not configured"
Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY
يجب تعيين متغير البيئة المقابل. يتعمد OpenClaw عدم تخزين API keys في ملف الإعدادات لأسباب أمنية.
الإصلاح: أضف API key إلى ملف ملف تعريف الشل الخاص بك (~/.bashrc أو ~/.zshrc) أو استخدم ملف .env:
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc
استخدام openclaw doctor
يقوم الأمر openclaw doctor بفحص كامل إعداداتك والإبلاغ عن المشاكل:
openclaw doctor
مثال على المخرجات:
Checking configuration...
✓ Config file found
✓ Model provider configured
✗ WhatsApp: enabled but missing access_token
✗ Discord: bot token invalid format
✓ Telegram: configured correctly
✓ Ollama: connection successful
2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.
يحاول علم --fix حل المشكلات تلقائياً:
openclaw doctor --fix
سيقوم هذا بتعطيل القنوات التي تفتقد لبيانات الاعتماد، وتصحيح مشكلات التنسيق المعروفة، واقتراح إصلاحات يدوية للمشكلات التي لا يمكن حلها تلقائياً.
إعدادات متقدمة
المهارات المخصصة
يدعم OpenClaw المهارات المخصصة (الإضافات) التي توسع قدرات المساعد:
skills:
- web_search
- calculator
- weather
- custom_skill:
path: ./my-skills/custom_tool.py
config:
api_key_env: CUSTOM_API_KEY
أو عبر سطر الأوامر:
openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator
إعدادات تحويل الكلام إلى نص (STT)
لدعم الرسائل الصوتية على WhatsApp و Telegram:
stt:
provider: whisper # whisper, deepgram, google
model: whisper-1
language: auto # الكشف التلقائي أو تحديد "ar" للغة العربية، "en" للإنجليزية، إلخ.
openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1
تكامل Tuya للمنازل الذكية
يمكن لـ OpenClaw التحكم في الأجهزة المنزلية الذكية المتوافقة مع Tuya:
tuya:
enabled: true
access_id: "YOUR_TUYA_ACCESS_ID"
access_key: "YOUR_TUYA_ACCESS_KEY"
endpoint: "https://openapi.tuyaus.com"
يتيح لك ذلك التحكم في المصابيح، والمفاتيح، وأجهزة تنظيم الحرارة، وأجهزة Tuya الأخرى من خلال أوامر اللغة الطبيعية في أي قناة متصلة.
إعدادات نماذج متعددة
يمكنك تحديد قوالب نماذج مسبقة والتبديل بينها:
models:
default:
provider: openai
name: gpt-4o
fast:
provider: ollama
name: llama3.3
reasoning:
provider: anthropic
name: claude-opus-4-6
openclaw config set model.active default
# أو التبديل أثناء التشغيل
openclaw --model fast
الأسئلة الشائعة
أين يتم تخزين ملف إعدادات OpenClaw؟
الموقع الافتراضي هو ~/.openclaw/config.yaml. في بعض التركيبات قد يكون في ~/.config/openclaw/config.yaml. قم بتشغيل openclaw config show --path لمعرفة الموقع الدقيق.
هل يمكنني استخدام OpenClaw بدون أي سحابة (Cloud API)؟
نعم. قم بتهيئة Ollama كمزود للنماذج واستخدم Telegram في وضع polling. سيعطيك هذا مساعد ذكاء اصطناعي محلي وخاص بالكامل دون أن تخرج أي بيانات من جهازك.
كيف أقوم بتحديث OpenClaw؟
pip install --upgrade openclaw
# أو
npm update -g openclaw
بعد التحديث، قم بتشغيل openclaw doctor للتحقق من أي تغييرات في تنسيق الإعدادات.
هل يمكنني تشغيل عدة قنوات في وقت واحد؟
نعم. قم بتفعيل أكبر عدد تريده من القنوات — سيتعامل OpenClaw معها جميعاً في وقت واحد. تشترك كل قناة في نفس إعدادات النماذج والمهارات.
كيف يمكنني إعادة تعيين إعداداتي إلى الافتراضيات؟
openclaw config reset
سيقوم هذا باستبدال ملف الإعدادات الخاص بك بالقالب الافتراضي. قم بعمل نسخة احتياطية لإعداداتك الحالية أولاً إذا لزم الأمر.
هل تريد شيئاً أكثر بساطة؟
OpenClaw قوي ولكنه يتطلب مهارة في استخدام التيرمينال والإعداد اليدوي. إذا كنت ترغب في بناء وإطلاق منتجات مدعومة بالذكاء الاصطناعي دون إدارة ملفات الإعداد ومزودي النماذج وتكامل القنوات بنفسك:
يتولى Y Build المنظومة بالكامل — النشر، وفيديوهات المنتجات، و AI SEO، والتحليلات. لا ملفات إعداد. لا تيرمينال. فقط ابنِ وانطلق.
ابدأ مجاناً ←المصادر: