Перейти к основному содержанию
Computer Use — это нативный для Codex MCP Plugin для локального управления рабочим столом. OpenClaw не встраивает desktop app, не выполняет действия на рабочем столе самостоятельно и не обходит разрешения Codex. Встроенный Plugin codex только подготавливает Codex app-server: он включает поддержку Codex Plugin, находит или устанавливает настроенный Codex Computer Use Plugin, проверяет доступность MCP-сервера computer-use, а затем позволяет Codex владеть нативными вызовами MCP-инструментов во время ходов в Codex-mode. Используйте эту страницу, когда OpenClaw уже использует нативный Codex harness. О настройке самого runtime см. Codex harness.

​
OpenClaw.app и Peekaboo

Интеграция Peekaboo в OpenClaw.app отделена от Codex Computer Use. Приложение macOS может размещать сокет PeekabooBridge, чтобы CLI peekaboo мог повторно использовать локальные разрешения приложения Accessibility и Screen Recording для собственных инструментов автоматизации Peekaboo. Этот мост не устанавливает и не проксирует Codex Computer Use, а Codex Computer Use не вызывает ничего через сокет PeekabooBridge. Используйте Peekaboo bridge, когда вы хотите, чтобы OpenClaw.app был хостом с учетом разрешений для автоматизации Peekaboo CLI. Используйте эту страницу, когда агент OpenClaw в Codex-mode должен иметь нативный MCP Plugin computer-use Codex доступным до начала хода.

​
Приложение iOS

Приложение iOS отделено от Codex Computer Use. Оно не устанавливает и не проксирует MCP-сервер Codex computer-use и не является backend для управления рабочим столом. Вместо этого приложение iOS подключается как узел OpenClaw и предоставляет мобильные возможности через команды узла, такие как canvas.*, camera.*, screen.*, location.* и talk.*. Используйте iOS, когда вы хотите, чтобы агент управлял узлом iPhone через Gateway. Используйте эту страницу, когда агент в Codex-mode должен управлять локальным рабочим столом macOS через нативный Plugin Computer Use Codex.

​
Прямой MCP cua-driver

Codex Computer Use — не единственный способ предоставить управление рабочим столом. Если вы хотите, чтобы runtime, управляемые OpenClaw, вызывали драйвер TryCua напрямую, используйте upstream сервер cua-driver mcp через MCP-реестр OpenClaw вместо специфичного для Codex процесса marketplace. После установки cua-driver либо запросите у него команду OpenClaw: 
cua-driver mcp-config --client openclaw
либо зарегистрируйте stdio-сервер самостоятельно: 
openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'
Этот путь сохраняет поверхность MCP-инструментов upstream без изменений, включая схемы драйвера и структурированные MCP-ответы. Используйте его, когда CUA-драйвер должен быть доступен как обычный MCP-сервер OpenClaw. Используйте настройку Codex Computer Use на этой странице, когда Codex app-server должен владеть установкой Plugin, перезагрузками MCP и нативными вызовами инструментов внутри ходов в Codex-mode. Драйвер CUA специфичен для macOS и по-прежнему требует локальных разрешений macOS, которые запрашивает его приложение, например Accessibility и Screen Recording. OpenClaw не устанавливает cua-driver, не предоставляет эти разрешения и не обходит модель безопасности upstream-драйвера.

​
Быстрая настройка

Задайте plugins.entries.codex.config.computerUse, когда ходы в Codex-mode должны иметь Computer Use доступным до запуска потока. autoInstall: true включает Computer Use и позволяет OpenClaw установить или повторно включить его перед ходом: 
{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          computerUse: {
            autoInstall: true,
          },
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}
С этой конфигурацией OpenClaw проверяет Codex app-server перед каждым ходом в Codex-mode. Если Computer Use отсутствует, но Codex app-server уже обнаружил устанавливаемый marketplace, OpenClaw просит Codex app-server установить или повторно включить Plugin и перезагрузить MCP-серверы. В macOS, когда подходящий marketplace не зарегистрирован и существует стандартный bundle приложения Codex, OpenClaw также пытается зарегистрировать встроенный Codex marketplace из /Applications/Codex.app/Contents/Resources/plugins/openai-bundled перед тем, как завершиться ошибкой. Если настройка по-прежнему не может сделать MCP-сервер доступным, ход завершается ошибкой до запуска потока. После изменения конфигурации Computer Use используйте /new или /reset в затронутом чате перед тестированием, если существующий поток Codex уже запущен. При управляемом запуске stdio в macOS OpenClaw предпочитает подписанный bundle desktop-приложения Codex по пути /Applications/Codex.app/Contents/Resources/codex, когда он существует. Это удерживает Computer Use внутри bundle приложения, которому принадлежат локальные разрешения управления рабочим столом. Если desktop-приложение не установлено, OpenClaw переключается на управляемый бинарный файл Codex, установленный рядом с Plugin. Если установленное desktop-приложение инициализируется с неподдерживаемой версией app-server, OpenClaw закрывает этот дочерний процесс и пробует следующего кандидата управляемого бинарного файла, вместо того чтобы позволять устаревшему desktop-приложению скрывать локальный fallback Plugin. Явная конфигурация appServer.command или OPENCLAW_CODEX_APP_SERVER_BIN по-прежнему переопределяет этот управляемый выбор.

