Rollbar Skill

Monitor and manage Rollbar errors directly from OpenClaw.

Setup

The script resolves your Rollbar token from the first matching source:

Priority	Method	How
1	$PWD/secrets/rollbar	One-line file in your agent workspace containing the token
2	.rollbar-mcp.json	MCP-compatible JSON config (cwd, ~/.rollbar-mcp.json, or $ROLLBAR_CONFIG_FILE)
3	$PWD/.env	File in your agent workspace with ROLLBAR_ACCESS_TOKEN=your-token
4	ROLLBAR_ACCESS_TOKEN	Environment variable (injected or shell)

MCP-Compatible Config (Recommended for multi-project setups)

Create .rollbar-mcp.json in your agent workspace:

// Single project
{ "token": "tok_abc123" }

// Multiple projects
{
  "projects": [
    { "name": "linkz-api",       "token": "tok_abc123" },
    { "name": "linkz-dashboard", "token": "tok_xyz789" },
    { "name": "linkz-php",       "token": "tok_def456" }
  ]
}

Use --project-name <name> to select a specific project's token when running commands.

Tip: Use project-token-create --save to have the agent auto-create and persist tokens to .rollbar-mcp.json.

Single-project .env

# workspace-myagent/.env
ROLLBAR_ACCESS_TOKEN=your-token-here

Token types

• Project-level token — from Rollbar → Project → Settings → Project Access Tokens. Use read scope for monitoring; add write scope to resolve/mute. Best for single-project use.
• Account-level token — from Rollbar → Account Settings → Account Access Tokens. Required for projects, project-tokens, and project-token-create. Use --project-id to target specific projects.

Commands

All commands use the helper script rollbar.sh in this skill directory.

List projects (account token only)

./skills/rollbar/rollbar.sh projects

List recent items (errors/warnings)

./skills/rollbar/rollbar.sh items [--project-id <id>] [--project-name <name>] [--status active|resolved|muted] [--level critical|error|warning|info] [--limit 20]

Get item details

./skills/rollbar/rollbar.sh item <item_id>

Get occurrences for an item

./skills/rollbar/rollbar.sh occurrences <item_id> [--limit 5]

Resolve an item

./skills/rollbar/rollbar.sh resolve <item_id> --yes
# or preview without making changes:
./skills/rollbar/rollbar.sh resolve <item_id> --dry-run

Mute an item

./skills/rollbar/rollbar.sh mute <item_id> --yes

Activate (reopen) an item

./skills/rollbar/rollbar.sh activate <item_id> --yes

Safety interlock: resolve, mute, activate, project-token-create, and project-token-update require --yes to execute or --dry-run to preview. Omitting both prints a warning and exits with an error — preventing silent state changes from mistaken or manipulated invocations.

List deploys

./skills/rollbar/rollbar.sh deploys [--limit 10]

Get project info

./skills/rollbar/rollbar.sh project

Top active items (summary)

./skills/rollbar/rollbar.sh top [--limit 10] [--hours 24]

---

Project Access Token Management

These commands require an account-level token with write scope.

List project access tokens

./skills/rollbar/rollbar.sh project-tokens --project-id <id>

Token values are truncated in output (first 8 chars + ...) for safety.

Create a project access token

./skills/rollbar/rollbar.sh project-token-create \
  --project-id <id> \
  --name "openclaw-agent" \
  --scopes read,write \
  [--project-name <name>] \
  [--save]

• --scopes — comma-separated, e.g. read or read,write (default: read,write)
• --save — automatically saves the new token to .rollbar-mcp.json using --project-name (or --name) as the key
• --project-name — name used as the key in .rollbar-mcp.json when --save is set

Bootstrap workflow — let the agent provision its own project tokens:

# Set account token first
export ROLLBAR_ACCESS_TOKEN=your-account-token

# Create tokens for each project and save to MCP config
./rollbar.sh project-token-create --project-id 378962  --name "linkz-api-agent"       --scopes read,write --project-name linkz-api       --save --yes
./rollbar.sh project-token-create --project-id 462118  --name "linkz-dashboard-agent"  --scopes read,write --project-name linkz-dashboard  --save --yes
./rollbar.sh project-token-create --project-id 755542  --name "linkz-php-agent"        --scopes read,write --project-name linkz-php        --save --yes

# Now use per-project tokens directly from config
./rollbar.sh items --project-name linkz-api

Update a project access token

./skills/rollbar/rollbar.sh project-token-update <token_id> \
  --project-id <id> \
  --token-status enabled|disabled

---

Proactive Monitoring

To get automatic alerts for new critical/error items, set up a cron job in OpenClaw:

"Check Rollbar for new critical or error-level items in the last hour. If any new items appeared, summarize them and alert me."

Recommended schedule: every 30–60 minutes during work hours.

Notes

• All output is JSON for easy parsing.
• The top command sorts active items by occurrence count — useful for daily triage.
• Token values in project-tokens output are truncated for safety; full values are only returned on creation.
• Rollbar API docs: https://docs.rollbar.com/reference