الدليل الرسمي

ابدأ مع OpenClaw

Your journey to AI autonomy starts here. Follow these steps to install your own personal agent.

Jump To:

1

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

Before you invite a space lobster into your machine, ensure you have:

Hardware

  • Mac (M1 or newer recommended)
  • Windows (WSL2 recommended)
  • Linux (Ubuntu 22.04+)
  • 8GB RAM minimum (16GB preferred)

Software

  • Node.js v20+
  • Docker (optional but recommended)
  • Git
2

التثبيت

اسهل طريقة لتثبيت OpenClaw هي عبر سطر الاوامر.

bash
npx openclaw@latest init

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

  • Check your system compatibility
  • تنزيل محرك OpenClaw الاساسي
  • Create a ~/.openclaw configuration folder
  • Prompt you to select your preferred LLM provider (Anthropic, OpenAI, or Local)
ℹ️
Note for Windows Users: We strongly recommend running this inside WSL2 (Ubuntu) for the best experience with file system permissions.
3

الإعداد

Once installed, you can talk to your agent via the terminal:

...
bash
openclaw chat

Connecting Chat Apps

To make your agent useful, connect it to where you hang out. Run:

...
bash
openclaw connect telegram

Follow the prompts to enter your Bot Token (get this from BotFather on Telegram). You can repeat this for Discord, Slack, or WhatsApp.

4

السلامة أولاً

⚠️
تحذير خطير: لدى OpenClaw وصول حقيقي الى نظامك.
اقرا التحليل الكامل ل مخاطر الامان قبل المتابعة.
تحقق اولا
فحص محلي فقط
By default, OpenClaw runs in "Ask Permission" mode. It will ask you before executing any shell command or modifying files. Do not disable this until you are comfortable with how it behaves.
Your API keys are stored in ~/.openclaw/config.yaml. Ensure this file is never shared or committed to public version control.

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

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

Ensure your keys (Anthropic, OpenAI, etc.) are complete and include any required prefixes. Double-check your ~/.openclaw/config.yaml or your project's .env file.

تم رفض الإذن (macOS)

OpenClaw requires specific permissions for background tasks. If an agent fails to run a command, check System Settings > Privacy & Security and ensure your terminal has "Full Disk Access".

تعارض في نسخة Node.js

يتطلب الاطار Node.js 18+. If you encounter "Module not found" or syntax errors, verify your version with node -v and update if necessary.

تعارض المنافذ (5173)

If the monitoring dashboard fails to start, ensure port 5173 is not being used by another Vite application. You can force a port in vite.config.js.