Blog

إصلاح أخطاء OpenClaw: 15 مشكلة شائعة وحلولها

Ashley Innocent

Ashley Innocent

5 مارس 2026

إصلاح أخطاء OpenClaw: 15 مشكلة شائعة وحلولها

ملخص

تغطي استكشاف أخطاء OpenClaw وإصلاحها مشاكل انقطاع الاتصال، وفشل المصادقة، وأخطاء التوجيه، ومشكلات الأداء. تنبع معظم المشاكل من عدم استقرار الشبكة، أو مفاتيح API غير الصحيحة، أو القنوات التي تم تكوينها بشكل خاطئ. يقدم هذا الدليل إصلاحات خطوة بخطوة لأكثر 15 خطأ شيوعًا في OpenClaw.

مشاكل التثبيت والإعداد

عدم تطابق إصدار Node.js

المشكلة: أمر openclaw غير موجود أو يفشل مع رسالة "إصدار Node غير مدعوم".

السبب: يتطلب OpenClaw Node.js 22 أو أحدث. تفتقر الإصدارات الأقدم إلى الميزات المطلوبة.

الإصلاح:

تحقق من إصدار Node الخاص بك:

node --version

إذا كان أقل من 22، قم بتحديث Node:

# استخدام nvm (موصى به)
nvm install 22
nvm use 22

# أو التنزيل من nodejs.org

أعد تثبيت OpenClaw:

npm install -g openclaw@latest

تحقق من التثبيت:

openclaw --version

رفض الإذن أثناء التثبيت

المشكلة: يفشل npm install -g openclaw برسائل EACCES أو أخطاء الأذونات.

السبب: يحاول npm الكتابة إلى مجلدات النظام دون الأذونات المناسبة.

الإصلاح:

لا تستخدم sudo. بدلاً من ذلك، قم بتكوين npm لاستخدام مجلد المستخدم:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'

أضف إلى ملف تعريف shell الخاص بك (~/.zshrc أو ~/.bashrc):

export PATH=~/.npm-global/bin:$PATH

أعد تحميل shell الخاص بك:

source ~/.zshrc

ثبت OpenClaw:

npm install -g openclaw@latest

ملف التكوين غير موجود

المشكلة: لا يمكن لـ OpenClaw العثور على ~/.openclaw/config.json بعد التثبيت.

السبب: لم يتم تشغيل معالج الإعداد أو فشل بصمت.

الإصلاح:

قم بتشغيل الإعداد يدويًا:

openclaw onboard

إذا فشل ذلك، قم بإنشاء مجلد التكوين:

mkdir -p ~/.openclaw

قم بإنشاء ملف تكوين بسيط:

cat > ~/.openclaw/config.json << 'EOF'
{
  "version": "1.0.0",
  "providers": {},
  "agents": {},
  "channels": {},
  "routing": []
}
EOF

أعد تشغيل الإعداد مرة أخرى:

openclaw onboard

مشاكل اتصال القنوات

رمز QR للواتساب لا يتم مسحه ضوئيًا

المشكلة: يظهر رمز QR ولكن تطبيق الواتساب يقول "رمز QR غير صالح" أو لا يستجيب.

السبب: انتهت صلاحية رمز QR أو مشاكل في الشبكة بين هاتفك و OpenClaw.

الإصلاح:

  1. تأكد من أن هاتفك وجهاز الكمبيوتر متصلان بنفس الشبكة.
  2. أعد إنشاء رمز QR:
openclaw channels logout whatsapp
openclaw channels login whatsapp
  1. امسح ضوئيًا في غضون 30 ثانية (تنتهي صلاحية رموز QR بسرعة).
  2. إذا استمر الفشل، تحقق من إعدادات جدار الحماية:
# macOS
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /usr/local/bin/node

# Linux (ufw)
sudo ufw allow 18789/tcp

الواتساب ينقطع الاتصال بعد بضع ساعات

المشكلة: يعمل الواتساب في البداية ولكنه ينقطع الاتصال بعد 2-4 ساعات.

السبب: يتطلب بروتوكول الواتساب إشارات نبض دورية. تغيرات الشبكة أو وضع السكون تقطع الاتصال.

