核心用法
Observability Skill 是一款面向 OpenClaw 用户的轻量级监控工具，提供两大核心功能：
1. API 成本报告（`get_cost_report`）
- 自动统计过去 24 小时内活跃会话的 API 调用成本
- 基于硬编码定价表计算各模型的预估费用
- 输出 Markdown 格式表格，便于快速查阅与分享
2. 错误会话追踪（`get_recent_errors`）
- 扫描最近 50 个会话，识别失败或异常终止的任务
- 通过
journalctl读取 systemd 日志，定位问题根因 - 返回问题会话 ID 列表及状态详情，辅助故障排查
该技能完全基于 Node.js 标准库实现，通过 child_process.exec 执行本地 openclaw CLI 和系统日志命令，无需配置外部 API 密钥或网络连接。
显著优点
零依赖架构：无 npm 外部依赖包，单文件（约 162 行有效代码）自包含，部署轻量、维护简单，彻底规避供应链攻击风险。
数据安全可控：所有操作均在本地完成，无外部网络请求、无 DNS 外带、无数据上传，会话元数据与日志信息完全保留在用户设备内，符合 GDPR 数据最小化原则。
命令注入免疫：child_process.exec 执行的命令均为硬编码模板，仅 limit 参数为数字变量，经静态分析确认无注入攻击面。
即装即用：无需复杂配置，安装后可直接调用工具函数，输出格式友好（Markdown 表格、结构化列表），适合集成到自动化工作流或报告生成场景。
潜在缺点与局限性
定价表静态维护：成本计算依赖内置的 PRICING_TABLE 硬编码数据，若 OpenClaw 官方调整模型定价，需手动更新技能版本，存在滞后风险。
平台绑定性强：深度依赖 OpenClaw CLI 和 systemd/journalctl，仅适用于 Linux 系统环境（或具备 systemd 的 WSL/macOS 配置），Windows 原生环境无法直接使用。
功能边界有限：仅支持成本估算（非精确账单）和错误日志摘要，缺乏实时监控告警、历史趋势分析、多租户聚合等高级可观测性功能。
会话范围受限：成本报告仅覆盖最近 24 小时，错误检查仅扫描最近 50 个会话，无法满足长期成本审计或大规模故障追溯需求。
适合的目标群体
- OpenClaw 个人开发者：需要快速了解 API 开销、排查会话失败原因的独立用户
- 小型技术团队：缺乏专业运维资源，希望通过轻量工具实现基础成本管控与故障定位
- CI/CD 自动化场景：在流水线中集成成本检查或错误扫描步骤，实现质量门禁
- 隐私敏感用户：对数据外泄高度警惕，偏好纯本地化运行的监控方案
使用风险说明
性能层面：journalctl 和 openclaw sessions list 命令在大规模日志或高并发会话场景下可能产生延迟，建议避免在实时交互链路中同步调用。
维护层面：定价表过期将导致成本估算偏差，建议关注仓库更新或自行 fork 维护；作者为 T3 来源个人开发者，长期支持承诺有限。
权限层面：技能需执行本地系统命令并读取用户级 systemd 日志，部署时应确保运行环境具备相应权限，避免在共享或受限容器中强制安装。
扩展性局限：若 OpenClaw 官方调整 CLI 输出格式或日志路径，现有解析逻辑可能失效，需等待社区修复或自行适配。