openclaw/docs/plugins/reference.md
Peter Steinberger 37ffe3ce94
feat: back up to external disks and Cloudflare R2 with storage locations (#161913)
Adds named storage locations as a generic, pluggable capability, with backup as its first consumer.

- Core storage owner (src/storage): storage.locations config, a location marker that binds identity (runtime never creates it, so unplugged disks and different disks at the same path are refused), client-side streaming encryption (scrypt key from a SecretRef passphrase, per-object HKDF keys, AES-256-GCM segments), and a built-in filesystem provider for external disks and mounts.
- Plugin SDK: api.registerStorageProvider plus manifest contracts.storageProviders; providers move opaque bytes only.
- Bundled cloudflare plugin: an r2 provider over the S3 API with conditional writes and bounded multipart uploads; auto-enabled when a location uses provider "r2".
- Backups: backup create --to <location> with verified archives, UTC retention, list/verify/restore --from, Gateway-owned offsite schedules (installed Git schedules unchanged), per-installation namespace claims fenced at publication and deletion, backup record for external jobs, backup.status RPC, Doctor/status hints, and a Systems page Backups section.

No config or state migration; the storage section is new and optional. Proof: live R2 and mounted-disk round trips, namespace takeover trace, and a published 2026.9.7 upgrade cell with an existing Git backup schedule.
2026-10-01 02:05:44 -07:00

922 B

summary read_when title
Pointer to the generated OpenClaw plugin reference pages
You need a reference page for a specific OpenClaw plugin
You are auditing plugin docs coverage
Plugin reference

This section holds one reference page for each OpenClaw plugin. Each page states the package, the install route, and the surface the plugin adds.

This page is a pointer, not the index. The browsable list of all 163 generated plugin reference pages lives in Plugin inventory, sorted by distribution, package, and description.

How this page is built

OpenClaw generates this page from the top-level extensions/*/openclaw.plugin.json manifests. Package metadata enriches entries when package.json is present. Regenerate the page with:

pnpm plugins:inventory:gen