الإصلاح:

قم بتمكين إعادة الاتصال التلقائي:

openclaw channels config whatsapp --auto-reconnect true --reconnect-interval 300

يتحقق هذا من الاتصال كل 5 دقائق ويعيد الاتصال إذا لزم الأمر.

إذا كنت تستخدم جهاز كمبيوتر محمول، فامنع وضع السكون أثناء تشغيل OpenClaw:

# macOS
caffeinate -i openclaw gateway

# Linux
systemd-inhibit --what=sleep openclaw gateway

للإنتاج، قم بتشغيل OpenClaw على خادم بدلاً من جهاز كمبيوتر محمول.

بوت تيليجرام لا يستقبل الرسائل

المشكلة: البوت متصل بالإنترنت ولكنه لا يستجيب للرسائل.

السبب: يفتقر البوت إلى الأذونات الضرورية أو أن الرمز المميز غير صالح.

الإصلاح:

اختبر رمز البوت المميز:

curl https://api.telegram.org/bot<YOUR_TOKEN>/getMe

إذا أعاد هذا خطأ، أعد إنشاء الرمز المميز:

  1. افتح تيليجرام وأرسل رسالة إلى @BotFather
  2. أرسل /mybots
  3. اختر البوت الخاص بك
  4. اختر "API Token" ← "Regenerate Token"
  5. حدث OpenClaw:
openclaw channels update telegram --token NEW_TOKEN

للمحادثات الجماعية، أضف البوت كمسؤول مع إذن "قراءة الرسائل".

بوت ديسكورد يظهر غير متصل

المشكلة: يظهر البوت غير متصل في قائمة خادم ديسكورد.

السبب: نقص "Message Content Intent" أو رمز مميز غير صالح.

الإصلاح:

  1. اذهب إلى Discord Developer Portal
  2. اختر تطبيقك
  3. اذهب إلى علامة التبويب "Bot"
  4. مكّن "Message Content Intent" ضمن Privileged Gateway Intents
  5. احفظ التغييرات
  6. أعد تشغيل OpenClaw:
openclaw gateway restart

إذا كان البوت لا يزال غير متصل، تحقق من الرمز المميز:

openclaw channels test discord

إذا فشل، أعد إنشاء الرمز المميز في Developer Portal وحدث OpenClaw.

جسر iMessage لا يعمل (macOS)

المشكلة: تظهر قناة iMessage "غير متصل" أو لا تستقبل الرسائل.

السبب: نقص أذونات الوصول أو عدم تشغيل تطبيق الرسائل.

الإصلاح:

  1. افتح إعدادات النظام ← الخصوصية والأمان ← إمكانية الوصول
  2. أضف Terminal (أو تطبيق الطرفية الخاص بك) إلى القائمة المسموح بها
  3. أعد تشغيل OpenClaw:
openclaw gateway restart
  1. تأكد من تشغيل تطبيق الرسائل وتسجيل الدخول إليه.
  2. اختبر بإرسال رسالة لنفسك.

إذا لم يعمل بعد، تحقق من عملية الجسر:

ps aux | grep openclaw-imessage-bridge

إذا لم يكن قيد التشغيل، ابدأه يدويًا:

openclaw channels restart imessage

أخطاء المصادقة وواجهة برمجة التطبيقات (API)

مفتاح API غير صالح

المشكلة: "فشل المصادقة" أو "مفتاح API غير صالح" في السجلات.

السبب: مفتاح API خاطئ، مفتاح منتهي الصلاحية، أو مفتاح بدون الأذونات المناسبة.

الإصلاح:

تحقق من مفتاح API الخاص بك:

# لـ Anthropic
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":10,"messages":[{"role":"user","content":"Hi"}]}'

# لـ OpenAI
curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4","messages":[{"role":"user","content":"Hi"}],"max_tokens":10}'

إذا فشل أمر curl، فإن مفتاحك غير صالح. احصل على مفتاح جديد من لوحة تحكم مزود الخدمة.

حدث OpenClaw:

openclaw config set --provider anthropic --api-key NEW_KEY

أعد تشغيل البوابة:

openclaw gateway restart

تجاوز حد المعدل

