Giám sát Codex

Mục tiêu

Tính năng giám sát Codex cho phép người vận hành OpenClaw khám phá các phiên Codex gốc và, khi an toàn, tạo một nhánh cục bộ thông qua giao diện Chat thông thường của OpenClaw. Codex App Server vẫn là thành phần sở hữu luồng hội thoại và vòng lặp mô hình. OpenClaw cung cấp danh mục đội máy, giao diện người vận hành đã xác thực, liên kết phiên và phân phối qua kênh.

Tính năng này thuộc Plugin codex chính thức. Không có Plugin Supervisor riêng hoặc bản triển khai giao thức Codex thứ hai.

Ranh giới sản phẩm

Danh mục được đăng ký bất cứ khi nào Plugin Codex đang hoạt động, trừ khi tính năng khám phá phiên gốc bị tắt rõ ràng bằng:

plugins.entries.codex.config.sessionCatalog.enabled = false

Bật các công cụ giám sát dành cho tác nhân bằng:

plugins.entries.codex.config.supervision.enabled = true

Sản phẩm ban đầu hiện đang hoạt động được chủ ý giới hạn hơn kế hoạch dài hạn cho đội máy:

• Chỉ liệt kê các luồng Codex chưa được lưu trữ.
• Nhóm các hàng cục bộ và hàng của Node đã ghép nối, được chọn tham gia theo danh tính máy chủ ổn định.
• Tạo một nhánh Chat thông thường bị khóa theo mô hình từ một luồng cục bộ trên Gateway đã lưu hoặc đang rảnh, khởi động luồng harness Codex đầy đủ của nhánh đó ở lượt đầu tiên, hoặc mở Chat đã được tạo cho một nhánh trước đó.
• Chỉ lưu trữ một luồng cục bộ trên Gateway đã lưu hoặc đang rảnh sau khi có xác nhận rõ ràng rằng không có trình chạy nào khác.
• Hiển thị các nguồn cục bộ đang hoạt động mà không có điều khiển tạo nhánh mới hoặc lưu trữ, đồng thời vẫn cho phép mở một Chat được giám sát hiện có.
• Hiển thị các hàng mới nhất theo từng máy chủ trong thanh bên chính, giữ toàn bộ danh mục trên trang phiên và cung cấp khả năng đọc bản chép lời có giới hạn, phân trang bằng con trỏ cho các hàng cục bộ và hàng của Node đã ghép nối.
• Cô lập lỗi danh mục theo từng máy chủ.

Danh mục là tập hợp chưa được lưu trữ. Một hàng trong đó vẫn có thể có trạng thái lượt là đang rảnh, đang hoạt động, notLoaded hoặc lỗi.

Tính năng giám sát dành cho tác nhân vẫn yêu cầu chủ động chọn tham gia. Quy trình hướng dẫn thiết lập ban đầu cố gắng cài đặt và bật tính năng này sau khi phát hiện thành công bản cài đặt Codex gốc và backend suy luận đã chọn vượt qua kiểm tra trực tiếp, độc lập với backend chính mà người dùng chọn. Tính năng giám sát chỉ được kích hoạt khi quá trình thiết lập Plugin theo cơ hội đó thành công. Plugin bị tắt rõ ràng, lệnh chặn theo chính sách hoặc supervision.enabled: false vẫn có hiệu lực quyết định đối với các công cụ giám sát, nhưng không tắt danh mục phiên dành cho người vận hành. sessionCatalog.enabled: false tắt tính năng khám phá dành cho người vận hành và các lệnh danh mục của Node đã ghép nối; trình cung cấp và harness Codex vẫn hoạt động.

Quyền sở hữu

Plugin codex sở hữu toàn bộ hành vi của Codex App Server:

• khám phá điểm cuối và vòng đời kết nối
• khởi tạo giao thức và kiểm tra phiên bản
• liệt kê, đọc, tiếp tục, lưu trữ và xử lý sự kiện của luồng
• cầu nối phê duyệt và đầu vào của người dùng
• liên kết luồng gốc với các phiên OpenClaw
• thực thi mô hình và harness chỉ dành cho Codex sau khi tiếp tục

Control UI và Gateway sử dụng dịch vụ do Plugin đó sở hữu. Chúng không đọc trực tiếp các tệp triển khai Codex và không triển khai một ứng dụng khách App Server khác.

