Skip to content
BrainRoad BrainRoad
Documentation Menu

Managing Keys

View, update, rotate, or remove your AI provider keys from the dashboard.

On this page

After setup, your keys are managed from the Helper page (/dashboard), under the API Keys tab of your helper’s detail card.

Viewing your keys

The API Keys tab lists each configured provider. If you’re still on the included trial key, it also shows your remaining trial credit (for example, “Trial credit: $3.20 of $5.00 remaining”) with a usage bar.

Updating or rotating a key

To replace a key — for example, after rotating it at the provider:

1

Open the API Keys tab

On the Helper page, open your helper's API Keys tab.

2

Edit the provider entry

Use the edit control next to the provider you want to update.

3

Paste the new key and save

The old key is replaced. Your helper restarts briefly to pick up the change.

Good rotation practice: create the new key at the provider first, save it in BrainRoad, confirm your helper is working, then revoke the old key in the provider’s dashboard.

Removing a provider

Each provider entry has a remove control; removing asks you to confirm before deleting the key from your helper’s configuration. If you remove your only working key, your helper has no model to think with and pauses AI work until you add another — nothing is deleted, it just waits.

Where keys are stored

Your keys are written into your helper’s own private, isolated workspace — each user’s helper runs in its own separated environment. For the OpenClaw runtime, that’s the runtime’s standard credentials file inside the workspace (auth-profiles.json). BrainRoad’s managed trial key is marked so it can be replaced or removed by BrainRoad without ever touching keys you added yourself.