المشكلة: أخطاء "تجاوز حد المعدل" أو "الكثير من الطلبات".

السبب: ترسل الكثير من الطلبات إلى مزود الذكاء الاصطناعي الخاص بك.

الإصلاح:

تحقق من استخدامك:

openclaw stats --period 1h

مكّن تحديد المعدل:

openclaw limits set --max-requests 50 --window 3600

هذا يحدك بـ 50 طلبًا في الساعة. اضبطه بناءً على حدود مزود الخدمة.

لحركة المرور المفاجئة، قم بتمكين قائمة الانتظار:

openclaw config set --enable-queue true --queue-max-size 100

تُضاف الرسائل إلى قائمة الانتظار عندما تصل إلى حد المعدل وتتم معالجتها عندما تكون السعة متاحة.

النموذج غير موجود

المشكلة: أخطاء "النموذج غير موجود" أو "نموذج غير صالح".

السبب: لقد حددت نموذجًا غير موجود أو غير متاح لحسابك.

الإصلاح:

سرد النماذج المتاحة:

# Anthropic
curl https://api.anthropic.com/v1/models \
  -H "x-api-key: YOUR_KEY"

# OpenAI
curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

حدث تكوين الوكيل الخاص بك:

openclaw agents update default --model claude-sonnet-4-6

أعد تشغيل البوابة:

openclaw gateway restart

أرصدة غير كافية

المشكلة: أخطاء "أرصدة غير كافية" أو "الدفع مطلوب".

السبب: نفدت أرصدة حساب مزود الذكاء الاصطناعي الخاص بك أو تجاوز حدود الفواتير.

الإصلاح:

تحقق من رصيد حسابك في لوحة تحكم مزود الخدمة:

أضف أرصدة أو حدث طريقة الدفع الخاصة بك.

بينما تنتظر، قم بالتوجيه إلى نموذج مجاني أو محلي:

openclaw agents add fallback --provider ollama --model llama2
openclaw routing add --fallback fallback

فشل توجيه الرسائل

الرسائل تذهب إلى الوكيل الخطأ

المشكلة: يتم توجيه الرسائل إلى وكيل الذكاء الاصطناعي الخطأ على الرغم من قواعد التوجيه.

السبب: تعارض قواعد التوجيه أو أولويات غير صحيحة.

الإصلاح:

سرد جميع قواعد التوجيه:

openclaw routing list

تحقق من وجود تعارضات. القواعد ذات الأولوية الأعلى تتطابق أولاً. إذا كان لديك:

الأولوية 5: channel=whatsapp ← agent=default
الأولوية 10: sender=+1234567890 ← agent=vip

ستذهب الرسائل من +1234567890 على WhatsApp إلى vip (الأولوية 10 تفوز).

أزل القواعد المتعارضة:

openclaw routing remove <rule-id>

أضف قواعد بأولويات صحيحة:

openclaw routing add --channel whatsapp --agent default --priority 1
openclaw routing add --sender +1234567890 --agent vip --priority 10

اختبر التوجيه:

openclaw routing test --channel whatsapp --sender +1234567890 --message "test"

يظهر هذا الوكيل الذي سيتعامل مع الرسالة دون إرسالها.

توجيه الكلمات الرئيسية لا يعمل

المشكلة: الرسائل التي تحتوي على كلمات رئيسية محددة لا يتم توجيهها إلى الوكيل المكون.

السبب: الكلمات الرئيسية حساسة لحالة الأحرف أو الرسالة لا تحتوي على الكلمة الرئيسية بالضبط.

الإصلاح:

اجعل الكلمات الرئيسية غير حساسة لحالة الأحرف:

openclaw routing add --keyword "debug" --agent debugging --case-insensitive

استخدم التعبيرات العادية للمطابقة المرنة:

openclaw routing add --pattern "debug|error|bug" --agent debugging

يطابق هذا "debug" أو "error" أو "bug" في أي مكان في الرسالة.

اختبر مطابقة الكلمات الرئيسية:

openclaw routing test --message "I found a debug issue"

أخطاء وظيفة التوجيه المخصصة

المشكلة: وظيفة التوجيه المخصصة تظهر أخطاء أو لا يتم تنفيذها.