Cấu trúc liên kết cục bộ mặc định là:

Codex Desktop -> App Server stdio riêng tư -> thư mục gốc Codex của người dùng                                             ^Plugin Codex của OpenClaw -> kết nối App Server giám sát  (mặc định là stdio thư mục gốc người dùng được quản lý; các thiết lập appServer rõ ràng được tuân thủ)  -> danh mục nguồn thụ động và đọc  -> ghim ảnh chụp nhanh -> nhánh nguồn appServer chuẩn  -> chèn lịch sử hiển thị và mọi lượt Chat được giám sát sau đó Các phiên Codex thông thường của OpenClaw -> stdio thư mục gốc tác nhân được quản lý theo mặc định  -> các luồng harness đầy đủ thông thường -> Chat OpenClaw và phân phối qua kênh

Việc bật giám sát không thay đổi harness Codex thông thường: theo mặc định, nó vẫn có phạm vi theo tác nhân. Kết nối giám sát riêng mặc định dùng stdio thư mục gốc người dùng được quản lý, vì vậy các thao tác danh mục và ảnh chụp nhanh của nó thấy được các luồng gốc đã lưu. Các thiết lập kết nối appServer rõ ràng được tuân thủ. Khi homeScope chưa được đặt, kết nối giám sát phân giải nó thành "user" cho stdio hoặc Unix và "agent" cho WebSocket. Chỉ đặt appServer.homeScope: "user" rõ ràng khi harness thông thường cũng cần dùng chung thư mục gốc Codex gốc. Chat được tiếp nhận từ nhóm Codex trong thanh bên là trường hợp ngoại lệ: liên kết giám sát riêng của Chat đó giữ các lượt đọc nguồn, việc tạo nhánh chuẩn và các lượt sau này trên kết nối giám sát. Trạng thái trực tiếp và quyền sở hữu vẫn cục bộ theo tiến trình; một luồng mà tiến trình giám sát của OpenClaw không biết đến là notLoaded ngay cả khi Codex Desktop đang chủ động chạy luồng đó.

Codex có một daemon cục bộ chuẩn đang ở trạng thái thử nghiệm với hợp đồng khởi động do trình cài đặt quản lý riêng. Tính năng này không được ngầm khởi động, tuyên bố sở hữu hoặc giả định daemon đó.

Luồng danh mục

Phương thức Gateway chung sessions.catalog.list điều phối đến trình cung cấp danh mục codex, trình này luôn yêu cầu archived: false và để App Server áp dụng giá trị mặc định cho nguồn tương tác của nó: cli, vscode, Atlas và ChatGPT. Phương thức này kết hợp:

1. Các kết quả thread/list cục bộ trên Gateway từ App Server giám sát, mặc định dùng stdio thư mục gốc người dùng được quản lý.
2. Các kết quả codex.appServer.threads.list.v1 từ mỗi Node đã kết nối và được chọn tham gia.

Việc chọn bản chép lời sử dụng thread/turns/list với itemsView: "full" ở cục bộ hoặc lệnh codex.appServer.thread.turns.list.v1 có phiên bản trên Node đã chọn. Mỗi phản hồi chứa tối đa 20 lượt đã lưu cùng các con trỏ tiến/lùi không trong suốt. Control UI yêu cầu các trang theo thứ tự mới nhất trước, hiển thị từng trang theo thứ tự thời gian và chèn các trang cũ hơn vào đầu. Giao diện này không bao giờ dự phòng về thread/read không giới hạn. OpenClaw cũng từ chối mọi trang mục đã tuần tự hóa lớn hơn 20 MiB trước khi trang đó có thể đi qua phương thức truyền tải của Node hoặc Gateway.

Bản triển khai Node đã ghép nối gốc trên macOS chỉ hỗ trợ giá trị chưa đặt/mặc định hoặc appServer.transport: "stdio" rõ ràng với phạm vi giám sát chưa đặt/mặc định hoặc appServer.homeScope: "user" rõ ràng. Nó chuyển command, args đã cấu hình và clearEnv đã chuẩn hóa vào tiến trình con. Với "unix", "websocket" hoặc homeScope: "agent" rõ ràng, nó không quảng bá năng lực danh mục lẫn lệnh; lời gọi trực tiếp cũng đóng khi lỗi. Nó tuyệt đối không được để lộ thư mục gốc Codex của người dùng cho cấu hình có phạm vi theo tác nhân hoặc thay thế stdio cục bộ cho một điểm cuối rõ ràng.

