Plugin cho bộ khung tác tử

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.

​

Khi nào dùng harness

• một máy chủ coding-agent 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 plan/reasoning/tool gốc
• một model runtime cần resume id riêng ngoài transcript phiên OpenClaw

​

Core vẫn sở hữu những gì

• provider và model
• trạng thái auth runtime
• mức thinking và ngân sách ngữ cảnh
• tệp transcript/phiên OpenClaw
• workspace, sandbox, và chính sách tool
• callback trả lời channel và callback streaming
• chính sách fallback model và chuyển model trực tiếp

• runtimePlan.tools.normalize(...) và runtimePlan.tools.logDiagnostics(...) cho chính sách schema tool nhận biết provider
• runtimePlan.transcript.resolvePolicy(...) cho chính sách làm sạch transcript và sửa tool-call
• runtimePlan.delivery.isSilentPayload(...) cho NO_REPLY dùng chung và việc chặn phân phối media
• runtimePlan.outcome.classifyRunResult(...) cho phân loại fallback model
• runtimePlan.observability cho metadata provider/model/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. Id harness đã ghi của một phiên hiện có thắng, nên thay đổi config/env sẽ không hot-switch transcript đó sang runtime khác.
2. OPENCLAW_AGENT_RUNTIME=<id> buộc một harness đã đăng ký với id đó cho các phiên chưa được ghim.
3. OPENCLAW_AGENT_RUNTIME=pi buộc harness PI tích hợp sẵn.
4. OPENCLAW_AGENT_RUNTIME=auto hỏi các harness đã đăng ký xem chúng có hỗ trợ provider/model đã phân giải hay không.
5. Nếu không có harness đã đăng ký nào khớp, OpenClaw dùng PI trừ khi fallback PI bị tắt.

​

Ghép cặp provider với harness

• model ref ưu tiên cho người dùng: openai/gpt-5.5 cộng với agentRuntime.id: "codex"
• ref tương thích: các ref legacy codex/gpt-* vẫn được chấp nhận, nhưng config mới không nên dùng chúng như ref provider/model thông thường
• id harness: codex
• auth: tính khả dụng provider tổng hợp, vì harness Codex sở hữu login/phiên Codex gốc
• yêu cầu app-server: OpenClaw gửi id model trần tới Codex và để harness nói chuyện với giao thức app-server gốc

​

Middleware kết quả tool

​

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

​

Chế độ harness Codex gốc

​

Tắt fallback PI

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

{
  "agents": {
    "defaults": {
      "agentRuntime": {
        "id": "auto",
        "fallback": "none"
      }
    }
  }
}

{
  "agents": {
    "defaults": {
      "agentRuntime": {
        "id": "auto",
        "fallback": "pi"
      }
    },
    "list": [
      {
        "id": "codex-only",
        "model": "openai/gpt-5.5",
        "agentRuntime": {
          "id": "codex",
          "fallback": "none"
        }
      }
    ]
  }
}

OPENCLAW_AGENT_RUNTIME=codex \
OPENCLAW_AGENT_HARNESS_FALLBACK=none \
openclaw gateway run

​

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

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

​

Kết quả tool và media

​

Hạn chế hiện tại

• Đường dẫn nhập 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 Pi để tương thích.
• Cài đặt khung thực thi của bên thứ ba đang ở giai đoạn thử nghiệm. Hãy ưu tiên Plugin nhà cung cấp cho đến khi bạn cần runtime phiên gốc.
• Hỗ trợ chuyển đổi khung thực thi giữa các lượt. Không chuyển đổi khung thực thi ở giữa một lượt sau khi công cụ gốc, phê duyệt, văn bản của trợ lý hoặc thao tá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
• Khung thực thi Codex
• Nhà cung cấp mô hình