What problem does it solve?
CodexClaw solves the problem of safely operating OpenAI Codex from a Telegram chat while keeping execution organized per repository and enabling controlled tool and workflow routing.
Core Features & Use Cases
- Zero-trust Telegram access: whitelist-only operators using
ALLOWED_USER_IDS and secure runtime state persisted in STATE_FILE.
- Codex coding execution with project scoping: maintains resumable coding sessions per
chat + repo and supports /new, /exec, /auto, and /plan.
- Bot-side control-plane subagents: explicit
/mcp ... and /gh ... commands route to MCP server tooling and GitHub automation with confirmations for high-risk writes.
- Frontend dev-server management: repo-scoped
/dev start|stop|status|logs|url to help with iterative development without exposing general shell access.
Quick Start
Clone the repository, install dependencies, copy .env.example to .env, set BOT_TOKEN and ALLOWED_USER_IDS, then start the bot with npm run start.