Phép chiếu danh mục chuẩn hóa mã định danh, tiêu đề, cwd, trạng thái, cờ chờ đang hoạt động, dấu thời gian, nguồn, trình cung cấp mô hình, phiên bản Codex và nhánh Git. Nó không trả về bản xem trước bản chép lời, lượt, đường dẫn triển khai, đường dẫn thư mục gốc Codex, Git remote, SHA commit, điểm cuối thô hoặc lỗi App Server thô. Phản hồi bản chép lời chỉ chứa trang mục App Server được yêu cầu rõ ràng và các con trỏ không trong suốt của trang đó.

Lỗi máy chủ được giữ cục bộ trong kết quả của từng máy chủ. Một Node ngoại tuyến hoặc App Server cục bộ không khả dụng không xóa các máy chủ lành mạnh khỏi trang. Khả năng kết nối là thuộc tính của máy chủ, không phải trạng thái luồng: kết quả máy chủ bị lỗi không chứa hàng phiên mới và không chiếu offline lên các luồng gốc.

Control UI yêu cầu các bản cập nhật danh mục tăng dần. Mỗi máy chủ cục bộ hoặc đã ghép nối xuất hiện khi quá trình liệt kê App Server của chính nó hoàn tất; phản hồi tổng hợp vẫn là ảnh chụp nhanh phục vụ khả năng tương thích và khôi phục. Trang hiển thị được đối soát sau khi khả năng kết nối thay đổi, khi được lấy nét và tối đa mỗi 30 giây, với một lượt nhanh hơn sau các thay đổi. Do đó, các phiên Codex gốc được tạo trong một ứng dụng khách khác cuối cùng vẫn được phát hiện mà không cần nhập chúng vào kho lưu trữ OpenClaw.

Khám phá danh mục là thao tác thụ động. Việc liệt kê hoặc đọc siêu dữ liệu không được gọi thread/resume, đăng ký ứng dụng khách OpenClaw nhận các yêu cầu luồng trực tiếp hoặc trả lời một yêu cầu phê duyệt.

Tìm kiếm chỉ theo tiêu đề và không phân biệt chữ hoa chữ thường. Đối với mỗi trang danh mục được trả về, Gateway và máy Mac đã ghép nối quét một số lượng trang gốc có giới hạn mà không chuyển truy vấn đến App Server, vì tìm kiếm gốc cũng có thể khớp với bản xem trước bản chép lời. Con trỏ gốc được trả về cho phép bên gọi tiếp tục quá trình quét.

Ranh giới CLI dành cho người vận hành

Plugin đăng ký ba lệnh shell được Gateway hỗ trợ:

openclaw codex sessions [--search <text>] [--host <id>] [--limit <count>] [--cursor <cursor>] [--json] [gateway-options]openclaw codex continue <thread-id> [--json] [gateway-options]openclaw codex archive <thread-id> --confirm-no-other-runner [--json] [gateway-options]

[gateway-options] là --url <url>, --token <token>, --timeout <ms> và công tắc --expect-final được kế thừa. Thời gian chờ mặc định của thao tác liệt kê phiên là 75,000 ms; thao tác tiếp tục và lưu trữ mặc định là 30,000 ms; --expect-final không có tác dụng bổ sung đối với các RPC đơn ngôi này. Tìm kiếm phiên chỉ theo tiêu đề và không phân biệt chữ hoa chữ thường; mỗi phản hồi quét một chuỗi trang gốc có giới hạn và --cursor tiếp tục với các kết quả cũ hơn. Giới hạn mặc định là 50 cho mỗi máy chủ và chấp nhận từ 1 đến 100; con trỏ yêu cầu một đích --host ổn định. Không lệnh nào chấp nhận tùy chọn archived/include-archived. Chỉ sessions có thể nhắm đến các máy chủ đã ghép nối; continue và archive luôn gửi hostId: "gateway:local", còn thao tác lưu trữ yêu cầu cờ xác nhận rõ ràng.

Không gian tên shell không phải là không gian tên thời gian chạy /codex trong Chat. Cụ thể, /codex sessions --host <node> liệt kê các tệp phiên Codex CLI trên một Node, /codex threads liệt kê các luồng App Server cho kết nối của cuộc hội thoại hiện tại và /codex resume hoặc /codex bind thay đổi liên kết của cuộc hội thoại đó. Các lệnh này không thay thế sessions.catalog.continue và không có lệnh thời gian chạy /codex continue hoặc /codex archive.