السبب: أخطاء في بناء الجملة، أو نقص التبعيات، أو قيم إرجاع غير صحيحة.

الإصلاح:

اختبر وظيفة التوجيه الخاصة بك:

openclaw routing test-custom ~/.openclaw/routing.js --message "test"

يقوم هذا بتشغيل وظيفتك ويعرض النتيجة أو الخطأ.

المشاكل الشائعة:

  1. أخطاء بناء الجملة: تحقق من بناء جملة JavaScript الخاص بك.
  2. نقص الإرجاع: قم دائمًا بإرجاع اسم وكيل.
  3. الوظائف غير المتزامنة: لا تستخدم async/await في وظائف التوجيه (يجب أن تكون متزامنة).

مثال على وظيفة صحيحة:

module.exports = function route(message) {
  // Always return a string (agent name)
  if (message.channel === 'whatsapp') {
    return 'whatsapp-agent';
  }
  return 'default';
};

مثال على وظيفة غير صحيحة:

// لا تفعل هذا
module.exports = async function route(message) {
  const result = await someAsyncOperation();
  return result; // الوظائف غير المتزامنة غير مدعومة
};

وكيل الاحتياطي لا يتم تفعيله

المشكلة: عندما يفشل الوكيل الأساسي، لا يتم توجيه الرسائل إلى الوكيل الاحتياطي.

السبب: لم يتم تكوين الوكيل الاحتياطي أو أن الوكيل الأساسي لا يبلغ عن الفشل بشكل صحيح.

الإصلاح:

كون الوكيل الاحتياطي:

openclaw routing set-fallback backup-agent

اختبر الوكيل الاحتياطي:

# تعطيل الوكيل الأساسي مؤقتًا
openclaw agents disable default

# أرسل رسالة اختبار
openclaw routing test --message "test"

# يجب أن يظهر الوكيل الاحتياطي

أعد تمكين الوكيل الأساسي:

openclaw agents enable default

مشاكل الأداء والذاكرة

استخدام عالي للذاكرة

المشكلة: يستخدم OpenClaw 2 جيجابايت+ من ذاكرة الوصول العشوائي ويستمر في الزيادة.

السبب: تتراكم بيانات الجلسة بمرور الوقت دون تنظيف.

الإصلاح:

تحقق من استخدام الذاكرة:

openclaw stats --memory

امسح الجلسات القديمة:

openclaw sessions clear --older-than 7d

قلل مهلة الجلسة:

openclaw config set --session-timeout 1800

تنتهي صلاحية الجلسات الآن بعد 30 دقيقة من عدم النشاط بدلاً من الساعة الافتراضية.

مكّن التنظيف التلقائي:

openclaw config set --auto-cleanup true --cleanup-interval 3600

يتم تشغيل التنظيف هذا كل ساعة.

أوقات استجابة بطيئة

المشكلة: تستغرق استجابات الذكاء الاصطناعي أكثر من 30 ثانية أو تتجاوز المهلة.

السبب: زمن انتقال الشبكة، أو مزود الذكاء الاصطناعي البطيء، أو تراكم قائمة الانتظار.

الإصلاح:

تحقق من حالة قائمة الانتظار:

openclaw queue status

إذا كانت قائمة الانتظار تحتوي على 50 رسالة أو أكثر، قم بزيادة التزامن:

openclaw config set --max-concurrent-requests 10

يعالج هذا 10 رسائل في وقت واحد بدلاً من 3 الافتراضية.

تحقق من زمن انتقال الشبكة إلى مزود الذكاء الاصطناعي الخاص بك:

# Anthropic
ping api.anthropic.com

# OpenAI
ping api.openai.com

إذا كان زمن الانتقال مرتفعًا (>200 مللي ثانية)، ففكر في استخدام مزود مختلف أو نموذج محلي.

مكّن مهلة الطلب:

openclaw config set --request-timeout 30000

الطلبات التي تستغرق أكثر من 30 ثانية تفشل وتُعاد المحاولة.

البوابة تصبح غير مستجيبة

المشكلة: تتوقف البوابة عن الاستجابة للرسائل أو مكالمات API.

