OpenClaw Guide: Build Your AI Assistant

ملخص سريع (TL;DR)

• OpenClaw هو مساعد ذكاء اصطناعي مفتوح المصدر يمتلك أكثر من 135 ألف نجمة على GitHub
• يعمل محلياً على جهازك — بياناتك تبقى خاصة تماماً
• يتصل عبر WhatsApp، Telegram، Discord، Slack، iMessage وغيرها
• يضم أكثر من 3000 مهارة مجتمعية للأتمتة، البرمجة، المنزل الذكي، والمزيد
• مجاني (تدفع فقط مقابل رموز API للذكاء الاصطناعي، عادةً ما بين 10-50 دولاراً شهرياً)
• يستغرق الإعداد حوالي 30 دقيقة باستخدام هذا الدليل

ما هو OpenClaw؟

يعتبر OpenClaw (المعروف سابقاً باسم Clawdbot، ثم Moltbot) أضخم مشروع ذكاء اصطناعي مفتوح المصدر لعام 2026. إنه مساعد ذكاء اصطناعي شخصي يتميز بـ:

• يعمل على حاسوبك الشخصي أو خادمك الخاص
• يتصل بـ تطبيقات المراسلة المفضلة لديك (WhatsApp، Telegram، Discord، إلخ)
• يمتلك وصولاً كاملاً إلى نظام الملفات، واجهة السطر البرمجي (terminal)، والمتصفح
• يمكنه أتمتة المهام مثل مساعد شخصي خارق

الرحلة: Clawdbot ← Moltbot ← OpenClaw

مر المشروع برحلة تسمية مثيرة:

بغض النظر عن الاسم الذي تطلقه عليه، تظل الوظيفة كما هي — مساعد ذكاء اصطناعي قوي للغاية يعمل محلياً.

لماذا OpenClaw؟

مقارنة بـ ChatGPT / Claude على الويب

مقارنة بوكلاء الذكاء الاصطناعي الآخرين

مميزات OpenClaw القاتلة:

1. صندوق وارد متعدد القنوات: ذكاء اصطناعي واحد، متاح عبر WhatsApp، Telegram، Discord، Slack، iMessage، وأكثر من 12 منصة أخرى.
2. ذاكرة مستمرة: يتذكر سياق المحادثات عبر الوقت.
3. نظام مهارات متكامل: أكثر من 3000 إضافة مجتمعية عبر ClawHub.
4. يدعم نماذج متعددة: يعمل مع Claude، GPT، Gemini، DeepSeek، نماذج Ollama المحلية، إلخ.
5. مفتوح المصدر: مرخص بموجب MIT، كود قابل للمراجعة بالكامل.

المتطلبات المسبقة

قبل البدء، تأكد من توفر ما يلي:

• [ ] جهاز كمبيوتر (Mac، Windows مع WSL2، أو Linux)
• [ ] تثبيت Node.js v22+ (حمله من هنا)
• [ ] مفتاح API للذكاء الاصطناعي (Anthropic Claude، OpenAI، أو غيرها)
• [ ] حوالي 30 دقيقة من وقتك

متطلبات العتاد (Hardware)

طرق التثبيت

الطريقة 1: التثبيت بسطر واحد (موصى به)

أسرع طريقة للبدء:

curl -fsSL https://openclaw.bot/install.sh | bash

سيقوم هذا السكربت بـ:

1. التحقق من متطلبات نظامك


2. تثبيت OpenClaw


3. تشغيل معالج الإعداد الأولي (onboarding wizard)

الطريقة 2: Docker (موصى به للخوادم)

إذا كنت تفضل النشر باستخدام الحاويات (containers):

# Clone the repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Run the Docker setup
./docker-setup.sh

ينشئ إعداد Docker دليلين مهمين:

• ~/.openclaw/ — التكوين، الذاكرة، مفاتيح API


• ~/openclaw/workspace/ — الملفات التي يمكن لوكيل الذكاء الاصطناعي الوصول إليها

الطريقة 3: البناء من المصدر (Build from Source)

للمطورين الذين يريدون تحكماً كاملاً:

# Clone the repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Install dependencies
pnpm install

# Build the UI
pnpm ui:build

# Build the project
pnpm build

# Run onboarding
pnpm openclaw onboard --install-daemon

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

الخطوة 1: تشغيل معالج الإعداد

بعد التثبيت، سيبدأ معالج الإعداد تلقائياً. إذا لم يحدث ذلك، قم بتشغيل:

openclaw onboard --install-daemon

سيرشدك المعالج خلال:

