docs: add tips + clawd-to-clawd faq

This commit is contained in:
Peter Steinberger
2026-01-25 04:04:14 +00:00
parent 617d8a12d7
commit 629ce4454d
5 changed files with 47 additions and 0 deletions

View File

@@ -32,6 +32,8 @@ Text is supported everywhere; media and reactions vary by channel.
## Notes ## Notes
- Channels can run simultaneously; configure multiple and Clawdbot will route per chat. - Channels can run simultaneously; configure multiple and Clawdbot will route per chat.
- Fastest setup is usually **Telegram** (simple bot token). WhatsApp requires QR pairing and
stores more state on disk.
- Group behavior varies by channel; see [Groups](/concepts/groups). - Group behavior varies by channel; see [Groups](/concepts/groups).
- DM pairing and allowlists are enforced for safety; see [Security](/gateway/security). - DM pairing and allowlists are enforced for safety; see [Security](/gateway/security).
- Telegram internals: [grammY notes](/channels/grammy). - Telegram internals: [grammY notes](/channels/grammy).

View File

@@ -31,6 +31,7 @@ These files live under the workspace (`agents.defaults.workspace`, default
- Decisions, preferences, and durable facts go to `MEMORY.md`. - Decisions, preferences, and durable facts go to `MEMORY.md`.
- Day-to-day notes and running context go to `memory/YYYY-MM-DD.md`. - Day-to-day notes and running context go to `memory/YYYY-MM-DD.md`.
- If someone says "remember this," write it down (do not keep it in RAM). - If someone says "remember this," write it down (do not keep it in RAM).
- If you want something to stick, **ask the bot to write it** into memory.
## Automatic memory flush (pre-compaction ping) ## Automatic memory flush (pre-compaction ping)

View File

@@ -29,6 +29,8 @@ Clawdbot is both a product and an experiment: youre wiring frontier-model beh
- where the bot is allowed to act - where the bot is allowed to act
- what the bot can touch - what the bot can touch
Start with the smallest access that still works, then widen it as you gain confidence.
### What the audit checks (high level) ### What the audit checks (high level)
- **Inbound access** (DM policies, group policies, allowlists): can strangers trigger the bot? - **Inbound access** (DM policies, group policies, allowlists): can strangers trigger the bot?

View File

@@ -85,6 +85,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
- [Remote gateways + nodes](#remote-gateways-nodes) - [Remote gateways + nodes](#remote-gateways-nodes)
- [How do commands propagate between Telegram, the gateway, and nodes?](#how-do-commands-propagate-between-telegram-the-gateway-and-nodes) - [How do commands propagate between Telegram, the gateway, and nodes?](#how-do-commands-propagate-between-telegram-the-gateway-and-nodes)
- [How can my agent access my computer if the Gateway is hosted remotely?](#how-can-my-agent-access-my-computer-if-the-gateway-is-hosted-remotely) - [How can my agent access my computer if the Gateway is hosted remotely?](#how-can-my-agent-access-my-computer-if-the-gateway-is-hosted-remotely)
- [Can two Clawdbots talk to each other (local + VPS)?](#can-two-clawdbots-talk-to-each-other-local--vps)
- [Is there a benefit to using a node on my personal laptop instead of SSH from a VPS?](#is-there-a-benefit-to-using-a-node-on-my-personal-laptop-instead-of-ssh-from-a-vps) - [Is there a benefit to using a node on my personal laptop instead of SSH from a VPS?](#is-there-a-benefit-to-using-a-node-on-my-personal-laptop-instead-of-ssh-from-a-vps)
- [Do nodes run a gateway service?](#do-nodes-run-a-gateway-service) - [Do nodes run a gateway service?](#do-nodes-run-a-gateway-service)
- [Is there an API / RPC way to apply config?](#is-there-an-api-rpc-way-to-apply-config) - [Is there an API / RPC way to apply config?](#is-there-an-api-rpc-way-to-apply-config)
@@ -230,6 +231,9 @@ This installs Clawdbot **from a git checkout**, so the agent can read the code +
reason about the exact version you are running. You can always switch back to stable later reason about the exact version you are running. You can always switch back to stable later
by re-running the installer without `--install-method git`. by re-running the installer without `--install-method git`.
Tip: ask the agent to **plan and supervise** the fix (step-by-step), then execute only the
necessary commands. That keeps changes small and easier to audit.
If you discover a real bug or fix, please file a GitHub issue or send a PR: If you discover a real bug or fix, please file a GitHub issue or send a PR:
https://github.com/clawdbot/clawdbot/issues https://github.com/clawdbot/clawdbot/issues
https://github.com/clawdbot/clawdbot/pulls https://github.com/clawdbot/clawdbot/pulls
@@ -307,6 +311,9 @@ disk as enough for personal use, and note that a **Raspberry Pi 4 can run it**.
If you want extra headroom (logs, media, other services), **2GB is recommended**, but its If you want extra headroom (logs, media, other services), **2GB is recommended**, but its
not a hard minimum. not a hard minimum.
Tip: a small Pi/VPS can host the Gateway, and you can pair **nodes** on your laptop/phone for
local screen/camera/canvas or command execution. See [Nodes](/nodes).
### Can I migrate my setup to a new machine (Mac mini) without redoing onboarding? ### Can I migrate my setup to a new machine (Mac mini) without redoing onboarding?
Yes. Copy the **state directory** and **workspace**, then run Doctor once. This Yes. Copy the **state directory** and **workspace**, then run Doctor once. This
@@ -973,6 +980,9 @@ If the bot “forgets” after a restart, confirm the Gateway is using the same
workspace on every launch (and remember: remote mode uses the **gateway hosts** workspace on every launch (and remember: remote mode uses the **gateway hosts**
workspace, not your local laptop). workspace, not your local laptop).
Tip: if you want a durable behavior or preference, ask the bot to **write it into
AGENTS.md or MEMORY.md** rather than relying on chat history.
See [Agent workspace](/concepts/agent-workspace) and [Memory](/concepts/memory). See [Agent workspace](/concepts/agent-workspace) and [Memory](/concepts/memory).
### Whats the recommended backup strategy? ### Whats the recommended backup strategy?
@@ -1167,6 +1177,29 @@ pair devices you trust, and review [Security](/gateway/security).
Docs: [Nodes](/nodes), [Gateway protocol](/gateway/protocol), [macOS remote mode](/platforms/mac/remote), [Security](/gateway/security). Docs: [Nodes](/nodes), [Gateway protocol](/gateway/protocol), [macOS remote mode](/platforms/mac/remote), [Security](/gateway/security).
### Can two Clawdbots talk to each other (local + VPS)?
Yes. There is no built-in "bot-to-bot" bridge, but you can wire it up in a few
reliable ways:
**Simplest:** use a normal chat channel both bots can access (Telegram/Slack/WhatsApp).
Have Bot A send a message to Bot B, then let Bot B reply as usual.
**CLI bridge (generic):** run a script that calls the other Gateway with
`clawdbot agent --message ... --deliver`, targeting a chat where the other bot
listens. If one bot is on Railway/VPS, point your CLI at that remote Gateway
via SSH/Tailscale (see [Remote access](/gateway/remote)).
Example pattern (run from a machine that can reach the target Gateway):
```bash
clawdbot agent --message "Hello from local bot" --deliver --channel telegram --reply-to <chat-id>
```
Tip: add a guardrail so the two bots do not loop endlessly (mention-only, channel
allowlists, or a "do not reply to bot messages" rule).
Docs: [Remote access](/gateway/remote), [Agent CLI](/cli/agent), [Agent send](/tools/agent-send).
### Is there a benefit to using a node on my personal laptop instead of SSH from a VPS? ### Is there a benefit to using a node on my personal laptop instead of SSH from a VPS?
Yes — nodes are the firstclass way to reach your laptop from a remote Gateway, and they Yes — nodes are the firstclass way to reach your laptop from a remote Gateway, and they
@@ -1515,6 +1548,11 @@ Models are referenced as `provider/model` (example: `anthropic/claude-opus-4-5`)
MiniMax M2.1 has its own docs: [MiniMax](/providers/minimax) and MiniMax M2.1 has its own docs: [MiniMax](/providers/minimax) and
[Local models](/gateway/local-models). [Local models](/gateway/local-models).
Rule of thumb: use the **best model you can afford** for high-stakes work, and a cheaper
model for routine chat or summaries. You can route models per agent and use sub-agents to
parallelize long tasks (each sub-agent consumes tokens). See [Models](/concepts/models) and
[Sub-agents](/tools/subagents).
Strong warning: weaker/over-quantized models are more vulnerable to prompt Strong warning: weaker/over-quantized models are more vulnerable to prompt
injection and unsafe behavior. See [Security](/gateway/security). injection and unsafe behavior. See [Security](/gateway/security).

View File

@@ -26,6 +26,10 @@ Primary goals:
- Keep the tool surface hard to misuse: sub-agents do **not** get session tools by default. - Keep the tool surface hard to misuse: sub-agents do **not** get session tools by default.
- Avoid nested fan-out: sub-agents cannot spawn sub-agents. - Avoid nested fan-out: sub-agents cannot spawn sub-agents.
Cost note: each sub-agent has its **own** context and token usage. For heavy or repetitive
tasks, set a cheaper model for sub-agents and keep your main agent on a higher-quality model.
You can configure this via `agents.defaults.subagents.model` or per-agent overrides.
## Tool ## Tool
Use `sessions_spawn`: Use `sessions_spawn`: