Обвязка Codex

​

Требования

• OpenClaw с доступным встроенным Plugin codex.
• Если ваша конфигурация использует plugins.allow, включите codex.
• Codex app-server 0.125.0 или новее. Встроенный Plugin по умолчанию управляет совместимым бинарным файлом Codex app-server, поэтому локальные команды codex в PATH не влияют на обычный запуск среды.
• Авторизация Codex доступна через openclaw models auth login --provider openai, учетную запись app-server в домашнем каталоге Codex агента или явный профиль авторизации Codex с API-ключом.

​

Быстрый старт

openclaw models auth login --provider openai

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

{
  plugins: {
    allow: ["codex"],
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

​

Конфигурация

{
  auth: {
    order: {
      openai: ["openai:user@example.com", "openai:api-key-backup"],
    },
  },
}

​

Проверка среды выполнения Codex

Runtime: OpenAI Codex

/codex status
/codex models

​

Маршрутизация и выбор модели

• Используйте openai/gpt-* для ходов агента OpenAI через Codex.
• Не используйте устаревшие ссылки Codex GPT в конфигурации. Запустите openclaw doctor --fix, чтобы исправить устаревшие ссылки и старые привязки маршрутов сессий.
• agentRuntime.id: "codex" необязателен для обычного автоматического режима OpenAI, но полезен, когда развертывание должно завершаться отказом, если Codex недоступен.
• agentRuntime.id: "openclaw" явно переводит провайдера или модель на встроенную среду выполнения OpenClaw, когда это сделано намеренно.
• /codex ... управляет нативными разговорами Codex app-server из чата.
• ACP/acpx — отдельный путь внешней среды. Используйте его только тогда, когда пользователь просит ACP/acpx или адаптер внешней среды.

​

Шаблоны развертывания

​

Базовое развертывание Codex

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

​

Развертывание со смешанными Provider

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      model: "anthropic/claude-opus-4-6",
    },
    list: [
      {
        id: "main",
        default: true,
        model: "anthropic/claude-opus-4-6",
      },
      {
        id: "codex",
        name: "Codex",
        model: "openai/gpt-5.5",
      },
    ],
  },
}

​

Развертывание Codex с отказом без резервного пути

{
  models: {
    providers: {
      openai: {
        agentRuntime: {
          id: "codex",
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

​

Политика сервера приложения

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            transport: "websocket",
            url: "ws://gateway-host:39175",
            authToken: "${CODEX_APP_SERVER_TOKEN}",
          },
        },
      },
    },
  },
}

{
  tools: {
    exec: {
      mode: "auto",
    },
  },
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

​

Команды и диагностика

• /codex status проверяет подключение к серверу приложения, модели, аккаунт, лимиты скорости, MCP-серверы и Skills.
• /codex models выводит живые модели сервера приложения Codex.
• /codex threads [filter] выводит недавние потоки сервера приложения Codex.
• /codex resume <thread-id> присоединяет текущую сессию OpenClaw к существующему потоку Codex.
• /codex compact просит сервер приложения Codex выполнить compact для присоединенного потока.
• /codex review запускает нативную review Codex для присоединенного потока.
• /codex diagnostics [note] спрашивает перед отправкой feedback Codex для присоединенного потока.
• /codex account показывает статус аккаунта и лимитов скорости.
• /codex mcp выводит статус MCP-серверов сервера приложения Codex.
• /codex skills выводит Skills сервера приложения Codex.

​

Локальная проверка потоков Codex

codex resume <thread-id>

1. Упорядоченные профили auth OpenAI для агента, предпочтительно в auth.order.openai. Запустите openclaw doctor --fix, чтобы мигрировать старые устаревшие id профилей auth Codex и устаревший порядок auth Codex.
2. Существующий аккаунт сервера приложения в Codex home этого агента.
3. Только для локальных запусков stdio-сервера приложения: CODEX_API_KEY, затем OPENAI_API_KEY, когда аккаунта сервера приложения нет, а auth OpenAI все еще требуется.

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            clearEnv: ["CODEX_API_KEY", "OPENAI_API_KEY"],
          },
        },
      },
    },
  },
}

