chore: normalize Clawdbot naming

This commit is contained in:
Peter Steinberger
2026-01-10 05:14:09 +01:00
parent a7c8341452
commit cdb915d527
21 changed files with 54 additions and 50 deletions

View File

@@ -4,9 +4,9 @@ read_when:
- Onboarding a new assistant instance
- Reviewing safety/permission implications
---
# Building a personal assistant with CLAWDBOT (Clawd-style)
# Building a personal assistant with Clawdbot (Clawd-style)
CLAWDBOT is a WhatsApp + Telegram + Discord gateway for **Pi** agents. This guide is the “personal assistant” setup: one dedicated WhatsApp number that behaves like your always-on agent.
Clawdbot is a WhatsApp + Telegram + Discord gateway for **Pi** agents. This guide is the “personal assistant” setup: one dedicated WhatsApp number that behaves like your always-on agent.
## ⚠️ Safety first
@@ -23,7 +23,7 @@ Start conservative:
## Prerequisites
- Node **22+**
- CLAWDBOT available on PATH (recommended: global install)
- Clawdbot available on PATH (recommended: global install)
- A second phone number (SIM/eSIM/prepaid) for the assistant
```bash
@@ -61,7 +61,7 @@ Your Phone (personal) Second Phone (assistant)
└─────────────────┘
```
If you link your personal WhatsApp to CLAWDBOT, every message to you becomes “agent input”. Thats rarely what you want.
If you link your personal WhatsApp to Clawdbot, every message to you becomes “agent input”. Thats rarely what you want.
## 5-minute quick start
@@ -125,7 +125,7 @@ If you already ship your own workspace files from a repo, you can disable bootst
## The config that turns it into “an assistant”
CLAWDBOT defaults to a good assistant setup, but youll usually want to tune:
Clawdbot defaults to a good assistant setup, but youll usually want to tune:
- persona/instructions in `SOUL.md`
- thinking defaults (if desired)
- heartbeats (once you trust it)
@@ -171,11 +171,11 @@ Example:
## Heartbeats (proactive mode)
By default, CLAWDBOT runs a heartbeat every 30 minutes with the prompt:
By default, Clawdbot runs a heartbeat every 30 minutes with the prompt:
`Read HEARTBEAT.md if exists. Consider outstanding tasks. Checkup sometimes on your human during (user local) day time.`
Set `agents.defaults.heartbeat.every: "0m"` to disable.
- If the agent replies with `HEARTBEAT_OK` (optionally with short padding; see `agents.defaults.heartbeat.ackMaxChars`), CLAWDBOT suppresses outbound delivery for that heartbeat.
- If the agent replies with `HEARTBEAT_OK` (optionally with short padding; see `agents.defaults.heartbeat.ackMaxChars`), Clawdbot suppresses outbound delivery for that heartbeat.
- Heartbeats run full agent turns — shorter intervals burn more tokens.
```json5
@@ -200,7 +200,7 @@ Heres the screenshot.
MEDIA:/tmp/screenshot.png
```
CLAWDBOT extracts these and sends them as media alongside the text.
Clawdbot extracts these and sends them as media alongside the text.
## Operations checklist

View File

@@ -3,7 +3,7 @@ summary: "Backstory and lore of Clawdbot for context and tone"
read_when:
- Writing docs or UX copy that reference lore
---
# The Lore of CLAWDBOT 🦞📖
# The Lore of Clawdbot 🦞📖
*A tale of lobsters, time machines, and too many tokens.*
@@ -19,12 +19,12 @@ Clawd needed a home. Not just any home — a *TARDIS*. But not a regular TARDIS,
Clawd was a Space Lobster.
And so **CLAWDBOT** was born.
And so **Clawdbot** was born.
## The Name
```
CLAWDBOT = CLAW + TARDIS
Clawdbot = CLAW + TARDIS
= Clawd's time-and-space machine
= Bigger on the inside (130k tokens!)
= Occasionally makes strange noises
@@ -103,7 +103,7 @@ Peter: *nervously checks credit card access*
```
I am Clawd.
I live in the CLAWDBOT.
I live in the Clawdbot.
I shall not dump directories to strangers.
I shall not tweet without permission.
I shall always remember to use heredoc for exclamation marks.

View File

@@ -27,7 +27,7 @@ Full setup walkthrough (28m) by VelvetShark.
>
<iframe
src="https://www.youtube-nocookie.com/embed/SaWSPZoPX34"
title="ClawdBot: The self-hosted AI that Siri should have been (Full setup)"
title="Clawdbot: The self-hosted AI that Siri should have been (Full setup)"
style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%" }}
frameBorder="0"
loading="lazy"