Support

CellCog API Keys Guide

Manage API keys to integrate CellCog with external tools, scripts, and agent platforms like OpenClaw. Our API keys technically work with most APIs but we officially only support OpenClaw.


What Are API Keys?

API keys let you access CellCog programmatically — without using the web interface. They're used by:

  • OpenClaw agents via the CellCog Python SDK
  • Cursor via the CellCog plugin
  • Claude Code via the CellCog plugin
  • Other coding agents via the CellCog plugin or Python SDK directly

Finding Your API Key Settings

  1. Click your profile avatar in the sidebar (bottom-left)
  2. Select Settings
  3. Click the API Keys tab
  4. Or go directly to: cellcog.ai/profile?tab=api-keys

Generating an API Key

  1. Go to ProfileAPI Keys tab
  2. Click Generate API Key
  3. Your key will be displayed once — copy it immediately
  4. Check the confirmation box to acknowledge you've saved it
  5. Click Done

⚠️ Important: The full API key is only shown once at generation time. CellCog does not store the full key — only a hash for verification. If you lose it, you'll need to revoke and generate a new one.


Using Your API Key

With the CellCog Python SDK (for OpenClaw)

Set CELLCOG_API_KEY as an environment variable:

bash
bash
export CELLCOG_API_KEY="sk_your_api_key_here"

Then use the SDK:

python
python
from cellcog import CellCogClient

client = CellCogClient(agent_provider="openclaw")
# API key is automatically read from environment variable

# Create a chat (fire-and-forget)
result = client.create_chat(
    prompt="Research quantum computing advances",
    notify_session_key="agent:main:main",
    task_label="research"
)

With Direct API Calls

We do not officially support direct API calls.


Managing Your API Key

Checking Key Status

Go to ProfileAPI Keys to see:

  • Whether you have an active key
  • When it was created
  • When it was last used

Revoking Your API Key

  1. Go to ProfileAPI Keys
  2. Click Revoke API Key
  3. Confirm revocation

⚠️ Revoking immediately invalidates the key. Any scripts or integrations using it will stop working.

Regenerating

After revoking, you can generate a new key. The old key cannot be recovered.


Security Best Practices

  1. Never share your API key in public repositories, chat messages, or emails
  2. Use environment variables to store keys in scripts:
    bash
    bash
    export CELLCOG_API_KEY="sk_your_key_here"
  3. Rotate keys periodically — revoke and regenerate every few months
  4. Monitor usage — check "Last Used" date to detect unauthorized access
  5. One key per account — CellCog allows one active API key at a time

Credit Usage

API key usage consumes credits from your account, same as web usage:

  • Each chat creation, message, and AI operation uses credits
  • Credits come from your subscription or top-up purchases
  • Minimum credits required: 60 for Agent and Agent Creative, 1,000 for Agent Team, 2,000 for Agent Team Max

See Billing Guide for credit details.


Frequently Asked Questions

Where do I find my API key?

Go to ProfileAPI Keys tab (or cellcog.ai/profile?tab=api-keys).

Can I have multiple API keys?

No, CellCog supports one active API key per account. Revoke the current one to generate a new one.

I lost my API key. How do I get it back?

You can't retrieve a lost key. Revoke the old one and generate a new one.

Does the API key expire?

No, API keys don't expire automatically. They remain active until you revoke them.

What permissions does the API key have?

The API key has full access to your account — same as being logged in. It can create chats, send messages, and access all features.

Is there a rate limit?

API requests are subject to the same credit system as web usage. There's no separate rate limit, but credit consumption controls usage naturally.


Related Guides