Tiếp tục cục bộ

Đối với một hàng cục bộ trên Gateway đã lưu hoặc đang rảnh, UI gọi sessions.catalog.continue với catalogId: "codex" cùng mã định danh máy chủ và luồng. Plugin:

1. Tái sử dụng Chat được giám sát hiện có khi nguồn đã có một Chat.
2. Nếu không, chiếu lịch sử người dùng và trợ lý có giới hạn đến hết lượt cuối cùng đã lưu và kết thúc trong nguồn (hoàn tất, bị gián đoạn hoặc thất bại) vào một Chat OpenClaw mới và ghi lại một nhánh harness đang chờ xử lý.
3. Lưu chính sách khóa mô hình chỉ dành cho Codex đang chờ xử lý, thay vì một lựa chọn mô hình hoặc trình cung cấp cụ thể, cùng phạm vi kết nối giám sát riêng tư, rồi trả về sessionKey của OpenClaw.

Phép chiếu lịch sử chọn phần cuối mới nhất của các thông điệp người dùng và trợ lý có thể hiển thị, với giới hạn cứng là 200 thông điệp, tổng cộng 512 KiB văn bản UTF-8 và 64 KiB cho mỗi thông điệp. Nó thay thế đầu vào hình ảnh và hình ảnh cục bộ bằng [Image attachment], không bao giờ sao chép tải trọng hoặc đường dẫn hình ảnh, đồng thời bỏ qua phần suy luận, lời gọi công cụ và kết quả công cụ.

UI điều hướng đến Chat thông thường bằng khóa phiên đó. Chưa có luồng harness chuẩn nào tồn tại. Ở lượt Chat thông thường đầu tiên, harness cài đặt các trình xử lý phê duyệt, gợi hỏi, sự kiện và phân phối Codex thực tế, sau đó:

1. Sử dụng kết nối giám sát để gọi thread/fork gốc mà không ghi đè mô hình hoặc trình cung cấp và ghim ảnh chụp nhanh nguồn đã lưu. Trạng thái ConfigManager hiện tại của Codex chọn mô hình và trình cung cấp, còn phản hồi fork báo cáo cặp thực tế. Nếu mô hình khác với mô hình cuối cùng được ghi lại trong nguồn, Codex phát cảnh báo khác biệt mô hình thông thường.
2. Trên cùng kết nối đó, khởi động luồng harness Codex đầy đủ chuẩn bằng threadSource: "appServer", cwd, chính sách, cấu hình, môi trường của OpenClaw, toàn bộ bề mặt công cụ của harness OpenClaw và chính xác mô hình cùng trình cung cấp do fork trả về cho lần khởi động ban đầu này.
3. Chèn lịch sử người dùng và trợ lý có thể hiển thị đã được giới hạn qua kết nối đó, commit liên kết chuẩn mà không loại bỏ phạm vi giám sát của liên kết, chạy lượt và lưu trữ fork tạm thời.

Trước lượt đầu tiên, Chat là một nhánh đang chờ bị khóa với bản sao lịch sử hiển thị; sau đó, mọi lượt của mô hình đều chạy qua luồng harness Codex chuẩn trên kết nối giám sát. Nhánh này không phải là bản sao rollout gốc đầy đủ: phần suy luận nguồn, lệnh gọi công cụ và kết quả công cụ được chủ ý lược bỏ. Nếu việc ghim snapshot hoặc tạo luồng chuẩn thất bại, nhánh đang chờ vẫn có thể được thử lại. Xung đột khi liên kết, tính năng giám sát bị tắt, hoặc kết nối giám sát không khả dụng hay không khớp sẽ khiến hệ thống đóng khi lỗi trước khi lượt chạy, thay vì quay về harness agent-home thông thường.

