← Back to Plugins
Tools

Alfred Reference Architecture

madmatty86 By madmatty86 👁 12 views ▲ 0 votes

Reference architecture and guardrail plugins for a self-hosted family AI assistant (OpenClaw). MIT.

GitHub

README

# Alfred – reference architecture for a safe home assistant agent

A personal AI assistant that runs on its own hardware and talks to the family via WhatsApp, Telegram, phone, TV and an Android app – **and is still safe to leave alone.**

This repository is **not** an install-and-run product. It is a **blueprint and a set of design patterns** from a system that has been running in a real household:

- **Send lock** – the agent may only write to the owner, to an allow-list, and into the running conversation (fail-closed, enforced by a root-owned plugin).
- **Identity from the session, not from the model** – the real sender is determined technically; the model cannot claim to be the owner.
- **Fast switches ("Weichen") before the LLM** – games, weather, health input, emergency keywords are answered by small plugins with fixed texts: cheaper, faster, predictable.
- **Cost watchdog** – measured outside the model, with daily/monthly limits and self-reporting.
- **Child profiles** – allow-lists, PIN, separate history.
- **Honest limits** – a section on what the guardrails do *not* guarantee, and how rollback works.

## Contents
| Path | What |
|---|---|
| [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) | Full architecture (English) |
| [`docs/ARCHITECTURE.de.md`](docs/ARCHITECTURE.de.md) | Full architecture (German original, anonymised) |
| [`plugins/`](plugins/) | The guardrail plugins (send lock, identity, read-only accounts, fast switches, logs) with tests |
| [`templates/SOUL.template.md`](templates/SOUL.template.md) | Persona/rules template |
| [`docs/CHECKLIST-before-publishing.md`](docs/CHECKLIST-before-publishing.md) | How the material was cleaned |
| [`scripts/check_clean.py`](scripts/check_clean.py) | Personal-data scanner |

Planned next: configuration examples for the plugins; individual skills (flyer search, marketplace watcher, telephony) as separate modules.

## Status
Reference material, shared for feedback. Issues and discussion are welcome; there is no support promise. Code comments and some message texts are German.
tools

Comments

Sign in to leave a comment

Loading comments...