Các Plugin cho bộ khung tác nhân

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.

​

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 phát trực tuyến 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 id tiếp tục riêng ngoài bản ghi phiên OpenClaw

​

Những gì phần lõi vẫn sở hữu

• 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 phát trực tuyến
• chính sách dự phòng 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 lời gọi công cụ
• runtimePlan.delivery.isSilentPayload(...) cho việc triệt tiêu phân phối NO_REPLY và phương tiện dùng chung
• runtimePlan.outcome.classifyRunResult(...) cho phân loại dự phòng mô hình
• runtimePlan.observability cho siêu dữ liệu 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 lựa chọn

1. Chính sách runtime theo phạm vi mô hình thắng.
2. Chính sách runtime theo phạm vi nhà cung cấp đứng kế tiếp.
3. auto hỏi các harness đã đăng ký xem chúng có hỗ trợ nhà cung cấp/mô hình đã phân giải hay không.
4. Nếu không có harness đã đăng ký nào khớp, OpenClaw dùng PI trừ khi dự phòng PI bị tắt.

​

Ghép cặp nhà cung cấp cộng 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-* cũ vẫn được chấp nhận, nhưng cấu hình mới không nên dùng chúng như ref nhà cung cấp/mô hình thông thường
• id harness: codex
• xác thực: tính khả dụng nhà cung cấp tổng hợp, vì harness Codex sở hữu phiên/đăng nhập Codex gốc
• yêu cầu máy chủ ứng dụng: OpenClaw gửi id mô hình trần cho Codex và để harness nói chuyện với giao thức máy chủ ứng dụng gốc

​

Middleware kết quả công cụ

​

Phân loại kết quả cuối

​

Chế độ harness Codex gốc

​

Mứ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-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"
      }
    }
  }
}

​

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

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

​

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ố alias kiểu lần thử/kết quả vẫn mang tên Pi để tương thích.
• Cài đặt harness bên thứ ba đang thử nghiệm. Ưu tiên Plugin nhà cung cấp cho đến khi bạn cần runtime phiên gốc.
• Hỗ trợ chuyển harness giữa các lượt. Không chuyển harness ở giữa một lượt sau khi 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 runtime
• Plugin nhà cung cấp
• Bộ khung Codex
• Nhà cung cấp mô hình