Ajan harness Plugin’leri

​

Çalıştırma altyapısı ne zaman kullanılır

• iş parçacıklarını ve Compaction’ı sahiplenen yerel bir kodlama agent sunucusu
• yerel plan/akıl yürütme/araç olaylarını akış olarak vermesi gereken yerel bir CLI veya daemon
• OpenClaw oturum dökümüne ek olarak kendi sürdürme kimliğine ihtiyaç duyan bir model çalışma zamanı

​

Çekirdeğin hâlâ sahip olduğu şeyler

• sağlayıcı ve model
• çalışma zamanı kimlik doğrulama durumu
• düşünme düzeyi ve bağlam bütçesi
• OpenClaw döküm/oturum dosyası
• çalışma alanı, sandbox ve araç ilkesi
• kanal yanıt geri çağrıları ve akış geri çağrıları
• model yedeğe düşme ve canlı model değiştirme ilkesi

• sağlayıcıya duyarlı araç şeması ilkesi için runtimePlan.tools.normalize(...) ve runtimePlan.tools.logDiagnostics(...)
• döküm temizleme ve araç çağrısı onarma ilkesi için runtimePlan.transcript.resolvePolicy(...)
• paylaşılan NO_REPLY ve medya teslimi bastırma için runtimePlan.delivery.isSilentPayload(...)
• model yedeğe düşme sınıflandırması için runtimePlan.outcome.classifyRunResult(...)
• çözümlenmiş sağlayıcı/model/çalıştırma altyapısı meta verileri için runtimePlan.observability

​

Çalıştırma altyapısı kaydetme

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);
  },
});

​

Seçim ilkesi

1. Model kapsamlı çalışma zamanı ilkesi kazanır.
2. Ardından sağlayıcı kapsamlı çalışma zamanı ilkesi gelir.
3. auto, kayıtlı çalıştırma altyapılarına çözümlenen sağlayıcı/modeli destekleyip desteklemediklerini sorar.
4. Kayıtlı hiçbir çalıştırma altyapısı eşleşmezse OpenClaw gömülü çalışma zamanını kullanır.

​

Sağlayıcı ve çalıştırma altyapısı eşleştirmesi

• tercih edilen kullanıcı model referansları: openai/gpt-5.5
• uyumluluk referansları: eski codex/gpt-* referansları kabul edilmeye devam eder, ancak yeni yapılandırmalar bunları normal sağlayıcı/model referansları olarak kullanmamalıdır
• çalıştırma altyapısı kimliği: codex
• kimlik doğrulama: sentetik sağlayıcı kullanılabilirliği, çünkü Codex çalıştırma altyapısı yerel Codex oturum açma/oturumunu sahiplenir
• uygulama sunucusu isteği: OpenClaw yalın model kimliğini Codex’e gönderir ve çalıştırma altyapısının yerel uygulama sunucusu protokolüyle konuşmasına izin verir

​

Araç sonucu ara katmanı

​

Terminal sonuç sınıflandırması

​

Agent sonu yan etkileri

​

Kullanıcı girdisi ve araç yüzeyleri

​

Yerel Codex çalıştırma altyapısı modu

​

Çalışma zamanı katılığı

{
  "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"
      }
    }
  }
}

​

Yerel oturumlar ve transkript yansıtması

• kanal tarafından görülebilen oturum geçmişi
• transkript arama ve indeksleme
• sonraki bir turda yerleşik OpenClaw koşumuna geri dönme
• genel /new, /reset ve oturum silme davranışı

​

Araç ve medya sonuçları

​

Mevcut sınırlamalar

• Genel içe aktarma yolu geneldir, ancak bazı deneme/sonuç tür takma adları uyumluluk için hâlâ eski adları taşır.
• Üçüncü taraf koşum kurulumu deneyseldir. Yerel bir oturum runtime’ına ihtiyaç duyana kadar sağlayıcı Pluginlerini tercih edin.
• Koşum değiştirme turlar arasında desteklenir. Yerel araçlar, onaylar, asistan metni veya ileti gönderimleri başladıktan sonra bir turun ortasında koşumları değiştirmeyin.

​

İlgili

• SDK’ye Genel Bakış
• Runtime Yardımcıları
• Sağlayıcı Pluginleri
• Codex Koşumu
• Model Sağlayıcıları