mirror of https://github.com/hanzoai/bot.git synced 2026-10-30 17:24:26 +00:00

Files

T

zeekay 0f9ecb370f docs: rebrand READMEs from upstream OpenClaw to Hanzo Bot

Strip upstream marketing surfaces (logo picture, EXFOLIATE tagline,
sponsor block pointing at upstream's OpenAI/Vercel/Blacksmith/Convex
relationship) and rewrite refs:

  openclaw → hanzo-bot               (CLI name from package.bin)
  OpenClaw → Hanzo Bot               (display name)
  openclaw/openclaw → hanzoai/bot
  openclaw.ai → hanzo.ai
  docs.openclaw.ai → docs.hanzo.ai
  discord.gg/clawd → hanzo.ai#community
  openclaw/nix-openclaw → hanzoai/nix-bot

Touches the top-level README plus the in-tree READMEs that carried the
same upstream copy (apps/*, assets/chrome-extension, docs/security,
docs/.i18n, extensions/*, scripts/shell-helpers, src/hooks/bundled).

Residual OPENCLAW_* env-var refs are intentionally left — they document
the runtime config keys the code still reads. Renaming those needs a
matching code change with a config migration.

2026-05-11 15:35:22 -07:00

4.2 KiB

Raw Permalink Blame History

@hanzo/bot-brain

The Hanzo Brain meta-pack. Drops memory + graph-links + recipes into Hanzo Bot. Single binary, single config, SQLite by default.

What gbrain is to Hanzo Bot, this is to Hanzo Bot — except we are Hanzo Bot (forked), so the gateway, channels, voice, mobile apps, and 355 atomic skills come along for free.

Install

The brain meta-pack is shipped with @hanzo/bot. Enable in hanzo.toml:

[plugins.brain]
enabled = true

[plugins.brain.memory]
# Optional. Defaults below.
# backend = "sqlite"
# dbPath  = "~/.hanzo/brain/brain.db"

[plugins.brain.graph]
enabled = true        # zero-LLM typed-link extraction on every page write

[plugins.brain.recipes]
# Daily-life automations. See recipes-brain/recipes/.
enabled = ["email"]

Then run the bot — solo dev or multi-tenant, same binary:

hanzo-bot serve

Drop markdown into ~/.hanzo/workspace/. Edges auto-extract. Facts queryable via the brain.recall and brain.search MCP tools.

What lives inside

Sub-extension	What it does
`@hanzo/bot-memory`	Pluggable BrainStore — SQLite default. `pages`, `edges`, `facts`, FTS5.
`@hanzo/bot-graph-links`	Zero-LLM typed-link extractor. Emits `attended/works_at/invested_in/founded/advises`.
`@hanzo/bot-recipes-brain`	YAML recipes — email today, calendar/slack/X/notion next.

Architecture

                  Hanzo Bot (Hanzo Bot fork)
                  │
                  ▼
             @hanzo/bot-brain  (this pack)
                  │
        ┌─────────┼───────────┐
        ▼         ▼           ▼
   memory     graph-links   recipes-brain
   (SQLite)   (regex)       (YAML loader)
        │         │           │
        ▼         ▼           ▼
   ~/.hanzo/brain/brain.db (one file, the brain)

MCP tools exposed

Tool	What it does
`brain.recall`	`{ entity, limit? }` → facts about an entity, newest first
`brain.search`	`{ query, topK? }` → hybrid search (FTS + vector + RRF) across all pages

These wire into Claude Code / Cursor / Windsurf the moment you claude mcp add hanzo.

Pluggability

The memory extension exposes registerBackend(name, factory). Anyone can ship a Postgres / LanceDB / D1 / libSQL backend as a sibling extension — no fork of this pack needed. See memory/README.md.

Compared to gbrain

	gbrain	Hanzo Brain
Runtime	Hanzo Bot mod	Hanzo Bot extension (we own the gateway)
Default store	PGLite	SQLite
Schema	pages/edges/facts	same — pages/edges/facts/FTS5
Graph extraction	regex, zero-LLM	regex, zero-LLM (same approach)
Skills	34 curated	355 atomic + 88 specialized agents in `~/work/hanzo/skills`
Channels	0 (BYO gateway)	30+ (Slack/Discord/WhatsApp/Telegram/iMessage/…)
Voice	Twilio + Realtime via Hanzo Bot	Twilio/Telnyx/Plivo + LiveKit native
Mobile apps	none	iOS / Android / macOS ship with the bot
Pricing model	single-user	multi-tenant, shared credits via Hanzo Node

4.2 KiB Raw Permalink Blame History