دليل تركيب thClaws: منصة وكيل ذكاء اصطناعي مفتوحة المصدر تعمل محلياً على جهازك
Open-source agent harness platform. Native Rust, multi-provider, runs on your own machine. Sovereign by design.
خريطة الصفحة
اختر القسم الذي تحتاجه الآن
- ما هو thClaws؟
- من يحتاج thClaws ومن لا؟
- المميزات الرئيسية
- المتطلبات الأساسية
- خطوات التركيب
- تهيئة secrets backend
- أول تشغيل واختبار
- الأخطاء الشائعة وحلولها
- استخدامات عملية في السياق السعودي
- هل يستحق التجربة؟
- بدائل مشابهة
- الأسئلة الشائعة
قبل أن تطبق
الفكرة التي تمنع التسرع
تعتقد أن مشاريع GitHub الجديدة مثل thClaws مخصصة للمطورين المحترفين فقط؟ الحقيقة أن أي مطور متوسط يمكنه تركيبها والاستفادة منها في يوم واحد.
أسئلة التشخيص السريع
قبل أن تطبق، اعرف أين تقف بالضبط
- هل جهازك يعمل بنظام macOS أو Windows أو Linux؟
- هل لديك Git و Rust (cargo) مثبتين؟
- هل لديك Node.js و pnpm مثبتين؟
- هل لديك مفتاح API صالح من أحد المزودين (OpenAI، Anthropic، Google)؟
- هل تفضل تخزين المفاتيح في keychain النظام أم في ملف .env؟
- هل تريد بناء النسخة بواجهة رسومية أم سطر أوامر فقط؟
- هل تواجه مشكلة في بناء المشروع (Build failed)؟
نظام التشغيل: Input → Process → Output
لوحة قياس النجاح
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
thClaws منصة وكيل ذكاء اصطناعي مفتوحة المصدر، مكتوبة بلغة Rust، وتعمل على جهازك المحلي. تدعم عدة مزودين مثل OpenAI وAnthropic، وتتيح لك بناء فرق وكلاء (agent teams) لأتمتة المهام. في هذا الدليل، سنشرح خطوات التركيب خطوة بخطوة، مع أمثلة عملية تناسب المطور العربي.
ما هو thClaws؟
thClaws هي منصة (agent harness) تسمح لك بإنشاء وكلاء ذكاء اصطناعي يعملون على جهازك. الفرق بينها وبين أدوات مثل Claude Code أنها مفتوحة المصدر بالكامل، وتدعم عدة مزودين، وتركز على الخصوصية (جميع المفاتيح مخزنة في keychain النظام).
من يحتاج thClaws ومن لا؟
يناسب: المطورين الذين يريدون أتمتة مهام البرمجة والتحليل، الباحثين عن بديل مفتوح للأدوات السحابية، الشركات الناشئة التي تريد تقليل تكاليف APIs.
لا يناسب: غير المبرمجين (يتطلب معرفة بسطر الأوامر)، من يحتاج واجهة رسومية متكاملة (الواجهة حالياً تجريبية)، من يريد دعماً فنياً فورياً.
المميزات الرئيسية
- مفتوح المصدر (رخصة Apache-2.0)
- يدعم عدة مزودين: OpenAI, Anthropic, Google, وأي مزود متوافق مع API
- يعمل محلياً: لا حاجة لسحابة، بياناتك على جهازك
- إدارة آمنة للمفاتيح: تخزين في keychain النظام أو ملف .env
- واجهة رسومية (Tauri) وسطر أوامر
- يدعم فرق وكلاء (agent teams) للتنسيق بين مهام متعددة
المتطلبات الأساسية
- نظام تشغيل: macOS, Windows, أو Linux
- Git
- Rust (cargo) مثبت
- Node.js و pnpm (لبناء الواجهة)
- مفتاح API من أحد المزودين (مثل OpenAI)
خطوات التركيب
1. استنساخ المستودع
git clone https://GitHub.com/thClaws/thClaws.git
cd thClaws2. بناء الواجهة الرسومية
cd frontend
pnpm install
pnpm build
cd ..3. بناء الباك إند (thclaws)
cargo build --release --features gui --bin thclawsملاحظة: إذا أردت نسخة بدون واجهة رسومية، استخدم cargo build --release --bin thclaws.
تهيئة secrets backend
عند أول تشغيل، سيُطلب منك اختيار طريقة تخزين المفاتيح:
- OS keychain (افتراضي): المفاتيح تخزن في keychain النظام (آمن).
- .env: ملف في مجلد المشروع (أقل أماناً، لكن أسهل للنقل).
نموذج ملف .env:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...تحذير: لا تشارك ملف .env أبداً، وأضفه إلى .gitignore.
أول تشغيل واختبار
./target/release/thclawsبعد التشغيل، ستظهر واجهة سطر أوامر تفاعلية. جرب الأمر التالي:
مرحباً، اكتب لي دالة بلغة Python لحساب مضروب عدد.إذا اشتغل، فأنت جاهز.
الأخطاء الشائعة وحلولها
استخدامات عملية في السياق السعودي
مثال 1: أتمتة كتابة تقرير أسبوعي
اطلب من thClaws تحليل ملف CSV لمبيعات متجرك الإلكتروني وإنشاء تقرير بصيغة PDF.
مثال 2: مراجعة كود مشروع مفتوح
استخدم thClaws لمراجعة Pull Request على GitHub وإخراج ملخص بالأخطاء والتحسينات.
مثال 3: مساعد بحثي
حمّل ملفات PDF واطلب ملخصاً لكل فصل.
هل يستحق التجربة؟
نعم، إذا كنت مطوراً وتبحث عن أداة AI محلية، مرنة، ومفتوحة المصدر. لكن لا تتوقع واجهة ناضجة بعد؛ المشروع لا يزال في مرحلة مبكرة.
بدائل مشابهة
الأسئلة الشائعة
هل thClaws مجاني بالكامل؟
نعم، البرنامج مجاني، لكنك تدفع مقابل استخدام APIs (مثل OpenAI).
ما الفرق بين thClaws وClaude Code؟
thClaws مفتوح المصدر ويدعم عدة مزودين، Claude Code مغلق ومخصص لـ Anthropic.
هل يمكن استخدام thClaws مع نماذج محلية مثل Llama؟
نظرياً نعم، إذا وفرت واجهة API متوافقة (مثل ollama). لكن README لا يذكر دعماً صريحاً.
هل thClaws يدعم اللغة العربية؟
النموذج المستخدم هو الذي يحدد دعم العربية. إذا استخدمت GPT-4 أو Claude، فسيفهم العربية.
Playbook التطبيق
خطوات عملية مرتبة من التشخيص إلى النتيجة
استنساخ المستودع
لماذا؟ للحصول على الكود المصدري لـ thClaws
كيف؟ git clone https://github.com/thClaws/thClaws.git && cd thClaws
الناتج: مجلد thClaws يحتوي على الكود
بناء الواجهة الرسومية
لماذا؟ لتوفير واجهة مستخدم رسومية (Tauri)
كيف؟ cd frontend && pnpm install && pnpm build && cd ..
الناتج: ملفات الواجهة الجاهزة في frontend/dist
بناء الباك إند
لماذا؟ لتجميع thClaws مع دعم الواجهة الرسومية
كيف؟ cargo build --release --features gui --bin thclaws
الناتج: ملف تنفيذي في target/release/thclaws
تهيئة secrets backend
لماذا؟ لتخزين مفاتيح API بشكل آمن
كيف؟ شغل thclaws لأول مرة واختر OS keychain أو .env، ثم أدخل المفاتيح
الناتج: تخزين المفاتيح في keychain أو ملف .env
أول تشغيل واختبار
لماذا؟ للتحقق من أن thClaws يعمل بشكل صحيح
كيف؟ ./target/release/thclaws ثم اكتب: مرحباً، اكتب لي دالة بلغة Python لحساب مضروب عدد
الناتج: استجابة من الوكيل تحتوي على كود Python
قوالب جاهزة للنسخ
حوّل القراءة إلى تنفيذ سريع
OPENAI_API_KEY=sk-... ANTHROPIC_API_KEY=sk-ant-... GOOGLE_API_KEY=...
cargo build --release --bin thclaws
مصفوفة الأخطاء
اعرف أين يتعثر الناس وكيف تتجنب ذلك
شجرة القرار
ماذا تفعل حسب حالتك؟
إذا: إذا كنت تريد واجهة رسومية
إذن: اتبع خطوات بناء الواجهة الرسومية (pnpm install && pnpm build)
إذا: إذا كنت تفضل سطر الأوامر فقط
إذن: استخدم cargo build --release --bin thclaws (بدون --features gui)
إذا: إذا كنت تريد تخزين المفاتيح بشكل آمن
إذن: اختر OS keychain عند أول تشغيل
إذا: إذا كنت تريد سهولة النقل
إذن: اختر .env وأضف المفاتيح
خطة تطبيق 7 أيام
جدول صغير يمنع التسويف
- اليوم 1: تثبيت المتطلبات (Git, Rust, Node.js, pnpm)
- اليوم 2: استنساخ المستودع وبناء الواجهة
- اليوم 3: بناء الباك إند وتهيئة secrets
- اليوم 4: أول تشغيل واختبار أمر بسيط
- اليوم 5: تجربة مثال عملي (تقرير أسبوعي)
- اليوم 6: تجربة مثال عملي (مراجعة كود)
- اليوم 7: استكشاف الأخطاء وتحسين الإعدادات
حقائق سريعة تحفظها
نقاط مختصرة ترجع لها لاحقاً
1. thClaws مكتوب بلغة Rust لضمان السرعة والأمان.
2. يدعم مزودين متعددين: OpenAI, Anthropic, Google.
3. جميع المفاتيح مخزنة محلياً في keychain النظام أو ملف .env.
4. الواجهة الرسومية مبنية باستخدام Tauri (Rust + Web).
5. المشروع مرخص تحت Apache-2.0.
6. يمكن استخدامه مع نماذج محلية مثل Llama عبر واجهة API متوافقة.
7. يتطلب معرفة بسطر الأوامر، غير مناسب لغير المبرمجين.
8. المشروع لا يزال في مرحلة مبكرة، الواجهة تجريبية.
أسئلة شائعة
إجابات مباشرة على ما يبحث عنه الزائر
مصطلحات سريعة
تعريفات مختصرة تمنع الالتباس
منصة تسمح بإنشاء وإدارة وكلاء ذكاء اصطناعي.
نظام تخزين آمن للمفاتيح في نظام التشغيل (مثل macOS Keychain).
إطار عمل لبناء تطبيقات سطح المكتب باستخدام Rust و Web.
مجموعة من الوكلاء تعمل معاً لتنسيق مهام متعددة.
أسئلة مرتبطة يبحث عنها الناس
استخدمها كمسارات متابعة داخل نفس الموضوع
لماذا هذا المرجع يتجاوز الموضوع نفسه؟
تحول القارئ: من مطور يظن أن أدوات AI المحلية معقدة، إلى مطور قادر على تركيب وتشغيل thClaws واستخدامه في مشاريعه اليومية
- أمن المعلومات: تخزين المفاتيح بأمان
- تطوير البرمجيات: بناء وكلاء AI
- ريادة الأعمال: تقليل تكاليف APIs للشركات الناشئة
- البحث العلمي: استخدام AI في تحليل البيانات
كيف تستخدم هذا المرجع لاحقاً؟
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
thClaws أداة واعدة لمطوري الذكاء الاصطناعي الذين يريدون الخصوصية والتحكم الكامل. التركيب بسيط إذا اتبعت الخطوات، والتجربة الأولى مشجعة. جربه اليوم وشاركنا رأيك.
خطة تحديث هذا الدليل
حتى يبقى المرجع صالحاً مع الوقت
- تحديث روابط المستودع إذا تغيرت
- إضافة دعم مزودين جدد (مثل Mistral)
- تحديث خطوات البناء إذا تغيرت تعليمات المشروع
- إضافة أمثلة عملية جديدة تناسب السياق المحلي
- مراجعة قسم الأخطاء الشائعة بناءً على تجارب المستخدمين
التعليقات (0)
لا توجد تعليقات بعد. كن أول من يبدأ النقاش 👇