السبب: تعليق، حلقة لا نهائية، أو استنفاد الموارد.

الإصلاح:

تحقق من حالة البوابة:

openclaw gateway status

إذا كانت مجمدة، احصل على تفريغ للخيوط:

kill -SIGUSR1 $(pgrep -f "openclaw gateway")

يكتب هذا تفريغًا للخيوط إلى ~/.openclaw/gateway.log. ابحث عن العمليات المعلقة.

أعد تشغيل البوابة:

openclaw gateway restart

مكّن الفحوصات الصحية:

openclaw config set --health-check-interval 60

تتحقق البوابة الآن من صحتها كل 60 ثانية وتعيد التشغيل إذا لم تستجب.

ارتفاع مفاجئ في استخدام وحدة المعالجة المركزية

المشكلة: OpenClaw يستخدم 100% من وحدة المعالجة المركزية باستمرار.

السبب: حلقة لا نهائية، تسجيل مفرط، أو فيضان رسائل.

الإصلاح:

تحقق مما يستهلك وحدة المعالجة المركزية:

top -p $(pgrep -f "openclaw gateway")

قلل مستوى التسجيل:

openclaw config set --log-level warn

يعطل هذا سجلات التصحيح والمعلومات، مما يقلل من عمليات الإدخال/الإخراج.

تحقق من فيضانات الرسائل:

openclaw stats --messages --period 1h

إذا كنت تستقبل أكثر من 1000 رسالة في الساعة، قم بتمكين تحديد المعدل لكل قناة:

openclaw channels config whatsapp --rate-limit 100 --rate-window 3600

أعطال وإعادة تشغيل البوابة

البوابة تتعطل عند بدء التشغيل

المشكلة: openclaw gateway يتعطل فورًا بدون رسالة خطأ.

السبب: ملف تكوين تالف أو تبعيات مفقودة.

الإصلاح:

تشغيل في وضع التصحيح:

openclaw gateway --debug

يظهر هذا رسائل خطأ مفصلة.

الأسباب الشائعة:

  1. تكوين تالف: انسخ احتياطيًا وأعد ضبط التكوين
cp ~/.openclaw/config.json ~/.openclaw/config.json.backup
openclaw config reset
openclaw onboard
  1. تبعيات مفقودة: أعد تثبيت OpenClaw
npm uninstall -g openclaw
npm install -g openclaw@latest
  1. المنفذ مستخدم بالفعل: غير المنفذ
openclaw gateway --port 18790

البوابة تتعطل أثناء التشغيل

المشكلة: تعمل البوابة لبعض الوقت ثم تتعطل بشكل غير متوقع.

السبب: استثناء غير معالج، تسرب ذاكرة، أو عملية خارجية تقتلها.

الإصلاح:

تحقق من سجلات الأعطال:

tail -100 ~/.openclaw/gateway.log

ابحث عن آثار مكدس أو رسائل خطأ قبل التعطل.

مكّن تفريغ الأعطال:

openclaw config set --enable-crash-dumps true

التعطل التالي يكتب تفريغًا إلى ~/.openclaw/crashes/. شارك هذا مع فريق OpenClaw لتصحيح الأخطاء.

شغل البوابة مع إعادة التشغيل التلقائي:

openclaw gateway --auto-restart

تُعاد تشغيل البوابة تلقائيًا بعد الأعطال.

للإنتاج، استخدم مدير عمليات:

# استخدام pm2
npm install -g pm2
pm2 start openclaw -- gateway
pm2 save
pm2 startup

فقدان بيانات الجلسة بعد إعادة التشغيل

المشكلة: تتم إعادة ضبط المحادثات بعد إعادة تشغيل البوابة.

السبب: عدم استمرارية الجلسات على القرص أو ملف جلسة تالف.

الإصلاح:

مكّن استمرارية الجلسة:

openclaw config set --persist-sessions true --session-file ~/.openclaw/sessions.db

يتم الآن حفظ الجلسات على القرص كل 30 ثانية.

تحقق من ملف الجلسة:

ls -lh ~/.openclaw/sessions.db

إذا كان حجمه 0 بايت أو مفقودًا، فلن يتم حفظ الجلسات. تحقق من مساحة القرص:

