Plugin สำหรับชุดควบคุมเอเจนต์

Documentation Index

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

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

​

ควรใช้ฮาร์เนสเมื่อใด

• เซิร์ฟเวอร์เอเจนต์เขียนโค้ดแบบ native ที่เป็นเจ้าของเธรดและ Compaction
• CLI หรือ daemon ภายในเครื่องที่ต้อง stream เหตุการณ์ native plan/reasoning/tool
• รันไทม์โมเดลที่ต้องมี resume id ของตัวเองนอกเหนือจาก transcript ของเซสชัน OpenClaw

​

สิ่งที่ core ยังเป็นเจ้าของ

• ผู้ให้บริการและโมเดล
• สถานะ auth ของรันไทม์
• ระดับ thinking และ context budget
• ไฟล์ transcript/เซสชัน OpenClaw
• workspace, sandbox และนโยบายเครื่องมือ
• callback สำหรับการตอบกลับของช่องทางและ callback สำหรับ streaming
• นโยบาย fallback ของโมเดลและการสลับโมเดลสด

• runtimePlan.tools.normalize(...) และ runtimePlan.tools.logDiagnostics(...) สำหรับนโยบาย schema เครื่องมือที่รับรู้ผู้ให้บริการ
• runtimePlan.transcript.resolvePolicy(...) สำหรับการ sanitize transcript และนโยบายซ่อมแซม tool-call
• runtimePlan.delivery.isSilentPayload(...) สำหรับ NO_REPLY ที่ใช้ร่วมกันและการระงับการส่งมอบ media
• runtimePlan.outcome.classifyRunResult(...) สำหรับการจัดประเภท fallback ของโมเดล
• runtimePlan.observability สำหรับ metadata ผู้ให้บริการ/โมเดล/ฮาร์เนสที่ resolve แล้ว

​

ลงทะเบียนฮาร์เนส

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 ถามฮาร์เนสที่ลงทะเบียนไว้ว่ารองรับผู้ให้บริการ/โมเดลที่ resolve แล้วหรือไม่
4. หากไม่มีฮาร์เนสที่ลงทะเบียนไว้ตรงกัน OpenClaw จะใช้ PI เว้นแต่ fallback ของ PI ถูกปิดใช้งาน

​

การจับคู่ผู้ให้บริการกับฮาร์เนส

• model ref ของผู้ใช้ที่แนะนำ: openai/gpt-5.5
• ref สำหรับ compatibility: ref เก่า codex/gpt-* ยังยอมรับได้ แต่ config ใหม่ไม่ควรใช้เป็น ref ผู้ให้บริการ/โมเดลปกติ
• id ฮาร์เนส: codex
• auth: ความพร้อมใช้งานของผู้ให้บริการแบบ synthetic เพราะฮาร์เนส Codex เป็นเจ้าของ native Codex login/session
• คำขอ app-server: OpenClaw ส่งเฉพาะ id โมเดลแบบ bare ไปยัง Codex และให้ฮาร์เนสคุยกับโปรโตคอล native app-server

​

middleware ของผลลัพธ์เครื่องมือ

​

การจัดประเภทผลลัพธ์ปลายทาง

​

โหมดฮาร์เนส Codex แบบ native

​

ความเข้มงวดของรันไทม์

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

​

เซสชัน native และ mirror ของ transcript

• ประวัติเซสชันที่ช่องทางมองเห็นได้
• การค้นหาและ indexing transcript
• การสลับกลับไปยังฮาร์เนส PI ในตัวบนเทิร์นถัดไป
• พฤติกรรมทั่วไปของ /new, /reset และการลบเซสชัน

​

ผลลัพธ์เครื่องมือและ media

​

ข้อจำกัดปัจจุบัน

• path import สาธารณะเป็นแบบ generic แต่ alias ของชนิด attempt/result บางตัวยังมีชื่อ Pi เพื่อ compatibility
• การติดตั้งฮาร์เนสของบุคคลที่สามยังเป็นแบบทดลอง ให้ใช้ Plugin ผู้ให้บริการก่อนจนกว่าคุณต้องการรันไทม์เซสชัน native
• รองรับการสลับฮาร์เนสข้ามเทิร์น อย่าสลับฮาร์เนสกลางเทิร์นหลังจาก native tools, approvals, ข้อความผู้ช่วย หรือการส่งข้อความเริ่มไปแล้ว

​

ที่เกี่ยวข้อง

• ภาพรวม SDK
• ตัวช่วยรันไทม์
• Plugin สำหรับผู้ให้บริการ
• Harness ของ Codex
• ผู้ให้บริการโมเดล