Chuyển đến nội dung chính

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.

Thời gian chạy tác nhân là thành phần sở hữu một vòng lặp mô hình đã được chuẩn bị: nó nhận prompt, điều khiển đầu ra của mô hình, xử lý các lệnh gọi công cụ gốc, và trả lượt đã hoàn tất về OpenClaw. Thời gian chạy dễ bị nhầm với nhà cung cấp vì cả hai đều xuất hiện gần phần cấu hình mô hình. Chúng là các lớp khác nhau:
LớpVí dụÝ nghĩa
Nhà cung cấpopenai, anthropic, openai-codexCách OpenClaw xác thực, khám phá mô hình, và đặt tên tham chiếu mô hình.
Mô hìnhgpt-5.5, claude-opus-4-6Mô hình được chọn cho lượt tác nhân.
Thời gian chạy tác nhânpi, codex, claude-cliVòng lặp hoặc backend cấp thấp thực thi lượt đã chuẩn bị.
KênhTelegram, Discord, Slack, WhatsAppNơi thông điệp đi vào và rời khỏi OpenClaw.
Bạn cũng sẽ thấy từ bộ thực thi trong mã. Bộ thực thi là phần triển khai cung cấp một thời gian chạy tác nhân. Ví dụ, bộ thực thi Codex được đóng gói sẵn triển khai thời gian chạy codex. Cấu hình công khai dùng agentRuntime.id trên các mục nhà cung cấp hoặc mô hình; các khóa thời gian chạy toàn tác nhân là di sản và bị bỏ qua. openclaw doctor --fix xóa các ghim thời gian chạy toàn tác nhân cũ và ghi lại các tham chiếu mô hình thời gian chạy di sản thành tham chiếu nhà cung cấp/mô hình chuẩn cùng với chính sách thời gian chạy theo phạm vi mô hình khi cần. Có hai nhóm thời gian chạy:
  • Bộ thực thi nhúng chạy bên trong vòng lặp tác nhân đã chuẩn bị của OpenClaw. Hiện tại nhóm này gồm thời gian chạy pi tích hợp sẵn cùng các bộ thực thi 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 ở dạng chuẩn. Ví dụ, anthropic/claude-opus-4-7 với agentRuntime.id: "claude-cli" theo phạm vi mô hình nghĩa là “chọn mô hình Anthropic, thực thi qua Claude CLI.” claude-cli không phải là id bộ thực thi nhúng và không được truyền vào lựa chọn AgentHarness.

Các bề mặt Codex