Điều này đảm bảo lựa chọn do Codex sở hữu, chứ không bảo toàn mô hình lịch sử của nguồn. Cặp được trả về từ fork được dùng để bắt đầu luồng chuẩn, và Codex duy trì mô hình cùng nhà cung cấp gốc của luồng đó. Các lần tiếp tục sau sẽ bỏ qua phần ghi đè mô hình và nhà cung cấp của OpenClaw, để Codex khôi phục cặp đã được duy trì. Nếu một cơ chế điều khiển Codex gốc riêng biệt thay đổi luồng chuẩn, OpenClaw chấp nhận lựa chọn gốc đã được duy trì đó. Mô hình OpenClaw bên ngoài và chuỗi dự phòng không bao giờ thay thế lựa chọn này.

Các thao tác thay đổi mô hình, xóa phiên và đặt lại/tạo mới phiên đều đóng khi lỗi đối với Chat được giám sát và khóa mô hình. Việc sửa đổi /codex model <model>, /codex bind, /codex resume (bao gồm Node --bind here), và /codex detach hoặc /codex unbind cũng đóng khi lỗi vì chúng thay thế hoặc xóa liên kết. Truy vấn /codex model cùng /codex fast, /codex permissions và /codex threads vẫn khả dụng. Công cụ agent codex_threads không thể gắn một fork mới hoặc lưu trữ luồng gốc đã liên kết. Thao tác đọc chỉ danh sách và siêu dữ liệu vẫn khả dụng; các trường bản chép lời yêu cầu supervision.allowRawTranscripts, còn đổi tên, bỏ lưu trữ, fork tách rời và lưu trữ một luồng không liên quan yêu cầu supervision.allowWriteControls. Không tùy chọn nào có thể thay thế liên kết đã khóa. Nếu không, việc xóa hoặc đặt lại mục OpenClaw sẽ loại bỏ liên kết gốc và tạo hoặc cho phép một luồng chung phía sau một phiên có vẻ là Codex. Do đó, hoạt động bảo trì lưu giữ sẽ bảo toàn các mục bị khóa mô hình ngay cả khi chúng vượt quá các giới hạn thông thường về tuổi, số lượng hoặc dung lượng ổ đĩa. Việc tắt hoặc gỡ cài đặt Plugin sở hữu cũng giữ lại khóa và dấu hiệu quyền sở hữu Plugin. Chat vẫn không khả dụng và đóng khi lỗi cho đến khi cùng Plugin đó được bật lại; quá trình dọn dẹp không bao giờ chuyển nó thành một phiên mô hình thông thường.

Nguồn không bao giờ được tiếp tục hoặc sửa đổi bởi thao tác này. Fork tạm thời ghim một snapshot; đó không phải là luồng tiếp tục bền vững. Việc bắt đầu một luồng harness chuẩn riêng biệt ở lượt đầu tiên ngăn OpenClaw trở thành một trình ghi nguồn cạnh tranh chỉ vì trạng thái cục bộ trong tiến trình không phát hiện được một lượt do Desktop sở hữu. Bản sao lịch sử hiển thị và snapshot đã ghim có thể bỏ sót công việc chưa hoàn tất trong một nguồn đang hoạt động. Nguồn CLI, VS Code, Atlas hoặc ChatGPT ban đầu vẫn đủ điều kiện xuất hiện trong cả danh mục gốc lẫn danh mục OpenClaw. Nhánh chuẩn vẫn là một luồng Codex gốc trong kho giám sát, nhưng các máy khách gốc có thể lọc loại nguồn appServer của nó, vì vậy khả năng hiển thị trong Codex Desktop không phải là một hợp đồng.

Hành vi lưu trữ

Đối với một hàng cục bộ của Gateway đã lưu hoặc không hoạt động, sessions.catalog.archive với catalogId: "codex" yêu cầu confirmNoOtherRunner: true rõ ràng, đọc mới trạng thái cục bộ hiện tại trong tiến trình, chỉ tiếp tục với idle hoặc notLoaded, gọi thread/archive gốc, và chỉ trả về thành công sau khi Codex chấp nhận thao tác. Sau đó, hàng này rời khỏi danh mục chưa lưu trữ.

