核心用法
本技能聚焦两大场景：初始化配置与问题排查。
安装配置阶段：通过 openclaw plugins install openclaw-plugin-sentry 安装插件，需在 openclaw.json 中完成两处关键配置——全局启用 diagnostics.enabled: true（链路追踪的开关），并在 plugins.entries.sentry.config 中配置 DSN、环境名、采样率等参数。DSN 可从 Sentry 项目的 Client Keys 页面获取。
数据采集覆盖：自动捕获异常错误（Issues）、AI 对话与消息处理链路（Tracing）、关键事件标记（captureMessage）以及网关日志（Structured Logs）。
问题排查阶段：通过 sentry CLI 完成认证后，可执行 issue list、issue explain（AI 根因分析）、event list 等命令；链路追踪数据需通过原生 API 查询，CLI 暂不支持直接展示。
显著优点
- 全链路可观测：同时覆盖错误、性能链路、日志三类信号，无需额外埋点
- AI 辅助诊断：
sentry issue explain提供自动化根因分析，降低 MTTR - 配置即生效：插件化架构，热更新友好，DSN 等敏感配置支持环境变量注入
- OpenClaw 原生集成：自动映射
model.usage→ai.chat等语义化 span，贴合 LLM 应用场景
潜在局限
- CLI 功能边界：链路追踪数据无法通过 CLI 直接查看，必须调用 REST API
- 时间戳精度敏感：Sentry SDK v10 要求毫秒级时间戳，配置不当会导致 0ms duration 异常
- 诊断事件依赖：链路追踪强依赖
diagnostics.enabled，易被误关闭 - 结构化日志限制：需 Sentry 项目侧开启功能开关，且依赖较新版本 SDK
适合人群
- 运维 OpenClaw 生产实例的工程师
- 需要 LLM 应用性能监控（LLM Observability）的 AI 产品团队
- 已使用 Sentry 作为统一可观测平台的企业用户
常规风险
- DSN 泄露风险：DSN 包含项目标识与写入权限，误提交至代码仓库可能导致数据污染或配额滥用
- 采样率配置陷阱：
tracesSampleRate: 1.0在高并发场景下可能触发 Sentry 配额或性能开销，生产环境建议配合环境动态调整 - 模块隔离问题：
globalThis.__oc_diag补丁机制若与其他诊断插件冲突，可能导致事件丢失