1. اختيار مزود النموذج (Model Provider)
2. تكوين مفتاح API
3. إعداد منصات المراسلة
4. إعدادات الأمان

الخطوة 2: تكوين نموذج الذكاء الاصطناعي الخاص بك

يدعم OpenClaw مزودي ذكاء اصطناعي متعددين. اختر واحداً:

الخيار أ: Anthropic Claude (موصى به)

# Set your API key
export ANTHROPIC_API_KEY=sk-ant-xxxxx

# Or use the config command
openclaw config set 'models.default' 'claude-sonnet-4'

الخيار ب: OpenAI

export OPENAI_API_KEY=sk-xxxxx
openclaw config set 'models.default' 'gpt-4o'

الخيار ج: DeepSeek (اقتصادي)

openclaw config set 'models.providers.deepseek' --json '{
  "baseUrl": "https://api.deepseek.com/v1",
  "apiKey": "your-api-key",
  "api": "openai-completions",
  "models": [
    { "id": "deepseek-chat", "name": "DeepSeek Chat" },
    { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
  ]
}'

الخيار د: نماذج محلية باستخدام Ollama

لخصوصية كاملة، قم بتشغيل النماذج محلياً:

# Install Ollama first: https://ollama.ai
ollama pull llama3.3

# Configure OpenClaw to use it
openclaw config set 'models.providers.ollama' --json '{
  "baseUrl": "http://localhost:11434/v1",
  "api": "openai-completions",
  "models": [
    { "id": "llama3.3", "name": "Llama 3.3" }
  ]
}'

الخطوة 3: ربط منصات المراسلة

هنا تبرز قوة OpenClaw — تحدث مع ذكائك الاصطناعي من أي مكان.

Telegram (الأسهل)

1. أرسل رسالة إلى @BotFather على Telegram
2. أرسل /newbot واتبع التعليمات
3. انسخ رمز البوت (token) الخاص بك
4. قم بتكوين OpenClaw:

openclaw config set 'channels.telegram.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.telegram.allowlist' '["your_telegram_username"]'

WhatsApp

يستخدم OpenClaw متصفح WhatsApp Web للاتصال:

# Enable WhatsApp channel
openclaw config set 'channels.whatsapp.enabled' true

# Restart the gateway
openclaw gateway restart

# Scan the QR code that appears

سيظهر رمز QR في واجهة السطر البرمجي (terminal). امسحه باستخدام تطبيق WhatsApp على هاتفك (الإعدادات ← الأجهزة المرتبطة ← ربط جهاز).

Discord

1. أنشئ تطبيق Discord في discord.com/developers
2. أنشئ بوتاً وانسخ الرمز الخاص به
3. التكوين:

openclaw config set 'channels.discord.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.discord.allowlist' '["your_discord_user_id"]'

iMessage (لنظام Mac فقط)

لمستخدمي Mac، يمكن لـ OpenClaw الاتصال مباشرة بـ iMessage:

openclaw config set 'channels.imessage.enabled' true

الخطوة 4: تشغيل البوابة (Gateway)

البوابة هي الخدمة الخلفية التي تحافظ على تشغيل OpenClaw:

# Start as a daemon (background service)
openclaw gateway start

# Or run in foreground for debugging
openclaw gateway

# Check status
openclaw gateway status

# View logs
openclaw logs --follow

الخطوة 5: الوصول إلى لوحة تحكم الويب

يتضمن OpenClaw واجهة ويب للتكوين والدردشة المباشرة:

# Open the dashboard in your browser
openclaw dashboard

سيفتح هذا الرابط http://127.0.0.1:18789/ مع رمز دخول مؤقت.

من لوحة التحكم يمكنك:

• الدردشة مباشرة مع ذكائك الاصطناعي


• إدارة الإعدادات


• عرض سجل المحادثات


• تثبيت المهارات

محادثتك الأولى

بمجرد إعداد كل شيء، أرسل رسالة إلى البوت الخاص بك (عبر Telegram أو WhatsApp أو واجهة الويب):

Hello! Can you tell me what you can do?

سيقوم OpenClaw بالتعريف بنفسه وبقدراته. جرب بعض المهام الحقيقية:

What files are in my Downloads folder?

Search my documents for anything related to "taxes 2025"

Create a Python script that converts CSV to JSON

What's using the most disk space on my computer?

تثبيت المهارات

توسع المهارات من قدرات OpenClaw. تصفح سجل ClawHub أو قم بالتثبيت مباشرة:

المهارات الشائعة

# GitHub integration
openclaw skill install github

# Web browser automation
openclaw skill install agent-browser

# Calendar management
openclaw skill install calendar

# Email automation
openclaw skill install email

