Plugins الخاصة بإطار تشغيل الوكيل

​

متى تستخدم حاضنة

• خادم وكيل برمجة أصلي يملك الخيوط وCompaction
• CLI محلي أو خدمة خفية يجب أن تبث أحداث الخطة/الاستدلال/الأدوات الأصلية
• بيئة تشغيل نموذج تحتاج إلى معرّف استئناف خاص بها إضافةً إلى نص جلسة OpenClaw

​

ما يبقى النواة مالكة له

• المزوّد والنموذج
• حالة مصادقة بيئة التشغيل
• مستوى التفكير وميزانية السياق
• ملف نص/جلسة OpenClaw
• مساحة العمل، وصندوق العزل، وسياسة الأدوات
• استدعاءات رد القناة واستدعاءات البث
• سياسة الرجوع إلى نموذج بديل وتبديل النموذج الحي

• runtimePlan.tools.normalize(...) و runtimePlan.tools.logDiagnostics(...) لسياسة مخطط الأدوات الواعية بالمزوّد
• runtimePlan.transcript.resolvePolicy(...) لسياسة تنقية النص وإصلاح استدعاءات الأدوات
• runtimePlan.delivery.isSilentPayload(...) لقمع التسليم المشترك لـ NO_REPLY والوسائط
• runtimePlan.outcome.classifyRunResult(...) لتصنيف الرجوع إلى نموذج بديل
• runtimePlan.observability لبيانات تعريف المزوّد/النموذج/الحاضنة المحلولة

​

تسجيل حاضنة

import type { AgentHarness } from "openclaw/plugin-sdk/agent-harness";
import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";

const myHarness: AgentHarness = {
  id: "my-harness",
  label: "My native agent harness",

  supports(ctx) {
    return ctx.provider === "my-provider"
      ? { supported: true, priority: 100 }
      : { supported: false };
  },

  async runAttempt(params) {
    // Start or resume your native thread.
    // Use params.prompt, params.tools, params.images, params.onPartialReply,
    // params.onAgentEvent, and the other prepared attempt fields.
    return await runMyNativeTurn(params);
  },
};

export default definePluginEntry({
  id: "my-native-agent",
  name: "My Native Agent",
  description: "Runs selected models through a native agent daemon.",
  register(api) {
    api.registerAgentHarness(myHarness);
  },
});

​

سياسة الاختيار

1. سياسة بيئة التشغيل على نطاق النموذج لها الأولوية.
2. تليها سياسة بيئة التشغيل على نطاق المزوّد.
3. يطلب auto من الحاضنات المسجّلة ما إذا كانت تدعم المزوّد/النموذج المحلول.
4. إذا لم تطابق أي حاضنة مسجّلة، يستخدم OpenClaw بيئة التشغيل المضمّنة.

​

إقران المزوّد والحاضنة

• مراجع نموذج المستخدم المفضلة: openai/gpt-5.5
• مراجع التوافق: تبقى مراجع codex/gpt-* القديمة مقبولة، لكن الإعدادات الجديدة يجب ألا تستخدمها كمراجع مزوّد/نموذج عادية
• معرّف الحاضنة: codex
• المصادقة: إتاحة مزوّد اصطناعية، لأن حاضنة Codex تملك تسجيل دخول/جلسة Codex الأصلية
• طلب خادم التطبيق: يرسل OpenClaw معرّف النموذج المجرد إلى Codex ويترك الحاضنة تتحدث إلى بروتوكول خادم التطبيق الأصلي

​

وسيط نتائج الأدوات

​

تصنيف النتيجة الطرفية

​

الآثار الجانبية عند نهاية الوكيل

​

إدخال المستخدم وأسطح الأدوات

​

وضع حاضنة Codex الأصلية

​

صرامة بيئة التشغيل

{
  "models": {
    "providers": {
      "openai": {
        "agentRuntime": {
          "id": "codex"
        }
      }
    }
  },
  "agents": {
    "defaults": {
      "model": "openai/gpt-5.5"
    }
  }
}

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-opus-4-8",
      "models": {
        "anthropic/claude-opus-4-8": {
          "agentRuntime": {
            "id": "claude-cli"
          }
        }
      }
    }
  }
}

{
  "agents": {
    "list": [
      {
        "id": "codex-only",
        "model": "openai/gpt-5.5",
        "models": {
          "openai/gpt-5.5": {
            "agentRuntime": { "id": "codex" }
          }
        }
      }
    ]
  }
}

{
  "agents": {
    "defaults": {
      "agentRuntime": {
        "id": "codex"
      }
    }
  }
}

​

الجلسات الأصلية ومرآة النص

• سجل الجلسة المرئي للقناة
• البحث في النص وفهرسته
• الرجوع إلى حزمة تشغيل OpenClaw المضمّنة في دور لاحق
• سلوك /new و/reset العام وحذف الجلسات

​

نتائج الأدوات والوسائط

​

القيود الحالية

• مسار الاستيراد العام عام، لكن بعض الأسماء المستعارة لأنواع المحاولة/النتيجة لا تزال تحمل أسماء قديمة للتوافق.
• تثبيت حزم تشغيل الجهات الخارجية تجريبي. فضّل Pluginات المزوّدين إلى أن تحتاج إلى وقت تشغيل جلسة أصلي.
• تبديل حزم التشغيل مدعوم عبر الأدوار. لا تبدّل حزم التشغيل في منتصف الدور بعد بدء الأدوات الأصلية أو الموافقات أو نص المساعد أو إرسال الرسائل.

​

ذو صلة

• نظرة عامة على SDK
• مساعدات وقت التشغيل
• Pluginات المزوّدين
• حزمة تشغيل Codex
• مزوّدو النماذج