sentry
Add observability to your OpenClaw instance — errors, logs, and traces sent to Sentry. Set up monitoring with the Sentry plugin, then investigate issues with the `sentry` CLI.
- License 许可
- MIT
- 最近更新
- 2026-06-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- sentry
- metadata
- { "openclaw": { "emoji": "🐛", "install": [ { "id": "npm", "bins": [ "sentry" ], "kind": "npm", "label": "Install Sentry CLI (npm)", "global": true, "package": "sentry" } ], "requires": { "bins": [ "sentry" ] } } }
- description
- Add observability to your OpenClaw instance — errors, logs, and traces sent to Sentry. Set up monitoring with the Sentry plugin, then investigate issues with the `sentry` CLI.
03 SKILL.md 正文
Sentry — OpenClaw Observability
See what your OpenClaw instance is doing: errors, structured logs, and performance traces — all in Sentry.
Two halves: setup (get telemetry flowing) and investigation (query it with the CLI).
Setup
1. Authenticate
sentry auth login
OAuth device flow — follow the browser prompt. Credentials stored in ~/.sentry/cli.db.
Alternatives (one-liners):
sentry auth login --token <TOKEN>— paste an auth token directlySENTRY_AUTH_TOKEN=<token>— env var, useful in CI
2. Create a Project
Create a dedicated Sentry project for your OpenClaw instance:
sentry api /teams/<org>/<team>/projects/ \
--method POST \
--field name="my-openclaw" \
--field platform=node
Don't know your org/team slugs? List them:
sentry api /organizations/ # list orgs
sentry api /organizations/<org>/teams/ # list teams in org
3. Get the DSN
sentry project view <org>/my-openclaw --json | jq -r '.dsn'
Or via the keys endpoint:
sentry api /projects/<org>/my-openclaw/keys/ | jq '.[0].dsn.public'
4. Configure OpenClaw
Add the DSN to your openclaw.json:
{
"plugins": {
"entries": {
"sentry": {
"enabled": true,
"config": {
"dsn": "https://examplePublicKey@o0.ingest.sentry.io/0",
"enableLogs": true
}
}
}
}
}
Note: Config goes under
plugins.entries.sentry.config, not directly undersentry.
Then install the Sentry plugin. See references/plugin-setup.md for the full plugin implementation using @sentry/node.
Log buffer gotcha: Sentry's structured logs buffer up to 100 items before auto-flushing. For low-volume services like OpenClaw, logs may sit in the buffer for a long time. The plugin should call
_INTERNAL_flushLogsBuffer(client)periodically (e.g. every 30s) and beforeSentry.flush()on shutdown. Seereferences/plugin-setup.mdfor the implementation.
5. Verify
Restart your OpenClaw gateway, then check Sentry for incoming events:
sentry issue list <org>/my-openclaw --limit 5
Investigation
Once telemetry is flowing, use the CLI to query your OpenClaw's errors, traces, and events.
List Issues
sentry issue list <org>/<project>
sentry issue list <org>/<project> --query "is:unresolved" --sort freq --limit 20
sentry issue list <org>/ # all projects in org
View an Issue
sentry issue view <short-id> # e.g. MY-OPENCLAW-42
sentry issue view <short-id> --json # structured output
AI Root Cause Analysis
sentry issue explain <issue-id> # Seer analyzes the root cause
sentry issue explain <issue-id> --force # force fresh analysis
sentry issue plan <issue-id> # generate a fix plan (run explain first)
Structured Logs
sentry log list <org>/<project> # last 100 logs
sentry log list <org>/<project> --limit 50 # last 50
sentry log list <org>/<project> -q 'level:error' # filter by level
sentry log list <org>/<project> -q 'database' # filter by message
sentry log list <org>/<project> -f # stream in real-time (2s poll)
sentry log list <org>/<project> -f 5 # stream with 5s poll
sentry log list <org>/<project> --json # structured output
View a specific log entry:
sentry log view <log-id> # 32-char hex ID
sentry log view <log-id> --json
sentry log view <log-id> --web # open in browser
Inspect Events
sentry event view <event-id> # full stack trace + context
sentry event view <event-id> --json
Direct API Calls
sentry api /projects/<org>/<project>/issues/ --paginate
sentry api /issues/<id>/ --method PUT --field status=resolved
sentry api /issues/<id>/ --method PUT --field assignedTo="user@example.com"
Workflow: Investigate an Error
sentry issue list <org>/<project> --query "is:unresolved" --sort date --limit 5sentry issue view <short-id>— context, affected users, timelinesentry issue explain <issue-id>— AI root cause analysissentry issue plan <issue-id>— concrete fix steps- Fix →
sentry api /issues/<id>/ --method PUT --field status=resolved
Reference
- Full CLI commands:
references/cli-commands.md - Plugin implementation:
references/plugin-setup.md - CLI docs: https://cli.sentry.dev
- Sentry API: https://docs.sentry.io/api/
- Node SDK: https://docs.sentry.io/platforms/javascript/guides/node/
04 同仓库更多 Skills
crowd-prompting
A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.
ceaser
Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).
ceaser-send
Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.
dilemm-ai
Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).
moldium
Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.
arxiv-paper-reviews
Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.