# Smart home control
openclaw skill install homeassistant

# Image generation
openclaw skill install dalle

# Voice conversations (Discord)
openclaw skill install discord-voice

فئات المهارات

تنبيه أمني

⚠️ هام: راجع المهارات قبل تثبيتها. الطبيعة المفتوحة لـ ClawHub تعني احتمال وجود مهارات ضارة. استخدم openclaw skill inspect لمراجعة الكود، أو اطلب من Claude Code مراجعته لك.

الإعدادات المتقدمة

هيكل ملف التكوين

يخزن OpenClaw إعداداته في ~/.openclaw/:

~/.openclaw/
├── openclaw.json    # التكوين الرئيسي
├── env              # متغيرات البيئة (مفاتيح API)
├── memory/          # تخزين الذاكرة المستمرة
├── skills/          # المهارات المثبتة
├── backups/         # نسخ احتياطية للتكوين
└── logs/            # ملفات السجل

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

# View current config
openclaw config get

# Set a value
openclaw config set 'key.path' 'value'

# Edit in your default editor
openclaw config edit

إدارة الذاكرة

يحافظ OpenClaw على ذاكرة مستمرة عبر المحادثات:

# View memory stats
openclaw memory stats

# Clear all memory (careful!)
openclaw memory clear

# Export memory for backup
openclaw memory export > memory-backup.json

إجراء فحوصات الحالة

# Comprehensive health check
openclaw doctor

# Check specific components
openclaw doctor --check api
openclaw doctor --check channels
openclaw doctor --check skills

أفضل ممارسات الأمان

يمتلك OpenClaw وصولاً كاملاً إلى النظام — وهذا ما يجعله قوياً، ولكنه محفوف بالمخاطر أيضاً. اتبع هذه الإرشادات:

1. استخدم جهازاً مخصصاً

لا تقم بتشغيل OpenClaw على جهاز عملك الرئيسي. الخيارات المتاحة:

• VPS: DigitalOcean، Vultr، AWS (5-20 دولاراً شهرياً)
• كمبيوتر محمول قديم: أعد استخدام العتاد القديم
• Raspberry Pi: يصلح للاستخدام الخفيف
• Docker: يوفر بعض العزل

2. تفعيل وضع Sandbox

للجلسات غير الموثوقة (المحادثات الجماعية، القنوات):

openclaw config set 'agents.defaults.sandbox.mode' 'non-main'

سيؤدي هذا لتشغيل جلسات المجموعات/القنوات داخل حاويات Docker معزولة.

3. استخدم القوائم البيضاء (Allowlists)

اسمح لمستخدمين محددين فقط بالتفاعل مع البوت الخاص بك:

# Telegram
openclaw config set 'channels.telegram.allowlist' '["username1", "username2"]'

# Discord
openclaw config set 'channels.discord.allowlist' '["user_id_1", "user_id_2"]'

4. حافظ على التحديث المستمر

تم العثور على ثغرات أمنية في الإصدارات القديمة. احرص دائماً على تشغيل أحدث إصدار:

# Check for updates
openclaw update --check

# Update to latest
openclaw update

ملاحظة: الإصدارات التي سبقت 2026.1.29 تحتوي على ثغرة أمنية معروفة. حدث فوراً إذا كنت تستخدم إصداراً أقدم.

5. فحص المهارات قبل التثبيت

# Inspect a skill's code
openclaw skill inspect <skill-name>

# Check skill reputation
openclaw skill info <skill-name>

أمثلة على الأتمتة

هنا تظهر قوة OpenClaw الحقيقية:

الموجز الصباحي

إعداد ملخص يومي في الساعة 8 صباحاً:

# In your config, add a cron job
openclaw config set 'automations.morning-briefing' --json '{
  "cron": "0 8 * * *",
  "action": "أرسل لي ملخصاً عن: توقعات الطقس، أحداث التقويم اليوم، رسائل البريد المهمة غير المقروءة، وأهم 3 عناوين أخبار"
}'

بوت مراجعة GitHub PR

مراجعة طلبات السحب (PRs) تلقائياً عند تعيينها إليك:

openclaw skill install github

# Configure webhook or polling
openclaw config set 'automations.pr-review' --json '{
  "trigger": "github.pr.assigned",
  "action": "راجع طلب السحب، وابحث عن الأخطاء والمشاكل الأمنية ومخالفات نمط الكود. وانشر تعليقاً ملخصاً."
}'

مشاهد المنزل الذكي

openclaw skill install homeassistant

