Clawdie Docs
Clawdie is a self-hosted AI system built for FreeBSD. It follows the
NanoClaw upstream line, but runs with native jails, PF, ZFS, and a
local built-in knowledge layer designed to reduce first-install LLM
setup friction.
What it is
Local-first AI operations on FreeBSD, not another Linux-only stack.
What is different
Prebuilt built-in knowledge in the database jail before production LLM keys are added.
What it tracks
Upstream-aware through NanoClaw, but not upstream-dependent in deployment.
What split brain means
Split brain is simple: Clawdie treats built-in system knowledge and user
memory as two different jobs.
Brain A
Built-in local knowledge
This is the memory Clawdie ships with: install help, system docs,
operator workflows, and product skills. It is prepared ahead of
time and imported into the db jail during bootstrap.
- No provider keys required on first install
- No need to generate embeddings live during onboarding
- Versioned, local, and expandable later
Brain B
User memory and future agents
This is the changing side: user preferences, notes, later personal
agents like mevy or bob, and other runtime
memories that grow after install.
- Separate lifecycle from built-in knowledge
- Can evolve from local git or future Gitea flows
- Can use production provider keys later
Grandma version
Clawdie arrives with her own instruction book already packed. Later,
she learns your household habits separately, instead of mixing them
into the factory manual.
Technical version
Brain A is a prebuilt vector-backed knowledge package stored locally
in the database jail. Brain B is dynamic user and agent memory with a
separate lifecycle, provenance, and update path.
Why FreeBSD is part of the design
Most AI tooling assumes Linux by default. Clawdie uses FreeBSD on purpose:
jails, PF, and ZFS are not wrappers here. They are core operating-system
features. That makes Clawdie a serious alternative for operators who want
platform diversity and tighter system control.
Large infrastructure operators often avoid monoculture because shared bugs
create shared outages. Clawdie follows the same logic for self-hosted AI:
stay close to the Linux-born upstream ecosystem, but provide a FreeBSD
deployment path with a different failure surface.
Native jails
Isolation without a Linux container stack layered on top.
ZFS snapshots
Rollback points for installs, experiments, and service changes.
PF firewalling
Network control as part of the system design, not an afterthought.
BSD-style licensing culture
Operationally attractive for long-lived infrastructure work.
How Clawdie relates to NanoClaw
Clawdie did not appear from nowhere. It grows from NanoClaw and keeps
track of upstream changes. But the goal is not to become a thin mirror.
The goal is to evolve a FreeBSD-native operating path while still learning
from upstream improvements.
| Topic |
NanoClaw upstream |
Clawdie |
| Primary ecosystem |
Linux-first |
FreeBSD-first deployment |
| Upstream tracking |
Source of evolution |
Fetch-only review, operator decides |
| Onboarding goal |
General framework |
Lower-friction bootstrap with local built-in knowledge |
| Memory model |
Generic |
Split brain: built-in knowledge plus user memory |
For CNC and operator workflows
Clawdie is not only a chat interface. The long-term direction is AI that
can support real operator work: system setup, maintenance, documentation
lookup, machine procedures, and later CNC-related task guidance. Split
brain matters here because stable operating knowledge should not be mixed
blindly with changing personal memory.
Brain A can carry the stable operating playbook. Brain B can carry shop,
operator, or agent-specific context. That separation makes the system easier
to trust, audit, and grow.