openclaw/docs/cli
Peter Steinberger e98c7dfbcb
feat(cloud-workers): session placement, dispatch, and worker turn routing (#106332)
* feat(gateway-protocol): add session placement schema

Closed state discriminator for session execution placement (local/requested/provisioning/syncing/starting/active/draining/reconciling/reclaimed/failed), sessions.dispatch params, and worker-admission transcript/live cursor extensions. Swift protocol models mirror the schema.

* feat(state): add worker session placement table

worker_session_placements rows carry placement state, transition generation, worker ownership metadata, ACK cursors, and the turn claim columns used for atomic admission.

* feat(cloud-workers): add durable placement state machine store

SQLite-backed placement store split by concern: state table (placement-state), discriminated record types + shape invariants (placement-record), row codec + CAS transition values (placement-row-codec), atomic turn-claim admission/release/waiters (placement-turn-claims), and lifecycle CAS transitions (placement-store).

* feat(cloud-workers): sync workspaces and attach sessions to worker environments

Environment service session attachment + turn credentials, tunnel workspace commands over a dedicated SSH runner, and git/plain workspace sync into $HOME/.openclaw-worker/workspaces with an immutable manifest. Symlink escapes are rejected locally before transfer (macOS openrsync stat-fails them opaquely) and again by the remote manifest guard.

* feat(worker): run one-shot embedded turns from launch descriptors

Worker runtime executes a single embedded turn from a stdin launch descriptor and reports completed/failed/fenced on stdout for the gateway launcher. Terminal lifecycle live events are deferred past the final transcript flush; transcript projection helpers are shared via transcript-message instead of duplicated in the runtime.

* feat(cloud-workers): dispatch placements and route worker turns

Dispatch service drives local->requested->provisioning->syncing->starting->active with failure teardown (placement-dispatch-failure) and restart/runtime recovery incl. lost-worker reclaim (placement-dispatch-recovery). Worker turn launcher claims the placement turn atomically, builds a windowed launch descriptor (worker-turn-payload), runs the remote one-shot worker, and reconciles the committed transcript; agent runners route turns through the session placement admission provider.

* feat(gateway): expose session placement RPCs and startup reconciliation

sessions.dispatch RPC with lifecycle admission barriers, operator-facing placement projection on session listings, placement-aware session reset guard, and startup/interval reconciliation wiring for worker placements.
2026-07-13 08:03:53 -07:00
..
acp.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
agent.md fix(agent): preserve explicit recipient sessions (#101507) 2026-07-07 10:07:13 +01:00
agents.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
approvals.md docs(cli): clarify that exec-policy show and approvals get exclude per-session /exec overrides (#94999) 2026-07-11 02:58:37 -07:00
attach.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
audit.md feat: add metadata-only message audit events (#103903) 2026-07-11 13:14:08 -07:00
backup.md docs(backup): enumerate volatile archive exclusions (#99007) 2026-07-12 20:14:12 -07:00
browser.md docs(browser): clarify JSON flag placement (#103155) 2026-07-12 06:58:40 +01:00
channels.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
clawbot.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
commitments.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
completion.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
config.md chore: migrate active GPT-5.5 references to GPT-5.6 (#104452) 2026-07-11 06:30:57 -07:00
configure.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
crestodian.md fix(onboarding): skip setup for configured gateways and require inference first (#102883) 2026-07-11 10:25:14 -07:00
cron.md improve(cron): show consecutive failure count and last error in cron CLI output (#99602) 2026-07-06 01:44:51 -07:00
daemon.md fix(sqlite): reject runtimes vulnerable to WAL corruption (#106065) 2026-07-13 13:59:00 +08:00
dashboard.md feat: Linux desktop companion app with auto-install, Gateway lifecycle, and Control UI window (#106352) 2026-07-13 05:17:27 -07:00
devices.md feat(gateway): auto-approve node pairing via SSH device-key verification (#104180) 2026-07-10 22:23:10 -07:00
directory.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
dns.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
docs.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
doctor.md fix(sqlite): serialize offline maintenance with gateway (#106210) 2026-07-13 18:15:32 +08:00
fleet.md feat(fleet): harden create, port allocation, drift visibility, and audit guidance (#104814) 2026-07-12 07:02:42 +01:00
flows.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
gateway.md fix(sqlite): reject runtimes vulnerable to WAL corruption (#106065) 2026-07-13 13:59:00 +08:00
health.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
hooks.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
index.md feat(cloud-workers): openclaw worker mode running the embedded loop on the box (#105865) 2026-07-13 02:34:31 -07:00
infer.md chore: migrate active GPT-5.5 references to GPT-5.6 (#104452) 2026-07-11 06:30:57 -07:00
logs.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
mcp.md fix(ui): preserve MCP App previews across reloads (#105728) 2026-07-12 17:30:34 -06:00
memory.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
message.md feat: add portable table presentation blocks (#103583) 2026-07-10 22:29:13 -07:00
migrate.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
models.md fix(openai): align auth availability with effective routes (#104685) 2026-07-11 15:26:48 -07:00
node.md fix(sqlite): reject runtimes vulnerable to WAL corruption (#106065) 2026-07-13 13:59:00 +08:00
nodes.md feat(nodes): route alerts to the active computer (#105083) 2026-07-12 10:05:50 +01:00
onboard.md fix(sqlite): reject runtimes vulnerable to WAL corruption (#106065) 2026-07-13 13:59:00 +08:00
pairing.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
path.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
plugins.md feat: publish plugins with extended-stable releases (#100448) 2026-07-05 16:16:26 -07:00
policy.md chore: migrate active GPT-5.5 references to GPT-5.6 (#104452) 2026-07-11 06:30:57 -07:00
promos.md feat(cli): add openclaw promos to discover and claim ClawHub promotional model offers (#100236) 2026-07-07 01:10:42 -06:00
proxy.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
qr.md feat(mobile): default pairing to full node access (#105928) 2026-07-13 02:30:45 -07:00
reset.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
sandbox.md fix: land ten small reliability fixes (#100483) 2026-07-06 00:08:51 +01:00
secrets.md Add Vault SecretRef plugin (#89255) 2026-07-09 05:30:12 -05:00
security.md refactor: flip sessions and transcripts to sqlite storage (#98236) 2026-07-11 14:50:37 -07:00
sessions.md refactor: flip sessions and transcripts to sqlite storage (#98236) 2026-07-11 14:50:37 -07:00
setup.md fix(onboarding): skip setup for configured gateways and require inference first (#102883) 2026-07-11 10:25:14 -07:00
skills.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
status.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
system.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
tasks.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
transcripts.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
tui.md fix(onboarding): skip setup for configured gateways and require inference first (#102883) 2026-07-11 10:25:14 -07:00
uninstall.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
update.md refactor: flip sessions and transcripts to sqlite storage (#98236) 2026-07-11 14:50:37 -07:00
voicecall.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
webhooks.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
wiki.md feat(memory-wiki): isolate vaults per agent (#103349) 2026-07-10 05:19:13 +01:00
workboard.md docs: rewrite published docs grounded in current source (#100142) 2026-07-05 00:32:47 -04:00
worker.md feat(cloud-workers): session placement, dispatch, and worker turn routing (#106332) 2026-07-13 08:03:53 -07:00