Trạng thái đang hoạt động hoặc lỗi từ lần đọc mới sẽ từ chối lưu trữ. Một nhánh được giám sát đang khởi tạo hoặc đang chờ từ nguồn cũng vậy: lượt Chat đầu tiên phải hiện thực hóa nhánh chuẩn của nó trước khi nguồn có thể được lưu trữ. Một chủ sở hữu liên kết OpenClaw đang hoạt động đã biết đối với đúng mục tiêu hoặc bất kỳ hậu duệ được tạo nào chưa được lưu trữ cũng khiến thao tác lưu trữ bị từ chối. OpenClaw phân trang quan hệ thử nghiệm thread/list ancestorThreadId của Codex và đóng khi lỗi nếu có lỗi yêu cầu hoặc phản hồi, chu trình con trỏ hoặc luồng, hay cạn kiệt giới hạn an toàn. Thao tác lưu trữ gốc có thể tắt công việc cha và hậu duệ đã tải, nên lưu trữ không phải là lối tắt để ngắt. Các lệnh gọi đọc, liệt kê hậu duệ và lưu trữ không có tính nguyên tử. Một máy khách độc lập vẫn có thể sở hữu hoặc bắt đầu công việc trên một hàng có vẻ không hoạt động hoặc notLoaded ở cục bộ. Việc xác nhận không có trình chạy nào khác bao quát các máy khách không xác định và xung đột đó cho đến khi Codex có thao tác lưu trữ có điều kiện hoặc lease liên tiến trình. Cấm lưu trữ trên Node đã ghép cặp.

Không có chế độ xem đã lưu trữ trong danh mục Codex. Một luồng được khôi phục bằng thread/unarchive trên một bề mặt Codex khác được chủ sở hữu ủy quyền sẽ lại đủ điều kiện xuất hiện trong danh mục chưa lưu trữ.

An toàn của luồng đang hoạt động

Codex tuần tự hóa các thay đổi đối với một luồng giữa các máy khách của cùng một App Server, nhưng không cung cấp lease trình chạy hoặc chủ sở hữu phê duyệt độc quyền giữa các tiến trình. Các App Server stdio độc lập có thể nối thêm vào cùng một rollout, trong khi mỗi máy chủ chỉ thấy trạng thái trong bộ nhớ của chính mình. Yêu cầu phê duyệt cũng có thể đến mọi bên đăng ký của một máy chủ, với phản hồi hợp lệ đầu tiên hoàn tất yêu cầu.

Do đó:

• các máy khách danh mục thụ động không đăng ký hoặc tự động từ chối phê duyệt
• các hàng hiện được báo cáo là đang hoạt động không cung cấp nhánh mới hay Lưu trữ
• một nguồn chưa được ánh xạ trở thành nhánh lịch sử hiển thị, trong đó luồng harness chuẩn không bao giờ tiếp tục nguồn
• notLoaded được hiển thị là không rõ hoạt động và chỉ có thể được lưu trữ sau khi có xác nhận đầy đủ thông tin rằng không có trình chạy nào khác
• lưu trữ cục bộ yêu cầu xác nhận đó cùng một lần đọc mới idle hoặc notLoaded, đồng thời thừa nhận xung đột giao thức giữa thao tác đọc và lưu trữ

Ngắt và bàn giao giữa nhiều máy khách là các quyết định sản phẩm trong tương lai. Việc hiển thị một hàng đang hoạt động không ngụ ý các tính năng đó.

Ranh giới Node đã ghép cặp

Lệnh gọi Node hiện chỉ hỗ trợ yêu cầu/phản hồi. Nó có thể trả về an toàn siêu dữ liệu danh mục có giới hạn và các trang lượt bản chép lời, nhưng không thể truyền luồng sự kiện dài hạn, yêu cầu phê duyệt, lệnh gọi công cụ, thao tác hủy và các phần cập nhật của trợ lý mà một lần chạy harness Codex yêu cầu.

Do đó, hợp đồng Node hỗ trợ danh sách và các trang lượt bản chép lời. Các hàng từ xa vẫn có thể đọc được, nhưng Tiếp tục và Lưu trữ không khả dụng, bất kể trạng thái không hoạt động. Một lần tiếp tục từ xa thực sự yêu cầu trình chạy phía Node và cầu nối truyền phát bảo toàn các bất biến về phê duyệt và liên kết giống như harness cục bộ.

Quyền

Mỗi máy tính tự nguyện bật tính năng này ở cục bộ. Việc bật Gateway không cấp quyền cho Node khác đọc siêu dữ liệu Codex của máy. Khả năng Node phải vượt qua quy trình ghép cặp và phê duyệt chính sách lệnh thông thường.

Việc liệt kê toàn bộ fleet và xem bản chép lời sử dụng phạm vi Gateway operator.write vì chúng gọi các Node đã ghép cặp. Tiếp tục và lưu trữ cục bộ là các thao tác của người vận hành đã xác thực và vẫn chịu kiểm tra máy chủ cùng trạng thái.

