Menu
Add OpenAI Codex agent SDK. Supports cloud models (GPT-5.x) and local models (OMLX, Ollama). Authenticates via ChatGPT subscription or API key.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Register an email mailbox for skills to operate on — reading, triage, drafting, bulk archive. NOT a channel; inbound emails will not wake the agent. For email-as-a-channel, use /add-gmail instead. Supports Google Workspace (Gmail), Microsoft 365 (Outlook/Exchange), and IMAP.
Set up email archive system — interactive calibration builds sender rules, creates folder taxonomy, and configures batch processing to reach inbox zero. Requires at least one email account registered via /add-email-account. Run this before using /email-archive in your main chat.
Batch-classify old emails into organized folders, working toward inbox zero. Uses sender rules (free, fast) with LLM fallback for unknown senders. Supports interactive, supervised, and autonomous modes. Provider-agnostic — works with any email account configured in config.yaml. Use /email-archive to process a batch, /email-archive status for progress.
Enable custom model support — use local models (OMLX, Ollama) or any third-party model endpoint (HuggingFace, Together AI, Groq, etc.) alongside your primary agent SDK. Triggers on "custom models", "local models", "add custom", "add local".
Add a model endpoint — local (OMLX, Ollama) or remote (HuggingFace, Together AI, Groq, or any OpenAI-compatible URL). Triggers on "add endpoint", "add model", "model endpoint", "connect model".
Add Google Gemini agent SDK. Free tier available (60 req/min). Built-in tools, MCP support, 11 lifecycle hooks. Authenticates via API key.
| name | add-agentSDK-codex |
| description | Add OpenAI Codex agent SDK. Supports cloud models (GPT-5.x) and local models (OMLX, Ollama). Authenticates via ChatGPT subscription or API key. |
Adds OpenAI Codex runtime support. After installation, groups can use runtime: 'codex' for GPT-5.x models, and local models via OMLX or LiteLLM.
Check if already applied:
ls src/runtime/openai-runtime.ts 2>/dev/null && echo "ALREADY_INSTALLED" || echo "NOT_INSTALLED"
If already installed, skip to Phase 3 (Configure).
git fetch origin skill/add-agentSDK-codex
git merge origin/skill/add-agentSDK-codex --no-edit
npm install && npm run build && ./container/build.sh
AskUserQuestion: How do you want to authenticate with OpenAI?
codex auth login on the server (opens browser for OAuth)OPENAI_API_KEY=sk-... to .envFor subscription: tell the user to run codex auth login in another terminal. Wait for confirmation.
Add to .env:
DEFAULT_RUNTIME=codex
launchctl kickstart -k gui/$(id -u)/com.nanoclaw # macOS
# Linux: systemctl --user restart nanoclaw
Send a message in the registered chat. Check /auth shows Codex status.
git log --oneline --all | grep "add Codex" # find the merge commit
git revert <commit> -m 1
npm install && npm run build && ./container/build.sh