Open-Claw

المورّد: Open-Claw اسم التثبيت: open-claw الحالة: معاينة الإعداد الأصلي: ~/.openclaw/openclaw.json

التثبيتCopy Anchor Link

apothem install --harness open-claw

يكتب المحوّل ملف الإعداد العام على مستوى المستخدم في OpenClaw، ويُسقِط الملف التعريفي المشترك في وثيقة ملف تعريفي، ويثبّت حزم دعم Apothem تحت جذر إطار العمل. الإعداد الأصلي لـ OpenClaw بصيغة JSON؛ ويُجسِّد المُجسِّد مفتاحًا واحدًا، skills.load.extraDirs، ويحتفظ الملف الموجود بمفاتيحه الأخرى.

الملفات المكتوبة: ~/.openclaw/openclaw.json، ووثيقة الملف التعريفي ~/.openclaw/apothem/rules/00-apothem-profile.md، وملفات الدعم تحت ~/.openclaw/.apothem/support/

تنتهي وثيقة الملف التعريفي بقسم ملفات دعم Apothem الذي يُسمّي الدليل المطلق تحت ~/.openclaw/.apothem/support/ الذي تُحَلّ نسبةً إليه كل إحالة بأسلوب المستودع (rules/<name>.md، وtemplates/...، وhooks/...).

تعيين الملف التعريفي إلى الإعداد الأصليCopy Anchor Link

يؤلّف المحوّل مفتاح إعداد واحدًا. فهو يضيف ~/.openclaw/.apothem/support/skills إلى skills.load.extraDirs، وهي قائمة أدلّة المهارات الإضافية التي يقرؤها OpenClaw، وبها يعثر OpenClaw على المهارات المُثبَّتة. ويأتي المُدخَل بعد أي مُدخَلات تسردها أصلًا، وتبقى مفاتيحك الأخرى كما هي. تذهب هوية الملف التعريفي وتفضيلاته وقواعده إلى وثيقة الملف التعريفي. وتُثبَّت الأوامر، والمهارات، والقواعد، والقوالب، ومطالبات الخطّافات المشتركة بوصفها مادة دعم تحت ~/.openclaw/.apothem/support/.

ملاحظات التوافقCopy Anchor Link

محوّل في مرحلة المعاينة. يُحمِّل OpenClaw مهارات Apothem عبر skills.load.extraDirs، لكنه لا يُحمِّل بقية شجرة الدعم ولا وثيقة الملف التعريفي من تلقاء نفسه: فلا يشير إليهما أيٌّ من ملفات تعليمات مساحة العمل لديه ولا إعداده، لذا يعمل OpenClaw بعد التثبيت دون قواعد Apothem أو خوادم MCP الخاصة بها.

تعارض الأسماء. يقرأ OpenClaw المهارات من هذه المصادر، من الأعلى أسبقيةً إلى الأدنى، وحين يظهر اسم المهارة نفسه في أكثر من موضع يفوز المصدر الأعلى: مجلّد skills/ في مساحة العمل، ومجلّد .agents/skills/ في مساحة العمل، و~/.agents/skills (لدليل الحالة الافتراضي فقط)، ومجلّد skills/ في دليل الحالة (~/.openclaw/skills افتراضيًا)، ومهارات الورشة، والمهارات المُضمَّنة ومهارات الحارس، وأخيرًا المجلّدات المسرودة تحت skills.load.extraDirs مع مهارات الإضافات. ودليل Apothem مُدخَل في extraDirs، لذا فإن المهارة التي تحمل الاسم نفسه وتحتفظ بها في أيٍّ من المصادر الأسبق هي التي يستخدمها OpenClaw، وتبقى نسخة Apothem من تلك المهارة غير مستخدمة على القرص. ولا يكتب Apothem إلا في openclaw.json وتحت ~/.openclaw/.apothem/support/، ولا يكتب أبدًا في تلك المجلّدات الأسبق، لذا لا يستبدل التثبيت والتحديث وإلغاء التثبيت مهارةً تحتفظ بها هناك.

