Plugin harness tác tử

​

Khi nào dùng harness

• một máy chủ tác tử lập trình gốc sở hữu luồng và Compaction
• một CLI hoặc daemon cục bộ phải stream các sự kiện kế hoạch/lập luận/công cụ gốc
• một runtime mô hình cần resume id riêng ngoài bản ghi phiên OpenClaw

​

Core vẫn sở hữu gì

• nhà cung cấp và mô hình
• trạng thái xác thực runtime
• mức suy nghĩ và ngân sách ngữ cảnh
• tệp bản ghi/phiên OpenClaw
• workspace, sandbox, và chính sách công cụ
• callback trả lời kênh và callback streaming
• chính sách fallback mô hình và chuyển đổi mô hình trực tiếp

• runtimePlan.tools.normalize(...) và runtimePlan.tools.logDiagnostics(...) cho chính sách schema công cụ nhận biết nhà cung cấp
• runtimePlan.transcript.resolvePolicy(...) cho chính sách làm sạch bản ghi và sửa tool-call
• runtimePlan.delivery.isSilentPayload(...) cho việc chặn phân phối NO_REPLY và media dùng chung
• runtimePlan.outcome.classifyRunResult(...) cho phân loại fallback mô hình
• runtimePlan.observability cho metadata nhà cung cấp/mô hình/harness đã phân giải

​

Đăng ký harness

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

​

Chính sách chọn

1. Chính sách runtime theo phạm vi mô hình được ưu tiên.
2. Chính sách runtime theo phạm vi nhà cung cấp đứng tiếp theo.
3. auto hỏi các harness đã đăng ký liệu chúng có hỗ trợ nhà cung cấp/mô hình đã phân giải không.
4. Nếu không có harness đã đăng ký nào khớp, OpenClaw dùng runtime nhúng của nó.

​

Ghép cặp nhà cung cấp và harness

• ref mô hình người dùng ưu tiên: openai/gpt-5.5
• ref tương thích: các ref codex/gpt-* legacy vẫn được chấp nhận, nhưng cấu hình mới không nên dùng chúng làm ref nhà cung cấp/mô hình thông thường
• id harness: codex
• xác thực: trạng thái sẵn sàng nhà cung cấp tổng hợp, vì harness Codex sở hữu đăng nhập/phiên Codex gốc
• yêu cầu app-server: OpenClaw gửi id mô hình trần cho Codex và để harness nói chuyện với giao thức app-server gốc

​

Middleware kết quả công cụ

​

Phân loại kết quả terminal

​

Tác dụng phụ khi tác tử kết thúc

​

Đầu vào người dùng và bề mặt công cụ

​

Chế độ harness Codex gốc

​

Độ nghiêm ngặt runtime

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

​

Phiên gốc và bản sao transcript

• lịch sử phiên hiển thị trên kênh
• tìm kiếm và lập chỉ mục transcript
• chuyển lại sang bộ khung OpenClaw tích hợp sẵn ở một lượt sau
• hành vi chung của /new, /reset và xóa phiên

​

Kết quả công cụ và phương tiện

​

Giới hạn hiện tại

• Đường dẫn import công khai là chung, nhưng một số bí danh kiểu lần thử/kết quả vẫn mang tên cũ để tương thích.
• Việc cài đặt bộ khung chạy của bên thứ ba còn mang tính thử nghiệm. Hãy ưu tiên Plugin nhà cung cấp cho đến khi bạn cần một thời gian chạy phiên gốc.
• Việc chuyển đổi bộ khung chạy được hỗ trợ giữa các lượt. Không chuyển đổi bộ khung chạy ở giữa một lượt sau khi các công cụ gốc, phê duyệt, văn bản trợ lý hoặc gửi tin nhắn đã bắt đầu.

​

Liên quan

• Tổng quan SDK
• Trình trợ giúp thời gian chạy
• Plugin nhà cung cấp
• Bộ khung chạy Codex
• Nhà cung cấp mô hình