df -h ~

إذا كان القرص ممتلئًا، حرر مساحة وأعد تشغيل البوابة.

استعادة من نسخة احتياطية:

cp ~/.openclaw/sessions.db.backup ~/.openclaw/sessions.db
openclaw gateway restart

مشاكل خاصة بالمنصة

macOS: "openclaw" لا يمكن فتحه

المشكلة: يحظر macOS OpenClaw برسالة تحذير "مطور غير معرف".

السبب: ميزة الأمان Gatekeeper في macOS.

الإصلاح:

اسمَح لـ OpenClaw:

xattr -d com.apple.quarantine $(which openclaw)

أو اذهب إلى إعدادات النظام ← الخصوصية والأمان وانقر على "السماح على أي حال" بجانب تحذير OpenClaw.

لينكس: رفض الإذن لـ inotify

المشكلة: "ENOSPC: تم الوصول إلى حد النظام لعدد مراقبي الملفات."

السبب: يحد لينكس من عدد الملفات التي يمكن لعملية مراقبتها.

الإصلاح:

زيادة الحد:

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

أعد تشغيل OpenClaw:

openclaw gateway restart

ويندوز: الأمر غير موجود

المشكلة: أمر openclaw غير معروف على ويندوز.

السبب: مجلد npm العام ليس في PATH.

الإصلاح:

ابحث عن مجلد npm العام:

npm config get prefix

أضفه إلى PATH:

  1. افتح خصائص النظام ← متغيرات البيئة.
  2. عدّل "Path" ضمن متغيرات المستخدم.
  3. أضف C:\Users\YourName\AppData\Roaming\npm (أو المسار من الأعلى).
  4. انقر فوق موافق وأعد تشغيل الطرفية الخاصة بك.

تحقق:

openclaw --version

دوكر: مشاكل الشبكة

المشكلة: OpenClaw في دوكر لا يستطيع الاتصال بمنصات المراسلة.

السبب: عزل شبكة دوكر.

الإصلاح:

شغل مع شبكة المضيف:

docker run --network host openclaw/openclaw gateway

أو كشف منفذ البوابة:

docker run -p 18789:18789 openclaw/openclaw gateway

بالنسبة للواتساب، تحتاج إلى كشف منافذ إضافية لمسح رمز QR:

docker run -p 18789:18789 -p 3000:3000 openclaw/openclaw gateway

أدوات التصحيح والسجلات

تمكين تسجيل التصحيح

احصل على سجلات مفصلة:

openclaw config set --log-level debug
openclaw gateway restart

تذهب السجلات إلى ~/.openclaw/gateway.log افتراضيًا.

راقب السجلات في الوقت الفعلي:

tail -f ~/.openclaw/gateway.log

اختبار المكونات الفردية

اختبار القنوات:

openclaw channels test whatsapp
openclaw channels test telegram
openclaw channels test discord

اختبار الوكلاء:

openclaw agents test default --message "Hello"

اختبار التوجيه:

openclaw routing test --channel whatsapp --sender +1234567890 --message "debug issue"

فحص حالة البوابة

احصل على الحالة الحالية:

openclaw gateway inspect

يظهر هذا:

تصدير التشخيصات

إنشاء تقرير تشخيصي:

openclaw diagnostics export > openclaw-diagnostics.json

يتضمن هذا:

شارك هذا مع الدعم عند الإبلاغ عن المشاكل.

تصحيح أخطاء الشبكة

اختبار الاتصال بمزودي الذكاء الاصطناعي:

openclaw network test anthropic
openclaw network test openai

يتحقق هذا من:

إذا فشل أي فحص، فلديك مشكلة في الشبكة.

الأسئلة الشائعة

لماذا يستخدم OpenClaw الكثير من الذاكرة؟

يحتفظ OpenClaw بسجل الجلسة في الذاكرة للوصول السريع. تخزن كل جلسة السياق الكامل للمحادثة. إذا كان لديك 100 جلسة نشطة بها 50 رسالة لكل منها، فهذا يعني 5000 رسالة في الذاكرة.

