دليل الإعداد الكامل لـ Clawdbot بما في ذلك التثبيت والتكوين وسير العمل التطويري.

مواقع التخزين

يفصل Clawdbot التكوين عن التثبيت:

الموقع	الغرض
`~/.clawdbot/workspace`	ملفات مساحة العمل الخاصة بك
`~/.clawdbot/clawdbot.json`	التكوين الرئيسي
`~/.clawdbot/credentials/`	رموز المصادقة

يسمح هذا الفصل بتحديثات سهلة دون تعطيل التكوينات الشخصية.

المتطلبات الأساسية

Node.js >= 22
pnpm (موصى به) أو npm
Docker (اختياري، للإعداد في حاويات)

طرق التثبيت

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

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

عبر npm

npm i -g clawdbot
clawdbot setup

عبر pnpm

pnpm add -g clawdbot
clawdbot setup

سير العمل

سير العمل المستقر (تطبيق macOS)

لمعظم المستخدمين، يوفر تطبيق macOS أسهل تجربة:

التثبيت - تنزيل وإطلاق Clawdbot.app
الإعداد - إكمال معالج الإعداد
الأذونات - منح الوصول المطلوب للنظام
وضع البوابة - التأكد من أن البوابة في الوضع المحلي
القنوات - ربط قنوات الاتصال (WhatsApp، Telegram، إلخ)
التحقق - تشغيل clawdbot health لتأكيد الإعداد

سير العمل التطويري

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

# استنساخ المستودع
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# تثبيت التبعيات
pnpm install

# بدء بوابة التطوير مع إعادة التحميل التلقائي
pnpm gateway:watch

قم بتكوين تطبيق macOS لوضع الاتصال المحلي. يتصل التطبيق بالبوابة العاملة على المنفذ المكوّن (افتراضي: ws://127.0.0.1:18789).

تخزين بيانات الاعتماد

النوع	الموقع
WhatsApp	`~/.clawdbot/credentials/whatsapp/<accountId>/creds.json`
Telegram	`~/.clawdbot/credentials/telegram/`
الجلسات	`~/.clawdbot/agents/<agentId>/sessions/`
OAuth	`~/.clawdbot/credentials/oauth.json`
السجلات	`/tmp/clawdbot/`

ملاحظات المنصة

macOS

يدير التطبيق البوابة تلقائياً عبر LaunchAgent.

Linux

يستخدم خدمة مستخدم systemd. فعّل lingering لمنع إيقاف الخدمة عند تسجيل الخروج:

sudo loginctl enable-linger $USER

Windows (WSL2)

قم بتشغيل Clawdbot داخل WSL2 مع توزيعة Linux. الإعداد مطابق لـ Linux.

استراتيجية التحديث

احتفظ بالمحتوى الشخصي في مجلدات ~/.clawdbot/ بشكل منفصل عن التثبيت:

# التحديث عبر npm
npm update -g clawdbot

# أو سحب أحدث الشفرة المصدرية
cd clawdbot
git pull
pnpm install

تبقى مساحة العمل والتكوين الخاصة بك سليمة عبر التحديثات.

فحص الصحة

تحقق من التثبيت الخاص بك:

clawdbot health

الإخراج المتوقع:

حالة البوابة: قيد التشغيل
المنفذ: 18789
القنوات: متصلة
الوكيل: جاهز

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

البوابة لا تبدأ

تحقق مما إذا كان المنفذ 18789 قيد الاستخدام: lsof -i :18789
راجع السجلات: cat /tmp/clawdbot/gateway.log
إعادة تعيين التكوين: clawdbot configure --reset

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

إعادة المصادقة: clawdbot channels login
التحقق من بيانات الاعتماد: ls ~/.clawdbot/credentials/
التحقق من قائمة السماح: فحص clawdbot.json

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

معالج الإعداد - إعداد موجه
الربط - التحكم في الوصول
المساعد الشخصي - بناء مساعدك

دليل الإعداد

On this page