# Send Sentry Observability to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "sentry-observability", "name": "Sentry Observability", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/sergical/sentry-observability", "canonicalUrl": "https://clawhub.ai/sergical/sentry-observability", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/sentry-observability", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sentry-observability", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "references/cli-commands.md", "references/plugin-setup.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "sentry-observability", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-08T16:39:03.361Z", "expiresAt": "2026-05-15T16:39:03.361Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sentry-observability", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sentry-observability", "contentDisposition": "attachment; filename=\"sentry-observability-1.1.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "sentry-observability" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/sentry-observability" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/sentry-observability", "downloadUrl": "https://openagent3.xyz/downloads/sentry-observability", "agentUrl": "https://openagent3.xyz/skills/sentry-observability/agent", "manifestUrl": "https://openagent3.xyz/skills/sentry-observability/agent.json", "briefUrl": "https://openagent3.xyz/skills/sentry-observability/agent.md" } } ``` ## Documentation ### 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). ### 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 — paste an auth token directly SENTRY_AUTH_TOKEN= — env var, useful in CI ### 2. Create a Project Create a dedicated Sentry project for your OpenClaw instance: sentry api /teams///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//teams/ # list teams in org ### 3. Get the DSN sentry project view /my-openclaw --json | jq -r '.dsn' Or via the keys endpoint: sentry api /projects//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 under sentry. 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 before Sentry.flush() on shutdown. See references/plugin-setup.md for the implementation. ### 5. Verify Restart your OpenClaw gateway, then check Sentry for incoming events: sentry issue list /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 / sentry issue list / --query "is:unresolved" --sort freq --limit 20 sentry issue list / # all projects in org ### View an Issue sentry issue view # e.g. MY-OPENCLAW-42 sentry issue view --json # structured output ### AI Root Cause Analysis sentry issue explain # Seer analyzes the root cause sentry issue explain --force # force fresh analysis sentry issue plan # generate a fix plan (run explain first) ### Structured Logs sentry log list / # last 100 logs sentry log list / --limit 50 # last 50 sentry log list / -q 'level:error' # filter by level sentry log list / -q 'database' # filter by message sentry log list / -f # stream in real-time (2s poll) sentry log list / -f 5 # stream with 5s poll sentry log list / --json # structured output View a specific log entry: sentry log view # 32-char hex ID sentry log view --json sentry log view --web # open in browser ### Inspect Events sentry event view # full stack trace + context sentry event view --json ### Direct API Calls sentry api /projects///issues/ --paginate sentry api /issues// --method PUT --field status=resolved sentry api /issues// --method PUT --field assignedTo="user@example.com" ### Workflow: Investigate an Error sentry issue list / --query "is:unresolved" --sort date --limit 5 sentry issue view — context, affected users, timeline sentry issue explain — AI root cause analysis sentry issue plan — concrete fix steps Fix → sentry api /issues// --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/ ## Trust - Source: tencent - Verification: Indexed source record - Publisher: sergical - Version: 1.1.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-08T16:39:03.361Z - Expires at: 2026-05-15T16:39:03.361Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/sentry-observability) - [Send to Agent page](https://openagent3.xyz/skills/sentry-observability/agent) - [JSON manifest](https://openagent3.xyz/skills/sentry-observability/agent.json) - [Markdown brief](https://openagent3.xyz/skills/sentry-observability/agent.md) - [Download page](https://openagent3.xyz/downloads/sentry-observability)