Phần lớn sự nhầm lẫn đến từ nhiều bề mặt khác nhau cùng dùng tên Codex:
Bề mặtTên/cấu hình OpenClawViệc nó làm
Thời gian chạy app-server Codex gốctham chiếu mô hình openai/*Chạy các lượt tác nhân nhúng OpenAI qua app-server Codex. Đây là thiết lập đăng ký ChatGPT/Codex thông thường.
Hồ sơ xác thực Codex OAuthnhà cung cấp xác thực openai-codexLưu xác thực đăng ký ChatGPT/Codex mà bộ thực thi app-server Codex tiêu thụ.
Bộ chuyển đổi Codex ACPruntime: "acp", agentId: "codex"Chạy Codex qua mặt phẳng điều khiển ACP/acpx bên ngoài. Chỉ dùng khi ACP/acpx được yêu cầu rõ ràng.
Bộ lệnh điều khiển trò chuyện Codex gốc/codex ...Liên kết, tiếp tục, điều hướng, dừng, và kiểm tra các luồng app-server Codex từ trò chuyện.
Tuyến OpenAI Platform API cho các bề mặt không phải tác nhânopenai/* cộng xác thực khóa APIDùng cho các API OpenAI trực tiếp như hình ảnh, embedding, giọng nói, và thời gian thực.
Các bề mặt đó độc lập có chủ ý. Bật Plugin codex làm cho các tính năng app-server gốc khả dụng; openclaw doctor --fix sở hữu việc sửa tuyến openai-codex/* di sản và dọn dẹp ghim phiên cũ. Chọn openai/* cho mô hình tác nhân hiện có nghĩa là “chạy phần này qua Codex” trừ khi một bề mặt OpenAI API không phải tác nhân đang được dùng. Thiết lập đăng ký ChatGPT/Codex thông thường dùng Codex OAuth để xác thực, nhưng giữ tham chiếu mô hình là openai/* và chọn thời gian chạy codex:
{
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}
Điều đó nghĩa là OpenClaw chọn một tham chiếu mô hình OpenAI, sau đó yêu cầu thời gian chạy app-server Codex chạy lượt tác nhân nhúng. Nó không có nghĩa là “dùng thanh toán API”, và cũng không có nghĩa là kênh, danh mục nhà cung cấp mô hình, hoặc kho phiên OpenClaw trở thành Codex. Khi Plugin codex được đóng gói sẵn được bật, điều khiển Codex bằng ngôn ngữ tự nhiên nên dùng bề mặt lệnh /codex gốc (/codex bind, /codex threads, /codex resume, /codex steer, /codex stop) thay vì ACP. Chỉ dùng ACP cho Codex khi người dùng yêu cầu rõ ràng ACP/acpx hoặc đang kiểm thử đường dẫn bộ chuyển đổi ACP. Claude Code, Gemini CLI, OpenCode, Cursor, và các bộ thực thi bên ngoài tương tự vẫn dùng ACP. Đây là cây quyết định dành cho tác nhân:
  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 được bật.
  2. Nếu người dùng yêu cầu Codex làm thời gian chạy nhúng hoặc muốn trải nghiệm tác nhân Codex thông thường được hỗ trợ bởi đăng ký, hãy dùng openai/<model>.
  3. Nếu người dùng chọn rõ ràng PI cho một mô hình OpenAI, hãy giữ tham chiếu mô hình là openai/<model> và đặt chính sách thời gian chạy nhà cung cấp/mô hình thành agentRuntime.id: "pi". Hồ sơ xác thực openai-codex đã chọn được định tuyến nội bộ qua phương thức vận chuyển xác thực Codex di sản của PI.
  4. Nếu cấu hình di sản vẫn chứa tham chiếu mô hình openai-codex/*, hãy sửa nó 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 ở nơi tham chiếu mô hình cũ đã ngụ ý điều đó.
  5. Nếu người dùng nói rõ ACP, acpx, hoặc bộ chuyển đổi Codex ACP, hãy dùng ACP với runtime: "acp"agentId: "codex".
  6. Nếu yêu cầu dành cho Claude Code, Gemini CLI, OpenCode, Cursor, Droid, hoặc một bộ thực thi bên ngoài khác, hãy dùng ACP/acpx, không dùng thời gian chạy tác nhân con gốc.
Ý bạn là…Dùng…
Điều khiển trò chuyện/luồng app-server Codex/codex ... từ Plugin codex được đóng gói sẵn
Thời gian chạy tác nhân nhúng app-server Codextham chiếu mô hình tác nhân openai/*
OpenAI Codex OAuthhồ sơ xác thực openai-codex
Claude Code hoặc bộ thực thi bên ngoài khácACP/acpx
Để biết phần tách tiền tố họ OpenAI, xem OpenAINhà cung cấp mô hình. Để biết hợp đồng hỗ trợ thời gian chạy Codex, xem Thời gian chạy bộ thực thi Codex.

Quyền sở hữu thời gian chạy

Các thời gian chạy khác nhau sở hữu các phần khác nhau của vòng lặp.
Bề mặtOpenClaw PI nhúngApp-server Codex
Chủ sở hữu vòng lặp mô hìnhOpenClaw qua runner PI nhúngApp-server Codex
Trạng thái luồng chuẩnBản ghi OpenClawLuồng Codex, cộng bản sao bản ghi OpenClaw
Công cụ động OpenClawVòng lặp công cụ OpenClaw gốcĐược bắc cầu qua bộ chuyển đổi Codex
Công cụ shell và tệp gốcĐường dẫn PI/OpenClawCông cụ gốc Codex, được bắc cầu qua hook gốc nơi được hỗ trợ
Công cụ ngữ cảnhLắp ráp ngữ cảnh OpenClaw gốcOpenClaw projects lắp ráp ngữ cảnh vào lượt Codex
CompactionOpenClaw hoặc công cụ ngữ cảnh đã chọnCompaction gốc Codex, với thông báo OpenClaw và bảo trì bản sao
Phân phối qua kênhOpenClawOpenClaw
Phần tách quyền sở hữu này là quy tắc thiết kế chính:
  • 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 thời gian chạy gốc sở hữu bề mặt, OpenClaw cần sự kiện thời gian chạy hoặc hook gốc.
  • Nếu thời gian chạy gốc sở hữu trạng thái luồng chuẩn, OpenClaw nên sao chép và chiếu ngữ cảnh, không ghi lại các phần nội bộ không được hỗ trợ.

Lựa chọn thời gian chạy

OpenClaw chọn một thời gian chạy nhúng sau khi phân giải nhà cung cấp và mô hình:
  1. Chính sách thời gian chạy theo phạm vi mô hình thắng. Chính sách này có thể nằm trong một 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.
  2. Chính sách thời gian chạy theo phạm vi nhà cung cấp đứng tiếp theo tại models.providers.<provider>.agentRuntime.
  3. Trong chế độ auto, các thời gian chạy 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 có thời gian chạy nào nhận một lượt trong chế độ auto, OpenClaw dùng PI làm thời gian chạy tương thích. Dùng id thời gian chạy rõ ràng khi lần chạy phải nghiêm ngặt.
Các ghim thời gian chạy toàn phiên và toàn tác nhân bị bỏ qua. Điều đó bao gồm OPENCLAW_AGENT_RUNTIME, trạng thái phiên agentHarnessId/agentRuntimeOverride, agents.defaults.agentRuntime, và agents.list[].agentRuntime. Chạy openclaw doctor --fix để xóa cấu hình thời gian chạy toàn tác nhân cũ và chuyển đổi các tham chiếu mô hình thời gian chạy di sản ở nơi OpenClaw có thể giữ nguyên ý định. Các thời gian chạy Plugin nhà cung cấp/mô hình rõ ràng sẽ đóng khi lỗi. Ví dụ, agentRuntime.id: "codex" trên một nhà cung cấp hoặc mô hình nghĩa là Codex hoặc một lỗi lựa chọn/thời gian chạy rõ ràng; nó không bao giờ được âm thầm định tuyến lại về PI. Bí danh backend CLI khác với id bộ thực thi nhúng. Dạng Claude CLI được ưu tiên là:
{
  agents: {
    defaults: {
      model: "anthropic/claude-opus-4-7",
      models: {
        "anthropic/claude-opus-4-7": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}
Các tham chiếu di sản như claude-cli/claude-opus-4-7 vẫn được hỗ trợ để tương thích, nhưng cấu hình mới nên giữ nhà cung cấp/mô hình ở dạng chuẩn và đặt backend thực thi trong chính sách thời gian chạy nhà cung cấp/mô hình. Chế độ auto có chủ ý thận trọng với hầu hết nhà cung cấp. Mô hình tác nhân OpenAI là ngoại lệ: thời gian chạy chưa đặt và auto đều phân giải về bộ thực thi Codex. Cấu hình thời gian chạy PI rõ ràng vẫn là tuyến tương thích theo kiểu chọn tham gia cho các lượt tác nhân openai/*; khi được ghép với một hồ sơ xác thực openai-codex đã chọn, OpenClaw định tuyến PI nội bộ qua phương thức vận chuyển xác thực Codex di sản trong khi vẫn giữ tham chiếu mô hình công khai là openai/*. Các ghim phiên OpenAI PI cũ bị lựa chọn thời gian chạy bỏ qua và có thể được dọn bằng openclaw doctor --fix. Nếu openclaw doctor cảnh báo rằng Plugin codex được bật trong khi openai-codex/* vẫn còn trong cấu hình, hãy coi đó là trạng thái tuyến di sản. Chạy openclaw doctor --fix để ghi lại nó thành openai/* với thời gian chạy Codex.

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

Khi thời gian chạy không phải PI, nó nên ghi tài liệu các bề mặt OpenClaw mà nó hỗ trợ. Dùng dạng này cho tài liệu thời gian chạy:
Câu hỏiVì sao điều này quan trọng
Ai sở hữu vòng lặp mô hình?Xác định nơi diễn ra việc thử lại, tiếp tục công cụ và quyết định câu trả lời cuối cùng.
Ai sở hữu lịch sử luồng chuẩn tắc?Xác định liệu OpenClaw có thể chỉnh sửa lịch sử hay chỉ phản chiếu lịch sử đó.
Các công cụ động của OpenClaw có hoạt động không?Nhắn tin, phiên, Cron và các công cụ do OpenClaw sở hữu phụ thuộc vào điều này.
Các hook công cụ động có hoạt động không?Các Plugin kỳ vọng before_tool_call, after_tool_call và middleware quanh các công cụ do OpenClaw sở hữu.
Các hook công cụ gốc có hoạt động không?Shell, patch và các công cụ do môi trường thực thi sở hữu cần hỗ trợ hook gốc cho chính sách và quan sát.
Vòng đời của công cụ ngữ cảnh có chạy không?Các Plugin bộ nhớ và ngữ cảnh phụ thuộc vào vòng đời assemble, ingest, after-turn và Compaction.
Dữ liệu Compaction nào được hiển thị?Một số Plugin chỉ cần thông báo, trong khi các Plugin khác cần siêu dữ liệu được giữ lại/bị loại bỏ.
Điều gì được cố ý không hỗ trợ?Người dùng không nên giả định tính tương đương PI khi môi trường thực thi gốc sở hữu nhiều trạng thái hơn.
Hợp đồng hỗ trợ môi trường thực thi Codex được ghi lại trong Môi trường thực thi harness Codex.

Nhãn trạng thái

Đầu ra trạng thái có thể hiển thị cả nhãn ExecutionRuntime. Hãy hiểu chúng như chẩn đoán, không phải tên nhà cung cấp.
  • 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 môi trường thực thi như codex cho bạn biết vòng lặp nào đang thực thi lượt này.
  • Nhãn kênh như Telegram hoặc Discord cho bạn biết cuộc trò chuyện đang diễn ra ở đâu.
Nếu một lần chạy vẫn hiển thị môi trường thực thi không mong đợi, trước tiên hãy kiểm tra chính sách môi trường thực thi của nhà cung cấp/mô hình đã chọn. Các ghim môi trường thực thi phiên cũ không còn quyết định định tuyến.

Liên quan