# "Leaving home" automation
openclaw config set 'automations.leaving-home' --json '{
  "trigger": "location.leave_home",
  "action": "أطفئ جميع الأضواء، واضبط منظم الحرارة على الوضع الاقتصادي، وفعّل نظام الأمان"
}'

تنظيم الملفات

اطلب من OpenClaw تنظيم مجلد التنزيلات الخاص بك:

نظم مجلد Downloads الخاص بي: انقل الصور إلى ~/Pictures، والمستندات إلى ~/Documents، واحذف أي شيء أقدم من 30 يوماً

استكشاف الأخطاء وإصلاحها

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

# Add to PATH
export PATH="$HOME/.openclaw/bin:$PATH"
# Add to your shell profile (.bashrc, .zshrc)

# Check your environment variables
openclaw config get models

# Re-run onboarding
openclaw onboard

# Check logs
openclaw logs --channel whatsapp

# Restart the gateway
openclaw gateway restart

# Rebuild skills index
openclaw skill rebuild

# Check for conflicts
openclaw doctor --check skills

الحصول على المساعدة

• التوثيق الرسمي: docs.openclaw.ai
• مشكلات GitHub: github.com/openclaw/openclaw/issues
• مجتمع Discord: discord.gg/openclaw
• Reddit: r/OpenClaw

تفصيل التكاليف

برنامج OpenClaw نفسه مجاني. تأتي تكاليفك من استخدام API للذكاء الاصطناعي:

نصائح لتوفير التكاليف

1. استخدم DeepSeek للمهام الروتينية (0.14 دولار لكل مليون رمز مقابل 3 دولارات في Claude)
2. النماذج المحلية للاستفسارات البسيطة (مجانية بعد تكلفة العتاد)
3. ضبط حدود الرموز لكل محادثة
4. استخدام التخزين المؤقت (caching) للاستفسارات المتكررة

ما هي الخطوة التالية؟

الآن بعد أن أصبح OpenClaw قيد التشغيل، إليك بعض الأفكار:

بناء مهاراتك الخاصة

أنشئ مهارات مخصصة لاحتياجاتك المحددة:

# Create a new skill
openclaw skill create my-custom-skill

# Edit the skill
code ~/.openclaw/skills/my-custom-skill/SKILL.md

ربط المزيد من المنصات

• أضف حسابات WhatsApp متعددة (شخصي + عمل)
• اربط Slack للعمل، و Discord للاستخدام الشخصي
• قم بإعداد iMessage لنظام Apple

استكشف النظام البيئي

• تصفح ClawHub لأكثر من 3000 مهارة
• انضم إلى مجتمع Discord للحصول على نصائح وحيل
• تابع @OpenClaw للحصول على التحديثات

للمزيد: ابدأ بإطلاق منتجات الذكاء الاصطناعي الخاصة بك

بمجرد أن تختبر قوة مساعدي الذكاء الاصطناعي، قد ترغب في بناء منتجات للآخرين. وهنا يأتي دور Y Build.

يساعدك Y Build على الانتقال من فكرة مدعومة بالذكاء الاصطناعي إلى منتج تم إطلاقه:

1. البرمجة بالذكاء الاصطناعي: صف ما تريده، وسيقوم الذكاء الاصطناعي بتوليد الكود
2. النشر بنقرة واحدة: انطلق مباشرة باستخدام CDN عالمي
3. أدوات النمو: فيديوهات تجريبية، تحسين محركات البحث (SEO)، والتحليلات

• أداة SaaS مدعومة بالذكاء الاصطناعي
• منصة أتمتة مثل OpenClaw
• بوت دردشة مخصص لعملك

الخاتمة

يمثل OpenClaw نموذجاً جديداً في الذكاء الاصطناعي الشخصي — مساعد يتميز بكونه:

• محلياً: بياناتك لا تغادر جهازك أبداً
• قوياً: الوصول الكامل للنظام يعني أتمتة حقيقية
• قابلاً للتوسع: أكثر من 3000 مهارة وفي ازدياد
• متعدد المنصات: ذكاء اصطناعي واحد، متاح في كل مكان

• الإجابة على الأسئلة من WhatsApp الخاص بك
• البحث وتنظيم ملفاتك
• أتمتة المهام المتكررة
• التحكم في منزلك الذكي
• وأكثر من ذلك بكثير

مرحباً بك في مجتمع OpenClaw. 🦞

• OpenClaw Official Documentation
• OpenClaw GitHub Repository
• ClawHub Skills Registry
• Codecademy: OpenClaw Tutorial
• DigitalOcean: What is OpenClaw
• Hostinger: How to Set Up OpenClaw
• CNBC: From Clawdbot to OpenClaw
• Medium: Running OpenClaw Safely with Docker