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.
Computer Use là một Plugin MCP nguyên sinh của Codex để điều khiển máy tính cục bộ. OpenClaw
không vendor ứng dụng máy tính, tự thực thi hành động trên máy tính, hoặc bỏ qua
quyền của Codex. Plugin codex được gói kèm chỉ chuẩn bị Codex app-server:
nó bật hỗ trợ Plugin Codex, tìm hoặc cài đặt Plugin Codex
Computer Use đã cấu hình, kiểm tra rằng máy chủ MCP computer-use có sẵn, và
sau đó để Codex sở hữu các lệnh gọi công cụ MCP nguyên sinh trong các lượt ở chế độ Codex.
Dùng trang này khi OpenClaw đã sử dụng harness Codex nguyên sinh. Đối với
chính phần thiết lập runtime, xem Codex harness.
OpenClaw.app và Peekaboo
Tích hợp Peekaboo của OpenClaw.app tách biệt với Codex Computer Use. Ứng dụng
macOS có thể lưu trữ socket PeekabooBridge để CLI peekaboo có thể tái sử dụng
các quyền Accessibility và Screen Recording cục bộ của ứng dụng cho các công cụ
tự động hóa riêng của Peekaboo. Bridge đó không cài đặt hoặc proxy Codex Computer Use, và
Codex Computer Use không gọi thông qua socket PeekabooBridge.
Dùng Peekaboo bridge khi bạn muốn OpenClaw.app là
máy chủ nhận biết quyền cho tự động hóa Peekaboo CLI. Dùng trang này khi một
agent OpenClaw ở chế độ Codex cần có Plugin MCP computer-use nguyên sinh của Codex
trước khi lượt bắt đầu.
Ứng dụng iOS
Ứng dụng iOS tách biệt với Codex Computer Use. Nó không cài đặt hoặc proxy
máy chủ MCP computer-use của Codex và không phải backend điều khiển máy tính.
Thay vào đó, ứng dụng iOS kết nối như một node OpenClaw và cung cấp các
khả năng di động thông qua các lệnh node như canvas.*, camera.*, screen.*,
location.*, và talk.*.
Dùng iOS khi bạn muốn một agent điều khiển một node iPhone thông qua
Gateway. Dùng trang này khi một agent ở chế độ Codex cần điều khiển máy tính
macOS cục bộ thông qua Plugin Computer Use nguyên sinh của Codex.
MCP cua-driver trực tiếp
Codex Computer Use không phải cách duy nhất để cung cấp điều khiển máy tính. Nếu bạn muốn
các runtime do OpenClaw quản lý gọi trực tiếp driver của TryCua, hãy dùng máy chủ
cua-driver mcp upstream thông qua registry MCP của OpenClaw thay vì luồng
marketplace dành riêng cho Codex.
Sau khi cài đặt cua-driver, hãy yêu cầu nó cung cấp lệnh OpenClaw:
cua-driver mcp-config --client openclaw
openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'
cua-driver, cấp các quyền đó, hoặc bỏ qua mô hình an toàn
của driver upstream.
Thiết lập nhanh
Đặt plugins.entries.codex.config.computerUse khi các lượt ở chế độ Codex phải có
Computer Use sẵn sàng trước khi một thread bắt đầu:
{
plugins: {
entries: {
codex: {
enabled: true,
config: {
computerUse: {
autoInstall: true,
},
},
},
},
},
agents: {
defaults: {
model: "openai/gpt-5.5",
agentRuntime: {
id: "codex",
fallback: "none",
},
},
},
}
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled trước khi
thất bại. Nếu thiết lập vẫn không thể làm cho máy chủ MCP có sẵn, lượt sẽ thất bại
trước khi thread bắt đầu.
Các phiên hiện có giữ runtime và liên kết thread Codex của chúng. Sau khi thay đổi
agentRuntime hoặc cấu hình Computer Use, dùng /new hoặc /reset trong cuộc trò chuyện
bị ảnh hưởng trước khi kiểm thử.
Lệnh
Dùng các lệnh /codex computer-use từ bất kỳ bề mặt trò chuyện nào có sẵn bề mặt lệnh
Plugin codex. Đây là các lệnh trò chuyện/runtime của OpenClaw,
không phải lệnh con CLI openclaw codex ...:
/codex computer-use status
/codex computer-use install
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>
/codex computer-use install --marketplace <name>
status chỉ đọc. Nó không thêm nguồn marketplace, cài đặt Plugin, hoặc
bật hỗ trợ Plugin Codex.
install bật hỗ trợ Plugin của Codex app-server, tùy chọn thêm một
nguồn marketplace đã cấu hình, cài đặt hoặc bật lại Plugin đã cấu hình thông qua Codex
app-server, tải lại các máy chủ MCP, và xác minh rằng máy chủ MCP cung cấp công cụ.
Lựa chọn marketplace
OpenClaw sử dụng cùng API app-server mà chính Codex cung cấp. Các trường
marketplace chọn nơi Codex nên tìm computer-use.
| Trường | Dùng khi | Hỗ trợ cài đặt |
|---|
| Không có trường marketplace | Bạn muốn Codex app-server dùng các marketplace mà nó đã biết. | Có, khi app-server trả về một marketplace cục bộ. |
marketplaceSource | Bạn có một nguồn marketplace Codex mà app-server có thể thêm. | Có, cho /codex computer-use install rõ ràng. |
marketplacePath | Bạn đã biết đường dẫn tệp marketplace cục bộ trên máy chủ. | Có, cho cài đặt rõ ràng và tự động cài đặt khi bắt đầu lượt. |
marketplaceName | Bạn muốn chọn một marketplace đã đăng ký theo tên. | Chỉ có khi marketplace được chọn có đường dẫn cục bộ. |
plugin/list trong tối đa
marketplaceDiscoveryTimeoutMs mili giây. Mặc định là 60 giây.
Nếu nhiều marketplace đã biết chứa Computer Use, OpenClaw ưu tiên
openai-bundled, rồi openai-curated, rồi local. Các kết quả khớp không rõ ràng
không xác định sẽ thất bại đóng và yêu cầu bạn đặt marketplaceName hoặc marketplacePath.
Marketplace macOS được gói kèm
Các bản dựng Codex desktop gần đây gói kèm Computer Use tại đây:
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled/plugins/computer-use
computerUse.autoInstall là true và không có marketplace nào chứa
computer-use được đăng ký, OpenClaw thử tự động thêm root marketplace được gói kèm
tiêu chuẩn:
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled
codex plugin marketplace add /Applications/Codex.app/Contents/Resources/plugins/openai-bundled
computerUse.marketplacePath thành
đường dẫn tệp marketplace cục bộ hoặc chạy /codex computer-use install --source <marketplace-source> một lần.
Giới hạn catalog từ xa
Codex app-server có thể liệt kê và đọc các mục catalog chỉ từ xa, nhưng hiện không
hỗ trợ plugin/install từ xa. Điều đó nghĩa là marketplaceName có thể
chọn một marketplace chỉ từ xa cho kiểm tra trạng thái, nhưng các lần cài đặt và bật lại
vẫn cần một marketplace cục bộ thông qua marketplaceSource hoặc marketplacePath.
Nếu trạng thái nói rằng Plugin có sẵn trong một marketplace Codex từ xa nhưng không hỗ trợ
cài đặt từ xa, hãy chạy cài đặt với nguồn hoặc đường dẫn cục bộ:
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>
Tham chiếu cấu hình
| Trường | Mặc định | Ý nghĩa |
|---|
enabled | suy luận | Yêu cầu Computer Use. Mặc định là true khi trường Computer Use khác được đặt. |
autoInstall | false | Cài đặt hoặc bật lại từ các marketplace đã phát hiện khi bắt đầu lượt. |
marketplaceDiscoveryTimeoutMs | 60000 | Thời gian cài đặt chờ Codex app-server phát hiện marketplace. |
marketplaceSource | chưa đặt | Chuỗi nguồn được truyền cho marketplace/add của Codex app-server. |
marketplacePath | chưa đặt | Đường dẫn tệp marketplace Codex cục bộ chứa Plugin. |
marketplaceName | chưa đặt | Tên marketplace Codex đã đăng ký để chọn. |
pluginName | computer-use | Tên Plugin marketplace Codex. |
mcpServerName | computer-use | Tên máy chủ MCP do Plugin đã cài đặt cung cấp. |
marketplaceSource
đã cấu hình. Thêm một nguồn mới là thao tác thiết lập rõ ràng, nên hãy dùng
/codex computer-use install --source <marketplace-source> một lần, rồi để
autoInstall xử lý các lần bật lại sau này từ các marketplace cục bộ đã phát hiện.
Tự động cài đặt khi bắt đầu lượt có thể dùng marketplacePath đã cấu hình, vì đó
đã là đường dẫn cục bộ trên máy chủ.
OpenClaw kiểm tra gì
OpenClaw báo cáo nội bộ một lý do thiết lập ổn định và định dạng trạng thái
hiển thị cho người dùng trong trò chuyện:
| Lý do | Ý nghĩa | Bước tiếp theo |
|---|
disabled | computerUse.enabled được resolve thành false. | Đặt enabled hoặc trường Computer Use khác. |
marketplace_missing | Không có marketplace khớp nào khả dụng. | Cấu hình nguồn, đường dẫn, hoặc tên marketplace. |
plugin_not_installed | Marketplace tồn tại, nhưng Plugin chưa được cài đặt. | Chạy cài đặt hoặc bật autoInstall. |
plugin_disabled | Plugin đã được cài đặt nhưng bị tắt trong cấu hình Codex. | Chạy cài đặt để bật lại. |
remote_install_unsupported | Marketplace được chọn chỉ từ xa. | Dùng marketplaceSource hoặc marketplacePath. |
mcp_missing | Plugin được bật, nhưng máy chủ MCP không khả dụng. | Kiểm tra Codex Computer Use và quyền OS. |
ready | Plugin và công cụ MCP có sẵn. | Bắt đầu lượt ở chế độ Codex. |
check_failed | Một yêu cầu Codex app-server thất bại trong khi kiểm tra trạng thái. | Kiểm tra kết nối app-server và log. |
auto_install_blocked | Thiết lập khi bắt đầu lượt sẽ cần thêm một nguồn mới. | Chạy cài đặt rõ ràng trước. |
Quyền macOS
Computer Use dành riêng cho macOS. Máy chủ MCP do Codex sở hữu có thể cần các quyền OS
cục bộ trước khi có thể kiểm tra hoặc điều khiển ứng dụng. Nếu OpenClaw nói Computer Use
đã được cài đặt nhưng máy chủ MCP không khả dụng, trước tiên hãy xác minh thiết lập Computer Use
phía Codex:
- Codex app-server đang chạy trên cùng máy chủ nơi việc điều khiển máy tính để bàn sẽ
diễn ra.
- Plugin Computer Use được bật trong cấu hình Codex.
- Máy chủ MCP
computer-use xuất hiện trong trạng thái MCP của Codex app-server.
- macOS đã cấp các quyền cần thiết cho ứng dụng điều khiển máy tính để bàn.
- Phiên máy chủ hiện tại có thể truy cập máy tính để bàn đang được điều khiển.
OpenClaw cố ý không cho phép tiếp tục khi computerUse.enabled là true. Một lượt
ở chế độ Codex không được âm thầm tiếp tục nếu thiếu các công cụ máy tính để bàn
gốc mà cấu hình đã yêu cầu.
Khắc phục sự cố
Trạng thái cho biết chưa được cài đặt. Chạy /codex computer-use install. Nếu
không phát hiện được marketplace, hãy truyền --source hoặc --marketplace-path.
Trạng thái cho biết đã cài đặt nhưng bị tắt. Chạy lại /codex computer-use install.
Quá trình cài đặt Codex app-server sẽ ghi lại cấu hình Plugin thành trạng thái bật.
Trạng thái cho biết không hỗ trợ cài đặt từ xa. Dùng nguồn hoặc đường dẫn
marketplace cục bộ. Có thể kiểm tra các mục danh mục chỉ từ xa, nhưng không thể
cài đặt chúng thông qua API app-server hiện tại.
Trạng thái cho biết máy chủ MCP không khả dụng. Chạy lại cài đặt một lần để
các máy chủ MCP tải lại. Nếu vẫn không khả dụng, hãy sửa ứng dụng Codex Computer Use,
trạng thái MCP của Codex app-server, hoặc quyền macOS.
Trạng thái hoặc một phép dò hết thời gian chờ ở computer-use.list_apps. Plugin và máy chủ MCP
đã hiện diện, nhưng cầu nối Computer Use cục bộ không phản hồi. Thoát hoặc
khởi động lại Codex Computer Use, khởi chạy lại Codex Desktop nếu cần, rồi thử lại trong một
phiên OpenClaw mới.
Một công cụ Computer Use báo Native hook relay unavailable. Hook công cụ gốc của Codex
không thể tiếp cận một relay OpenClaw đang hoạt động thông qua cầu nối cục bộ hoặc
phương án dự phòng Gateway. Bắt đầu một phiên OpenClaw mới bằng /new hoặc /reset. Nếu sự cố
tiếp tục xảy ra, hãy khởi động lại gateway để loại bỏ các luồng app-server cũ và đăng ký hook
cũ, rồi thử lại.
Tự động cài đặt khi bắt đầu lượt từ chối một nguồn. Đây là hành vi có chủ ý. Thêm
nguồn bằng lệnh rõ ràng /codex computer-use install --source <marketplace-source>
trước, sau đó các lần tự động cài đặt khi bắt đầu lượt trong tương lai có thể dùng marketplace cục bộ
đã được phát hiện.