Skip to content

madrzak/vidclaw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

203 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

VidClaw

A secure, self-hosted command center for managing your OpenClaw AI agent.

Dark theme dashboard with Kanban board, usage tracking, and more build license

Features

  • πŸ—‚οΈ Kanban Task Board β€” Backlog β†’ Todo β†’ In Progress β†’ Done. Drag & drop, priorities, skill assignment. Your agent picks up tasks automatically via heartbeat or cron.
  • πŸ“Š Usage Tracking β€” Real-time token usage and cost estimates parsed from session transcripts. Progress bars matching Anthropic's rate limit windows.
  • πŸ”„ Model Switching β€” Switch between Claude models directly from the dashboard. Hot-reloads via OpenClaw's config watcher.
  • πŸ“… Activity Calendar β€” Monthly view of agent activity, parsed from memory files and task history.
  • πŸ“ Content Browser β€” Browse workspace files with markdown preview, syntax highlighting, and download.
  • 🧩 Skills Manager β€” View all bundled/workspace skills, enable/disable them, create custom skills.
  • πŸ’œ Soul Editor β€” Edit SOUL.md, IDENTITY.md, USER.md, AGENTS.md with version history and persona templates.
  • ⚑ Task Execution β€” Tasks execute automatically via cron (every 2 min) or heartbeat (every 30 min). Hit "Run Now" for immediate execution.

Security

VidClaw binds to localhost only (127.0.0.1:3333) β€” no external network calls, all data stays on your machine.

Remote access is handled via Tailscale Serve (enabled by default on port 8443). Alternatively, use an SSH tunnel: ssh -L 3333:localhost:3333 <user>@<server>.

Then open https://your-machine.your-tailnet.ts.net:8443 (Tailscale) or http://localhost:3333 (SSH).

Prerequisites

  • OpenClaw installed and running
  • Node.js >= 18
  • Git

Install

curl -fsSL vidclaw.com/install.sh | bash

Installs Node.js, git, Tailscale, and VidClaw in one command. Localhost only: add --no-tailscale.

Update

./update.sh

Usage

./start.sh       # start the service
./stop.sh        # stop the service
./status.sh      # check service status
./logs.sh        # view logs

Development

./start.sh --dev

Starts the backend + Vite dev server with HMR.

API

See API.md for the endpoint reference.

Stack

React + Vite + Tailwind CSS / Express.js / JSON file storage

License

MIT


Copyright (c) 2026 woocassh Β· MIT License

About

The OpenClaw Dashboard 🦞

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors