Summary

This OpenClaw plugin bridges the gap between chat platforms (Telegram, Discord) and the Codex App Server protocol. It allows users to interact with their existing Codex threads directly from their conversations, leveraging their local Codex CLI setup without requiring a separate hosted service. The primary benefit is a seamless, integrated workflow for managing AI-driven threads within familiar chat environments.

How It Works

The plugin functions as an OpenClaw extension, connecting to the Codex App Server protocol. It utilizes the user's existing local Codex CLI and shared login state, eliminating the need for separate authentication. Users initiate interactions via chat commands like /cas_resume, which binds the conversation to a specific Codex thread. Subsequent plain text messages are routed to the thread, and interactive buttons provide controls for project/thread selection, model switching, and skill shortcuts, enhancing usability within the chat interface.

Quick Start & Requirements

• Install: openclaw plugins install --dangerously-force-unsafe-install openclaw-codex-app-server
• Prerequisites: OpenClaw (version compatibility is critical, see table in README), local Codex CLI.
• Compatibility: Plugin release 0.6.1+ requires OpenClaw 2026.3.22 or newer. Older plugin versions have specific OpenClaw compatibility ranges.
• Links: Installation and update procedures are detailed in the README.

Highlighted Details

• Leverages existing local Codex CLI and shared login state for authentication.
• Provides a natural chat interface with commands for binding, status, planning, and control.
• Supports dynamic model switching, fast mode, and permissions adjustments directly from chat.
• Offers interactive buttons for thread selection, model changes, and quick access to Codex skills.

Maintenance & Community

This repository is presented as an independent project, not officially affiliated with OpenAI or Codex. No specific details regarding maintainers, community channels (e.g., Discord, Slack), or roadmaps were found in the provided README.

Licensing & Compatibility

The README does not specify a license. This absence makes it impossible to determine compatibility for commercial use or closed-source linking without further clarification.

Limitations & Caveats

The plugin is flagged as "unsafe" by OpenClaw due to its requirement to launch the codex app-server process. Specific workarounds involving uninstalling and reinstalling with the --dangerously-force-unsafe-install flag are necessary for certain OpenClaw versions (e.g., 2026.3.31 through 2026.4.3) due to update limitations, as tracked in openclaw/openclaw#59241. Manual installation steps are also provided for cases where standard installation is blocked. Careful attention to OpenClaw and plugin version compatibility is essential.