Referensi harness Codex

​

Permukaan konfigurasi plugin

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

​

Supervisi

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

​

Transportasi 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",
            },
          },
        },
      },
    },
  },
};

​

Mode persetujuan dan sandbox

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

​

Eksekusi native dalam sandbox

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

​

Isolasi autentikasi dan lingkungan

1. Profil autentikasi Codex OpenClaw yang eksplisit untuk agen.
2. Akun app-server yang sudah ada dalam direktori home Codex agen tersebut.
3. Hanya untuk peluncuran app-server stdio lokal, CODEX_API_KEY, lalu OPENAI_API_KEY, saat tidak ada akun app-server dan autentikasi OpenAI masih diperlukan.

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

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

​

Alat dinamis

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

​

Batas waktu

• Argumen timeoutMs per panggilan yang bernilai positif.
• Untuk image_generate, agents.defaults.imageGenerationModel.timeoutMs.
• Untuk image_generate tanpa batas waktu yang dikonfigurasi, nilai default pembuatan gambar sebesar 120 detik.
• Untuk alat pemahaman media image, tools.media.image.timeoutSeconds yang dikonversi ke milidetik, atau nilai default media sebesar 60 detik. Untuk pemahaman gambar, batas ini berlaku pada permintaan itu sendiri dan tidak dikurangi oleh pekerjaan persiapan sebelumnya.
• Untuk alat message, nilai default tetap sebesar 120 detik.
• Nilai default alat dinamis sebesar 90 detik.

​

Penemuan model

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

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

​

File bootstrap ruang kerja

• TOOLS.md diteruskan sebagai instruksi pengembang Codex yang diwarisi, sehingga subagen Codex native yang dibuat selama giliran juga melihatnya.
• SOUL.md, IDENTITY.md, dan USER.md diteruskan sebagai instruksi kolaborasi dengan cakupan giliran. Subagen Codex native tidak mewarisinya, sehingga giliran subagen tidak mengambil persona agen induk dan profil pengguna.
• Daftar ringkas Skills OpenClaw yang dimuat juga diteruskan sebagai instruksi pengembang kolaborasi dengan cakupan giliran, sehingga subagen Codex native juga tidak mewarisinya.
• Konten HEARTBEAT.md tidak disuntikkan; giliran heartbeat mendapatkan petunjuk mode kolaborasi untuk membaca file tersebut jika tersedia dan tidak kosong.
• Konten MEMORY.md dari ruang kerja agen yang dikonfigurasi tidak ditempelkan ke masukan giliran Codex native ketika alat memori tersedia untuk ruang kerja tersebut; jika tersedia, harness menambahkan petunjuk singkat memori ruang kerja ke instruksi pengembang kolaborasi dengan cakupan giliran dan Codex harus menggunakan memory_search atau memory_get ketika memori persisten relevan. Jika alat dinonaktifkan, pencarian memori tidak tersedia, atau ruang kerja aktif berbeda dari ruang kerja memori agen, MEMORY.md menggunakan jalur konteks giliran terbatas yang normal.
• BOOTSTRAP.md, jika tersedia, diteruskan sebagai konteks referensi masukan giliran OpenClaw.

​

Penggantian lingkungan

• 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

​

Terkait

• Harness Codex
• Runtime harness Codex
• Supervisi Codex
• Plugin Codex native
• Penggunaan Komputer Codex
• Penyedia OpenAI
• Referensi konfigurasi