بناء مساعد شخصي

نظرة عامة

يعمل Clawdbot كبوابة تربط منصات المراسلة بوكلاء الذكاء الاصطناعي، مما يتيح لك التفاعل مع مساعد ذكاء اصطناعي من خلال تطبيق المراسلة المفضل لديك.

اعتبارات الأمان

يمكن لـ Clawdbot تنفيذ الأوامر والوصول إلى الملفات وإرسال الرسائل. إجراءات الأمان المهمة:

• قم بتعيين channels.whatsapp.allowFrom لتقييد الوصول
• استخدم رقم هاتف مخصص للمساعد
• ابدأ مع تعطيل نبضات القلب ("0m") حتى الوثوق
• راجع الأذونات قبل منح الوصول إلى shell

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

• Node.js 22+
• تثبيت Clawdbot عالمياً
• رقم هاتف ثانٍ للمساعد (موصى به)

الهيكلية الموصى بها

استخدم هاتفين للإعداد الأكثر أماناً:

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  هاتفك          │────▶│  المساعد        │────▶│  جهاز الكمبيوتر │
│  (الشخصي)       │     │  رقم الهاتف     │     │  (Clawdbot)     │
└─────────────────┘     └─────────────────┘     └─────────────────┘

يرسل جهازك الشخصي رسائل إلى هاتف ثانٍ (المساعد) المرتبط بـ Clawdbot الذي يعمل على جهاز الكمبيوتر الخاص بك.

البدء السريع

1. ربط WhatsApp Web

clawdbot channels login whatsapp

امسح رمز QR بهاتف المساعد الخاص بك.

2. بدء البوابة

clawdbot gateway --port 18789

3. تكوين قائمة السماح

عدّل ~/.clawdbot/clawdbot.json:

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+1234567890"],
      "dmPolicy": "allowlist"
    }
  }
}

مساحة العمل والذاكرة

مساحة العمل الافتراضية

الموقع: ~/.clawdbot/workspace

يحتوي على ملفات التعليمات:

التحكم في الإصدارات

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

cd ~/.clawdbot/workspace
git init
git add .
git commit -m "Initial workspace"

الجلسات

يتم تخزين الجلسات لكل مرسل. أوامر إدارة الجلسات:

نبضات القلب (المهام الاستباقية)

نبضات القلب هي فحوصات دورية حيث يقرأ الوكيل HEARTBEAT.md للمهام.

التكوين

في ~/.clawdbot/clawdbot.json:

{
  "heartbeat": {
    "interval": "30m",
    "enabled": true
  }
}

السلوك

• الافتراضي: كل 30 دقيقة
• يقرأ الوكيل HEARTBEAT.md للمهام المعلقة
• يستجيب بـ HEARTBEAT_OK إذا لم يكن هناك شيء يحتاج انتباه
• اضبط على "0m" للتعطيل

مثال HEARTBEAT.md

# مهام نبضات القلب

- التحقق من رسائل البريد الإلكتروني الجديدة وتلخيص المهمة منها
- مراجعة التقويم للاجتماعات القادمة
- مراقبة أسعار الأسهم لـ AAPL، GOOGL

معالجة الوسائط

المرفقات الواردة

يمكن لـ Clawdbot استلام ومعالجة:

• الصور
• المستندات
• الملاحظات الصوتية
• مقاطع الفيديو

الوسائط الصادرة

أرسل الوسائط باستخدام صيغة MEDIA:<path>:

MEDIA:/path/to/image.png

العمليات

أوامر الحالة

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

# عرض الحالة
clawdbot status

# التحقق من السجلات
tail -f /tmp/clawdbot/gateway.log

التسجيل

يتم تخزين السجلات في /tmp/clawdbot/:

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

قم بتكوين قنوات متعددة في clawdbot.json:

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "allowFrom": ["+1234567890"]
    },
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    },
    "discord": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

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

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