refactor: rename clawdbot to moltbot with legacy compat

This commit is contained in:
Peter Steinberger
2026-01-27 12:19:58 +00:00
parent 83460df96f
commit 6d16a658e5
1839 changed files with 11250 additions and 11199 deletions

View File

@@ -7,7 +7,7 @@ read_when:
---
# CLI backends (fallback runtime)
Clawdbot can run **local AI CLIs** as a **text-only fallback** when API providers are down,
Moltbot can run **local AI CLIs** as a **text-only fallback** when API providers are down,
rate-limited, or temporarily misbehaving. This is intentionally conservative:
- **Tools are disabled** (no tool calls).
@@ -20,16 +20,16 @@ want “always works” text responses without relying on external APIs.
## Beginner-friendly quick start
You can use Claude Code CLI **without any config** (Clawdbot ships a built-in default):
You can use Claude Code CLI **without any config** (Moltbot ships a built-in default):
```bash
clawdbot agent --message "hi" --model claude-cli/opus-4.5
moltbot agent --message "hi" --model claude-cli/opus-4.5
```
Codex CLI also works out of the box:
```bash
clawdbot agent --message "hi" --model codex-cli/gpt-5.2-codex
moltbot agent --message "hi" --model codex-cli/gpt-5.2-codex
```
If your gateway runs under launchd/systemd and PATH is minimal, add just the
@@ -76,7 +76,7 @@ Add a CLI backend to your fallback list so it only runs when primary models fail
Notes:
- If you use `agents.defaults.models` (allowlist), you must include `claude-cli/...`.
- If the primary provider fails (auth, rate limits, timeouts), Clawdbot will
- If the primary provider fails (auth, rate limits, timeouts), Moltbot will
try the CLI backend next.
## Configuration overview
@@ -132,7 +132,7 @@ The provider id becomes the left side of your model ref:
## How it works
1) **Selects a backend** based on the provider prefix (`claude-cli/...`).
2) **Builds a system prompt** using the same Clawdbot prompt + workspace context.
2) **Builds a system prompt** using the same Moltbot prompt + workspace context.
3) **Executes the CLI** with a session id (if supported) so history stays consistent.
4) **Parses output** (JSON or plain text) and returns the final text.
5) **Persists session ids** per backend, so follow-ups reuse the same CLI session.
@@ -159,8 +159,8 @@ imageArg: "--image",
imageMode: "repeat"
```
Clawdbot will write base64 images to temp files. If `imageArg` is set, those
paths are passed as CLI args. If `imageArg` is missing, Clawdbot appends the
Moltbot will write base64 images to temp files. If `imageArg` is set, those
paths are passed as CLI args. If `imageArg` is missing, Moltbot appends the
file paths to the prompt (path injection), which is enough for CLIs that auto-
load local files from plain paths (Claude Code CLI behavior).
@@ -178,7 +178,7 @@ Input modes:
## Defaults (built-in)
Clawdbot ships a default for `claude-cli`:
Moltbot ships a default for `claude-cli`:
- `command: "claude"`
- `args: ["-p", "--output-format", "json", "--dangerously-skip-permissions"]`
@@ -189,7 +189,7 @@ Clawdbot ships a default for `claude-cli`:
- `systemPromptWhen: "first"`
- `sessionMode: "always"`
Clawdbot also ships a default for `codex-cli`:
Moltbot also ships a default for `codex-cli`:
- `command: "codex"`
- `args: ["exec","--json","--color","never","--sandbox","read-only","--skip-git-repo-check"]`
@@ -204,12 +204,12 @@ Override only if needed (common: absolute `command` path).
## Limitations
- **No Clawdbot tools** (the CLI backend never receives tool calls). Some CLIs
- **No Moltbot tools** (the CLI backend never receives tool calls). Some CLIs
may still run their own agent tooling.
- **No streaming** (CLI output is collected then returned).
- **Structured outputs** depend on the CLIs JSON format.
- **Codex CLI sessions** resume via text output (no JSONL), which is less
structured than the initial `--json` run. Clawdbot sessions still work
structured than the initial `--json` run. Moltbot sessions still work
normally.
## Troubleshooting