الربط مع OpenCode واختيار النماذج المجانية في TinyClaw – دليل شامل 🦞

في هذا المقال، سنشرح كيفية ربط TinyClaw مع OpenCode، وكيفية اختيار نماذج مجانية، وأفضل الممارسات لكتابة الأوامر.

🤝 الجزء الأول: ربط TinyClaw مع OpenCode

ما هو OpenCode؟

OpenCode هو مساعد برمجي ذكي يعمل في terminal الخاص بك. عند ربطه مع TinyClaw، يمكنك:

• إرسال أكواد للـ agents لتحليلها
• تنفيذ أوامر برمجية
• مراجعة الكود تلقائياً

خطوات الربط

1. تثبيت OpenCode

# على Linux/Mac
curl -fsSL https://opencode.ai/install | bash

# أو باستخدام npm
npm install -g opencode

2. إعداد التكامل

أنشئ ملف التكامل في TinyClaw:

mkdir -p ~/.tinyclaw/plugins
nano ~/.tinyclaw/plugins/opencode.js

أضف الكود التالي:

module.exports = {
  name: "opencode",
  description: "Execute code via OpenCode",
  execute: async function(query) {
    const { execSync } = require("child_process");
    const result = execSync(`opencode "${query}"`, {
      encoding: "utf-8"
    });
    return result;
  }
};

3. تفعيل الإضافة

tinyclaw restart

🧠 الجزء الثاني: اختيار النموذج المجاني

النماذج المدعومة في TinyClaw

أفضل الخيارات المجانية

1. Claude Haiku (الأRecommanded)

tinyclaw agent add
# اختر:
# Provider: anthropic
# Model: haiku

2. نماذج مجانية عبر OpenRouter

يمكنك استخدام نماذج مجانية من OpenRouter:

tinyclaw provider add
# Name: OpenRouter Free
# Type: custom
# Base URL: https://openrouter.ai/api/v1
# API Key: (احصل عليها من openrouter.ai)

3. النماذج المجانية المتاحة

• Llama 3 – من Meta
• Mistral – مفتوح المصدر
• Gemma – من Google

إعداد النموذج المجاني

nano ~/.tinyclaw/settings.json

# أضف:
{
  "custom_providers": {
    "free_llama": {
      "name": "Free Llama",
      "harness": "claude",
      "base_url": "https://api.openrouter.ai/v1",
      "api_key": "your-openrouter-key",
      "model": "meta-llama/llama-3-8b-instruct"
    }
  }
}

ثم:

tinyclaw agent provider coder free_llama

✍️ الجزء الثالث: كيفية كتابة الأوامر بشكل صحيح

قواعد أساسية

أمثلة عملية

1. كتابة كود

@coder Write a Python function to calculate Fibonacci numbers in Arabic comments
2. مراجعة كود
@reviewer Review this code for security issues:
def login(username, password):
    query = f"SELECT * FROM users WHERE user={username} AND pass={password}"
    return execute(query)
3. شرح مفهوم
@writer Explain what is Machine Learning in simple Arabic for beginners
4. إنشاء فريق متكامل
tinyclaw team add dev_team
tinyclaw team add-agent dev_team coder
tinyclaw team add-agent dev_team reviewer
tinyclaw team add-agent dev_team writer

# الاستخدام:
@dev_team Build a REST API for e-commerce
نصائح لتحسين النتائج
كن محدداً: لا تقل "ساعدني" بل "اكتب function يرتب array"
حدد التنسيق: "Use Arabic comments"
اطلب التفسير: "Explain in Arabic with examples"
استخدم السياق: "Based on our previous discussion about auth..."
💡 نموذج Prompt مثالي
@[agent_name] [task] in [language]. [context if any]. [format if needed].
مثال:
@coder Write a React component in TypeScript that displays a shopping cart. Use clean code and add Arabic comments.
🎯 الخلاصة

✅ OpenCode: يتيح تنفيذ الكود مباشرة
✅ النماذج المجانية: Llama 3 و Mistral متاحة مجاناً
✅ كتابة صحيحة: كن محدداً ومارس الضغط@

🔗 روابط مفيدة

OpenCode
TinyClaw GitHub
OpenRouter (نماذج مجانية)