Bộ khung Codex của OpenClaw: phiên, thông tin xác thực và thanh toán

OpenClaw Codex harness là plugin @openclaw/codex chính thức: nó chuyển một lượt tác vụ của agent OpenClaw cho Codex app-server của OpenAI để Codex quản lý vòng lặp model, tiếp tục thread, tiếp tục công cụ và rút gọn ngữ cảnh. Đây không phải sản phẩm ủy thác lập trình, không phải lớp thanh toán và — điểm khiến hầu hết các thiết lập gặp vướng mắc — không phải cách chạy Codex với endpoint API của bên thứ ba. Bạn thực sự cần yếu tố nào trong số đó là quyết định mà trang này được tạo ra để giúp bạn đưa ra.

Ưu tiên ngày tháng, để không có nội dung nào ở đây thiếu mốc thời gian. Gói npm openclaw đang ở phiên bản 2026.9.5 và yêu cầu Node >=24.16.0 <25 || >=26.1.0; @openclaw/codex cũng ở phiên bản 2026.9.5, được phát hành ngày 18 tháng 9 năm 2026. Cả hai đều được đọc từ registry vào ngày 21 tháng 9 năm 2026. Ba dự án không liên quan dùng chung các tên này và không con số nào của chúng thuộc về nội dung này: pjasicek/OpenClaw tự mô tả là bản triển khai lại của game platformer Captain Claw năm 1997, gói npm không có namespace codex là một "trình tạo trang tĩnh và tài liệu mã" được phát hành lần cuối vào năm 2012, còn CLI của OpenAI là @openai/codex (0.155.1 vào cùng ngày).

Năm bề mặt OpenClaw cùng dùng tên "Codex"

Tài liệu agent-runtimes của OpenClaw gọi chúng là "cố ý độc lập". Chọn nhầm thành phần là lý do phổ biến nhất khiến một cấu hình trông có vẻ đúng nhưng không làm gì cả.

Tên thứ sáu hoàn toàn không thuộc về OpenClaw. openclaw-code-agent là plugin bên thứ ba chạy các phiên lập trình trong nền với phê duyệt kế hoạch và cô lập worktree; README riêng của nó nêu rõ rằng nó tách biệt với plugin runtime acpx được OpenClaw đóng gói sẵn và plugin lõi codex được đóng gói sẵn. Nếu bạn đến đây vì muốn ủy thác thay vì thay thế runtime, đó là một sản phẩm khác với các khóa cấu hình khác.

Bật harness và xác minh rằng harness đã được bật

Đường dẫn được tài liệu hóa gồm hai lệnh — cài plugin, sau đó đăng nhập.

openclaw plugins install @openclaw/codex
openclaw models auth login --provider openai

Tiếp theo là cấu hình tối thiểu. Nếu bạn sử dụng danh sách plugins.allow, hãy thêm "codex" vào danh sách đó.

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      // The docs' own example ref. Legacy codex-cli/* refs are
      // repaired to the same openai/<model> route by doctor --fix.
      model: "openai/gpt-6-astra",
    },
  },
}

Tài liệu harness nêu rõ hai chi tiết. Các thay đổi cấu hình plugin được áp dụng tự động trong chế độ tải lại hybrid, nhưng một chat hiện có cần /new hoặc /reset trước để lượt tiếp theo phân giải harness từ cấu hình hiện tại. Ngoài ra, hồ sơ công cụ hiệu lực phải cho phép các khả năng shell và filesystem native: coding và full cho phép, còn messaging và minimal vô hiệu hóa bề mặt native. Sandbox OpenClaw thông thường hoặc chính sách công cụ bị hạn chế là mức giới hạn hẹp hơn trong cùng tài liệu — nó vô hiệu hóa chế độ mã native trừ khi bạn bật đường dẫn sandbox exec-server thử nghiệm — và khi sandbox vô hiệu hóa bề mặt native, các lệnh shell được phép vẫn có thể truy cập qua sandbox_exec.

