Обв’язка Codex

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Вимоги

• OpenClaw з доступним вбудованим plugin codex.
• Якщо ваша конфігурація використовує plugins.allow, додайте codex.
• Codex app-server 0.125.0 або новіший. Вбудований plugin типово керує сумісним бінарним файлом Codex app-server, тому локальні команди codex у PATH не впливають на звичайний запуск harness.
• Codex auth доступний через openclaw models auth login --provider openai-codex, обліковий запис app-server у Codex home агента або явний auth profile Codex API-key.

​

Швидкий старт

openclaw models auth login --provider openai-codex

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

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

​

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

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

​

Перевірка runtime Codex

Runtime: OpenAI Codex

/codex status
/codex models

​

Routing і вибір моделі

• Використовуйте openai/gpt-* для ходів агентів OpenAI через Codex.
• Не використовуйте openai-codex/gpt-* у конфігурації. Запустіть openclaw doctor --fix, щоб виправити legacy refs і застарілі route pins сесій.
• agentRuntime.id: "codex" необов’язковий для звичайного auto mode OpenAI, але корисний, коли розгортання має fail closed, якщо Codex недоступний.
• agentRuntime.id: "pi" переводить provider або model у пряму поведінку PI, коли це зроблено навмисно.
• /codex ... керує нативними розмовами Codex app-server з чату.
• ACP/acpx — це окремий шлях зовнішнього harness. Використовуйте його лише тоді, коли користувач просить ACP/acpx або зовнішній harness adapter.

​

Шаблони розгортання

​

Базове розгортання 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",
      },
    ],
  },
}

​

Fail-closed розгортання Codex

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

​

Політика app-server

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

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

​

Команди й діагностика

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

​

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

codex resume <thread-id>

1. Упорядковані профілі автентифікації OpenAI для агента, бажано в auth.order.openai. Наявні ідентифікатори профілів openai-codex:* залишаються чинними.
2. Наявний обліковий запис app-server у Codex home цього агента.
3. Лише для локальних запусків app-server через stdio: CODEX_API_KEY, потім OPENAI_API_KEY, коли обліковий запис app-server відсутній, а автентифікація OpenAI усе ще потрібна.

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

• 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

{
  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 залишається в шляху виконання.
• Нативні shell, patch, MCP і нативні app-інструменти Codex належать Codex. OpenClaw може спостерігати або блокувати вибрані нативні події через підтримуваний relay, але він не переписує аргументи нативних інструментів.
• Codex володіє нативною Compaction. OpenClaw зберігає дзеркало транскрипту для історії каналу, пошуку, /new, /reset і майбутнього перемикання моделі або harness.
• Генерація медіа, розуміння медіа, TTS, схвалення і вивід messaging-tool продовжують проходити через відповідні налаштування провайдера/моделі OpenClaw.
• tool_result_persist застосовується до результатів інструментів транскрипту, що належать OpenClaw, а не до записів результатів нативних інструментів Codex.

​

Усунення несправностей

​

Пов’язане

• Довідник harness Codex
• Середовище виконання harness Codex
• Нативні плагіни Codex
• Використання комп’ютера Codex
• Середовища виконання агентів
• Провайдери моделей
• Провайдер OpenAI
• Плагіни harness агента
• Хуки Plugin
• Експорт діагностики
• Статус
• Тестування