agents.defaults.skills هي قائمة السماح بأسماء المهارات؛ ولا يعدّلها Apothem، لذا إن كنت تحتفظ بواحدة، فتحقّق من أنها تسمّي مهارات Apothem التي تريدها. ويُبقي apothem update على المفاتيح التي تضيفها إلى openclaw.json. وتعيش خوادم MCP في كتلة mcp.servers من إعداد OpenClaw، التي تديرها عبر openclaw mcp add والأوامر الفرعية ذات الصلة؛ ولا يكتب المحوّل فيها أي مُدخَلات. (سلوك OpenClaw وفق وثائقه عن المهارات، وإعداد المهارات، وامتدادات الإعداد، كما قُرئت في 2026-10-24، ووثائقه عن واجهة سطر أوامر MCP، كما قُرئت في 2026-10-02.)

التعليقات في openclaw.json. يقرأ OpenClaw إعداده بصيغة JSON5، ويُعيد Apothem كتابة الملف بصيغة JSON عادية. وحين يحمل الملف تعليقات أو صياغة أخرى من JSON5 ويكون المُدخَل مفقودًا، يترك Apothem الملف دون مساس ويتوقّف التثبيت برسالة تسمّي المفتاح. ادمج هذا المُدخَل في ملفك بنفسك، أو حوّل الملف إلى JSON عادي، ثم شغّل التثبيت مجدّدًا:

{
  "skills": {
    "load": {
      "extraDirs": ["~/.openclaw/.apothem/support/skills"]
    }
  }
}

المُدخَل الذي تضيفه بنفسك يُعَدّ مُدخَلك: فيتركه إلغاء التثبيت في مكانه.

التحقّقCopy Anchor Link

apothem verify --harness open-claw

يؤكّد أمر التحقّق ما يلي:

1. الإعداد الأصلي موجود في المسار المتوقَّع.
2. كل هدف مُدار موجود؛ والملفات المُدارة غير فارغة، وتُحلَّل إعدادات JSON أو YAML. أضِف --profile PATH لتتحقّق كذلك من أن الملفات المثبّتة تطابق ذلك الملف التعريفي.
3. يسرد skills.load.extraDirs في الإعداد الأصلي ~/.openclaw/.apothem/support/skills. فمن دون ذلك المُدخَل لا يُحمِّل OpenClaw المهارات المُثبَّتة؛ ويُعيد apothem update إضافته.
4. روتين التحقّق الخاص بالمحوّل يُبلِغ عن النجاح.

التحديثCopy Anchor Link

apothem update --harness open-claw

يُعيد اشتقاق وثيقة الملف التعريفي من الحالة الراهنة للملف التعريفي المشترك ويُحدِّث ملفات الدعم؛ ويحتفظ openclaw.json بالمفاتيح الموجودة فيه أصلًا، ويبقى مُدخَل Apothem في skills.load.extraDirs مسرودًا مرة واحدة مهما تكرّر التحديث. شغّله بعد تحرير ~/.config/apothem/profile.yaml أو ترقية حزمة Apothem المُثبَّتة.

إلغاء التثبيتCopy Anchor Link

apothem uninstall --harness open-claw

يُزيل ما أضافه المحوّل: مُدخَله في skills.load.extraDirs، ووثيقة الملف التعريفي، وشجرة الدعم. تبقى مفاتيحك الخاصة في openclaw.json، بما فيها مُدخَلات extraDirs الخاصة بك، ولا يُحذَف الملف إلا إذا كان Apothem هو من أنشأه ولم يتبقَّ فيه شيء يخصّك. لا يتأثّر ملف YAML الخاص بالملف التعريفي المشترك ولا محرّك Apothem.

بوابة المطابقةCopy Anchor Link

python -m apothem.conformity.gate --all .

استكشاف الأخطاء وإصلاحهاCopy Anchor Link

مفاتيح الضبطCopy Anchor Link

انظر أيضًاCopy Anchor Link

• كل أُطُر العمل — الفهرس الكامل للأدوات المدعومة
• دليل التثبيت — ثبّت Apothem في إطار العمل هذا
• مرجع apothem harnesses — اسرد المحوّلات وافحصها من واجهة سطر الأوامر