openclaw/extensions/codex
Peter Steinberger 3ccf2a0739
feat: render inline web chat widgets via capability-gated show_widget tool (#101840)
Adds client-capability-gated tool availability: gateway clients declare
capabilities at connect (new inline-widgets cap), chat.send stamps them into
the run context, and every tool assembly path (embedded runner, queued
followups, Codex app-server harness, plugin-only construction plans) drops
tools whose requiredClientCaps the originating client did not declare. The
Canvas plugin ships the first such tool, show_widget: agents pass SVG or an
HTML fragment plus a title; the plugin hosts it as a bounded, retention-scoped
Canvas document and returns the existing canvas preview handle, which web chat
renders as a sandboxed iframe fitted to the widget's reported content height.
Widget frames never get allow-same-origin (per-preview sandbox ceiling,
including the sidebar path) and the Canvas host serves widget documents with a
CSP sandbox header so direct navigation runs in an opaque origin. Verified
live end-to-end on a Testbox with gpt-5.5 (screenshots on the PR). CLI-backed
model backends do not carry client caps yet and stay fail-closed (#102577).

Closes #101790
2026-07-09 12:29:50 +01:00
..
src feat: render inline web chat widgets via capability-gated show_widget tool (#101840) 2026-07-09 12:29:50 +01:00
doctor-contract-api.test.ts fix(codex): migrate retired approval policy 2026-07-08 23:07:20 -07:00
doctor-contract-api.ts fix(codex): migrate retired approval policy 2026-07-08 23:07:20 -07:00
harness.test.ts refactor(codex): store app-server thread bindings in SQLite plugin state (#101210) 2026-07-07 03:03:44 +01:00
harness.ts refactor(codex): store app-server thread bindings in SQLite plugin state (#101210) 2026-07-07 03:03:44 +01:00
index.test.ts refactor(codex): store app-server thread bindings in SQLite plugin state (#101210) 2026-07-07 03:03:44 +01:00
index.ts refactor(codex): store app-server thread bindings in SQLite plugin state (#101210) 2026-07-07 03:03:44 +01:00
media-understanding-provider.test.ts refactor(codex): keyed turn routing, client-scoped rate limits, and resume subscription safety (#101376) 2026-07-07 07:25:15 +01:00
media-understanding-provider.ts feat: add Codex hosted web search (#93446) 2026-06-16 00:38:16 -06:00
npm-shrinkwrap.json chore(codex): bump app-server to 0.143.0 2026-07-08 23:07:20 -07:00
openclaw.plugin.json Let owner-operated Codex agents use connected account apps (#100973) 2026-07-06 12:31:45 -07:00
package.json chore(codex): bump app-server to 0.143.0 2026-07-08 23:07:20 -07:00
prompt-overlay-runtime-contract.test.ts docs: document large extension sources 2026-06-04 21:40:44 -04:00
prompt-overlay.ts refactor(codex): drop unused prompt overlay wrapper 2026-06-19 23:51:44 +08:00
provider-catalog.ts feat(openai): add GPT-5.6 series support (#98333) 2026-07-01 06:48:57 +01:00
provider-discovery.ts docs: document codex root plugin modules 2026-06-04 08:16:35 -04:00
provider.test.ts fix(codex): honor Pro reasoning effort contracts (#101484) 2026-07-07 03:13:50 -07:00
provider.ts fix(codex): honor Pro reasoning effort contracts (#101484) 2026-07-07 03:13:50 -07:00
README.md docs(plugins): add npm readmes for channel providers 2026-05-31 20:02:45 +01:00
test-api.ts docs: document codex command helpers 2026-06-04 08:55:39 -04:00
tsconfig.json
web-search-contract-api.ts feat: add Codex hosted web search (#93446) 2026-06-16 00:38:16 -06:00

OpenClaw Codex

Official OpenClaw provider and harness plugin for OpenAI Codex app-server integration. It exposes the Codex-managed GPT model catalog and the Codex runtime surfaces used by OpenClaw agents.

Install from OpenClaw:

openclaw plugin add @openclaw/codex

Use this plugin when you want OpenClaw to run Codex-backed model turns, media understanding, and prompt overlays through the Codex app-server harness.