codex-multi-subscription-auth-fallbacks
by markeljan
Coding Agents & IDEsBrief
Set up OpenClaw multi-provider auth with OpenAI Codex OAuth fallback profiles and automatic model switching.
Description
What This Skill Does
Configures multiple OpenAI Codex OAuth profiles in OpenClaw and sets up automatic failover between them when a provider hits a rate limit. Includes a script for device-flow login that imports tokens into OpenClaw's auth-profiles store without exposing them externally. An optional cron job can auto-switch the active model when a provider enters cooldown.
Eliminates manual account switching by letting OpenClaw fail over to a backup Codex profile automatically when one account is rate-limited.
When to Use It
- Adding a second OpenAI Codex account to avoid rate limit interruptions
- Rotating between Codex profiles during heavy coding sessions
- Setting failover priority order across multiple OpenAI accounts
- Automating model switching when a Codex session hits cooldown
- Importing fresh OAuth tokens into OpenClaw without manual JSON editing
Example Workflow
User asks: add my second OpenAI account as a fallback Codex profile named 'work'
- 1
Runs codex-add-profile.sh work to start the import process
- 2
Creates timestamped backups of ~/.codex/auth.json and auth-profiles.json
- 3
Clears Codex CLI auth and triggers device-flow login via browser
- 4
Extracts access token, refresh token, and expiry from the new session
- 5
Writes the new 'work' profile into auth-profiles.json and restores original Codex auth
OpenClaw auth-profiles.json updated with a second Codex OAuth profile named 'work', ready for failover
Requirements
- OpenAI account with Codex access
- OpenAI Codex CLI installed (npm i -g @openai/codex)
Installation
clawhub install markeljan/codex-multi-subscription-auth-fallbacksRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.