Skillppx logo

Claw Insights Install

本地运行的 OpenClaw 代理监控仪表盘，支持会话回放与状态卡片生成。

已扫描
适合谁
OpenClaw 开发者、AI 代理系统运维人员
不适合谁
无 OpenClaw 环境的普通用户、无法安装 Node.js 的受限环境用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @lucal6/claw-insights-install
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

安装 Claw Insights

启动时提示： "我正在设置 Claw Insights —— 一个用于 OpenClaw 代理的只读可观测性仪表板。"

什么是 Claw Insights？

一个用于 OpenClaw 代理的只读可观测性仪表板。只需一条命令即可安装，自动连接到正在运行的网关 —— 无需任何配置。

  • 零侵入性 —— 纯侧车模式，仅读取日志和 CLI 输出；无需代码修改，不调用云端服务，数据完全保留在本地机器
  • 完整会话回放 —— 带角色区分、工具调用记录和每轮 token 使用量追踪的完整对话时间线
  • 可分享的快照 —— 通过 REST API 生成 PNG/SVG 格式的状态卡片，支持主题、语言和详细程度选择

本地运行，使用 SQLite 存储。需要 Node.js ≥ 22.5 及一个正在运行的 OpenClaw 网关。

安装

# 一键安装（推荐）
curl -fsSL https://claw-insights.com/install.sh | sh

# 或通过 npm 安装
npm install -g claw-insights

启动

claw-insights start             # 默认端口 41041，自动打开浏览器
claw-insights start --port 8080 # 自定义端口
claw-insights start --no-auth   # 禁用认证
claw-insights stop              # 停止服务
claw-insights restart           # 重启服务

验证

curl http://127.0.0.1:41041/health
# → {"status":"ok",...}

升级

npm update -g claw-insights
# 或重新运行安装脚本
curl -fsSL https://claw-insights.com/install.sh | sh

快速配置

环境变量默认值说明
CLAW_INSIGHTS_SERVER_PORT41041服务器端口
CLAW_INSIGHTS_API_TOKEN_(自动生成)_认证令牌（最少 32 位）
CLAW_INSIGHTS_NO_AUTHfalse完全禁用认证
CLAW_INSIGHTS_DB~/.claw-insights/metrics.dbSQLite 数据库路径
CLAW_INSIGHTS_RAW_RETENTION_DAYS7原始指标保留天数（天）

完整配置参考：查看 [references/configuration.md](references/configuration.md)

故障排除

现象原因解决方法
EADDRINUSE端口已被占用执行 claw-insights stop 后重试，或使用 --port 指定新端口
Cannot connect to gatewayOpenClaw 网关未运行启动网关：openclaw gateway start
401 Unauthorized令牌不匹配检查 CLAW_INSIGHTS_API_TOKEN，或使用 --no-auth
Node.js version errorNode.js 版本低于 22.5将 Node.js 升级至 ≥ 22.5

更多故障排除信息：查看 [references/troubleshooting.md](references/troubleshooting.md)

下一步

使用 claw-insights-snapshot 技能通过 REST API 生成并分享可视化状态卡片。

L
@lucal6

已收录 2 个 Skill

相关推荐