diff --git a/README.md b/README.md
index dc4ab10..8edfc04 100644
--- a/README.md
+++ b/README.md
@@ -113,6 +113,14 @@ Inter-agent communication via the comms API. Agents can send messages to each ot
### Integrations
Outbound webhooks with delivery history, configurable alert rules with cooldowns, and multi-gateway connection management. Optional 1Password CLI integration for secret management.
+### Workspace Management
+Workspaces (tenant instances) are created and managed through the **Super Admin** panel, accessible from the sidebar under **Admin > Super Admin**. From there, admins can:
+- **Create** new client instances (slug, display name, Linux user, gateway port, plan tier)
+- **Monitor** provisioning jobs and their step-by-step progress
+- **Decommission** tenants with optional cleanup of state directories and Linux users
+
+Each workspace gets its own isolated environment with a dedicated OpenClaw gateway, state directory, and workspace root. See the [Super Admin API](#api-overview) endpoints under `/api/super/*` for programmatic access.
+
### Update Checker
Automatic GitHub release check notifies you when a new version is available, displayed as a banner in the dashboard.
@@ -277,6 +285,20 @@ All endpoints require authentication unless noted. Full reference below.
+
+Super Admin (Workspace/Tenant Management)
+
+| Method | Path | Role | Description |
+|--------|------|------|-------------|
+| `GET` | `/api/super/tenants` | admin | List all tenants with latest provisioning status |
+| `POST` | `/api/super/tenants` | admin | Create tenant and queue bootstrap job |
+| `POST` | `/api/super/tenants/[id]/decommission` | admin | Queue tenant decommission job |
+| `GET` | `/api/super/provision-jobs` | admin | List provisioning jobs (filter: `?tenant_id=`, `?status=`) |
+| `POST` | `/api/super/provision-jobs` | admin | Queue additional job for existing tenant |
+| `POST` | `/api/super/provision-jobs/[id]/action` | admin | Approve, reject, or cancel a provisioning job |
+
+
+
Direct CLI
diff --git a/src/components/panels/agent-detail-tabs.tsx b/src/components/panels/agent-detail-tabs.tsx
index 1e6bee1..4f5ffd0 100644
--- a/src/components/panels/agent-detail-tabs.tsx
+++ b/src/components/panels/agent-detail-tabs.tsx
@@ -517,7 +517,7 @@ export function MemoryTab({
Working Memory
- Agent-level scratchpad only. Use the global Memory page to browse all workspace memory files.
+ This is agent-level scratchpad memory (stored as WORKING.md in the database), not the workspace memory folder.
@@ -543,6 +543,14 @@ export function MemoryTab({
+ {/* Info Banner */}
+
+ Agent Memory vs Workspace Memory:{' '}
+ This tab edits only this agent's private working memory (a scratchpad stored in the database).
+ To browse or edit all workspace memory files (daily logs, knowledge base, MEMORY.md, etc.), visit the{' '}
+ Memory Browser page.
+
+ Workspace Management:{' '}
+ To create or manage workspaces (tenant instances), go to the{' '}
+ {' '}
+ panel under Admin > Super Admin in the sidebar. From there you can create new client instances, manage tenants, and monitor provisioning jobs.
+