What is the codex-account-switcher skill?

This skill provides tools for managing multiple OpenAI Codex accounts. It allows the agent to switch between accounts to avoid rate limits and utilize multiple API keys.

What tools does the codex-account-switcher skill provide?

`switch_to_account`, `list_accounts`, `get_active_account`.

What does the `switch_to_account` tool do?

Switches the active Codex account to the specified one.

What parameters does the `switch_to_account` tool require?

`account_id` (string, required): ID of the account to switch to.

What does the `list_accounts` tool do?

Lists all available Codex accounts. No parameters. Returns list of account IDs.

What does the `get_active_account` tool do?

Gets the currently active account. No parameters. Returns active account ID.

How do you set up the codex-account-switcher skill?

Set `CODEX_ACCOUNTS` environment variable to a JSON array: `[{ "id": "account1", "api_key": "sk-..." }, { "id": "account2", "api_key": "sk-..." }]`.

When should the codex-account-switcher skill be used?

Use when Codex API rate limit is hit or to balance usage across accounts.

OpenClaw skill

codex-account-switcher

An OpenClaw skill that allows agents to switch between multiple Codex accounts seamlessly. It manages authentication tokens and handles account switching without interrupting the agent's workflow. Features include storing multiple Codex API keys, dynamic switching, automatic token refresh, and fallback to secondary accounts on rate limits or errors.

View repository Open SKILL.md

Security notice: review the SKILL.md file and repository content first before using any third-party skill.

Files

Review the files below to add this skill to your agents.

_meta.jsonView
SKILL.mdView

SKILL.md content

Unable to load SKILL.md content from source.

How this skill works

On invocation with action=\"list\": Returns list of available accounts and current active account
On invocation with action=\"switch\" and valid account: Switches to the specified account, sets it as current, and confirms
Accounts are stored in a persistent store (file-based JSON at ~/.openclaw/codex-accounts.json)
Current active account is tracked in the same store
Validates account existence before switching
If invalid account specified, returns error message without switching

When to use it

When the agent needs to switch the active Codex account to a specified pre-configured account
When managing multiple Codex accounts during extended API usage sessions

Best practices

Configure accounts as an array of objects with 'name' and 'api_key' properties
Set a 'default_account' value in the configuration
Validate API keys before configuring the skill
Store configuration securely since API keys are in plain text
Do not commit API keys to version control systems

Example use cases

Bypassing rate limits during intensive API usage: Switches to an alternative Codex account when the primary account hits OpenAI API rate limits, enabling continued task execution.
Load balancing across multiple accounts: Rotates between configured Codex accounts to distribute API calls and prevent any single account from being throttled.
Seamless continuation of long-running tasks: Automatically handles account switching mid-task to maintain workflow without interruption due to quota exhaustion.

FAQs

More similar skills to explore

achurch
An OpenClaw skill for church administration that handles member management, event scheduling, sermon retrieval, and donation processing. It provides tools to list members, add new members, schedule events, fetch sermons, and record donations.
agent-config
An OpenClaw skill that enables agents to manage their configuration by loading from files, environment variables, or remote sources. It supports retrieving, setting, and validating configuration values. The skill allows for hot-reloading of configurations.
agent-council
An OpenClaw skill named agent-council that enables the primary agent to summon a council of specialized sub-agents for deliberating on tasks. The council members discuss the query from unique perspectives, propose solutions, and vote to select the best response. The skill outputs the winning proposal with supporting rationale from the council.
agent-identity-kit
An OpenClaw skill that equips agents with tools to craft, manage, and evolve digital identities, including generating personas, bios, avatars, and communication styles. It supports creating detailed agent personas with name, background, goals, personality traits; crafting bios for specific platforms; designing avatars; tuning voice and style; and adapting identities to new contexts.
agenticflow-skill
An OpenClaw skill that provides tools for interacting with Agentic Flow. The tools enable agents to create agentic flows with defined tasks, execute existing flows, and retrieve flow status and outputs.
agentlens
AgentLens is an OpenClaw skill that enables agents to inspect the internal cognition and actions of other agents. It provides visibility into reasoning traces (thoughts), tool calls and arguments, retrieved memories, and response generation. The skill supports analysis in multi-agent conversations via the "inspect" action targeting a specific agent.