Quyền truy cập của agent tự động và MCP độc lập là riêng biệt. Các hợp đồng công cụ codex_endpoint_probe, codex_sessions_list, codex_session_read, codex_session_send và codex_session_interrupt được phát hành vẫn thuộc sở hữu của Plugin codex. Khi tính năng giám sát được bật, các thao tác đọc bản chép lời codex_threads thô và các trường danh sách bắt nguồn từ bản chép lời cũng yêu cầu supervision.allowRawTranscripts; mọi thao tác fork, đổi tên, lưu trữ hoặc bỏ lưu trữ codex_threads đều yêu cầu supervision.allowWriteControls. Cả hai chính sách đều bị tắt theo mặc định.

Khả năng tương thích

openclaw doctor --fix di chuyển cấu hình plugins.entries.codex-supervisor đã phát hành, bao gồm các endpoint và chính sách bản chép lời/ghi, cùng các tham chiếu cho phép/từ chối Plugin sang plugins.entries.codex.config.supervision. Các giá trị đích chuẩn được chỉ định rõ ràng được ưu tiên khi xảy ra xung đột. Mã runtime chỉ sử dụng hình dạng Plugin codex chuẩn sau khi di chuyển.

Plugin chính thức giữ lại chính xác năm công cụ tương thích Supervisor: codex_endpoint_probe, codex_sessions_list, codex_session_read, codex_session_send và codex_session_interrupt. Theo mặc định, danh sách phiên chỉ gồm các phiên đã tải; không có tham số loaded_only. include_stored: true bổ sung các hàng chưa lưu trữ trong cơ sở dữ liệu trạng thái, được giới hạn theo từng endpoint bởi max_stored_sessions (mặc định 200, phạm vi được chấp nhận từ 1 đến 1,000); các hàng đã tải không bị giới hạn bởi cài đặt đó. Các trường bắt nguồn từ bản chép lời và thao tác đọc vẫn được kiểm soát bởi allowRawTranscripts; gửi và ngắt vẫn được kiểm soát bởi allowWriteControls.

Thao tác gửi tương thích không bao giờ bắt đầu hoặc tiếp tục một luồng không hoạt động. mode: "start" luôn bị từ chối; "auto" và "steer" chỉ điều khiển một lượt đang hoạt động có thể đọc. Tương tự, thao tác ngắt yêu cầu một lượt đang hoạt động có thể đọc. Việc tiếp tục luồng không hoạt động được định tuyến đến danh mục Codex gốc để harness đầy đủ sở hữu các phê duyệt, công cụ và liên kết. Bộ điều hợp MCP cũ độc lập phân giải chính các công cụ này từ Plugin chính thức và là đường dẫn duy nhất tuân thủ các biến môi trường chính sách cũ được giữ lại.

Giao diện người dùng danh mục tháng 7, phương thức Gateway, khả năng Node và đăng ký CLI chưa được phát hành dưới id Plugin cũ. Chúng được chuyển trực tiếp sang quyền sở hữu codex mà không có facade runtime thứ hai.

Công việc trong tương lai

• trình chạy truyền phát phía Node và cầu nối sự kiện để tiếp tục từ xa
• lease rõ ràng cho trình chạy và chủ sở hữu phê duyệt để bàn giao đồng thời giữa các máy khách
• lưu trữ từ xa sau khi có lease quyền sở hữu trình chạy hoặc cơ chế rào chắn tương đương
• ngắt và quan sát phiên đang hoạt động phong phú hơn
• bàn giao đã được kiểm tra giữa Codex Desktop, CLI và OpenClaw

Duyệt nội dung đã lưu trữ không thuộc thanh bên giám sát theo kế hoạch. Các bề mặt Codex gốc vẫn là đường dẫn khôi phục cho các luồng đã lưu trữ.

Kiểm thử chấp nhận