تقليل استخدام الذاكرة:

  1. قلل مهلة الجلسة
  2. مكّن التنظيف التلقائي
  3. حدّد طول السياق لكل جلسة
openclaw config set --session-timeout 1800 --auto-cleanup true --max-context-length 50

هل يمكنني تشغيل OpenClaw بدون إنترنت؟

نعم، إذا كنت تستخدم نموذج ذكاء اصطناعي محلي. ثبت Ollama وكون OpenClaw لاستخدامه:

# ثبت Ollama
curl https://ollama.ai/install.sh | sh

# اسحب نموذجًا
ollama pull llama2

# كون OpenClaw
openclaw agents add local --provider ollama --model llama2 --endpoint http://localhost:11434

لا تزال منصات المراسلة بحاجة إلى الإنترنت، لكن استدلال الذكاء الاصطناعي يعمل محليًا.

كيف يمكنني الترحيل إلى جهاز جديد؟

صدّر تكوينك:

openclaw config export > openclaw-backup.json

انسخ openclaw-backup.json إلى الجهاز الجديد.

ثبت OpenClaw:

npm install -g openclaw@latest

استورد التكوين:

openclaw config import openclaw-backup.json

أعد توصيل القنوات (رموز QR والرموز المميزة لا تنتقل):

openclaw channels login whatsapp
openclaw channels update telegram --token YOUR_TOKEN

لماذا تصل الرسائل بترتيب غير صحيح؟

يعالج OpenClaw الرسائل بشكل متزامن. إذا أرسلت 3 رسائل بسرعة، فقد تصل إلى مزود الذكاء الاصطناعي بترتيبات مختلفة اعتمادًا على توقيت الشبكة.

مكّن المعالجة المتسلسلة:

openclaw config set --max-concurrent-requests 1

يعالج هذا رسالة واحدة في كل مرة، مما يحافظ على الترتيب. إنه أبطأ ولكنه يضمن التسلسل.

هل يمكنني استخدام OpenClaw للإنتاج؟

نعم، ولكن اتبع هذه الإرشادات:

  1. شغل على خادم، وليس جهاز كمبيوتر محمول.
  2. استخدم مدير عمليات (pm2, systemd).
  3. مكّن استمرارية الجلسة.
  4. أعد إعداد المراقبة والتنبيهات.
  5. كون حدود المعدل.
  6. استخدم وكيلًا عكسيًا (nginx) لواجهة مستخدم التحكم.
  7. مكّن HTTPS.
  8. انسخ التكوين احتياطيًا بانتظام.

مثال على خدمة systemd:

[Unit]
Description=بوابة OpenClaw
After=network.target

[Service]
Type=simple
User=openclaw
WorkingDirectory=/home/openclaw
ExecStart=/usr/bin/openclaw gateway --port 18789
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

كيف أبلغ عن الأخطاء؟

  1. أنشئ تشخيصات:
openclaw diagnostics export > diagnostics.json
  1. افتح مشكلة على GitHub
  2. تضمين:

الخلاصة

تنبع معظم مشاكل OpenClaw من مشاكل الشبكة، أو التكوين غير الصحيح، أو المشاكل الخاصة بالمنصة. يغطي هذا الدليل أكثر 15 خطأ شيوعًا وإصلاحاتها.

خطوات استكشاف الأخطاء وإصلاحها الرئيسية:

  1. تحقق من السجلات أولاً (~/.openclaw/gateway.log)
  2. اختبر المكونات بشكل فردي (القنوات، الوكلاء، التوجيه)
  3. مكّن وضع التصحيح للأخطاء المفصلة
  4. استخدم أدوات التشخيص لتصدير الحالة
  5. انضم إلى المجتمع للمساعدة

إذا كنت تقوم بإنشاء تدفقات عمل API جنبًا إلى جنب مع OpenClaw، فتحقق من Apidog لتصميم واجهة برمجة التطبيقات واختبارها وتوثيقها. إنه يكمل واجهة OpenClaw المحادثة بإدارة واجهة برمجة تطبيقات منظمة.

زر

الخطوات التالية:

ممارسة تصميم API في Apidog

اكتشف طريقة أسهل لبناء واستخدام واجهات برمجة التطبيقات

التسجيل مجانًاتحميل