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

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.

• Harness nhúng chạy bên trong vòng lặp tác tử đã chuẩn bị của OpenClaw. Hiện nay, đó là runtime pi tích hợp sẵn cùng với các harness Plugin đã đăng ký như codex.
• Backend CLI chạy một tiến trình CLI cục bộ trong khi vẫn giữ tham chiếu mô hình chuẩn tắc. Ví dụ, anthropic/claude-opus-4-7 với agentRuntime.id: "claude-cli" 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 phần chọn AgentHarness.

​

Ba thứ mang tên Codex

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

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 đi kèm được bật.
2. Nếu người dùng yêu cầu Codex làm runtime nhúng, hãy dùng openai/<model> với agentRuntime.id: "codex".
3. Nếu người dùng yêu cầu xác thực OAuth/đăng ký Codex trên trình chạy OpenClaw bình thường, hãy dùng openai-codex/<model> và giữ runtime là PI.
4. Nếu người dùng nói rõ ACP, acpx, hoặc bộ điều hợp ACP Codex, hãy dùng ACP với runtime: "acp" và agentId: "codex".
5. Nếu yêu cầu dành cho Claude Code, Gemini CLI, OpenCode, Cursor, Droid, hoặc một harness bên 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 bình 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 tắc, OpenClaw nên phản 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ợ.

​

Chọn runtime

1. Runtime đã ghi trong phiên được ưu tiên. Thay đổi cấu hình không chuyển nóng một bản ghi hội thoại hiện có sang một hệ thống luồng gốc khác.
2. OPENCLAW_AGENT_RUNTIME=<id> ép runtime đó cho các phiên mới hoặc phiên đã đặt lại.
3. agents.defaults.agentRuntime.id hoặc agents.list[].agentRuntime.id có thể đặt auto, pi, một id harness nhúng đã đăng ký như codex, hoặc một bí danh backend CLI được hỗ trợ như claude-cli.
4. Ở chế độ auto, các runtime Plugin đã đăng ký có thể nhận các cặp nhà cung cấp/mô hình mà chúng hỗ trợ.
5. Nếu không runtime nào nhận một lượt ở chế độ auto và fallback: "pi" được đặt (mặc định), OpenClaw dùng PI làm phương án tương thích dự phòng. Đặt fallback: "none" để thay vào đó làm cho lựa chọn chế độ auto không khớp bị lỗi.

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

​

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

​

Nhãn trạng thái

• Một 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.
• Một mã định danh runtime như codex cho bạn biết vòng lặp nào đang thực thi lượt này.
• Mộ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
• OpenAI
• Plugin harness tác tử
• Vòng lặp tác tử
• Mô hình
• Trạng thái