docs: reorganize documentation structure

This commit is contained in:
Peter Steinberger
2026-01-07 00:41:31 +01:00
parent b8db8502aa
commit db4d0b8e75
126 changed files with 881 additions and 270 deletions

164
docs/start/hubs.md Normal file
View File

@@ -0,0 +1,164 @@
---
summary: "Hubs that link to every Clawdbot doc"
read_when:
- You want a complete map of the documentation
---
# Docs hubs
Use these hubs to discover every page, including deep dives and reference docs that dont appear in the left nav.
## Start here
- [Index](https://docs.clawd.bot)
- [Getting Started](https://docs.clawd.bot/start/getting-started)
- [Onboarding](https://docs.clawd.bot/start/onboarding)
- [Wizard](https://docs.clawd.bot/start/wizard)
- [Setup](https://docs.clawd.bot/start/setup)
- [Dashboard (local Gateway)](http://127.0.0.1:18789/)
- [FAQ](https://docs.clawd.bot/start/faq)
- [Configuration](https://docs.clawd.bot/gateway/configuration)
- [Clawd (personal assistant)](https://docs.clawd.bot/start/clawd)
- [Showcase](https://docs.clawd.bot/start/showcase)
- [Lore](https://docs.clawd.bot/start/lore)
## Installation + updates
- [Docker](https://docs.clawd.bot/install/docker)
- [Nix](https://docs.clawd.bot/install/nix)
- [Updating / rollback](https://docs.clawd.bot/install/updating)
- [Bun workflow](https://docs.clawd.bot/install/bun)
## Core concepts
- [Architecture](https://docs.clawd.bot/concepts/architecture)
- [Agent runtime](https://docs.clawd.bot/concepts/agent)
- [Agent workspace](https://docs.clawd.bot/concepts/agent-workspace)
- [Agent loop](https://docs.clawd.bot/concepts/agent-loop)
- [Multi-agent routing](https://docs.clawd.bot/concepts/multi-agent)
- [Sessions](https://docs.clawd.bot/concepts/session)
- [Sessions (alias)](https://docs.clawd.bot/concepts/sessions)
- [Session tools](https://docs.clawd.bot/concepts/session-tool)
- [Queue](https://docs.clawd.bot/concepts/queue)
- [Slash commands](https://docs.clawd.bot/tools/slash-commands)
- [RPC adapters](https://docs.clawd.bot/reference/rpc)
- [TypeBox schemas](https://docs.clawd.bot/concepts/typebox)
- [Timezone handling](https://docs.clawd.bot/concepts/timezone)
- [Presence](https://docs.clawd.bot/concepts/presence)
- [Discovery + transports](https://docs.clawd.bot/gateway/discovery)
- [Bonjour](https://docs.clawd.bot/gateway/bonjour)
- [Provider routing](https://docs.clawd.bot/concepts/provider-routing)
- [Groups](https://docs.clawd.bot/concepts/groups)
- [Group messages](https://docs.clawd.bot/concepts/group-messages)
- [Model failover](https://docs.clawd.bot/concepts/model-failover)
## Providers + ingress
- [WhatsApp](https://docs.clawd.bot/providers/whatsapp)
- [Telegram](https://docs.clawd.bot/providers/telegram)
- [Telegram (grammY notes)](https://docs.clawd.bot/providers/grammy)
- [Slack](https://docs.clawd.bot/providers/slack)
- [Discord](https://docs.clawd.bot/providers/discord)
- [Signal](https://docs.clawd.bot/providers/signal)
- [iMessage](https://docs.clawd.bot/providers/imessage)
- [Location parsing](https://docs.clawd.bot/providers/location)
- [WebChat](https://docs.clawd.bot/web/webchat)
- [Webhooks](https://docs.clawd.bot/automation/webhook)
- [Gmail Pub/Sub](https://docs.clawd.bot/automation/gmail-pubsub)
## Gateway + operations
- [Gateway runbook](https://docs.clawd.bot/gateway)
- [Gateway pairing](https://docs.clawd.bot/gateway/pairing)
- [Gateway lock](https://docs.clawd.bot/gateway/gateway-lock)
- [Background process](https://docs.clawd.bot/gateway/background-process)
- [Health](https://docs.clawd.bot/gateway/health)
- [Heartbeat](https://docs.clawd.bot/gateway/heartbeat)
- [Doctor](https://docs.clawd.bot/gateway/doctor)
- [Logging](https://docs.clawd.bot/gateway/logging)
- [Dashboard](https://docs.clawd.bot/web/dashboard)
- [Control UI](https://docs.clawd.bot/web/control-ui)
- [Remote access](https://docs.clawd.bot/gateway/remote)
- [Remote gateway README](https://docs.clawd.bot/gateway/remote-gateway-readme)
- [Tailscale](https://docs.clawd.bot/gateway/tailscale)
- [Security](https://docs.clawd.bot/gateway/security)
- [Troubleshooting](https://docs.clawd.bot/gateway/troubleshooting)
## Tools + automation
- [Tools surface](https://docs.clawd.bot/tools)
- [Bash tool](https://docs.clawd.bot/tools/bash)
- [Elevated mode](https://docs.clawd.bot/tools/elevated)
- [Cron jobs](https://docs.clawd.bot/automation/cron-jobs)
- [Thinking + verbose](https://docs.clawd.bot/tools/thinking)
- [Models](https://docs.clawd.bot/concepts/models)
- [Sub-agents](https://docs.clawd.bot/tools/subagents)
- [Agent send CLI](https://docs.clawd.bot/tools/agent-send)
- [Terminal UI](https://docs.clawd.bot/web/tui)
- [Browser control](https://docs.clawd.bot/tools/browser)
- [Browser (Linux troubleshooting)](https://docs.clawd.bot/tools/browser-linux-troubleshooting)
- [Polls](https://docs.clawd.bot/automation/poll)
## Nodes, media, voice
- [Nodes overview](https://docs.clawd.bot/nodes)
- [Camera](https://docs.clawd.bot/nodes/camera)
- [Images](https://docs.clawd.bot/nodes/images)
- [Audio](https://docs.clawd.bot/nodes/audio)
- [Location command](https://docs.clawd.bot/nodes/location-command)
- [Voice wake](https://docs.clawd.bot/nodes/voicewake)
- [Talk mode](https://docs.clawd.bot/nodes/talk)
## Platforms
- [macOS app overview](https://docs.clawd.bot/platforms/macos)
- [macOS dev setup](https://docs.clawd.bot/platforms/mac/dev-setup)
- [macOS menu bar](https://docs.clawd.bot/platforms/mac/menu-bar)
- [macOS voice wake](https://docs.clawd.bot/platforms/mac/voicewake)
- [macOS voice overlay](https://docs.clawd.bot/platforms/mac/voice-overlay)
- [macOS WebChat](https://docs.clawd.bot/platforms/mac/webchat)
- [macOS Canvas](https://docs.clawd.bot/platforms/mac/canvas)
- [macOS child process](https://docs.clawd.bot/platforms/mac/child-process)
- [macOS health](https://docs.clawd.bot/platforms/mac/health)
- [macOS icon](https://docs.clawd.bot/platforms/mac/icon)
- [macOS logging](https://docs.clawd.bot/platforms/mac/logging)
- [macOS permissions](https://docs.clawd.bot/platforms/mac/permissions)
- [macOS remote](https://docs.clawd.bot/platforms/mac/remote)
- [macOS signing](https://docs.clawd.bot/platforms/mac/signing)
- [macOS release](https://docs.clawd.bot/platforms/mac/release)
- [macOS bun gateway](https://docs.clawd.bot/platforms/mac/bun)
- [macOS XPC](https://docs.clawd.bot/platforms/mac/xpc)
- [macOS skills](https://docs.clawd.bot/platforms/mac/skills)
- [macOS Peekaboo plan](https://docs.clawd.bot/platforms/mac/peekaboo)
- [iOS node](https://docs.clawd.bot/platforms/ios)
- [Android node](https://docs.clawd.bot/platforms/android)
- [Windows app](https://docs.clawd.bot/platforms/windows)
- [Linux app](https://docs.clawd.bot/platforms/linux)
- [Web surfaces](https://docs.clawd.bot/web)
## Workspace + templates
- [Skills](https://docs.clawd.bot/tools/skills)
- [ClawdHub](https://docs.clawd.bot/tools/clawdhub)
- [Skills config](https://docs.clawd.bot/tools/skills-config)
- [Default AGENTS](https://docs.clawd.bot/reference/AGENTS.default)
- [Templates: AGENTS](https://docs.clawd.bot/reference/templates/AGENTS)
- [Templates: BOOTSTRAP](https://docs.clawd.bot/reference/templates/BOOTSTRAP)
- [Templates: HEARTBEAT](https://docs.clawd.bot/reference/templates/HEARTBEAT)
- [Templates: IDENTITY](https://docs.clawd.bot/reference/templates/IDENTITY)
- [Templates: SOUL](https://docs.clawd.bot/reference/templates/SOUL)
- [Templates: TOOLS](https://docs.clawd.bot/reference/templates/TOOLS)
- [Templates: USER](https://docs.clawd.bot/reference/templates/USER)
## Experiments + proposals
- [Onboarding config protocol](https://docs.clawd.bot/experiments/onboarding-config-protocol)
- [Plan: cron hardening](https://docs.clawd.bot/experiments/plans/cron-add-hardening)
- [Plan: group policy hardening](https://docs.clawd.bot/experiments/plans/group-policy-hardening)
- [Research: memory](https://docs.clawd.bot/experiments/research/memory)
- [Proposal: model config](https://docs.clawd.bot/experiments/proposals/model-config)
## Testing + release
- [Testing](https://docs.clawd.bot/reference/test)
- [Release checklist](https://docs.clawd.bot/reference/RELEASING)
- [Device models](https://docs.clawd.bot/reference/device-models)