Môi trường chạy tác nhân

• Harness nhúng chạy bên trong vòng lặp tác tử đã chuẩn bị của OpenClaw. Hiện nay gồm runtime tích hợp sẵn openclaw cùng các harness plugin đã đăng ký như codex và copilot.
• Backend CLI chạy một tiến trình CLI cục bộ trong khi vẫn giữ model ref chuẩn. Ví dụ, anthropic/claude-opus-4-8 với agentRuntime.id: "claude-cli" trong phạm vi mô hình có nghĩa là “chọn mô hình Anthropic, thực thi qua Claude CLI.” claude-cli không phải là id harness nhúng và không được truyền vào lựa chọn AgentHarness.

​

Các bề mặt Codex

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

1. Nếu người dùng yêu cầu liên kết/điều khiển/luồng/tiếp tục/điều hướng/dừng Codex, hãy dùng bề mặt lệnh /codex gốc khi plugin codex được đóng gói sẵn đã bật.
2. Nếu người dùng yêu cầu Codex làm runtime nhúng hoặc muốn trải nghiệm tác tử Codex thông thường được hỗ trợ bằng thuê bao, hãy dùng openai/<model>.
3. Nếu người dùng chọn tường minh OpenClaw cho một mô hình OpenAI, giữ model ref là openai/<model> và đặt chính sách runtime nhà cung cấp/mô hình thành agentRuntime.id: "openclaw". Một hồ sơ OAuth openai đã chọn được định tuyến nội bộ qua transport xác thực Codex của OpenClaw.
4. Nếu cấu hình di sản vẫn chứa legacy Codex model refs, hãy sửa thành openai/<model> bằng openclaw doctor --fix; doctor giữ tuyến xác thực Codex bằng cách thêm agentRuntime.id: "codex" theo phạm vi nhà cung cấp/mô hình tại nơi model ref cũ đã ngụ ý điều đó. Các codex-cli/* model refs di sản sửa về cùng tuyến app-server Codex openai/<model>; OpenClaw không còn giữ backend Codex CLI đóng gói sẵn.
5. Nếu người dùng nói tường minh ACP, acpx, hoặc bộ chuyển đổi ACP Codex, hãy dùng ACP với runtime: "acp" và agentId: "codex".
6. Nếu yêu cầu dành cho Claude Code, Gemini CLI, OpenCode, Cursor, Droid, hoặc một harness ngoài khác, hãy dùng ACP/acpx, không dùng runtime tác tử con gốc.

​

Quyền sở hữu runtime

• Nếu OpenClaw sở hữu bề mặt, OpenClaw có thể cung cấp hành vi hook plugin thông thường.
• Nếu runtime gốc sở hữu bề mặt, OpenClaw cần sự kiện runtime hoặc hook gốc.
• Nếu runtime gốc sở hữu trạng thái luồng chuẩn, OpenClaw nên sao chiếu và chiếu ngữ cảnh, không viết lại các phần nội bộ không được hỗ trợ.

​

Lựa chọn runtime

1. Chính sách runtime phạm vi mô hình thắng. Chính sách này có thể nằm trong mục mô hình nhà cung cấp đã cấu hình hoặc trong agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime. Ký tự đại diện nhà cung cấp như agents.defaults.models["vllm/*"].agentRuntime áp dụng sau chính sách mô hình chính xác, để các mô hình nhà cung cấp được khám phá động có thể dùng chung một runtime mà không ghi đè các ngoại lệ theo từng mô hình chính xác.
2. Chính sách runtime phạm vi nhà cung cấp đứng tiếp theo tại models.providers.<provider>.agentRuntime.
3. Trong chế độ auto, các runtime plugin đã đăng ký có thể nhận các cặp nhà cung cấp/mô hình được hỗ trợ.
4. Nếu không runtime nào nhận một lượt trong chế độ auto, OpenClaw dùng openclaw làm runtime tương thích. Dùng một id runtime tường minh khi lượt chạy phải nghiêm ngặt.

{
  agents: {
    defaults: {
      model: "anthropic/claude-opus-4-8",
      models: {
        "anthropic/claude-opus-4-8": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}

​

Runtime tác nhân GitHub Copilot

{
  agents: {
    defaults: {
      model: "github-copilot/gpt-5.5",
      models: {
        "github-copilot/gpt-5.5": {
          agentRuntime: { id: "copilot" },
        },
      },
    },
  },
}

​

Hợp đồng tương thích

​

Nhãn trạng thái

• Tham chiếu mô hình như openai/gpt-5.5 cho bạn biết nhà cung cấp/mô hình đã chọn.
• ID runtime như codex cho bạn biết vòng lặp nào đang thực thi lượt.
• Nhãn kênh như Telegram hoặc Discord cho bạn biết cuộc trò chuyện đang diễn ra ở đâu.

​

Liên quan

• Harness Codex
• Runtime harness Codex
• Runtime tác nhân GitHub Copilot
• OpenAI
• Plugin harness tác nhân
• Vòng lặp tác nhân
• Mô hình
• Trạng thái