From 41448da4172ebe0d9ca0102ef8abd1e87a286b98 Mon Sep 17 00:00:00 2001 From: Vincent Koc Date: Thu, 23 Apr 2026 15:45:29 -0700 Subject: [PATCH] docs: gloss agentDir, BOOT.md, and ambiguous dashboard pronoun --- docs/concepts/agent-workspace.md | 2 +- docs/concepts/multi-agent.md | 4 +++- docs/start/openclaw.md | 2 +- 3 files changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/concepts/agent-workspace.md b/docs/concepts/agent-workspace.md index c5600205be5..043e9ec78bf 100644 --- a/docs/concepts/agent-workspace.md +++ b/docs/concepts/agent-workspace.md @@ -90,7 +90,7 @@ These are the standard files OpenClaw expects inside the workspace: - Keep it short to avoid token burn. - `BOOT.md` - - Optional startup checklist executed on gateway restart when internal hooks are enabled. + - Optional startup checklist run automatically on gateway restart (when [internal hooks](/automation/hooks) are enabled). - Keep it short; use the message tool for outbound sends. - `BOOTSTRAP.md` diff --git a/docs/concepts/multi-agent.md b/docs/concepts/multi-agent.md index 4e86b91717e..59f9ecdfe4e 100644 --- a/docs/concepts/multi-agent.md +++ b/docs/concepts/multi-agent.md @@ -5,7 +5,9 @@ read_when: "You want multiple isolated agents (workspaces + auth) in one gateway status: active --- -Goal: multiple _isolated_ agents (separate workspace + `agentDir` + sessions), plus multiple channel accounts (e.g. two WhatsApps) in one running Gateway. Inbound is routed to an agent via bindings. +Run multiple _isolated_ agents — each with its own workspace, state directory (`agentDir`), and session history — plus multiple channel accounts (e.g. two WhatsApps) in one running Gateway. Inbound messages are routed to the right agent through bindings. + +An **agent** here is the full per-persona scope: workspace files, auth profiles, model registry, and session store. `agentDir` is the on-disk state directory that holds this per-agent config at `~/.openclaw/agents//`. A **binding** maps a channel account (e.g. a Slack workspace or a WhatsApp number) to one of those agents. ## What is "one agent"? diff --git a/docs/start/openclaw.md b/docs/start/openclaw.md index 6795dfb8a32..619477c3ba5 100644 --- a/docs/start/openclaw.md +++ b/docs/start/openclaw.md @@ -66,7 +66,7 @@ openclaw gateway --port 18789 Now message the assistant number from your allowlisted phone. -When onboarding finishes, we auto-open the dashboard and print a clean (non-tokenized) link. If it prompts for auth, paste the configured shared secret into Control UI settings. Onboarding uses a token by default (`gateway.auth.token`), but password auth works too if you switched `gateway.auth.mode` to `password`. To reopen later: `openclaw dashboard`. +When onboarding finishes, OpenClaw auto-opens the dashboard and prints a clean (non-tokenized) link. If the dashboard prompts for auth, paste the configured shared secret into Control UI settings. Onboarding uses a token by default (`gateway.auth.token`), but password auth works too if you switched `gateway.auth.mode` to `password`. To reopen later: `openclaw dashboard`. ## Give the agent a workspace (AGENTS)