Reference OS v8 5 دقائق قراءة ٢٠ مايو ٢٠٢٦ informational: يبحث القارئ عن شرح عملي لتركيب مشروع thClaws على GitHub وكيفية استخدامه دليل تركيب thClaws: منصة وكيل ذكاء اصطناعي مفتوحة المصدر تعمل محلياً…

Open-source agent harness platform. Native Rust, multi-provider, runs on your own machine. Sovereign by design.
اختر القسم الذي تحتاجه الآن
الفكرة التي تمنع التسرع
تعتقد أن مشاريع GitHub الجديدة مثل thClaws مخصصة للمطورين المحترفين فقط؟ الحقيقة أن أي مطور متوسط يمكنه تركيبها والاستفادة منها في يوم واحد.
قبل أن تطبق، اعرف أين تقف بالضبط
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
thClaws منصة وكيل ذكاء اصطناعي مفتوحة المصدر، مكتوبة بلغة Rust، وتعمل على جهازك المحلي. تدعم عدة مزودين مثل OpenAI وAnthropic، وتتيح لك بناء فرق وكلاء (agent teams) لأتمتة المهام. في هذا الدليل، سنشرح خطوات التركيب خطوة بخطوة، مع أمثلة عملية تناسب المطور العربي.
thClaws هي منصة (agent harness) تسمح لك بإنشاء وكلاء ذكاء اصطناعي يعملون على جهازك. الفرق بينها وبين أدوات مثل Claude Code أنها مفتوحة المصدر بالكامل، وتدعم عدة مزودين، وتركز على الخصوصية (جميع المفاتيح مخزنة في keychain النظام).
يناسب: المطورين الذين يريدون أتمتة مهام البرمجة والتحليل، الباحثين عن بديل مفتوح للأدوات السحابية، الشركات الناشئة التي تريد تقليل تكاليف APIs.
لا يناسب: غير المبرمجين (يتطلب معرفة بسطر الأوامر)، من يحتاج واجهة رسومية متكاملة (الواجهة حالياً تجريبية)، من يريد دعماً فنياً فورياً.
git clone https://GitHub.com/thClaws/thClaws.git
cd thClawscd frontend
pnpm install
pnpm build
cd ..cargo build --release --features gui --bin thclawsملاحظة: إذا أردت نسخة بدون واجهة رسومية، استخدم cargo build --release --bin thclaws.
عند أول تشغيل، سيُطلب منك اختيار طريقة تخزين المفاتيح:
نموذج ملف .env:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...تحذير: لا تشارك ملف .env أبداً، وأضفه إلى .gitignore.
./target/release/thclawsبعد التشغيل، ستظهر واجهة سطر أوامر تفاعلية. جرب الأمر التالي:
مرحباً، اكتب لي دالة بلغة Python لحساب مضروب عدد.إذا اشتغل، فأنت جاهز.
اطلب من thClaws تحليل ملف CSV لمبيعات متجرك الإلكتروني وإنشاء تقرير بصيغة PDF.
استخدم thClaws لمراجعة Pull Request على GitHub وإخراج ملخص بالأخطاء والتحسينات.
حمّل ملفات PDF واطلب ملخصاً لكل فصل.
نعم، إذا كنت مطوراً وتبحث عن أداة AI محلية، مرنة، ومفتوحة المصدر. لكن لا تتوقع واجهة ناضجة بعد؛ المشروع لا يزال في مرحلة مبكرة.
نعم، البرنامج مجاني، لكنك تدفع مقابل استخدام APIs (مثل OpenAI).
thClaws مفتوح المصدر ويدعم عدة مزودين، Claude Code مغلق ومخصص لـ Anthropic.
نظرياً نعم، إذا وفرت واجهة API متوافقة (مثل ollama). لكن README لا يذكر دعماً صريحاً.
النموذج المستخدم هو الذي يحدد دعم العربية. إذا استخدمت GPT-4 أو Claude، فسيفهم العربية.
خطوات عملية مرتبة من التشخيص إلى النتيجة
لماذا؟ للحصول على الكود المصدري لـ 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
لماذا؟ لتخزين مفاتيح 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 وأضف المفاتيح
جدول صغير يمنع التسويف
نقاط مختصرة ترجع لها لاحقاً
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 واستخدامه في مشاريعه اليومية
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
thClaws أداة واعدة لمطوري الذكاء الاصطناعي الذين يريدون الخصوصية والتحكم الكامل. التركيب بسيط إذا اتبعت الخطوات، والتجربة الأولى مشجعة. جربه اليوم وشاركنا رأيك.
حتى يبقى المرجع صالحاً مع الوقت
FAQ