​
Команды

Используйте команды /codex computer-use с любой поверхности чата, где доступна командная поверхность Plugin codex. Это команды чата/runtime OpenClaw, а не подкоманды 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 доступна только для чтения. Она не добавляет источники marketplace, не устанавливает Plugin и не включает поддержку Codex Plugin. Если конфигурация не включает Computer Use, status может сообщить, что он отключен, даже после разовой команды установки. install включает поддержку Plugin в Codex app-server, при необходимости добавляет настроенный источник marketplace, устанавливает или повторно включает настроенный Plugin через Codex app-server, перезагружает MCP-серверы и проверяет, что MCP-сервер предоставляет инструменты.

​
Выбор marketplace

OpenClaw использует тот же API app-server, который предоставляет сам Codex. Поля marketplace выбирают, где Codex должен искать computer-use.
ПолеКогда использоватьПоддержка установки
Нет поля marketplaceВы хотите, чтобы Codex app-server использовал уже известные ему marketplace.Да, когда app-server возвращает локальный marketplace.
marketplaceSourceУ вас есть источник Codex marketplace, который app-server может добавить.Да, для явной /codex computer-use install.
marketplacePathВы уже знаете локальный путь к файлу marketplace на хосте.Да, для явной установки и автоустановки при запуске хода.
marketplaceNameВы хотите выбрать один уже зарегистрированный marketplace по имени.Да, только когда выбранный marketplace имеет локальный путь.
Свежим Codex home может понадобиться немного времени, чтобы заполнить официальные marketplace. Во время установки OpenClaw опрашивает plugin/list в течение до marketplaceDiscoveryTimeoutMs миллисекунд. Значение по умолчанию — 60 секунд. Если несколько известных marketplace содержат Computer Use, OpenClaw предпочитает openai-bundled, затем openai-curated, затем local. Неизвестные неоднозначные совпадения завершаются отказом и просят задать marketplaceName или marketplacePath.

​
Встроенный marketplace macOS

В недавних сборках Codex desktop Computer Use встроен здесь: 
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled/plugins/computer-use
Когда computerUse.autoInstall имеет значение true и не зарегистрирован marketplace, содержащий computer-use, OpenClaw пытается автоматически добавить стандартный встроенный корень marketplace: 
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled
Вы также можете зарегистрировать его явно из shell с помощью Codex: 
codex plugin marketplace add /Applications/Codex.app/Contents/Resources/plugins/openai-bundled
Если вы используете нестандартный путь к приложению Codex, один раз выполните /codex computer-use install --source <marketplace-root> или задайте computerUse.marketplacePath равным локальному пути к файлу marketplace. Используйте --marketplace-path только тогда, когда у вас есть путь к JSON-файлу marketplace, а не корень встроенного marketplace.

​
Ограничение удаленного каталога

Codex app-server может перечислять и читать записи только удаленного каталога, но сейчас не поддерживает удаленный plugin/install. Это означает, что marketplaceName может выбирать удаленный marketplace только для проверок статуса, но для установок и повторных включений по-прежнему нужен локальный marketplace через marketplaceSource или marketplacePath. Если status сообщает, что Plugin доступен в удаленном Codex marketplace, но удаленная установка не поддерживается, выполните install с локальным источником или путем: 
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>

​
Справочник конфигурации

ПолеПо умолчаниюЗначение
enabledinferredТребовать Computer Use. По умолчанию true, когда задано другое поле Computer Use.
autoInstallfalseУстановить или повторно включить из уже обнаруженных marketplace при запуске хода.
marketplaceDiscoveryTimeoutMs60000Как долго install ждет обнаружения marketplace в Codex app-server.
marketplaceSourceunsetСтрока источника, передаваемая в marketplace/add Codex app-server.
marketplacePathunsetЛокальный путь к файлу Codex marketplace, содержащему Plugin.
marketplaceNameunsetИмя зарегистрированного Codex marketplace для выбора.
pluginNamecomputer-useИмя Plugin в Codex marketplace.
mcpServerNamecomputer-useИмя MCP-сервера, предоставляемого установленным Plugin.
Автоустановка при запуске хода намеренно отклоняет настроенные значения marketplaceSource. Добавление нового источника — это явная операция настройки, поэтому один раз используйте /codex computer-use install --source <marketplace-source>, затем позвольте autoInstall обрабатывать будущие повторные включения из обнаруженных локальных marketplace. Автоустановка при запуске хода может использовать настроенный marketplacePath, потому что это уже локальный путь на хосте.