export default {
  plugins: {
    entries: {
      codex: {
        config: {
          appServer: {
            sandbox: "workspace-write",
            networkProxy: {
              enabled: true,
              domains: {
                "api.openai.com": "allow",
                "blocked.example.com": "deny",
              },
              unixSockets: {
                "/tmp/proxy.sock": "allow",
                "/tmp/blocked.sock": "none",
              },
              allowUpstreamProxy: true,
              proxyUrl: "http://127.0.0.1:3128",
            },
          },
        },
      },
    },
  },
};

• OPENCLAW_CODEX_APP_SERVER_BIN
• OPENCLAW_CODEX_APP_SERVER_ARGS
• OPENCLAW_CODEX_APP_SERVER_MODE=yolo|guardian
• OPENCLAW_CODEX_APP_SERVER_APPROVAL_POLICY
• OPENCLAW_CODEX_APP_SERVER_SANDBOX

​

Нативные Plugin Codex

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          codexPlugins: {
            enabled: true,
            allow_destructive_actions: true,
            plugins: {
              "google-calendar": {
                enabled: true,
                marketplaceName: "openai-curated",
                pluginName: "google-calendar",
              },
            },
          },
        },
      },
    },
  },
}

​

Использование компьютера

​

Границы среды выполнения

• Динамические инструменты OpenClaw поддерживаются. Codex просит OpenClaw выполнить эти инструменты, поэтому OpenClaw остается в пути выполнения.
• Нативные инструменты оболочки, исправлений, MCP и нативных приложений Codex принадлежат Codex. OpenClaw может наблюдать или блокировать выбранные нативные события через поддерживаемый ретранслятор, но не переписывает аргументы нативных инструментов.
• Codex владеет нативной Compaction. OpenClaw хранит зеркало транскрипта для истории каналов, поиска, /new, /reset и будущего переключения модели или среды выполнения, но не заменяет Compaction Codex суммаризатором OpenClaw или движка контекста.
• Генерация медиа, понимание медиа, TTS, подтверждения и вывод инструментов сообщений продолжают проходить через соответствующие настройки провайдера/модели OpenClaw.
• tool_result_persist применяется к результатам инструментов транскрипта, принадлежащим OpenClaw, а не к нативным записям результатов инструментов Codex.

​

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

(
  pattern='openai/gpt-5\.[45]|openai[-]codex|agentRuntime(\.id)?|harnessRuntime|Runtime: OpenAI Codex|legacy OpenAI Codex prefix|resolveSelectedOpenAIRuntimeProvider|candidateProvider[": ]+openai|status[": ]+401|Incorrect API key|No API key|api-key path|API-key path|OAuth'

  if ls /tmp/openclaw/openclaw-*.log >/dev/null 2>&1; then
    grep -E -i -n "$pattern" /tmp/openclaw/openclaw-*.log 2>/dev/null || true
  else
    journalctl --user -u openclaw-gateway --since today --no-pager 2>/dev/null \
      | grep -E -i "$pattern" || true
  fi
) | sed -E \
    -e 's/(Authorization: Bearer )[A-Za-z0-9._~+\/-]+/\1[REDACTED]/Ig' \
    -e 's/(Bearer )[A-Za-z0-9._~+\/-]+/\1[REDACTED]/Ig' \
    -e 's/(api[_ -]?key[=: ]+)[^ ,}"]+/\1[REDACTED]/Ig' \
    -e 's/(OPENAI_API_KEY[=: ]+)[^ ,}"]+/\1[REDACTED]/Ig' \
    -e 's/sk-[A-Za-z0-9_-]{12,}/sk-[REDACTED]/g' \
    -e 's/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/[EMAIL-REDACTED]/g' \
  | tail -200

​

Связанное

• Справочник по среде выполнения Codex
• Среда выполнения Codex
• Нативные Plugin Codex
• Codex Computer Use
• Среды выполнения агентов
• Поставщики моделей
• Поставщик OpenAI
• Справка OpenAI Codex
• Plugin среды выполнения агентов
• Хуки Plugin
• Экспорт диагностики
• Статус
• Тестирование