> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wolffi.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# قناة Telegram

> ربط وولف فيش بـ Telegram كبوت شخصي

# بوت Telegram الشخصي

تحوّل قناة Telegram تطبيق وولف فيش إلى بوت شخصي يستجيب لرسائلك الخاصة. نفس الذكاء، ونفس القدرات، متاح من أي جهاز مثبّت عليه Telegram.

## الإعداد

<Tabs>
  <Tab title="الخطوة 1: إنشاء البوت">
    افتح Telegram وأرسل رسالة إلى [@BotFather](https://t.me/BotFather):

    ```
    /newbot
    ```

    اتبع التعليمات لتسمية البوت. سيمنحك BotFather رمزًا (token) مثل:

    ```
    7123456789:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw
    ```

    انسخ هذا الرمز.
  </Tab>

  <Tab title="الخطوة 2: تهيئة وولف فيش">
    في وولف فيش، افتح **الإعدادات > Telegram** والصق رمز البوت. اضغط **اتصال**.

    سيتحقق وولف فيش من الرمز ويؤكد الاتصال. البوت الآن يعمل.
  </Tab>

  <Tab title="الخطوة 3: ابدأ المحادثة">
    افتح البوت في Telegram (ابحث عن اسم المستخدم الخاص به) وأرسل أي رسالة. سيستجيب وولف فيش عبر نفس خط معالجة الذكاء المستخدم في واجهة سطح المكتب.
  </Tab>
</Tabs>

<Warning>
  حافظ على سرية رمز البوت. أي شخص يملك الرمز يمكنه استقبال الرسائل المرسلة إلى البوت. في حال تسرّبه، قم بإلغائه عبر BotFather بأمر `/revoke` ثم أعد التهيئة في وولف فيش.
</Warning>

## الأوامر

يتعرّف البوت على أوامر الشرطة المائلة التالية:

| الأمر      | الإجراء                                              |
| ---------- | ---------------------------------------------------- |
| `/stop`    | إلغاء المهمة الجارية حاليًا                          |
| `/new`     | بدء محادثة جديدة                                     |
| `/resume`  | متابعة المحادثة السابقة                              |
| `/delete`  | حذف المحادثة الحالية                                 |
| `/current` | عرض المحادثة النشطة                                  |
| `/status`  | تقرير النظام (النموذج، استخدام الذاكرة، وقت التشغيل) |
| `/local`   | التبديل إلى النموذج المحلي (Ollama)                  |
| `/cloud`   | التبديل إلى النموذج السحابي (Claude/OpenAI)          |

## آلية الموافقة

عندما تُصنّف الـ amygdala استدعاء أداة على أنه قد يكون خطيرًا، يرسل وولف فيش لوحة أزرار مضمّنة في Telegram:

```
Wolffish wants to execute:
  shell_exec: rm -rf ./build/

[Approve] [Deny]
```

اضغط **Approve** للمتابعة أو **Deny** للإلغاء. يتوقف الدور حتى تستجيب — لا مهلة زمنية، ولا موافقة تلقائية.

<Info>
  تتضمن طلبات الموافقة اسم الأداة الكامل ومعاملاتها حتى تتمكن من اتخاذ قرار مستنير. الأوامر الخطرة (حذف الملفات، طلبات الشبكة، تعديلات النظام) تتطلب دائمًا موافقة.
</Info>

## إدارة المحادثات

كل محادثة في Telegram ترتبط بمحادثة في وولف فيش. الربط يعمل كالتالي:

* **المحادثة الخاصة مع البوت** = سلسلة محادثة واحدة
* استخدم `/new` لبدء محادثة جديدة (المحادثة السابقة محفوظة في الذاكرة)
* استخدم `/resume` للعودة إلى آخر محادثة نشطة
* استخدم `/delete` لحذف المحادثة الحالية من السجل

المحادثات مشتركة بين القنوات. محادثة بدأت في Telegram تظهر في قائمة محادثات واجهة Electron، والعكس صحيح.

## معالجة الملفات

يمكن للبوت استقبال ومعالجة:

* **الصور** — لقطات شاشة، صور، مخططات (تُعالج عبر قدرات الرؤية)
* **المستندات** — ملفات بي دي اف، ملفات نصية، ملفات برمجية (يُستخرج المحتوى ويُمرّر للذكاء)
* **الرسائل الصوتية** — تُحوّل لنص عبر تقنية تحويل الكلام إلى نص وتُعالج كمدخل نصي

أرسل ملفًا مع أو بدون تعليق. إذا أرفقت تعليقًا، يصبح رسالة المستخدم مع الملف كسياق. إذا لم يكن هناك تعليق، يستنتج وولف فيش القصد من محتوى الملف.

## تنسيق الردود

ينسّق وولف فيش الردود باستخدام مجموعة HTML الفرعية في Telegram:

```html theme={null}
<b>bold</b>
<i>italic</i>
<code>inline code</code>
<pre>code block</pre>
<a href="url">link text</a>
```

تُقسّم الردود الطويلة عند حدود منطقية (فواصل الفقرات، عناصر القوائم) للبقاء ضمن حدود طول الرسائل في Telegram. تُحافظ كتل الشفرة البرمجية على سلامتها قدر الإمكان.

## نتائج المهام المفصّلة

افتراضيًا يستقبل Telegram **تغذية نظيفة** — ردود الوكيل، وأي ملفات يُنتجها، والأخطاء. أما خطوات الأدوات التفصيلية فتبقى في واجهة سطح المكتب حتى لا تمتلئ محادثتك بالخطوات الداخلية.

بدّل ذلك من **الإعدادات → القنوات → Telegram → نتائج المهام المفصّلة**:

* **إيقاف (الافتراضي)** — رسائل الوكيل والنتائج الحاملة للملفات والأخطاء فقط.
* **تشغيل** — يُعاد بثّ كل استدعاء أداة وكل نتيجة وكل نشاط إلى المحادثة لحظة حدوثه.

<Note>
  لا يغيّر الوضع المفصّل سوى ما يُرسَل إلى Telegram. أما الدور كاملًا — كل استدعاء أداة ونتيجته — فيُحفظ في السجل والذاكرة بغضّ النظر عن الإعداد.
</Note>

## التفاصيل التقنية

قناة Telegram مبنية على مكتبة [Grammy](https://grammy.dev/) — إطار عمل حديث مكتوب بـ TypeScript لبناء بوتات Telegram. تتولى Grammy:

* الاستطلاع المطوّل لتحديثات الرسائل
* إدارة لوحات الأزرار المضمّنة للموافقات
* رفع وتنزيل الملفات
* تنسيق الرسائل وتقسيمها
* استرداد الأخطاء وإعادة الاتصال

## فلتر البيانات الحساسة

يتضمن وولف فيش فلتراً اختيارياً يتجاهل الرسائل التي تحتوي على بيانات اعتماد قبل وصولها للوكيل. هو **معطّل افتراضياً** — مناقشة الأسرار جزء مشروع من كثير من سير العمل (إعداد التكاملات، تصحيح المصادقة، تدوير المفاتيح).

**لتفعيله:** الإعدادات → وولف فيش → حجب البيانات الحساسة في الرسائل

عند التفعيل، أي رسالة واردة تطابق نمط بيانات اعتماد تُتجاهل فوراً بالكامل. لا يُعالج الدور، ولا يُحفظ شيء، ويتلقى المستخدم إشعاراً قصيراً. ينطبق هذا بالتساوي على سطح المكتب وTelegram وWhatsApp.

**الأنماط المكتشفة:** كلمات المرور (`password:`، `my password is...`)، مفاتيح API (`api_key:`، `secret_key:`)، رموز الوصول (`access_token:`، `bearer_token:`)، المفاتيح الخاصة SSH/RSA/PGP (`-----BEGIN PRIVATE KEY-----`)، عبارات المفاتيح الخاصة (`private_key:`، `ssh_key:`).

<Note>
  عندما يكون الفلتر معطّلاً (الافتراضي)، تُعالج الرسائل بشكل طبيعي بغض النظر عن محتواها. إذا كنت تعمل مع بيانات الاعتماد بشكل متكرر، فهذا سلوك متوقع — خزّن الأسرار في الإعدادات → المتغيرات بدلاً من لصقها في المحادثة.
</Note>