MetaClaw

# فقط تحدّث مع الوكيل الخاص بك، وسيتعلّم ويتطوّر باستمرار.

مستوحى من طريقة تعلّم الدماغ. اجعل 🦞 الخاص بك يتعلّم ويتطوّر من كل محادثة حقيقية. لا حاجة لوحدات GPU. يدعم Kimi وQwen وClaude وMiniMax والمزيد.

MetaClaw Architecture

[🇺🇸 English](../README.md) • [🇨🇳 中文](./README_ZH.md) • [🇯🇵 日本語](./README_JA.md) • [🇰🇷 한국어](./README_KO.md) • [🇫🇷 Français](./README_FR.md) • [🇩🇪 Deutsch](./README_DE.md) • [🇪🇸 Español](./README_ES.md) • [🇧🇷 Português](./README_PT.md) • [🇷🇺 Русский](./README_RU.md) • [🇮🇹 Italiano](./README_IT.md) • [🇻🇳 Tiếng Việt](./README_VI.md) • [🇮🇳 हिन्दी](./README_HI.md)
[نظرة عامة](#-نظرة-عامة) • [البدء السريع](#-البدء-السريع) • [الإعدادات](#️-الإعدادات) • [وضع المهارات](#-وضع-المهارات) • [وضع RL](#-وضع-rl) • [وضع MadMax](#-وضع-madmax-الافتراضي) • [الاقتباس](#-الاقتباس)

---

### أمران فقط. هذا كل شيء.

```bash metaclaw setup # معالج الإعداد لمرة واحدة metaclaw start # الوضع الافتراضي: madmax، مهارات + تدريب RL مُجدوَل metaclaw start --daemon # تشغيل في الخلفية، السجلات -> ~/.metaclaw/metaclaw.log metaclaw start --daemon --log-file /tmp/metaclaw.log # مسار سجل مخصص metaclaw start --mode rl # RL بدون مُجدوِل (يتدرّب فورًا عند اكتمال الدُّفعة) metaclaw start --mode skills_only # مهارات فقط، بدون RL (لا حاجة لـ Tinker) ```

MetaClaw demo

--- ## 🔥 آخر الأخبار - **[2026/03/25]** **v0.4.0** — طبقة السياق (Contexture layer): يحتفظ MetaClaw الآن بالذاكرة عبر الجلسات للمستخدمين والمشاريع. يتم استرجاع الحقائق والتفضيلات وتاريخ المشروع ذات الصلة تلقائيًا وحقنها في المطالبات. يشمل سياسة ذاكرة تكيفية وتوحيدًا في الخلفية وخدمة sidecar اختيارية للذاكرة. - **[2026/03/16]** **v0.3.2** دعم متعدد الـ Claw: أصبح IronClaw وPicoClaw وZeroClaw وCoPaw وNanoClaw وNemoClaw مدعومين إلى جانب OpenClaw. NanoClaw عبر نقطة النهاية الجديدة المتوافقة مع Anthropic `/v1/messages`؛ NemoClaw عبر توجيه الاستدلال OpenShell. إضافة OpenRouter كمنصة LLM مدعومة. - **[2026/03/13]** **v0.3.1** دعم واجهة MinT الخلفية: يعمل تدريب RL الآن مع Tinker وMinT معًا. يمكن ضبطه عبر `rl.backend` (auto/tinker/mint). - **[2026/03/13]** **v0.3** دعم التعلّم الفوقي المستمر: تحديثات RL البطيئة تعمل فقط خلال ساعات النوم أو فترات الخمول أو اجتماعات Google Calendar. تمت إضافة فصل مجموعات support/query لمنع إشارات المكافأة القديمة من تلويث تحديثات النموذج. - **[2026/03/11]** **v0.2** نشر بنقرة واحدة عبر واجهة `metaclaw` CLI. المهارات مُفعّلة افتراضيًا، وRL أصبح اختياريًا. - **[2026/03/09]** إطلاق **MetaClaw** رسميًا. فقط تحدّث مع الوكيل ودعه يتطوّر تلقائيًا. **لا حاجة** لنشر GPU، فقط اتصل بـ **API**. --- ## 🎥 عرض توضيحي https://github.com/user-attachments/assets/d86a41a8-4181-4e3a-af0e-dc453a6b8594 --- ## 📖 نظرة عامة **MetaClaw وكيل يتعلّم فوقيًا ويتطوّر في البيئات الحقيقية.** فقط تحدّث مع وكيلك كالمعتاد. يحوّل MetaClaw كل محادثة حيّة إلى إشارة تعلّم، مما يُمكّن الوكيل من التحسّن المستمر من خلال النشر الفعلي بدلًا من الاعتماد على التدريب دون اتصال فقط. في الخلفية، يضع MetaClaw نموذجك خلف وكيل وسيط متوافق مع OpenAI (مع نقطة نهاية `/v1/messages` متوافقة مع Anthropic للوكلاء مثل NanoClaw) يعترض التفاعلات من OpenClaw وNanoClaw وNemoClaw وغيرها من الوكلاء المدعومين، ويحقن المهارات ذات الصلة في كل دور، ويتعلّم فوقيًا من التجارب المتراكمة. تُلخَّص المهارات تلقائيًا بعد كل جلسة. عند تفعيل RL، يؤجّل مُجدوِل التعلّم الفوقي تحديثات الأوزان إلى فترات الخمول حتى لا يُقاطَع الوكيل أثناء الاستخدام النشط. لا حاجة لمجموعة GPU. يعمل MetaClaw مع أي واجهة LLM API متوافقة مع OpenAI مباشرةً، ويستخدم واجهة خلفية متوافقة مع Tinker لتدريب LoRA السحابي. [Tinker](https://www.thinkingmachines.ai/tinker/) هو المسار المرجعي الافتراضي، ويمكن تفعيل MinT أو Weaver من خلال حزم توافق منفصلة عند الحاجة. ## 🤖 الميزات الرئيسية ### **نشر بنقرة واحدة** قم بالإعداد مرة واحدة باستخدام `metaclaw setup`، ثم `metaclaw start` يُشغّل الوكيل الوسيط ويحقن المهارات ويربط OpenClaw تلقائيًا. لا حاجة لسكربتات shell يدوية. ### **ثلاثة أوضاع تشغيل** | الوضع | افتراضي | الوصف | |------|---------|-------| | `skills_only` | | وكيل وسيط لواجهة LLM API الخاصة بك. يحقن المهارات ويُلخّصها تلقائيًا بعد كل جلسة. لا حاجة لـ GPU / Tinker. | | `rl` | | المهارات + تدريب RL (GRPO). يتدرّب فورًا عند اكتمال الدُّفعة. OPD اختياري لتقطير المعلّم. | | `madmax` | ✅ | المهارات + RL + مُجدوِل ذكي. تحديثات أوزان RL تعمل فقط خلال فترات النوم/الخمول/الاجتماعات. | ### **ذاكرة طويلة المدى** يمكن لـ MetaClaw الاحتفاظ بالحقائق والتفضيلات وسجل المشروع عبر الجلسات وحقن السياق المناسب في كل دور — حتى يتذكر الوكيل ما أخبرته به حتى بعد أسابيع. ### **تصميم غير متزامن بالكامل** الخدمة ونمذجة المكافآت والتدريب منفصلة تمامًا. يستمر الوكيل في الاستجابة بينما يعمل التقييم والتحسين بالتوازي في الخلفية. --- ## 🚀 البدء السريع ### 1. التثبيت **OpenClaw (تثبيت بنقرة واحدة):** استخدم الإصدار [v0.4.0](https://github.com/aiming-lab/MetaClaw/releases/tag/v0.4.0) — نفّذ الأوامر أدناه، ثم `metaclaw setup` و`metaclaw start`. مزيد من التفاصيل (Windows، المرايا، الإعداد، استكشاف الأخطاء): [`extensions/metaclaw-openclaw/README.md`](../extensions/metaclaw-openclaw/README.md). ```bash curl -LO https://github.com/aiming-lab/MetaClaw/releases/download/v0.4.0/metaclaw-plugin.zip unzip metaclaw-plugin.zip -d ~/.openclaw/extensions openclaw plugins enable metaclaw-openclaw && openclaw gateway restart ``` **pip** (PyPI أو هذا المستودع): ```bash pip install -e . # وضع skills_only (خفيف الوزن) pip install -e ".[rl]" # + دعم تدريب RL (torch، transformers، tinker) pip install -e ".[evolve]" # + تطوير المهارات عبر LLM متوافق مع OpenAI pip install -e ".[scheduler]" # + تكامل Google Calendar مع المُجدوِل pip install -e ".[rl,evolve,scheduler]" # موصى به: إعداد RL + مُجدوِل كامل ``` (اختياري) يستخدم دمج WeChat الملحق الرسمي @tencent-weixin/openclaw-weixin. يثبّت MetaClaw هذا الملحق تلقائياً عند تفعيل WeChat: ```bash metaclaw config wechat.enabled true metaclaw start ``` يتم تثبيت الملحق تلقائياً عند بدء MetaClaw. يمكنك أيضاً تثبيته يدوياً: ```bash npx -y @tencent-weixin/openclaw-weixin-cli@latest install ``` لتبديل حسابات WeChat (إعادة تسجيل الدخول برمز QR جديد): ```bash metaclaw start --wechat-relogin ``` إذا كنت تريد استخدام `rl.backend=mint`، قم بتثبيت حزمة توافق MinT بشكل منفصل في نفس البيئة، مثل [`mindlab-toolkit`](https://github.com/MindLab-Research/mindlab-toolkit). لاستخدام `rl.backend=weaver`، قم بتثبيت [`nex-weaver`](https://github.com/nex-agi/weaver) بشكل منفصل. لا يضمّن MetaClaw هذه التبعيات في الحزمة الافتراضية حتى يتمكّن مستخدمو RL من اختيار Tinker أو MinT أو Weaver بشكل صريح. ### 2. الإعداد ```bash metaclaw setup ``` الدليل التفاعلي سيطلب منك: 1. **اختيار الوكيل الشخصي** — `openclaw` أو `copaw` أو `ironclaw` أو `picoclaw` أو `zeroclaw` أو `nanoclaw` أو `nemoclaw` أو `none` (يضبطه MetaClaw تلقائياً عند التشغيل) 2. **اختيار مزود LLM** — Kimi أو Qwen أو OpenAI أو Volcano Engine أو مخصص 3. **إدخال مفتاح API** وتفعيل تدريب RL اختيارياً يمكن لمسار RL في MetaClaw التبديل صراحةً بين `tinker` و`mint` و`weaver`. القيمة الافتراضية الموصى بها هي `auto` وستظل تستنتج MinT أو Weaver من بيانات الاعتماد أو عناوين URL المقابلة عندما تكون الحزم مثبّتة. **Tinker**: ```bash metaclaw config rl.backend tinker metaclaw config rl.api_key sk-... metaclaw config rl.model moonshotai/Kimi-K2.5 ``` **MinT**: ```bash metaclaw config rl.backend mint metaclaw config rl.api_key sk-mint-... metaclaw config rl.base_url https://mint.macaron.xin/ metaclaw config rl.model Qwen/Qwen3-4B-Instruct-2507 ``` **Weaver**: ```bash metaclaw config rl.backend weaver metaclaw config rl.api_key sk-... metaclaw config rl.base_url https://weaver-console.nex-agi.cn metaclaw config rl.model Qwen/Qwen3-8B ``` الأسماء المستعارة القديمة `rl.tinker_api_key` و`rl.tinker_base_url` لا تزال مقبولة للتوافق مع الإصدارات السابقة. ### 3. التشغيل ```bash metaclaw start ``` هذا كل شيء. يبدأ MetaClaw البروكسي، ويضبط الوكيل الشخصي المختار تلقائياً، ويعيد تشغيل البوابة. افتح الوكيل وابدأ المحادثة — تُحقَن المهارات في كل دور وتُلخَّص الجلسة تلقائياً إلى مهارات جديدة عند الانتهاء. --- ## ⚙️ الإعدادات ملف الإعدادات موجود في `~/.metaclaw/config.yaml`، يُنشأ بواسطة `metaclaw setup`. **أوامر CLI:** ``` metaclaw setup # معالج الإعداد التفاعلي لأول مرة metaclaw start # تشغيل MetaClaw (الوضع الافتراضي: madmax) metaclaw start --daemon # تشغيل MetaClaw في الخلفية metaclaw start --daemon --log-file /tmp/metaclaw.log # مسار سجل مخصص metaclaw start --mode rl # فرض وضع RL لهذه الجلسة (بدون مُجدوِل) metaclaw start --mode skills_only # فرض وضع المهارات فقط لهذه الجلسة metaclaw stop # إيقاف مثيل MetaClaw قيد التشغيل metaclaw status # التحقق من صحة الوكيل الوسيط والوضع الحالي وحالة المُجدوِل metaclaw config show # عرض الإعدادات الحالية metaclaw config KEY VALUE # تعيين قيمة إعداد ``` عند تشغيل MetaClaw مع `--daemon`، ينتظر الأمر حتى يصبح الوكيل المحلي جاهزًا قبل الإرجاع. استخدم `metaclaw status` للتحقق من الجاهزية و `metaclaw stop` لإيقاف العملية في الخلفية.

المرجع الكامل للإعدادات (انقر للتوسيع)

```yaml mode: madmax # "madmax" | "rl" | "skills_only" claw_type: openclaw # "openclaw" | "copaw" | "ironclaw" | "picoclaw" | "zeroclaw" | "nanoclaw" | "nemoclaw" | "hermes" | "none" llm: provider: kimi # kimi | qwen | openai | minimax | novita | openrouter | volcengine | custom model_id: moonshotai/Kimi-K2.5 api_base: https://api.moonshot.cn/v1 api_key: sk-... proxy: port: 30000 api_key: "" # اختياري: رمز bearer للوكيل الوسيط المحلي لـ MetaClaw skills: enabled: true dir: ~/.metaclaw/skills # دليل مكتبة المهارات الخاصة بك retrieval_mode: template # template | embedding top_k: 6 task_specific_top_k: 10 # الحد الأقصى للمهارات الخاصة بالمهمة (افتراضي 10) auto_evolve: true # تلخيص المهارات تلقائيًا بعد كل جلسة rl: enabled: false # اضبط على true لتفعيل تدريب RL backend: auto # "auto" | "tinker" | "mint" | "weaver" model: moonshotai/Kimi-K2.5 api_key: "" base_url: "" # نقطة نهاية خلفية اختيارية، مثل https://mint.macaron.xin/ لـ MinT أو https://weaver-console.nex-agi.cn لـ Weaver tinker_api_key: "" # اسم مستعار متوافق لـ api_key tinker_base_url: "" # اسم مستعار متوافق لـ base_url prm_url: https://api.openai.com/v1 prm_model: gpt-5.2 prm_api_key: "" lora_rank: 32 batch_size: 4 resume_from_ckpt: "" # اختياري: استئناف التدريب من نقطة تفتيش evolver_api_base: "" # اتركه فارغًا لإعادة استخدام llm.api_base evolver_api_key: "" evolver_model: gpt-5.2 opd: enabled: false # اضبط على true لتفعيل OPD (تقطير المعلّم) teacher_url: "" # عنوان URL الأساسي لنموذج المعلّم (متوافق مع OpenAI /v1/completions) teacher_model: "" # اسم نموذج المعلّم (مثل Qwen/Qwen3-32B) teacher_api_key: "" # مفتاح API لنموذج المعلّم kl_penalty_coef: 1.0 # معامل عقوبة KL لـ OPD max_context_tokens: 20000 # حد رموز الموجه قبل الاقتطاع؛ 0 = بلا اقتطاع # (موصى به في skills_only مع نماذج سحابية ذات سياق كبير) context_window: 0 # نافذة السياق المبلَّغ عنها للوكيل (مثل عتبة ضغط OpenClaw)؛ # 0 = تلقائي (≈200000 في skills_only، 32768 في rl/madmax) scheduler: # v0.3: مُجدوِل التعلّم الفوقي (يُفعَّل تلقائيًا في وضع madmax) enabled: false # يُفعَّل تلقائيًا في وضع madmax، يجب ضبطه يدويًا في وضع rl sleep_start: "23:00" sleep_end: "07:00" idle_threshold_minutes: 30 min_window_minutes: 15 calendar: enabled: false credentials_path: "" token_path: "" ```

--- ## 💪 وضع المهارات **`metaclaw start --mode skills_only`** أخف وضع تشغيل. لا حاجة لـ GPU أو واجهة RL خلفية. يضع MetaClaw واجهة LLM الخاصة بك خلف وكيل وسيط يحقن المهارات ذات الصلة في كل دور محادثة، ثم يُلخّص مهارات جديدة تلقائيًا بعد كل محادثة. لمزودين مخصصين متوافقين مع OpenAI، اضبط `llm.api_base` على عنوان قاعدة واجهة الدردشة الكامل (عادة ينتهي بـ `/v1`، مثل `https://your-gateway.example/v1`). في وضع `skills_only`، يعيد MetaClaw استخدام نقطة النهاية نفسها لضغط الموجه واستدعاءات نموذج اللغة المساعدة ما لم تُضبَط نقطة نهاية evolver منفصلة. المهارات هي تعليمات Markdown قصيرة تُخزَّن في `~/.metaclaw/skills/` كملفات `SKILL.md` مستقلة. تنمو المكتبة تلقائيًا مع استخدامك. لتحميل بنك المهارات المدمج مسبقًا (أكثر من 40 مهارة تشمل البرمجة والأمان ومهام الوكيل وغيرها): ```bash cp -r memory_data/skills/* ~/.metaclaw/skills/ ``` --- ## 🔬 وضع RL **`metaclaw start --mode rl`** كل ما في وضع المهارات، بالإضافة إلى الضبط الدقيق المستمر بالتعلّم المعزّز من المحادثات الحيّة. يتم تحويل كل دور محادثة إلى رموز وإرساله كعيّنة تدريب. يقوم نموذج LLM حكم (PRM) بتقييم الاستجابات بشكل غير متزامن، وتُجري واجهة خلفية متوافقة مع Tinker (مثل Tinker السحابي أو MinT أو Weaver) ضبطًا دقيقًا لـ LoRA مع تبديل الأوزان تلقائيًا. **Tinker**: ```bash metaclaw config rl.backend tinker metaclaw config rl.api_key sk-... metaclaw config rl.model moonshotai/Kimi-K2.5 metaclaw config rl.prm_url https://api.openai.com/v1 metaclaw config rl.prm_api_key sk-... metaclaw start --mode rl ``` **MinT**: ```bash metaclaw config rl.backend mint metaclaw config rl.api_key sk-mint-... metaclaw config rl.base_url https://mint.macaron.xin/ metaclaw config rl.model Qwen/Qwen3-4B-Instruct-2507 metaclaw config rl.prm_url https://api.openai.com/v1 metaclaw config rl.prm_api_key sk-... metaclaw start --mode rl ``` **Weaver**: ```bash metaclaw config rl.backend weaver metaclaw config rl.api_key sk-... metaclaw config rl.base_url https://weaver-console.nex-agi.cn metaclaw config rl.model Qwen/Qwen3-8B metaclaw config rl.prm_url https://api.openai.com/v1 metaclaw config rl.prm_api_key sk-... metaclaw start --mode rl ``` يستخرج نموذج LLM مُطوِّر مخصّص أيضًا مهارات جديدة من الحلقات الفاشلة ويُعيدها إلى مكتبة المهارات. **التنفيذ البرمجي** (بدون واجهة OpenClaw TUI): اضبط `openclaw_env_data_dir` على دليل يحتوي ملفات مهام JSONL: ```json {"task_id": "task_1", "instruction": "Register the webhook at https://example.com/hook"} ``` ### التقطير على السياسة (OPD) OPD إضافة اختيارية لوضع RL. يُقطّر نموذج معلّم أكبر إلى نموذج الطالب على السياسة: يُنشئ نموذج الطالب الاستجابات كالمعتاد، بينما يوفّر نموذج المعلّم احتمالات لوغاريتمية لكل رمز على نفس الاستجابات. تُوجّه عقوبة KL نموذج الطالب نحو توزيع المعلّم. ```bash metaclaw config opd.enabled true metaclaw config opd.teacher_url http://localhost:8082/v1 metaclaw config opd.teacher_model Qwen/Qwen3-32B metaclaw config opd.kl_penalty_coef 1.0 ``` يجب نشر نموذج المعلّم خلف نقطة نهاية `/v1/completions` متوافقة مع OpenAI (مثل vLLM أو SGLang). يمكن الجمع بين OPD وتقييم PRM، حيث يعمل كلاهما بشكل غير متزامن. راجع `examples/run_conversation_opd.py` و`scripts/run_openclaw_tinker_opd.sh`. --- ## 🧠 وضع MadMax (الافتراضي) **`metaclaw start`** كل ما في وضع RL، بالإضافة إلى مُجدوِل تعلّم فوقي يؤجّل تحديثات الأوزان إلى فترات عدم نشاط المستخدم حتى لا يُقاطَع الوكيل أثناء الاستخدام النشط. هذا هو الوضع الافتراضي. تُوقف خطوة تبديل أوزان RL الوكيل لعدة دقائق. بدلًا من التدريب فورًا عند اكتمال الدُّفعة (كما في وضع RL)، ينتظر MadMax نافذة مناسبة. ثلاثة شروط تُفعّل نافذة التحديث (أي شرط منها كافٍ): - **ساعات النوم**: وقت بداية/نهاية قابل للتعديل (مثل 23:00 إلى 07:00) - **خمول لوحة المفاتيح**: يُفعَّل بعد N دقيقة من عدم النشاط - **أحداث Google Calendar**: يكتشف الاجتماعات لتشغيل التحديثات أثناء غيابك ```bash metaclaw config scheduler.sleep_start "23:00" metaclaw config scheduler.sleep_end "07:00" metaclaw config scheduler.idle_threshold_minutes 30 # اختياري: تكامل Google Calendar pip install -e ".[scheduler]" metaclaw config scheduler.calendar.enabled true metaclaw config scheduler.calendar.credentials_path ~/.metaclaw/client_secrets.json ``` إذا عاد المستخدم أثناء التحديث، تُحفظ الدُّفعة الجزئية وتُستأنف في النافذة التالية. يحمل كل `ConversationSample` علامة إصدار `skill_generation`. عندما يرفع تطوّر المهارات رقم الإصدار، يُفرَّغ مخزن RL المؤقت بحيث تُستخدم فقط العيّنات بعد التطوّر لتحديثات التدرّج (فصل مجموعات support/query في MAML). --- ## 📚 الاقتباس ```bibtex @misc{xia2026metaclaw, author = {Xia, Peng and Chen, Jianwen and Yang, Xinyu and Tu, Haoqin and Han, Siwei and Qiu, Shi and Zheng, Zeyu and Xie, Cihang and Yao, Huaxiu}, title = {MetaClaw: Just Talk --- An Agent That Meta-Learns and Evolves in the Wild}, year = {2026}, organization = {GitHub}, url = {https://github.com/aiming-lab/MetaClaw}, } ``` --- ## 🙏 شكر وتقدير MetaClaw مبني على المشاريع مفتوحة المصدر التالية: - [OpenClaw](https://openclaw.ai) , إطار عمل الوكيل الأساسي. - [SkillRL](https://github.com/aiming-lab/SkillRL) , إطار عمل RL المُعزَّز بالمهارات. - [Tinker](https://www.thinkingmachines.ai/tinker/) , يُستخدم لتدريب RL عبر الإنترنت. - [MinT](https://github.com/MindLab-Research/mindlab-toolkit) , واجهة خلفية بديلة لتدريب RL عبر الإنترنت. - [Weaver](https://github.com/nex-agi/weaver) , واجهة خلفية بديلة لتدريب RL عبر الإنترنت. - [OpenClaw-RL](https://github.com/Gen-Verse/OpenClaw-RL) , مصدر إلهام لتصميم RL الخاص بنا. - [awesome-openclaw-skills](https://github.com/VoltAgent/awesome-openclaw-skills) , يوفّر الأساس لبنك المهارات الخاص بنا. - [NanoClaw](https://github.com/qwibitai/nanoclaw) , وكيل Claude الشخصي من qwibitai، يتصل عبر نقطة النهاية `/v1/messages` المتوافقة مع Anthropic. - [NemoClaw](https://github.com/NVIDIA/NemoClaw) , مكوّن إضافي لوكيل OpenShell من NVIDIA للاستدلال. --- ## 📄 الترخيص هذا المشروع مرخّص بموجب [ترخيص MIT](LICENSE).