​
Что проверяет OpenClaw

OpenClaw сообщает стабильную причину настройки внутренне и форматирует пользовательский статус для чата:
ПричинаЗначениеСледующий шаг
disabledcomputerUse.enabled разрешился в false.Задайте enabled или другое поле Computer Use.
marketplace_missingПодходящий маркетплейс недоступен.Настройте источник, путь или имя маркетплейса.
plugin_not_installedМаркетплейс существует, но plugin не установлен.Запустите установку или включите autoInstall.
plugin_disabledPlugin установлен, но отключен в конфигурации Codex.Запустите установку, чтобы снова включить его.
remote_install_unsupportedВыбранный маркетплейс доступен только удаленно.Используйте marketplaceSource или marketplacePath.
mcp_missingPlugin включен, но сервер MCP недоступен.Проверьте Codex Computer Use и разрешения ОС.
readyPlugin и инструменты MCP доступны.Начните ход в режиме Codex.
check_failedЗапрос к app-server Codex завершился ошибкой при проверке статуса.Проверьте подключение к app-server и журналы.
auto_install_blockedНастройке при начале хода нужно было бы добавить новый источник.Сначала запустите явную установку.
Вывод чата включает состояние plugin, состояние сервера MCP, маркетплейс, инструменты, когда они доступны, и конкретное сообщение для неудачного шага настройки.

​
Разрешения macOS

Computer Use относится только к macOS. Сервер MCP, принадлежащий Codex, может потребовать локальные разрешения ОС, прежде чем сможет проверять приложения или управлять ими. Если OpenClaw сообщает, что Computer Use установлен, но сервер MCP недоступен, сначала проверьте настройку Computer Use на стороне Codex:
  • Codex app-server запущен на том же хосте, где должно выполняться управление рабочим столом.
  • Plugin Computer Use включен в конфигурации Codex.
  • Сервер MCP computer-use отображается в статусе MCP Codex app-server.
  • macOS предоставила необходимые разрешения приложению для управления рабочим столом.
  • Текущий сеанс хоста может получить доступ к управляемому рабочему столу.
OpenClaw намеренно отказывает по умолчанию, когда computerUse.enabled равно true. Ход в режиме Codex не должен незаметно продолжаться без нативных инструментов рабочего стола, которые требуются конфигурацией.

​
Устранение неполадок

Статус сообщает, что не установлено. Запустите /codex computer-use install. Если маркетплейс не обнаружен, передайте --source или --marketplace-path. Статус сообщает, что установлено, но отключено. Снова запустите /codex computer-use install. Установка через Codex app-server записывает конфигурацию plugin обратно как включенную. Статус сообщает, что удаленная установка не поддерживается. Используйте локальный источник маркетплейса или путь. Записи каталога, доступные только удаленно, можно просматривать, но нельзя устанавливать через текущий API app-server. Статус сообщает, что сервер MCP недоступен. Один раз повторно запустите установку, чтобы серверы MCP перезагрузились. Если он остается недоступным, исправьте приложение Codex Computer Use, статус MCP Codex app-server или разрешения macOS. Статус или проба истекает по тайм-ауту на computer-use.list_apps. Plugin и сервер MCP присутствуют, но локальный мост Computer Use не ответил. Закройте или перезапустите Codex Computer Use, при необходимости перезапустите Codex Desktop, затем повторите попытку в новом сеансе OpenClaw. Если ранее хост запускал Computer Use через более старый управляемый Codex app-server, обновите установленный plugin из маркетплейса, встроенного в настольное приложение: 
/codex computer-use install --source /Applications/Codex.app/Contents/Resources/plugins/openai-bundled
Инструмент Computer Use сообщает Native hook relay unavailable. Нативный для Codex хук инструмента не смог достичь активного ретранслятора OpenClaw через локальный мост или резервный путь Gateway. Запустите новый сеанс OpenClaw с помощью /new или /reset. Если это срабатывает один раз, а затем снова завершается ошибкой при более позднем вызове инструмента, /new очищает только текущую попытку; перезапустите Codex app-server или OpenClaw Gateway, чтобы старые потоки и регистрации хуков были удалены, затем повторите попытку в новом сеансе. Автоустановка при начале хода отклоняет источник. Это намеренно. Сначала добавьте источник с явной командой /codex computer-use install --source <marketplace-source>, затем будущая автоустановка при начале хода сможет использовать обнаруженный локальный маркетплейс.

​
См. также