• Việc bật giám sát sẽ liệt kê các phiên cục bộ chưa được lưu trữ.
• Các phiên đã lưu trữ không bao giờ xuất hiện trong phản hồi danh mục hoặc giao diện người dùng.
• Các máy chủ hoạt động bình thường vẫn hiển thị khi một máy chủ khác gặp lỗi; máy chủ không khả dụng không trả về hàng dữ liệu mới nào thay vì tự tạo trạng thái phiên ngoại tuyến.
• Một hàng cục bộ đã lưu hoặc đang rảnh sẽ tạo một bản sao Chat với khóa mô hình/runtime chỉ dành cho Codex; lượt đầu tiên ghim một ảnh chụp nhanh tạm thời và khởi động luồng harness đầy đủ chính tắc, còn việc lặp lại Continue sẽ mở Chat hiện có.
• Lượt đầu tiên bỏ qua các giá trị ghi đè mô hình/nhà cung cấp trên nhánh ảnh chụp nhanh và ghim lần khởi động chính tắc vào đúng cặp do Codex trả về, ngay cả khi Codex cảnh báo rằng mô hình hiện tại của nó khác với mô hình được ghi nhận gần nhất của nguồn.
• Các liên kết được giám sát đang chờ xử lý và đã cam kết sử dụng kết nối giám sát để truy cập nguồn, tạo nhánh chính tắc và thực hiện mọi lượt sau đó; các phiên Codex thông thường vẫn thuộc phạm vi tác nhân.
• Các lần tiếp tục sau đó bỏ qua các giá trị ghi đè mô hình/nhà cung cấp của OpenClaw, duy trì lựa chọn chính tắc đã lưu của Codex, chấp nhận các thay đổi gốc riêng biệt đối với luồng đó và không bao giờ thay thế bằng mô hình OpenClaw bên ngoài hoặc chuỗi dự phòng.
• Việc tắt giám sát hoặc mất vòng đời liên kết/kết nối sẽ đóng khi gặp lỗi thay vì chuyển Chat sang harness thư mục chính của tác nhân thông thường.
• Không thể xóa Chat được giám sát và khóa mô hình trong khi Chat đó bảo vệ liên kết gốc.
• Chat sao chép tối đa 200 tin nhắn của người dùng và trợ lý, tổng cộng 512 KiB và 64 KiB cho mỗi tin nhắn. Hình ảnh trở thành phần giữ chỗ; quá trình suy luận nguồn, lệnh gọi công cụ, kết quả công cụ, tải trọng hình ảnh và đường dẫn cục bộ không được sao chép.
• Luồng tạo nhánh không bao giờ tiếp tục luồng nguồn.
• Nguồn ban đầu vẫn đủ điều kiện xuất hiện trong cả hai danh mục. Nhánh gốc chính tắc sử dụng loại nguồn appServer và không được đảm bảo sẽ xuất hiện trong Codex Desktop.
• Các nguồn cục bộ đang hoạt động không thể tạo nhánh hoặc được lưu trữ; Chat được giám sát hiện có vẫn có thể mở.
• Các hàng không xác định được hoạt động có thể tạo nhánh mà không cần xác nhận; việc lưu trữ yêu cầu xác nhận rõ ràng rằng không có trình chạy nào khác.
• Không thể lưu trữ nguồn có nhánh được giám sát đang khởi tạo hoặc chờ xử lý cho đến khi lượt Chat đầu tiên hiện thực hóa nhánh chính tắc.
• Chủ sở hữu liên kết đang hoạt động đã biết cho chính xác đích hoặc bất kỳ hậu duệ được tạo ra nào chưa lưu trữ sẽ chặn việc lưu trữ; lỗi liệt kê hậu duệ sẽ đóng khi gặp lỗi, còn xác nhận rõ ràng vẫn chịu trách nhiệm đối với các máy khách không xác định và tình trạng tranh chấp giữa kiểm tra trạng thái và lưu trữ.
• Việc lưu trữ cục bộ đã được xác nhận ở trạng thái đã lưu hoặc đang rảnh sẽ xóa hàng sau khi thao tác gốc thành công.
• Các hàng của Node đã ghép nối vẫn hiển thị mà không có Continue hoặc Archive.
• Việc liệt kê thụ động không bao giờ đăng ký nhận hoặc phản hồi các yêu cầu phê duyệt luồng.
• Cấu hình Supervisor cũ được di chuyển sang cấu trúc cấu hình Codex chính tắc.
• Theo mặc định, danh sách cũ chỉ được tải; việc liệt kê các mục đã lưu tuân theo giới hạn riêng của từng điểm cuối và thao tác gửi tương thích không bao giờ khởi động hoặc tiếp tục một luồng đang rảnh.