openclaw onboard

معالج تفاعلي خطوة بخطوة لإعداد OpenClaw وتكوينه للمرة الأولى.

الاستخدام الأساسي

openclaw onboard [options]

ما الذي يفعله المعالج؟

1️⃣

التحقق من التبعيات

يتحقق من وجود Node.js والأدوات المطلوبة وإصداراتها

2️⃣

تكوين نماذج الذكاء الاصطناعي

إرشادك لإضافة API keys لـ Anthropic أو OpenAI أو Google

3️⃣

إعداد القنوات

تكوين Telegram أو Discord أو قنوات أخرى

4️⃣

إنشاء ملفات Workspace

إنشاء AGENTS.md، USER.md، وملفات أخرى إذا لم تكن موجودة

5️⃣

بدء Gateway

بدء خدمة OpenClaw Gateway تلقائياً

6️⃣

الإقران الأول

إرشادات لإقران أول جهاز أو قناة

الأمثلة

إعداد جديد كامل

# بدء المعالج التفاعلي
openclaw onboard

# سيسألك المعالج:
# - هل لديك API key لـ Claude أو GPT؟
# - ما القناة التي تريد استخدامها؟
# - معلومات الإعداد الأساسية

إعادة التكوين

# إعادة تشغيل المعالج (سيحتفظ بالإعدادات الموجودة)
openclaw onboard --reconfigure

# بدء من الصفر
openclaw onboard --clean

تخطي خطوات

# تخطي تكوين القنوات
openclaw onboard --skip-channels

# تخطي بدء Gateway
openclaw onboard --skip-start

# وضع غير تفاعلي (يستخدم الإعدادات الافتراضية)
openclaw onboard --non-interactive

الخيارات

الخيارالوصف
--reconfigureإعادة التكوين مع الاحتفاظ بالإعدادات الحالية
--cleanبدء من الصفر (حذف التكوين الحالي)
--skip-channelsتخطي تكوين القنوات
--skip-startعدم بدء Gateway تلقائياً
--non-interactiveوضع غير تفاعلي (استخدام الإعدادات الافتراضية)
--workspace <path>مسار workspace مخصص
--model <name>تعيين النموذج الافتراضي مباشرة
--verboseعرض معلومات تفصيلية

خطوات الإعداد بالتفصيل

1. التحقق من التبعيات

يتحقق المعالج من:

  • ✅ Node.js (الإصدار 18 أو أحدث)
  • ✅ npm أو yarn
  • ✅ Git (اختياري، للتحديثات)
  • ✅ مساحة القرص الكافية

2. تكوين نماذج الذكاء الاصطناعي

سيُطلب منك اختيار مزود:

? Select your AI provider:
  ❯ Anthropic (Claude)
    OpenAI (GPT)
    Google (Gemini)
    Skip for now

? Enter your API key: [hidden]
? Select default model:
  ❯ claude-3-5-sonnet (Recommended)
    claude-3-opus (Most powerful)
    claude-3-haiku (Fastest)

3. إعداد القنوات

اختر القنوات التي تريد استخدامها:

? Which channels do you want to configure?
  ◯ Telegram
  ◯ Discord
  ◯ WhatsApp
  ◯ Slack
  ◉ Skip for now

# لكل قناة، سيُطلب منك:
? Enter Telegram Bot Token: [hidden]
? Enter allowed user IDs (comma-separated): 123456,789012

4. إنشاء Workspace

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

workspace/
├── AGENTS.md         # تعليمات الوكيل
├── USER.md          # معلومات المستخدم
├── TOOLS.md         # ملاحظات محلية
├── MEMORY.md        # الذاكرة طويلة المدى
└── memory/          # سجلات يومية

5. بدء Gateway

✓ Starting OpenClaw Gateway...
✓ Gateway is running on http://localhost:18790
✓ Health check passed
✓ All systems operational

6. الإقران الأول

سيعرض المعالج التعليمات للإقران:

🎉 Setup complete!

Next steps:
1. Open Telegram and send /start to your bot
2. Approve the pairing request:
   openclaw pairing list
   openclaw pairing approve telegram <request-id>

3. Start chatting with your AI assistant!

Run 'openclaw doctor' to verify everything is working.

✅ نصائح للإعداد الناجح

  • جهز API key قبل بدء المعالج
  • استخدم claude-3-5-sonnet كنموذج افتراضي للتوازن الأمثل
  • يمكنك دائماً إعادة تشغيل المعالج مع --reconfigure
  • استخدم openclaw doctor بعد الإعداد للتحقق

الحصول على API Keys

Anthropic (Claude)

احصل على API key من:

console.anthropic.com

الخطة المجانية: $5 رصيد تجريبي

OpenAI (GPT)

احصل على API key من:

platform.openai.com/api-keys

يتطلب إضافة طريقة دفع

Google (Gemini)

احصل على API key من:

makersuite.google.com/app/apikey

طبقة مجانية سخية متاحة

استكشاف الأخطاء

فشل التحقق من التبعيات

# التحقق من إصدار Node.js
node --version  # يجب أن يكون >= 18.0.0

# تثبيت Node.js من
# https://nodejs.org

# أو استخدم nvm
nvm install 20
nvm use 20

خطأ في API Key

# اختبار API key يدوياً
openclaw models test claude-3-5-sonnet

# تعديل API key
openclaw config set anthropic.api_key "sk-ant-..."

# إعادة تشغيل المعالج
openclaw onboard --reconfigure

Gateway لا يبدأ

# بدء يدوي مع verbose
openclaw gateway start --verbose

# التحقق من السجلات
openclaw logs --level error

# تشخيص شامل
openclaw doctor

💡 بعد الإعداد

بمجرد اكتمال الإعداد، قم بما يلي:

  • قم بتشغيل openclaw doctor للتحقق
  • راجع workspace/AGENTS.md لتخصيص شخصية الوكيل
  • أضف معلوماتك في workspace/USER.md
  • ابدأ بإقران أول جهاز أو قناة

إعادة التثبيت

إذا أردت البدء من جديد تماماً:

# إيقاف Gateway
openclaw gateway stop

# إعادة التعيين (حذف جميع الإعدادات)
openclaw reset --all

# بدء المعالج من جديد
openclaw onboard

⚠️ تحذير

استخدام openclaw reset --allسيحذف جميع الإعدادات، الجلسات، والإقرانات. تأكد من عمل نسخة احتياطية إذا لزم الأمر.

الأوامر ذات الصلة

  • openclaw doctor - تشخيص شامل للنظام
  • openclaw config - تعديل الإعدادات
  • openclaw pairing - إدارة الإقرانات
  • openclaw reset - إعادة تعيين النظام