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

​

Поверхность конфигурации плагина

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: true,
            timeoutMs: 2500,
          },
          appServer: {
            mode: "guardian",
          },
        },
      },
    },
  },
}

​

Контроль

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          sessionCatalog: {
            enabled: false,
          },
        },
      },
    },
  },
}

​

Транспорт app-server

codex app-server --listen stdio://

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

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

​

Режимы подтверждения и песочницы

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            mode: "guardian",
            serviceTier: "priority",
          },
        },
      },
    },
  },
}

​

Нативное выполнение в песочнице

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            experimental: {
              sandboxExecServer: true,
            },
          },
        },
      },
    },
  },
}

​

Изоляция аутентификации и среды

1. Явно заданный профиль аутентификации OpenClaw Codex для агента.
2. Существующая учётная запись сервера приложений в домашнем каталоге Codex этого агента.
3. Только для локального запуска сервера приложений через stdio: CODEX_API_KEY, затем OPENAI_API_KEY, если учётная запись сервера приложений отсутствует, а аутентификация OpenAI всё ещё требуется.

openclaw migrate codex --dry-run
openclaw migrate apply codex --yes

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

​

Динамические инструменты

• read
• write
• edit
• apply_patch
• exec
• process
• update_plan
• tool_call
• tool_describe
• tool_search
• tool_search_code

​

Тайм-ауты

• Положительный аргумент timeoutMs для конкретного вызова.
• Для image_generate — agents.defaults.imageGenerationModel.timeoutMs.
• Для image_generate без настроенного тайм-аута — значение по умолчанию для генерации изображений, равное 120 секундам.
• Для инструмента анализа медиа image — tools.media.image.timeoutSeconds, преобразованное в миллисекунды, или значение по умолчанию для медиа, равное 60 секундам. Для анализа изображений оно применяется к самому запросу и не уменьшается из-за выполненной ранее подготовительной работы.
• Для инструмента message — фиксированное значение по умолчанию, равное 120 секундам.
• Значение по умолчанию для динамических инструментов, равное 90 секундам.

​

Обнаружение моделей

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: true,
            timeoutMs: 2500,
          },
        },
      },
    },
  },
}

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: false,
          },
        },
      },
    },
  },
}

​

Файлы начальной настройки рабочей области

• TOOLS.md передаётся как наследуемые инструкции разработчика Codex, поэтому нативные субагенты Codex, созданные во время хода, также их видят.
• SOUL.md, IDENTITY.md и USER.md передаются как относящиеся к ходу инструкции по совместной работе. Нативные субагенты Codex их не наследуют, что предотвращает получение ходами субагентов персоны и профиля пользователя родительского агента.
• Компактный список загруженных Skills OpenClaw также передаётся как относящиеся к ходу инструкции разработчика по совместной работе, поэтому нативные субагенты Codex его также не наследуют.
• Содержимое HEARTBEAT.md не внедряется; ходы Heartbeat получают указатель в режиме совместной работы, предлагающий прочитать файл, если он существует и не пуст.
• Содержимое MEMORY.md из настроенной рабочей области агента не вставляется во входные данные нативного хода Codex, когда для этой рабочей области доступны инструменты памяти; если оно существует, среда добавляет небольшой указатель на память рабочей области в относящиеся к ходу инструкции разработчика по совместной работе, а Codex должен использовать memory_search или memory_get, когда актуальна долговременная память. Если инструменты отключены, поиск в памяти недоступен или активная рабочая область отличается от рабочей области памяти агента, MEMORY.md использует обычный ограниченный путь контекста хода.
• BOOTSTRAP.md, если присутствует, передаётся как справочный контекст входных данных хода OpenClaw.

​

Переопределения среды

• 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

​

Связанные материалы

• Среда Codex
• Среда выполнения Codex
• Надзор за Codex
• Нативные плагины Codex
• Управление компьютером с помощью Codex
• Провайдер OpenAI
• Справочник по конфигурации