تحرير إعدادات OpenClaw: دليل الإعداد والتكوين الشامل (2026)
أتقن أوامر openclaw config edit لـ WhatsApp وDiscord وTelegram وOllama والمزيد. دليل خطوة بخطوة لتكوين القنوات والنماذج والموفرين وإصلاح أخطاء تكوين OpenClaw الشائعة.
ملخص سريع
مرجع سريع لأكثر أوامر تكوين 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 هو إطار عمل مفتوح المصدر لمساعد الذكاء الاصطناعي يربط نماذج اللغة الكبيرة بقنوات المراسلة مثل WhatsApp وDiscord وTelegram وSlack. يدعم موفري نماذج متعددين — OpenAI وAnthropic وOllama (نماذج محلية) وGoogle والمزيد — ويمكن توسيعه بمهارات وإضافات مخصصة.
جوهر OpenClaw هو نظام التكوين الخاص به. تقريباً كل شيء — أي القنوات نشطة، وأي نموذج يُستخدم، وأي المهارات محملة — يتم التحكم فيه من خلال ملفات التكوين. إتقان openclaw config edit هو المفتاح لتشغيل OpenClaw بالطريقة التي تريدها.
openclaw config edit: الأساسيات
فتح محرر التكوين
الأمر الرئيسي لتكوين OpenClaw هو:
openclaw config edit
يفتح هذا ملف التكوين في محرر الطرفية الافتراضي (عادة nano أو vim أو ما تم تعيينه في $EDITOR). يقع ملف التكوين عادة في ~/.openclaw/config.yaml أو ~/.config/openclaw/config.yaml حسب التثبيت.
هيكل ملف التكوين
ملف تكوين OpenClaw بتنسيق YAML ومنظم في أقسام:
# تكوين النموذج
model:
provider: openai # openai, anthropic, ollama, google
name: gpt-4o # سلسلة معرّف النموذج
temperature: 0.7
max_tokens: 4096
# تكوين القنوات
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:
- web_search
- calculator
- weather
# تحويل الكلام إلى نص
stt:
provider: whisper
model: whisper-1
# رسالة النظام
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
هذا مفيد للبرمجة النصية أو التغييرات السريعة دون فتح محرر.
Be first to build with AI
Y Build is the AI-era operating system for startups. Join the waitlist and get early access.
إعداد القنوات
يتطلب تكامل 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"
# تعيين عنوان URL للويب هوك
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"
Discord
إعداد Discord أبسط — تحتاج فقط إلى رمز بوت من بوابة مطوري Discord.
openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"
Telegram
يتطلب Telegram رمز بوت من @BotFather:
openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"
يدعم Telegram وضعي الاستطلاع والويب هوك. الاستطلاع أسهل للتطوير (لا حاجة لعنوان URL عام):
openclaw config set channels.telegram.mode polling
للإنتاج، استخدم وضع الويب هوك:
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 كمتغير بيئة (لا تضعه في ملف التكوين):
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 أو خروج البيانات من جهازك.
# ثبّت 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) وأن عنوان 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 يستخدم API متوافق مع 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 في ملف التكوين لأسباب أمنية.
الإصلاح: أضف مفتاح API إلى ملف تعريف الصدفة (~/.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 # كشف تلقائي أو تحديد "en"، "es"، إلخ.
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 بدون أي API سحابي؟
نعم. كوّن Ollama كموفر النموذج واستخدم Telegram في وضع الاستطلاع. يمنحك هذا مساعد ذكاء اصطناعي محلي وخاص بالكامل بدون خروج أي بيانات من جهازك.
كيف أحدّث OpenClaw؟
pip install --upgrade openclaw
# أو
npm update -g openclaw
بعد التحديث، شغّل openclaw doctor للتحقق من أي تغييرات في تنسيق التكوين.
هل يمكنني تشغيل قنوات متعددة في وقت واحد؟
نعم. فعّل أي عدد تريده من القنوات — يتعامل معها OpenClaw بشكل متزامن. تشترك كل قناة في نفس تكوين النموذج والمهارات.
كيف أعيد تعيين التكوين للافتراضي؟
openclaw config reset
يستبدل هذا ملف التكوين بالقالب الافتراضي. احفظ نسخة احتياطية من التكوين الحالي أولاً إذا لزم الأمر.
هل تريد شيئاً أبسط؟
OpenClaw قوي لكنه يتطلب راحة مع الطرفية وتكويناً يدوياً. إذا كنت تريد بناء وشحن منتجات مدعومة بالذكاء الاصطناعي بدون إدارة ملفات التكوين وموفري النماذج وتكاملات القنوات بنفسك:
Y Build يتولى المجموعة الكاملة — النشر وفيديوهات المنتج وتحسين محركات البحث بالذكاء الاصطناعي والتحليلات. بدون ملفات تكوين. بدون طرفية. فقط ابنِ وأطلق. ابدأ مجاناً →المصادر:
Be first to build with AI
Y Build is the AI-era operating system for startups. Join the waitlist and get early access.