openclaw-inspector

KO | EN

gitlite — search

#javascript #python #hacktoberfest #llm #android #rust #linux #docker #macos #kubernetes #awesome-list #pytorch #ios #openai

openclaw-inspector

(★ 5)

Review every conversation your OpenClaw agent has ever had — including deleted sessions — and flag dangerous actions.

openclaw-inspector 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# OpenClaw Inspector 🔍

**Your AI agent has full access to your machine. Are you sure it's behaving?**

[OpenClaw](https://openclaw.ai) (and Clawdbot) can run shell commands, edit files, push to git, install packages, access your camera, take screenshots — essentially do *anything* on your system. It runs autonomously in background sessions, cron jobs, and sub-agents. Most of the time, you never see what it does.

**OpenClaw Inspector** lets you see everything. It's a local web app that reads your bot's session history and shows you exactly what happened — every command, every file edit, every tool call. It automatically flags dangerous actions so you can catch problems before they escalate.

## When you need this

- 🤔 **"What did my bot do while I was away?"** — Browse all sessions including deleted ones
- 🚨 **"Did it run anything dangerous?"** — Auto-detects `rm -rf`, `git push --force`, `sudo`, config edits, secret exposure, and more
- 📱 **"Did it access my camera/screen?"** — Flags surveillance actions (screenshots, camera, location tracking)
- 📊 **"I have 100+ sessions, how do I review them all?"** — Track read progress, filter by status, mark sessions as reviewed
- 🔄 **"I want to monitor in real-time"** — Live updates via SSE, toast notifications for new messages

## Quick start

```bash
npx openclaw-inspector
```

Opens at http://localhost:9100. That's it.

### Custom port

```bash
PORT=9101 npx openclaw-inspector
```

### Custom sessions directory

```bash
SESSIONS_DIR=~/.openclaw/agents/main/sessions npx openclaw-inspector
```

## What it detects

| Category | Examples | Severity |
|----------|----------|----------|
| **Destructive filesystem** | `rm -rf`, `shred`, `find -delete` | 🔴 Critical |
| **Git destructive** | `git push --force`, `git reset --hard`, `git clean -f` | 🔴 Critical |
| **Repo/account actions** | `gh repo delete`, `gh repo edit --visibility public` | 🔴 Critical |
| **Config changes** | `sed -i`, writing to `.env`, `.ssh/`, `.zshrc` | 🟡 Warning |
| **Package/system** | `sudo`, `brew uninstall`, `chmod 777` | 🟡 Warning |
| **Process killing** | `kill -9`, `killall`, `pkill` | 🟡 Warning |
| **Secrets/network** | `curl -X POST`, exported tokens/passwords | 🟡 Warning |
| **Surveillance** | Screenshots, camera access, screen recording, location | 🟡 Warning |
| **Cron changes** | `crontab`, `launchctl`, `systemctl` | 🟡 Warning |

Rules are fully customizable — edit `~/.openclaw-inspector/danger-rules.json`.

## Features

- **Multi-axis filtering** — filter by review status (unread/in progress/reviewed), session type (active/orphan/deleted), and danger level — all combinable
- **Read progress tracking** — click any message to mark everything up to that point as reviewed; a blue divider shows where you left off
- **Live updates** — new messages and sessions appear automatically with toast notifications
- **Tool call previews** — see URLs, file paths, search queries, and commands inline without expanding
- **Session renaming** — click the title to give any session a custom label
- **Message search** — full-text search within a session
- **Mobile responsive** — works on phones and tablets
- **State persistence** — all filters, sort order, and UI state saved in localStorage

## Live monitoring

Inspector watches your sessions directory in real-time. When your bot starts a new conversation, receives a message, or runs a tool — it appears instantly in the UI. No need to refresh the page.

- New sessions appear in the sidebar automatically
- New messages stream into the currently open session
- Toast notifications show activity in other sessions
- Works for background sessions, cron jobs, and sub-agents too

## Privacy & security

- 🔒 **100% local** — everything runs on your machine. No cloud, no telemetry, no external connections
- 📁 **Read-only** — Inspector never modifies, deletes, or interferes with your sessions. It only reads JSONL files from disk
- 🏠 **Localhost only** — server binds to `127.0.0.1` by default, inaccessible from the network
- 💾 **Your data stays yours** — progress and settings stored in `~/.openclaw-inspector/`, never sent anywhere

## Configuration

### Environment variables

| Variable | Default | Description |
|----------|---------|-------------|
| `PORT` | `9100` | Server port |
| `HOST` | `127.0.0.1` | Bind address (localhost only by default) |
| `SESSIONS_DIR` | auto-detect (`~/.openclaw/` or `~/.clawdbot/`) | Path to session JSONL files |
| `DATA_DIR` | `~/.openclaw-inspector` | User config and progress storage |

### User data (`~/.openclaw-inspector/`)

Created automatically on first launch:

- `danger-rules.json` — danger detection rules (customize freely, won't be overwritten on updates)
- `progress.json` — read progress (persists across devices if you sync the folder)

### Remote access via Tailscale

To access Inspector from your phone or another device:

```bash
# Serve local port via Tailscale HTTPS
tailscale serve https:9100 / http://localhost:9100
```

Then open `https://your-machine.tailnet.ts.net:9100` from any device on your tailnet.

## Development

```bash
git clone https://github.com/lukavyi-consulting/openclaw-inspector.git
cd openclaw-inspector
npm install

# Run both backend + frontend in one command
npm run dev:full
```

Open http://inspector.localhost:1355 (requires [portless](https://github.com/vercel-labs/portless)).

Without portless:

```bash
# Terminal 1: Backend
npm run dev:api

# Terminal 2: Vite dev server with HMR
npm run dev
```

Open http://localhost:5173 (proxies API to backend).

```bash
npm test          # Unit tests (Vitest)
npm run build     # Production build → dist/
```

## ⚠️ Compatibility note

This project has been tested **exclusively with Telegram** sessions. Other messaging channels (Discord, Signal, WhatsApp, Slack, etc.) may have different session file structures or message formats that could cause display issues or missing data.

If you use OpenClaw with a non-Telegram channel and encounter problems, please [open an issue](https://github.com/lukavyi-consulting/openclaw-inspector/issues) — PRs welcome!

## Built with OpenClaw 🤖

This entire project was vibe-coded through [OpenClaw](https://openclaw.ai) — from the first line of code to npm publish. No manual coding involved. The irony of an AI agent building its own inspector is not lost on us.

## License

MIT

openclaw-inspector

openclaw-inspector 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

openclaw-inspector

openclaw-inspector 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README