Ajan yürütme ortamı pluginleri

​

Harness ne zaman kullanılır?

• iş parçacıklarının ve Compaction’ın sahibi olan yerel bir kodlama agent’ı sunucusu
• yerel planlama/akıl yürütme/araç olaylarını akışla iletmesi gereken yerel bir CLI veya daemon
• OpenClaw oturum transkriptine ek olarak kendi sürdürme kimliğine ihtiyaç duyan bir model çalışma zamanı

​

Core’un sahipliğinde kalanlar

• sağlayıcı ve model
• harness kimlik doğrulama önyüklemesinin sahibi olduğunu bildirmediği sürece çalışma zamanı kimlik doğrulama durumu
• düşünme düzeyi ve bağlam bütçesi
• OpenClaw transkript/oturum dosyası
• çalışma alanı, korumalı alan ve araç politikası
• kanal yanıt geri çağrıları ve akış geri çağrıları
• model geri dönüşü ve canlı model değiştirme politikası

​

Harness’ın sahip olduğu kimlik doğrulama önyüklemesi

​

Doğrulanmış kurulum çalışma zamanı yapıtları

• sağlayıcıya duyarlı araç şeması politikası için runtimePlan.tools.normalize(...) ve runtimePlan.tools.logDiagnostics(...)
• transkript temizleme ve araç çağrısı onarma politikası için runtimePlan.transcript.resolvePolicy(...)
• paylaşılan NO_REPLY ve medya teslimatı engellemesi için runtimePlan.delivery.isSilentPayload(...)
• model geri dönüşü sınıflandırması için runtimePlan.outcome.classifyRunResult(...)
• çözümlenmiş sağlayıcı/model/harness meta verileri için runtimePlan.observability

​

İstek aktarımı sözleşmesi

• runtimePolicy.compatibleIds, sağlayıcının bu somut rotayla uyumlu olduğunu bildirdiği çalışma zamanı kimliklerini listeler. Politikanın bulunmaması, sağlayıcının rota düzeyinde uyumluluk bildirmediği anlamına gelir; destek varsayma izni değildir.
• requestTransportOverrides: "none", yazılmış hiçbir sağlayıcı/model isteği geçersiz kılmasının yeniden üretilmesi gerekmediği anlamına gelir. "present", yazılmış üstbilgilerin, kimlik doğrulama aktarımının, proxy’nin, TLS’nin, yerel hizmetin, özel ağ davranışının veya istek parametrelerinin mevcut olduğu anlamına gelir. Bu olgu söz konusu değerleri açığa çıkarmaz.

​

Harness 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) {
    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: "effective route is not harness-compatible" };
  },

  async runAttempt(params) {
    // Yerel iş parçacığınızı başlatın veya sürdürün.
    // params.prompt, params.tools, params.images, params.onPartialReply,
    // params.onAgentEvent ve hazırlanmış denemenin diğer alanlarını kullanın.
    return await runMyNativeTurn(params);
  },
};

export default definePluginEntry({
  id: "my-native-agent",
  name: "My Native Agent",
  description: "Seçilen modelleri yerel bir agent daemon’u üzerinden çalıştırır.",
  register(api) {
    api.registerAgentHarness(myHarness);
  },
});

​

Devredilmiş yürütme

​

Seçim politikası

1. Model kapsamlı çalışma zamanı politikası önceliklidir.
2. Ardından sağlayıcı kapsamlı çalışma zamanı politikası gelir.
3. auto, kayıtlı harness’lara çözümlenmiş etkin rotayı destekleyip desteklemediklerini sorar. Sağlayıcı/model ön ekleri tek başına hiçbir zaman harness seçmez.
4. Kayıtlı hiçbir harness eşleşmezse OpenClaw gömülü çalışma zamanını kullanır.

​

Sağlayıcı ve harness eşleştirmesi

• tercih edilen kullanıcı model başvuruları: openai/gpt-5.6-sol
• uyumluluk başvuruları: eski codex/gpt-* başvuruları kabul edilmeye devam eder, ancak yeni yapılandırmalar bunları normal sağlayıcı/model başvuruları olarak kullanmamalıdır
• harness kimliği: codex
• kimlik doğrulama: Codex harness’ı yerel Codex oturum açma/oturumunun sahibi olduğundan yapay sağlayıcı kullanılabilirliği
• uygulama sunucusu isteği: OpenClaw, çıplak model kimliğini Codex’e gönderir ve harness’ın yerel uygulama sunucusu protokolüyle iletişim kurmasını sağlar

​

Araç sonucu ara yazılımı

​

Terminal sonucu sınıflandırması

​

Aracı sonlandırma yan etkileri

​

Kullanıcı girişi ve araç yüzeyleri

​

Yerel Codex çalıştırma ortamı modu

​

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

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

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-opus-5",
      "models": {
        "anthropic/claude-opus-5": {
          "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"
      }
    }
  }
}

​

Yerel oturumlar ve transkript yansısı

• kanalda görünen oturum geçmişi
• transkript araması ve dizinleme
• daha sonraki bir turda yerleşik OpenClaw çalıştırma ortamına geri dönme
• genel /new, /reset ve oturum silme davranışı

​

Araç ve medya sonuçları

​

Terminal araç sonuçları

• Mevcutsa protokol çağrı kimliğini, kanonik araç adını ve hazırlık veya kanca yeniden yazımlarından sonra araca gerçekten ulaşan bağımsız değişkenleri aktarın.
• Doğrulama, onay veya başka bir koruma, araç uygulaması başlamadan önce çağrıyı durdurduğunda executionStarted: false ayarlayın. Gönderim gerçekleşmiş olabilecek duruma geldiğinde ihtiyatlı biçimde true bildirin.
• outcome: "success" veya outcome: "failure" bildirin. Görüntüleme metninden başarısızlık çıkarmak yerine çalışma zamanındaki yapılandırılmış başarısızlık alanlarını dahil edin.
• nativeMutation öğesini yalnızca OpenClaw araç tanımı kullanmayan yerel araçlar için kullanın. Protokol tarafından yönetilen değişiklik ve yeniden oynatma olgularını burada sağlayın; OpenClaw’ın değişiklik sınıflandırıcısını çalıştırma ortamına kopyalamayın.

​

Karara bağlanmış araç sonlandırması

• tam olarak kısıtlanmış yerel transkripti veya karara bağlanmış araç sonucu sınırına kadar dondurulmuş eksiksiz bir uygulama transkriptini kullanmak;
• hiçbir araç, izin verme veya kullanıcı girişi yeteneği, yerel yürütme kancası, aracı, Skills, bellek, zamanlama, uzantı ya da uzaktan denetim sunmamak;
• yalnızca ana makine tarafından sağlanan sonlandırma istemini göndermek; ve
• seçilen transkript/yalıtım stratejisi bu kısıtlamaları uygulayamıyorsa kapalı biçimde başarısız olmak.

​

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 harness kurulumu deneyseldir. Yerel bir oturum çalışma zamanına ihtiyaç duyana kadar sağlayıcı pluginlerini tercih edin.
• Turlar arasında harness değiştirme desteklenir. Yerel araçlar, onaylar, asistan metni veya ileti gönderimleri başladıktan sonra turun ortasında harness değiştirmeyin.

​

İlgili

• SDK’ya Genel Bakış
• Çalışma Zamanı Yardımcıları
• Sağlayıcı Pluginleri
• Codex Harness
• Model Sağlayıcıları