Bộ khung 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.

​

Yêu cầu

• OpenClaw có sẵn Plugin codex đi kèm.
• Nếu cấu hình của bạn dùng plugins.allow, hãy bao gồm codex.
• Codex app-server 0.125.0 hoặc mới hơn. Plugin đi kèm mặc định quản lý một binary Codex app-server tương thích, vì vậy các lệnh codex cục bộ trên PATH không ảnh hưởng đến khởi động harness thông thường.
• Xác thực Codex có sẵn thông qua openclaw models auth login --provider openai-codex, tài khoản app-server trong Codex home của agent, hoặc profile xác thực Codex API-key rõ ràng.

​

Bắt đầu nhanh

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,
      },
    },
  },
}

​

Cấu hình

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

​

Xác minh runtime Codex

Runtime: OpenAI Codex

/codex status
/codex models

​

Định tuyến và lựa chọn model

• Dùng openai/gpt-* cho các lượt agent OpenAI qua Codex.
• Đừng dùng openai-codex/gpt-* trong cấu hình. Chạy openclaw doctor --fix để sửa các ref cũ và route pin phiên đã lỗi thời.
• agentRuntime.id: "codex" là tùy chọn cho chế độ OpenAI tự động thông thường, nhưng hữu ích khi một triển khai cần đóng lỗi nếu Codex không khả dụng.
• agentRuntime.id: "pi" đưa provider hoặc model vào hành vi PI trực tiếp khi đó là chủ ý.
• /codex ... điều khiển các cuộc trò chuyện Codex app-server gốc từ chat.
• ACP/acpx là một đường dẫn harness bên ngoài riêng biệt. Chỉ dùng nó khi người dùng yêu cầu ACP/acpx hoặc adapter harness bên ngoài.

​

Mẫu triển khai

​

Triển khai Codex cơ bản

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

​

Triển khai provider hỗn hợp

{
  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",
      },
    ],
  },
}

​

Triển khai Codex đóng lỗi

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

​

Chính sách 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",
          },
        },
      },
    },
  },
}

​

Lệnh và chẩn đoán

• /codex status kiểm tra kết nối app-server, mô hình, tài khoản, giới hạn tốc độ, máy chủ MCP và skills.
• /codex models liệt kê các mô hình app-server Codex trực tiếp.
• /codex threads [filter] liệt kê các luồng app-server Codex gần đây.
• /codex resume <thread-id> gắn phiên OpenClaw hiện tại vào một luồng Codex hiện có.
• /codex compact yêu cầu app-server Codex compact luồng đã gắn.
• /codex review khởi động rà soát Codex gốc cho luồng đã gắn.
• /codex diagnostics [note] hỏi trước khi gửi phản hồi Codex cho luồng đã gắn.
• /codex account hiển thị trạng thái tài khoản và giới hạn tốc độ.
• /codex mcp liệt kê trạng thái máy chủ MCP app-server Codex.
• /codex skills liệt kê skills app-server Codex.

​

Kiểm tra các luồng Codex cục bộ

codex resume <thread-id>

1. Các hồ sơ xác thực OpenAI có thứ tự cho agent, ưu tiên trong auth.order.openai. Các id hồ sơ openai-codex:* hiện có vẫn hợp lệ.
2. Tài khoản hiện có của app-server trong Codex home của agent đó.
3. Chỉ với các lần khởi chạy app-server stdio cục bộ, CODEX_API_KEY, rồi OPENAI_API_KEY, khi không có tài khoản app-server và vẫn cần xác thực 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

​

Plugin Codex gốc

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

​

Computer Use

​

Ranh giới runtime

• Công cụ động OpenClaw được hỗ trợ. Codex yêu cầu OpenClaw thực thi các công cụ đó, nên OpenClaw vẫn nằm trong đường dẫn thực thi.
• Shell, patch, MCP, và các công cụ app gốc của Codex do Codex sở hữu. OpenClaw có thể quan sát hoặc chặn các sự kiện gốc được chọn thông qua relay được hỗ trợ, nhưng không viết lại đối số công cụ gốc.
• Codex sở hữu Compaction gốc. OpenClaw giữ một bản sao transcript cho lịch sử kênh, tìm kiếm, /new, /reset, và việc chuyển đổi mô hình hoặc harness trong tương lai.
• Tạo phương tiện, hiểu nội dung phương tiện, TTS, phê duyệt, và đầu ra công cụ nhắn tin tiếp tục đi qua các thiết lập nhà cung cấp/mô hình OpenClaw tương ứng.
• tool_result_persist áp dụng cho kết quả công cụ transcript do OpenClaw sở hữu, không phải các bản ghi kết quả công cụ gốc của Codex.

​

Khắc phục sự cố

​

Liên quan

• Tham chiếu harness Codex
• Runtime harness Codex
• Plugin Codex gốc
• Codex Computer Use
• Runtime tác tử
• Nhà cung cấp mô hình
• Nhà cung cấp OpenAI
• Plugin harness tác tử
• Hook Plugin
• Xuất chẩn đoán
• Trạng thái
• Kiểm thử