Ajan çalışma altyapısı Plugin'leri

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Harness ne zaman kullanılır

• thread’leri ve Compaction’ı sahiplenen yerel bir coding-agent sunucusu
• yerel plan/akıl yürütme/araç olaylarını stream etmesi gereken yerel bir CLI veya daemon
• OpenClaw oturum transcript’ine ek olarak kendi resume id’sine ihtiyaç duyan bir model runtime’ı

​

Core hâlâ nelerin sahibi

• sağlayıcı ve model
• runtime kimlik doğrulama durumu
• düşünme düzeyi ve bağlam bütçesi
• OpenClaw transcript/oturum dosyası
• çalışma alanı, sandbox ve araç ilkesi
• kanal yanıt callback’leri ve streaming callback’leri
• model fallback ve canlı model değiştirme ilkesi

• sağlayıcı farkındalıklı araç şeması ilkesi için runtimePlan.tools.normalize(...) ve runtimePlan.tools.logDiagnostics(...)
• transcript temizleme ve tool-call onarım ilkesi için runtimePlan.transcript.resolvePolicy(...)
• paylaşılan NO_REPLY ve medya teslimatı bastırma için runtimePlan.delivery.isSilentPayload(...)
• model fallback sınıflandırması için runtimePlan.outcome.classifyRunResult(...)
• çözümlenmiş sağlayıcı/model/harness metadata’sı için runtimePlan.observability

​

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) {
    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ı runtime ilkesi kazanır.
2. Sağlayıcı kapsamlı runtime ilkesi sonra gelir.
3. auto, kayıtlı harness’lere çözümlenen sağlayıcı/modeli destekleyip desteklemediklerini sorar.
4. Eşleşen kayıtlı harness yoksa OpenClaw, PI fallback devre dışı bırakılmadıkça PI kullanır.

​

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

• tercih edilen kullanıcı model ref’leri: openai/gpt-5.5
• uyumluluk ref’leri: eski codex/gpt-* ref’leri kabul edilmeye devam eder, ancak yeni config’ler bunları normal sağlayıcı/model ref’leri olarak kullanmamalıdır
• harness id’si: codex
• kimlik doğrulama: sentetik sağlayıcı kullanılabilirliği, çünkü Codex harness’i yerel Codex login/oturumunu sahiplenir
• app-server isteği: OpenClaw, çıplak model id’sini Codex’e gönderir ve harness’in yerel app-server protokolüyle konuşmasına izin verir

​

Araç sonucu middleware’i

​

Terminal sonuç sınıflandırması

​

Yerel Codex harness modu

​

Runtime katılığı

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

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-opus-4-7",
      "models": {
        "anthropic/claude-opus-4-7": {
          "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 transcript yansısı

• kanalda görünür oturum geçmişi
• transcript arama ve indeksleme
• daha sonraki bir dönüşte yerleşik PI harness’ine geri dönme
• genel /new, /reset ve oturum silme davranışı

​

Araç ve medya sonuçları

​

Mevcut sınırlamalar

• Genel import yolu generic’tir, ancak bazı deneme/sonuç tür takma adları uyumluluk için hâlâ Pi adları taşır.
• Üçüncü taraf harness kurulumu deneyseldir. Yerel bir oturum runtime’ına ihtiyaç duyana kadar provider plugin’leri tercih edin.
• Harness değiştirme dönüşler arasında desteklenir. Yerel araçlar, onaylar, asistan metni veya mesaj gönderimleri başladıktan sonra bir dönüşün ortasında harness değiştirmeyin.

​

İlgili

• SDK Genel Bakışı
• Çalışma Zamanı Yardımcıları
• Sağlayıcı Plugin’leri
• Codex Çalıştırma Altyapısı
• Model Sağlayıcıları