Set limits

What are limits?

Two types of rules you can set per agent:

Open agent settings

Open your agent’s Settings page in the dashboard.

Add a rule

Under “Notification Rules”, click Add Rule.

Configure the rule

Pick a metric (tokens or cost), period (hour / day / week / month), threshold, and action (notify or block).

Save

Save. The rule takes effect immediately.

When a “block” rule triggers, the next ingest request returns 429 Too Many Requests with a message:

Limit exceeded: cost usage ($X) exceeds $Y per day

The block resets at the start of the next period.

Emails are sent via the platform’s mail provider. Make sure your account email is valid.

Configure an email provider in ~/.openclaw/manifest/config.json:

{
  "email": {
    "provider": "mailgun",
    "apiKey": "key-...",
    "domain": "mg.example.com",
    "from": "alerts@example.com"
  }
}

Supported providers: Mailgun, Resend, SendGrid. If no provider is configured, email notifications are skipped (block rules still work).

Rules are evaluated hourly (cron) for notifications, and on every ingest for blocks.
A notification is sent once per rule per period to avoid spam.