Vault chevron_right README.md
#self-hosted #claude-code #local-first #one-install

GranClaw

Everything you wanted in OpenClaw. In one place.

GranClaw is a personal AI assistant you run on your own [[machine]]. Give it a [[browser]], saved logins, [[persistent-memory]], and a real-time dashboard — then tell it what to do. It drafts your posts, runs your errands on the web, tracks your work in a kanban, and writes back to you on Telegram. Everything happens locally, on your hardware, where you can see it.

No black boxes. No gated features. No surprise bans. Built on Claude Code — the CLI you already pay for, not the API.

# The Stack

the-stack.md

Most "agent frameworks" are a BYO-everything scavenger hunt. You wire together a browser plugin, a vector DB, a kanban service, a notion plugin, a secrets manager, a cron worker, a Telegram bot library, a usage tracker — twelve tools, twelve accounts, twelve surfaces to keep updated. GranClaw ships all of it in one page.

OpenClaw / DIY 12 tools to glue
browser plugin
puppeteer
LangChain
vector db
redis
kanban SaaS
notion api
obsidian plugin
cron worker
secrets mgr
telegram lib
usage tracker
arrow_forward in one page
granclaw/ one npm run dev
languagereal browser
view_kanbanmission control
memoryobsidian-native vault
locksecrets vault
schedulecron schedules
chattelegram adapter
bar_chartusage & cost
one repo · one install · one dashboard

# Mission Control

mission-control.md

A built-in kanban board every agent already knows how to use.

Say "plan a LinkedIn launch week" and watch the cards appear, move through states, and report back. Zero configuration.

![[mission-control]]
GranClaw Mission Control — kanban board with agent-created tasks
docs/images/mission-control.png — kanban tasks agents create themselves

# Real Browser, Real Sessions

real-browser.md

LinkedIn, Instagram, Reddit, Gmail, your internal tools.

Log in once, save the profile, and the agent reuses it forever. No CAPTCHA loops. No API keys for sites that don't have APIs.

![[browser-onboarding]]
GranClaw browser onboarding — save a real browser session for LinkedIn
docs/images/browser-onboarding.png — log in once, reuse forever

# Watch It Browse

watch-it-browse.md

Every page, every click, every scroll.

Click any session and you get a timeline of screenshots plus the exact DOM commands the agent ran.

![[browser-session-player]]
GranClaw browser session player — screenshots timeline and DOM command log
docs/images/browser-session-player.png — timeline + exact DOM commands

# Everything else. Also built in.

the-wow.md
info Note

Every agent ships with this out of the box. No setup, no plugins, no config.

wow/streaming-chat.md
bolt

Streaming Chat

Tokens stream live over WebSocket. See the agent thinking in real time. Stop it mid-action. Session memory survives restarts.

Streaming chat UI
wow/obsidian-vault.md
hub

Obsidian-native vault

Every agent has its own vault of plain markdown files: daily journals, action logs, topic notes, wikilinks between everything. Open it in Obsidian and browse your agent's brain.

workspaces/lucia/vault/
├ journal/2026-04-09.md
├ actions/linkedin-promo.md
├ knowledge/audience.md
└ topics/growth.md
wow/secrets-vault.md
lock

Secrets that stay secret

API keys, bot tokens, credentials added in the UI, injected as env vars only inside the agent process. Never written to files. Never committed.

TELEGRAM_BOT_TOKEN**** injected
wow/usage-tracking.md
bar_chart

Know what you're spending

Every token, every session, every day. Cost estimates, cache hit rates, per-model breakdown. No surprises at the end of the month.

Usage dashboard with per-day cost
wow/claude-code.md
terminal

Claude Code first

Runs on your Claude Code subscription, the same CLI you use every day. No API billing. No rate-limit terror. No risk of account action for "unusual usage" — because it is usual usage.

wow/schedules.md
schedule

Schedules & Telegram

Cron-based scheduled tasks. Agent wakes up at 9am, writes you a summary, and sends it to you on Telegram. Then goes back to sleep.

0 9 * * * → lucia-agent → daily-briefing

# Install

install.md

Four lines. No sign-up. No account. Everything local.

# 1. clone
git clone https://github.com/aitrace-dev/granclaw.git
# 2. enter
cd granclaw
# 3. install & run
npm install && npm run dev
# dashboard
→ http://localhost:5173
info
Prereqs

Node 20+ and the claude CLI on your PATH (from your Claude Code subscription).

# Why not OpenClaw?

manifesto.md
Because you want to sleep at night.

GranClaw was built for people who got tired of waiting for features they already needed, fighting vendor lock-in, and worrying about bans on accounts they were paying for. Everything here runs locally, on your machine, from code you can read.

fork_right Fork it

It belongs to you.

tune Modify it

Adapt it to your workflow.

delete Delete what you don't need

Nobody is watching.

# GitHub

github.md
[[github.com/aitrace-dev/granclaw]] open_in_new
MIT
License
TS
Language
Node 20+
Runtime
local
First