README.md
#self-hosted #byo-llm #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 vendor lock-in. Bring your own LLM — OpenAI, Anthropic, Gemini, Groq, or OpenRouter. Swap providers from the settings panel whenever you like.

# 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/byo-llm.md
hub

Bring your own LLM

Plug in OpenAI, Anthropic, Gemini, Groq, or OpenRouter — one API key and you're running. Switch provider or model from the settings panel, per agent, without restarting anything. No lock-in, no middleman.

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 an API key from any supported provider — OpenAI, Anthropic, Gemini, Groq, or OpenRouter. Paste it into the settings panel on first run.

# 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]]
MIT
License
TS
Language
Node 20+
Runtime
local
First