概述

Install Claw Insights

Announce at start: "I'm setting up Claw Insights — a read-only observability dashboard for your OpenClaw agent."

What is Claw Insights?

A read-only observability dashboard for OpenClaw agents. One command installs it, auto-connects to your running gateway — no configuration needed.

Zero intrusion — pure sidecar that reads logs and CLI output only; no code changes, no cloud calls, data stays on your machine
Full session replay — complete transcript timeline with role separation, tool calls, and per-turn token tracking
Shareable snapshots — generate PNG/SVG status cards with themes, languages, and detail levels via REST API

Runs locally with SQLite. Requires Node.js ≥ 22.5 and a running OpenClaw gateway.

Install

# One-line install (recommended)
curl -fsSL https://claw-insights.com/install.sh | sh

# Or via npm
npm install -g claw-insights

Run

claw-insights start             # Default port 41041, opens browser
claw-insights start --port 8080 # Custom port
claw-insights start --no-auth   # Disable authentication
claw-insights stop              # Stop the service
claw-insights restart           # Restart

Verify

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

Upgrade

npm update -g claw-insights
# Or re-run the install script
curl -fsSL https://claw-insights.com/install.sh | sh

Quick Config

Variable	Default	Description
----------------------------------	-----------------------------	---------------------------
`CLAW_INSIGHTS_SERVER_PORT`	`41041`	Server port
`CLAW_INSIGHTS_API_TOKEN`	_(auto)_	Auth token (min 32 chars)
`CLAW_INSIGHTS_NO_AUTH`	`false`	Disable auth entirely
`CLAW_INSIGHTS_DB`	`~/.claw-insights/metrics.db`	SQLite database path
`CLAW_INSIGHTS_RAW_RETENTION_DAYS`	`7`	Raw metric retention (days)

Full configuration reference: See references/configuration.md

Troubleshooting

Symptom	Cause	Fix
---------------------------	----------------------------	--------------------------------------------------
`EADDRINUSE`	Port already in use	`claw-insights stop` then retry, or use `--port`
`Cannot connect to gateway`	OpenClaw gateway not running	Start gateway: `openclaw gateway start`
`401 Unauthorized`	Token mismatch	Check `CLAW_INSIGHTS_API_TOKEN` or use `--no-auth`
`Node.js version error`	Node.js < 22.5	Upgrade Node.js to ≥ 22.5

More troubleshooting: See references/troubleshooting.md

Next Step

Use the claw-insights-snapshot skill to generate and share visual status cards via REST API.

版本历史

共 1 个版本

v1.0.0 当前

2026-05-02 00:41 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)