chore(sync): mirror docs from openclaw/openclaw@c478aeca5a

.openclaw-sync/source.json

@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "f155a5f95593380077e3e77f93d3dfa95ebe7e23",
-  "syncedAt": "2026-04-28T11:35:46.906Z"
+  "sha": "c478aeca5a7fcfc9bfbeb088a59e3605d4dae5e1",
+  "syncedAt": "2026-04-28T11:42:12.205Z"
 }

docs/help/environment.md

@@ -156,6 +156,18 @@ openclaw gateway run
 Do not rely on writing only to `~/.openclaw/.env` for this variable; Node reads
 `NODE_EXTRA_CA_CERTS` at process startup.
 
+## Legacy environment variables
+
+OpenClaw only reads `OPENCLAW_*` environment variables. The legacy
+`CLAWDBOT_*` and `MOLTBOT_*` prefixes from earlier releases are silently
+ignored.
+
+If any are still set on the Gateway process at startup, OpenClaw emits a
+single Node deprecation warning (`OPENCLAW_LEGACY_ENV_VARS`) listing the
+detected prefixes and the total count. Rename each value by replacing the
+legacy prefix with `OPENCLAW_` (for example `CLAWDBOT_GATEWAY_TOKEN` →
+`OPENCLAW_GATEWAY_TOKEN`); the old names take no effect.
+
 ## Related
 
 - [Gateway configuration](/gateway/configuration)

docs/plugins/hooks.md

@@ -109,6 +109,7 @@ observation-only.
 **Lifecycle**
 
 - `gateway_start` / `gateway_stop` — start or stop plugin-owned services with the Gateway
+- `cron_changed` — observe gateway-owned cron lifecycle changes (added, updated, removed, started, finished, scheduled)
 - **`before_install`** — inspect skill or plugin install scans and optionally block
 
 ## Tool call policy
@@ -313,6 +314,17 @@ resources.
 Do not rely on the internal `gateway:startup` hook for plugin-owned runtime
 services.
 
+`cron_changed` fires for gateway-owned cron lifecycle events with a typed
+event payload covering `added`, `updated`, `removed`, `started`, `finished`,
+and `scheduled` reasons. The event carries a `PluginHookGatewayCronJob`
+snapshot (including `state.nextRunAtMs`, `state.lastRunStatus`, and
+`state.lastError` when present) plus a `PluginHookGatewayCronDeliveryStatus`
+of `not-requested` | `delivered` | `not-delivered` | `unknown`. Removed
+events still carry the deleted job snapshot so external schedulers can
+reconcile state. Use `ctx.getCron?.()` and `ctx.config` from the runtime
+context when syncing external wake schedulers, and keep OpenClaw as the
+source of truth for due checks and execution.
+
 ## Upcoming deprecations
 
 A few hook-adjacent surfaces are deprecated but still supported. Migrate