إضافات بيئة تشغيل الوكيل

​

متى تستخدم مشغّلًا

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

​

ما تظل النواة مسؤولة عنه

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

​

تمهيد المصادقة المملوك للمشغّل

​

عناصر بيئة تشغيل الإعداد المتحقق منها

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

​

عقد نقل الطلبات

• يسرد runtimePolicy.compatibleIds معرّفات بيئات التشغيل التي يعلن الموفّر توافقها مع ذلك المسار المحدد. يعني غياب السياسة أن الموفّر لم يعلن توافقًا على مستوى المسار؛ ولا يُعد ذلك إذنًا بافتراض الدعم.
• يعني requestTransportOverrides: "none" عدم وجوب إعادة إنتاج أي تجاوز مُنشأ لطلب الموفّر/النموذج. ويعني "present" وجود ترويسات مُنشأة أو نقل مصادقة أو وكيل أو TLS أو خدمة محلية أو سلوك شبكة خاصة أو معاملات طلب. لا تكشف هذه الحقيقة تلك القيم.

​

تسجيل مشغّل

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

const myHarness: AgentHarness = {
  id: "my-harness",
  label: "مشغّل وكيلي الأصلي",

  supports(ctx) {
    const routeSupportsHarness =
      ctx.modelProvider?.runtimePolicy?.compatibleIds.includes("my-harness") === true;
    const canReproduceRequest = ctx.modelProvider?.requestTransportOverrides !== "present";
    return ctx.provider === "my-provider" && routeSupportsHarness && canReproduceRequest
      ? { supported: true, priority: 100 }
      : { supported: false, reason: "المسار الفعلي غير متوافق مع المشغّل" };
  },

  async runAttempt(params) {
    // ابدأ سلسلة المحادثات الأصلية أو استأنفها.
    // استخدم params.prompt وparams.tools وparams.images وparams.onPartialReply،
    // وparams.onAgentEvent وحقول المحاولة المُعَدّة الأخرى.
    return await runMyNativeTurn(params);
  },
};

export default definePluginEntry({
  id: "my-native-agent",
  name: "وكيلي الأصلي",
  description: "يشغّل النماذج المحددة عبر برنامج خفي أصلي للوكيل.",
  register(api) {
    api.registerAgentHarness(myHarness);
  },
});

​

التنفيذ المفوّض

​

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

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

​

إقران الموفّر بالمشغّل

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

​

برمجيات نتائج الأدوات الوسيطة

​

تصنيف النتيجة النهائية

​

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

​

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

​

وضع إطار تشغيل Codex الأصلي

​

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

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

{
  "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.6-sol",
        "models": {
          "openai/gpt-5.6-sol": {
            "agentRuntime": { "id": "codex" }
          }
        }
      }
    ]
  }
}

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

​

الجلسات الأصلية ونسخة سجل المحادثة

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

​

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

​

النتائج النهائية للأدوات

• مرّر معرّف استدعاء البروتوكول عند وجوده، واسم الأداة الأساسي، والوسائط التي وصلت فعليًا إلى الأداة بعد الإعداد أو إعادة الكتابة بواسطة الخطافات.
• عيّن executionStarted: false عندما يمنع التحقق أو الموافقة أو حاجز آخر الاستدعاء قبل بدء تنفيذ الأداة. وبمجرد احتمال حدوث الإرسال، أبلغ عن true بصورة متحفظة.
• أبلغ عن outcome: "success" أو outcome: "failure". وأدرج حقول الإخفاق المنظّمة المتاحة من بيئة التشغيل بدلًا من استنتاج الإخفاق من نص العرض.
• استخدم nativeMutation فقط للأدوات الأصلية التي لا تستخدم تعريف أداة OpenClaw. وقدّم هناك حقائق التغيير وإعادة التشغيل التي يديرها البروتوكول؛ ولا تنسخ مصنّف التغيير الخاص بـ OpenClaw إلى إطار التشغيل.

​

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

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

​

ذو صلة

• نظرة عامة على SDK
• مساعدات بيئة التشغيل
• Plugins المزوّدين
• إطار تشغيل Codex
• مزوّدو النماذج