Yêu cầu phiên bản, được kiểm tra ngày 21 tháng 9 năm 2026 đối chiếu với tài liệu tham khảo về transport của app-server: plugin quản lý Codex app-server ổn định 0.154.0, trong khi các executable tùy chỉnh cụ thể, app-server từ xa và binary desktop macOS phải báo phiên bản semantic có thể phân tích là 0.149.0 trở lên. Phiên bản mới nhất của npm @openai/codex là 0.155.1 vào cùng ngày, vì vậy phiên bản được quản lý chậm hơn một bản vá — đó là lý do mọi hướng dẫn nói "Codex latest" mà không có ngày sẽ lỗi thời trong vài ngày. Việc di chuyển từ thiết lập cũ cũng quan trọng: trang agent-runtimes cho biết backend Codex CLI được OpenClaw đóng gói đã bị xóa trong v2026.5.14, và các ref codex-cli/* cũ sẽ được sửa thành cùng route Codex app-server openai/<model> dưới openclaw doctor --fix, thành phần quản lý việc sửa route Codex cũ nói chung.

Để xác minh: một lượt chạy được Codex hỗ trợ báo Runtime: OpenAI Codex dưới /status, còn /codex status, /codex models và /codex binding kiểm tra trạng thái app-server. Lệnh lint — openclaw doctor --lint --only codex/managed-app-server --json — kiểm tra binary được quản lý, nhưng tài liệu mô tả đây là thao tác chỉ đọc và loại binary Codex Desktop được chọn, lệnh tùy chỉnh cụ thể cùng app-server từ xa khỏi bước kiểm tra gói đó.

Có một điểm mâu thuẫn đáng biết trước khi bạn xây dựng dựa trên điều này. Tài liệu app-server của OpenAI nêu rằng "lệnh app-server và transport WebSocket đang thử nghiệm và không được hỗ trợ cho workload production" — lưu ý cảnh báo đề cập cả lệnh lẫn transport. OpenClaw xây dựng một tính năng được phát hành dựa trên lệnh đó, và trường transport của nó mặc định là stdio, còn websocket chỉ được dùng khi bạn cấu hình url. Cả hai nhận định đều đúng đồng thời; hãy đưa ra quyết định khi xem xét cả hai.

Artifact ủy thác, quyền, hủy và tiếp tục

Tài liệu harness trung thực về giới hạn của những gì trạng thái subagent native có thể chứng minh: việc thực thi, kết quả tác vụ và việc gửi kết quả là các sự kiện riêng biệt, một thread native đang rảnh, bị gián đoạn hoặc chưa được tải không chứng minh tác vụ đã thành công, và khi không thể xác nhận chắc chắn việc đóng, tác vụ sẽ yêu cầu bạn thử lại thao tác đóng. Subagent Codex native là cơ chế riêng của Codex — việc ủy thác OpenClaw hoặc ACP rõ ràng vẫn đi qua sessions_spawn.

Theo bảng trường cấu hình của plugin, quyền thực thi cho app-server mà OpenClaw tạo ra mặc định là mode yolo, chính sách phê duyệt never và sandbox danger-full-access, trừ khi các yêu cầu Codex cục bộ không cho phép thiết lập đó; trong trường hợp ấy, mặc định của guardian ưu tiên phê duyệt theo yêu cầu và workspace-write, nếu không thì read-only; requestTimeoutMs, thời gian chờ cho các lệnh gọi control-plane của app-server, mặc định là 60000. Đây là các giá trị mặc định của OpenClaw cho tiến trình mà nó khởi chạy, không phải của Codex CLI, và trong một repository xa lạ, mặc định đầu tiên đó là thiết lập cần xem xét trước lần chạy đầu tiên.

Việc điều khiển trong một lượt chạy là native: /codex stop, /codex steer, /codex resume, /codex detach, /codex bind, /codex compact, /codex threads, /codex goal, /codex model, /codex fast và /codex permissions. Một lượt chạy bị hạn chế áp dụng theo từng lượt thay vì là chế độ phiên, và chỉ trong lượt đó, nó vô hiệu hóa Code Mode native, các lựa chọn môi trường, các MCP server đã cấu hình và relay hook native. Hợp đồng hỗ trợ runtime v1 của OpenClaw cũng liệt kê các tính năng không được hỗ trợ: thay đổi đối số công cụ native (pre-tool hook có thể chặn, nhưng OpenClaw không viết lại đối số), lịch sử transcript native của Codex có thể chỉnh sửa, can thiệp rút gọn ngữ cảnh và ghi lại request API model chính xác từng byte — vì vậy nếu yêu cầu kiểm toán của bạn là request gửi đi chính xác, runtime này không thể cung cấp nó.

Xác thực, quyền lợi gói và mức tiêu thụ token là ba vấn đề khác nhau

Đọc từ trang chính sách Codex app-server của OpenClaw vào ngày 21 tháng 9 năm 2026. Trên vấn đề này còn có một bẫy về tên gọi: trang giá API của OpenAI cho biết Priority processing đã được đổi tên thành Fast mode vào ngày 30 tháng 7 năm 2026 và bạn có thể gửi service_tier là "priority" hoặc "fast", trong khi appServer.serviceTier của OpenClaw ghi lại "priority" và "flex" và chuẩn hóa "fast" cũ thành "priority" — theo hướng ngược lại. "Bật fast mode" có ý nghĩa khác nhau trong hai hệ thống.

Vì sao endpoint của bên thứ ba khiến harness không còn được sử dụng

Đây là sự thật duy nhất mà hầu hết các bài viết của bên thứ ba diễn giải ngược. bảng runtime agent ngầm định của OpenClaw, đối với runtime provider hoặc model chưa được đặt hoặc là auto, cho biết:

Vì vậy, việc trỏ OpenClaw đến bất kỳ base URL nào của bên thứ ba — bao gồm Kunavo — sẽ đưa lượt chạy vào runtime tích hợp sẵn của OpenClaw theo thiết kế. Chỉ riêng tiền tố openai/* không bao giờ chọn harness, và việc ép buộc agentRuntime.id: "codex" cũng không thể khắc phục điều đó. Trang runtimes cho biết thiết lập này "yêu cầu một Codex harness đã đăng ký; các route hoặc cơ chế xác thực không được hỗ trợ sẽ bị từ chối an toàn, ngoại trừ việc tùy chọn ghi đè request do người dùng khai báo có thể sử dụng fallback OpenClaw exact-request đã khai báo của Codex trước khi thực thi" — vì vậy chỉ có hai kết quả: lượt chạy thất bại hoặc lượt chạy OpenClaw, và không kết quả nào là Codex trên endpoint tùy chỉnh. Các trường cấu hình được tài liệu hóa của plugin cũng không có thiết lập base URL cho model; trường url duy nhất ở đó là địa chỉ WebSocket hoặc unix:// riêng của app-server. Việc appServer.args có thể đưa lén tùy chọn ghi đè provider vào app-server được quản lý hay không chưa được tài liệu hóa và chưa được kiểm thử; trang này không trình bày nó như một giải pháp thay thế.

Một route dùng runtime tích hợp sẵn cũng định hình lại request, và trang provider tùy chỉnh của OpenClaw nêu cụ thể phạm vi của từng quy tắc. Đối với api: "openai-completions" trên endpoint không phải của chính nhà cung cấp — được định nghĩa là bất kỳ baseUrl không rỗng nào có host không phải api.openai.com — OpenClaw buộc compat.supportsDeveloperRole thành false và ghi đè một true được chỉ định rõ ràng. Riêng các route tương thích với OpenAI kiểu proxy "bỏ qua việc định hình request chỉ dành cho API gốc của OpenAI": không có service_tier, không có store của Responses, không có store của Completions, không có gợi ý bộ nhớ đệm prompt, không có định hình payload tương thích với suy luận OpenAI và không có header ghi nguồn ẩn. Khi không có service_tier trong request được gửi đi, Fast mode và Flex không thể được chọn trên route đó. Thay vào đó, trang này cung cấp truyền thẳng params.extra_body cho các proxy Completions tương thích với OpenAI, headers theo từng provider và models.providers.<id>.timeoutSeconds cho các host chậm hoặc từ xa.

Bản thân Codex là nửa còn lại của câu chuyện và có tính cho phép rộng hơn: trang cấu hình nâng cao của Codex cho thấy ~/.codex/config.toml hỗ trợ [model_providers.<id>] với base_url và env_key. Tuy nhiên, có một điều kiện bắt buộc — tài liệu tham khảo cấu hình nêu rằng đối với model_providers.<id>.wire_api, "responses là giá trị duy nhất được hỗ trợ và là giá trị mặc định khi bị bỏ qua". Vì vậy, một endpoint chỉ cung cấp Chat Completions không thể điều khiển Codex. Cùng trang cấu hình nâng cao dành riêng các id tích hợp sẵn openai, ollama và lmstudio, đồng thời liệt kê model_provider và model_providers trong số các khóa mà Codex bỏ qua trong .codex/config.toml cấp dự án, vì vậy các khóa provider phải nằm trong cấu hình cấp người dùng. Kunavo triển khai một bề mặt Responses native tại /v1/responses, nhờ đó thiết lập Codex CLI trở nên khả thi — nhưng đó là Codex CLI độc lập, không phải OpenClaw harness, và Kunavo chưa kiểm thử khi chạy với cả hai ứng dụng.

Chi phí của phần mềm và chi phí của token

Bản thân OpenClaw có giá $0. Mục lục tài liệu của dự án mô tả đây là dự án được cấp phép MIT, do cộng đồng thúc đẩy, được phát triển bởi một quỹ độc lập theo điều khoản 501(c)(3), với "Không có gói trả phí"; @openclaw/codex được phát hành miễn phí trên registry npm công khai. Mọi chi phí thực tế là máy bạn chạy Gateway cùng với mức sử dụng model, và mức sử dụng model phát sinh theo một trong ba loại hợp đồng.

Từ trang giá Codex của OpenAI, được kiểm tra ngày 21 tháng 9 năm 2026. Bảng này cần đi kèm ba lưu ý. Thẻ giá chỉ công bố "Từ $100" cho Pro; bài viết riêng của OpenAI Giới thiệu các gói ChatGPT Pro nêu một gói $200 cao hơn, nhưng việc đăng ký mới và nâng cấp gói này đã bị tạm dừng kể từ ngày 10 tháng 9 năm 2026, vì vậy hãy xác nhận khi thanh toán thay vì lập ngân sách theo một con số mà trang này không thấy trên thẻ giá. Mức sử dụng được bao gồm chỉ được công bố dưới dạng khoảng ước tính số tin nhắn cục bộ trong mỗi khoảng thời gian năm giờ, không phải số tin nhắn cố định. Ngoài ra, mức tín dụng sau giới hạn được bao gồm được công bố theo tín dụng trên một triệu token, nhưng trang giá đó không nêu giá trị đô la của một tín dụng — vì vậy không cung cấp quy đổi sang đô la cho dòng đó. Riêng GPT-5.5 sẽ ngừng có mặt trên ChatGPT, ChatGPT Work và Codex ở mọi gói vào ngày 14 tháng 10 năm 2026, trong khi OpenAI API không bị ảnh hưởng.

Hợp đồng thứ ba là một gateway trên runtime tích hợp sẵn của OpenClaw. Giả sử một lượt ủy quyền gửi 180.000 token đầu vào chưa lưu bộ nhớ đệm và nhận 9.000 token đầu ra; mức giá là giá catalog Kunavo hiện hành trên mỗi một triệu token.

Đây là phép tính token minh họa, không phải chi phí tác vụ đo được và không phải mức trần hóa đơn — hình dạng lượt là một giả định, và một lượt agent thực tế sẽ gửi lại ngữ cảnh trong mỗi vòng khứ hồi công cụ. Số tiền trong catalog của Kunavo là mức sàn tính phí chứ không phải mức giới hạn: khi upstream báo cáo khoản phí, hóa đơn là giá trị lớn hơn giữa chi phí catalog và chi phí upstream nhân với mức cộng giá áp dụng. Phí bộ nhớ đệm và công cụ bên ngoài nằm ngoài ví dụ này. Mức nạp tối thiểu là $10 tín dụng trả trước, dùng để nạp số dư thay vì mua gói — xem chi tiết thanh toán.

Kunavo không cung cấp model embedding, model chuyển văn bản thành giọng nói hay model chuyển giọng nói thành văn bản. Kunavo không phục vụ các bước đó trên bất kỳ route nào, vì vậy hãy chuyển chúng sang một nhà cung cấp có cung cấp các dịch vụ này.

Ranh giới đó quan trọng ở đây vì bảng bề mặt phía trên giữ riêng một route OpenAI Platform không phải agent với harness, và khóa Gateway chỉ bao phủ các model trò chuyện trong catalog Kunavo.

Tuyến nào thắng trong trường hợp nào

Nếu câu trả lời là dòng gateway, hãy bắt đầu từ tích hợp Codex CLI để xem cấu trúc Responses API, so sánh các lựa chọn trong API tốt nhất cho OpenClaw và API tốt nhất cho Codex, rồi tạo tài khoản Kunavo khi bạn sẵn sàng nạp tiền cho một khóa. Đối với phần ngân sách của một trợ lý tự lưu trữ, giá OpenClaw tách riêng chi phí phần mềm, lưu trữ và model.

Câu hỏi thường gặp

Bảng runtime, thứ tự xác thực, cảnh báo app-server, cổng wire_api, các phiên bản cố định và giá gói ở trên được lấy vào ngày 21 tháng 9 năm 2026 từ tài liệu riêng của OpenClaw và OpenAI, trung tâm trợ giúp OpenAI và các mục trong registry npm cho openclaw, @openclaw/codex, @openai/codex, codex và openclaw-code-agent. Mỗi nhận định đều liên kết đến trang nguồn; khi tài liệu không giải quyết được một câu hỏi, văn bản nêu rõ điều đó thay vì lấp đầy khoảng trống. Kunavo chưa chạy thử runtime của OpenClaw hoặc harness Codex, vì vậy mọi cấu hình ở đây được đối chiếu với tài liệu nguồn chứ không được chứng minh trên endpoint Kunavo. Mức giá token của Kunavo lấy từ catalog hiện hành, và mỗi con số đô la là phép tính minh họa.