The Claw Bay (theclawbay)

theclawbay is a customer CLI for The Claw Bay.

This package no longer runs local account login automation or local account switching flows.

Not affiliated with OpenAI or Codex. Not an official tool.

Requirements

• Node.js 18+
• Codex CLI (@openai/codex) and/or OpenClaw CLI

Install

npm i -g theclawbay

If you use nvm, keep a single global prefix to avoid duplicate binaries:

npm config delete prefix

One-Time Setup (Recommended)

Use your purchased API key from your dashboard:

theclawbay setup --api-key <apiKey>

This auto-detects installed clients and writes direct WAN API-key config so users can run directly. It configures Codex with model_provider = "theclawbay" and a managed bearer token, auto-selects the highest backend-advertised model, and preserves conversation visibility by neutralizing legacy local session provider tags so chats remain visible across provider modes.

It also configures OpenClaw/OpenCode automatically when those CLIs are installed. OpenClaw/OpenCode provider configs are written with a literal API key (no env var dependency). If OpenClaw has a stale ${CODEX_LB_API_KEY} placeholder from an older setup, theclawbay setup now auto-heals ~/.openclaw/openclaw.json.

CODEX_LB_API_KEY is persisted for restarts in:

• ~/.config/theclawbay/env
• ~/.bashrc
• ~/.zshrc
• ~/.profile
• ~/.vscode-server/server-env-setup (and ~/.vscode-server-insiders/server-env-setup when present)

If you operate a custom backend, pass it explicitly:

theclawbay setup --api-key <apiKey> --backend https://your-domain.com

After setup, restart terminal/VS Code once only if your own shell workflows depend on CODEX_LB_API_KEY.

Codex Extension Behavior

• In API-key provider mode, Codex may label the model source as Custom.
• Full ChatGPT account model-picker behavior is tied to ChatGPT auth mode.
• theclawbay setup keeps your existing Codex login state unchanged on purpose (so local history context is preserved and setup stays non-destructive).

Run Relay (Optional)

Only needed as a fallback compatibility mode:

theclawbay link --api-key <apiKey>
theclawbay proxy

By default this starts a local relay on http://127.0.0.1:2455 and forwards to:

• https://theclawbay.com/api/codex-auth/v1/proxy/...

The command auto-detects whether openclaw and/or opencode are installed and configures them automatically.

Notes

• End users only need API keys. They do not need upstream account credentials.
• Keep your backend on HTTPS for WAN usage.
• Linked config is stored at ~/.codex/theclawbay.managed.json.