openclaw/extensions/codex/openclaw.plugin.json

{
  "id": "codex",
  "name": "Codex",
  "description": "Codex app-server harness and Codex-managed GPT model catalog.",
  "providers": ["codex"],
  "contracts": {
    "mediaUnderstandingProviders": ["codex"]
  },
  "mediaUnderstandingProviderMetadata": {
    "codex": {
      "capabilities": ["image"],
      "defaultModels": {
        "image": "gpt-5.5"
      }
    }
  },
  "providerDiscoveryEntry": "./provider-discovery.ts",
  "syntheticAuthRefs": ["codex"],
  "nonSecretAuthMarkers": ["codex-app-server"],
  "activation": {
    "onAgentHarnesses": ["codex"]
  },
  "commandAliases": [
    {
      "name": "codex",
      "kind": "runtime-slash",
      "cliCommand": "plugins"
    }
  ],
  "configSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "discovery": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "enabled": { "type": "boolean" },
          "timeoutMs": {
            "type": "number",
            "minimum": 1,
            "default": 2500
          }
        }
      },
      "computerUse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "enabled": {
            "type": "boolean",
            "default": false
          },
          "autoInstall": {
            "type": "boolean",
            "default": false
          },
          "marketplaceDiscoveryTimeoutMs": {
            "type": "number",
            "minimum": 1,
            "default": 60000
          },
          "marketplaceSource": {
            "type": "string"
          },
          "marketplacePath": {
            "type": "string"
          },
          "marketplaceName": {
            "type": "string"
          },
          "pluginName": {
            "type": "string",
            "default": "computer-use"
          },
          "mcpServerName": {
            "type": "string",
            "default": "computer-use"
          }
        }
      },
      "appServer": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "mode": {
            "type": "string",
            "enum": ["yolo", "guardian"],
            "default": "yolo"
          },
          "transport": {
            "type": "string",
            "enum": ["stdio", "websocket"],
            "default": "stdio"
          },
          "command": { "type": "string" },
          "args": {
            "oneOf": [
              {
                "type": "array",
                "items": { "type": "string" }
              },
              { "type": "string" }
            ]
          },
          "url": { "type": "string" },
          "authToken": { "type": "string" },
          "headers": {
            "type": "object",
            "additionalProperties": { "type": "string" }
          },
          "requestTimeoutMs": {
            "type": "number",
            "minimum": 1,
            "default": 60000
          },
          "approvalPolicy": {
            "type": "string",
            "enum": ["never", "on-request", "on-failure", "untrusted"]
          },
          "sandbox": {
            "type": "string",
            "enum": ["read-only", "workspace-write", "danger-full-access"]
          },
          "approvalsReviewer": {
            "type": "string",
            "enum": ["user", "auto_review", "guardian_subagent"]
          },
          "serviceTier": { "type": ["string", "null"], "enum": ["fast", "flex", null] },
          "defaultWorkspaceDir": {
            "type": "string"
          }
        }
      }
    }
  },
  "uiHints": {
    "discovery": {
      "label": "Model Discovery",
      "help": "Plugin-owned controls for discovering Codex app-server models."
    },
    "discovery.enabled": {
      "label": "Enable Discovery",
      "help": "When false, OpenClaw keeps the Codex harness available but uses the bundled fallback model list."
    },
    "discovery.timeoutMs": {
      "label": "Discovery Timeout",
      "help": "Maximum time to wait for Codex app-server model discovery before falling back to the bundled model list.",
      "advanced": true
    },
    "computerUse": {
      "label": "Computer Use",
      "help": "Controls Codex app-server setup for the Computer Use plugin.",
      "advanced": true
    },
    "computerUse.enabled": {
      "label": "Enable Computer Use",
      "help": "When true, Codex-mode turns require the configured Computer Use MCP server to be available.",
      "advanced": true
    },
    "computerUse.autoInstall": {
      "label": "Auto Install",
      "help": "Install the configured Computer Use plugin when Codex-mode turns start.",
      "advanced": true
    },
    "computerUse.marketplaceDiscoveryTimeoutMs": {
      "label": "Marketplace Discovery Timeout",
      "help": "Maximum time to wait for Codex app-server to finish loading marketplaces during Computer Use install.",
      "advanced": true
    },
    "computerUse.marketplaceSource": {
      "label": "Marketplace Source",
      "help": "Optional Codex marketplace source to add before installing Computer Use.",
      "advanced": true
    },
    "computerUse.marketplacePath": {
      "label": "Marketplace Path",
      "help": "Optional local Codex marketplace file path containing the Computer Use plugin.",
      "advanced": true
    },
    "computerUse.marketplaceName": {
      "label": "Marketplace Name",
      "help": "Optional registered Codex marketplace name containing the Computer Use plugin.",
      "advanced": true
    },
    "computerUse.pluginName": {
      "label": "Plugin Name",
      "help": "Codex marketplace plugin name for Computer Use.",
      "advanced": true
    },
    "computerUse.mcpServerName": {
      "label": "MCP Server Name",
      "help": "MCP server name exposed by the Computer Use plugin.",
      "advanced": true
    },
    "appServer": {
      "label": "App Server",
      "help": "Runtime controls for connecting to Codex app-server.",
      "advanced": true
    },
    "appServer.mode": {
      "label": "Execution Mode",
      "help": "Use yolo for unchained local execution or guardian for Codex guardian-reviewed approvals.",
      "advanced": true
    },
    "appServer.transport": {
      "label": "Transport",
      "help": "Use stdio to spawn Codex locally, or websocket to connect to an already-running app-server.",
      "advanced": true
    },
    "appServer.command": {
      "label": "Command",
      "help": "Executable used for stdio transport. Leave unset to use OpenClaw's managed Codex binary.",
      "advanced": true
    },
    "appServer.args": {
      "label": "Arguments",
      "help": "Arguments used for stdio transport. Defaults to app-server --listen stdio://.",
      "advanced": true
    },
    "appServer.url": {
      "label": "WebSocket URL",
      "help": "Codex app-server WebSocket URL when transport is websocket.",
      "advanced": true
    },
    "appServer.authToken": {
      "label": "Auth Token",
      "help": "Bearer token sent to the WebSocket app-server.",
      "sensitive": true,
      "advanced": true
    },
    "appServer.headers": {
      "label": "Headers",
      "help": "Additional headers sent to the WebSocket app-server.",
      "advanced": true
    },
    "appServer.requestTimeoutMs": {
      "label": "Request Timeout",
      "help": "Maximum time to wait for Codex app-server control-plane requests.",
      "advanced": true
    },
    "appServer.approvalPolicy": {
      "label": "Approval Policy",
      "help": "Codex native approval policy sent to thread start, resume, and turns.",
      "advanced": true
    },
    "appServer.sandbox": {
      "label": "Sandbox",
      "help": "Codex native sandbox mode sent to thread start and resume.",
      "advanced": true
    },
    "appServer.approvalsReviewer": {
      "label": "Approvals Reviewer",
      "help": "Use user approvals or Codex auto_review for native app-server approvals. guardian_subagent remains accepted for compatibility.",
      "advanced": true
    },
    "appServer.serviceTier": {
      "label": "Service Tier",
      "help": "Optional Codex app-server service tier. Use fast, flex, or null.",
      "advanced": true
    },
    "appServer.defaultWorkspaceDir": {
      "label": "Default Workspace",
      "help": "Workspace used by /codex bind when --cwd is omitted.",
      "advanced": true
    }
  }
}