دليل شامل لتثبيت مساعد الذكاء الاصطناعي Clawdbot على macOS وLinux وWindows. تثبيت سريع بأمر واحد أو خيارات الإعداد اليدوي.

نظرة عامة على تثبيت Clawdbot

استخدم مثبّت Clawdbot ما لم يكن لديك سبب محدد لعدم استخدامه. يقوم بإعداد واجهة سطر الأوامر وتشغيل عملية الإعداد الأولي تلقائياً.

التثبيت السريع (موصى به)

ثبّت Clawdbot بأمر واحد:

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

Windows (PowerShell):

iwr -useb https://clawd.bot/install.ps1 | iex

الخطوة التالية (إذا تخطيت الإعداد الأولي):

clawdbot onboard --install-daemon

متطلبات النظام

المتطلب	التفاصيل
Node.js	الإصدار 22 أو أعلى
نظام التشغيل	macOS أو Linux أو Windows عبر WSL2
pnpm	مطلوب فقط عند البناء من الكود المصدري

اختر طريقة التثبيت

1. سكريبت التثبيت (موصى به)

يقوم مثبّت Clawdbot بالتثبيت العام عبر npm وتشغيل الإعداد الأولي:

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

خيارات المثبّت:

curl -fsSL https://clawd.bot/install.sh | bash -s -- --help

غير تفاعلي (تخطي الإعداد الأولي):

curl -fsSL https://clawd.bot/install.sh | bash -s -- --no-onboard

2. التثبيت العام (يدوي)

إذا كان لديك Node.js مثبتاً بالفعل:

npm install -g clawdbot@latest

إذا كان لديك libvips مثبتاً عالمياً وفشل sharp:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g clawdbot@latest

باستخدام pnpm:

pnpm add -g clawdbot@latest
pnpm approve-builds -g  # الموافقة على clawdbot وnode-llama-cpp وsharp وغيرها

ثم شغّل الإعداد الأولي:

clawdbot onboard --install-daemon

3. من الكود المصدري (للمساهمين/التطوير)

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build
pnpm build
clawdbot onboard --install-daemon

4. خيارات تثبيت أخرى

Docker: راجع تثبيت Docker
Nix: راجع تثبيت Nix
Ansible: راجع تثبيت Ansible

بعد التثبيت

شغّل هذه الأوامر للتحقق من تثبيت Clawdbot:

# تشغيل الإعداد الأولي
clawdbot onboard --install-daemon

# فحص سريع
clawdbot doctor

# التحقق من صحة البوابة
clawdbot status
clawdbot health

# فتح لوحة التحكم
clawdbot dashboard

طريقة التثبيت: npm مقابل git

يدعم مثبّت Clawdbot طريقتين:

الطريقة	الوصف
`npm` (افتراضي)	`npm install -g clawdbot@latest`
`git`	استنساخ/بناء من الكود المصدري على GitHub

خيارات CLI:

# npm صريح
curl -fsSL https://clawd.bot/install.sh | bash -s -- --install-method npm

# التثبيت من GitHub (checkout الكود المصدري)
curl -fsSL https://clawd.bot/install.sh | bash -s -- --install-method git

الخيارات الشائعة:

الخيار	الوصف
`--install-method npm\|git`	اختيار طريقة التثبيت
`--git-dir <path>`	مجلد Git (افتراضي: ~/clawdbot)
`--no-git-update`	تخطي git pull للـ checkout الموجود
`--no-prompt`	تعطيل المطالبات (لـ CI/الأتمتة)
`--dry-run`	عرض ما سيحدث
`--no-onboard`	تخطي الإعداد الأولي

متغيرات البيئة

للأتمتة، استخدم متغيرات البيئة هذه:

CLAWDBOT_INSTALL_METHOD=git|npm
CLAWDBOT_GIT_DIR=...
CLAWDBOT_GIT_UPDATE=0|1
CLAWDBOT_NO_PROMPT=1
CLAWDBOT_DRY_RUN=1
CLAWDBOT_NO_ONBOARD=1
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1

استكشاف الأخطاء: clawdbot غير موجود (PATH)

تشخيص سريع:

node -v
npm -v
npm prefix -g
echo "$PATH"

إذا لم يكن $(npm prefix -g)/bin في PATH الخاص بك، أضفه إلى ملف بدء التشغيل الخاص بك:

macOS / Linux (~/.zshrc أو ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

Windows: أضف ناتج npm prefix -g إلى متغير البيئة PATH.

ثم افتح طرفية جديدة أو شغّل hash -r (bash) / rehash (zsh).

التحديث / إلغاء التثبيت

التحديثات: راجع تحديث Clawdbot
إلغاء التثبيت: راجع إلغاء تثبيت Clawdbot

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

دليل إعداد Clawdbot - دليل الإعداد الكامل
بوابة Clawdbot - تكوين البوابة
Clawdbot WhatsApp - الاتصال بـ WhatsApp

دليل تثبيت Clawdbot