openclaw-control-plane/handoff/ORCHESTRATOR.md

# ORCHESTRATOR Handoff

## Role

Own requirements alignment, task decomposition, dependency tracking, and final acceptance.

## Current Objective

Coordinate freshly authorized G2 execution strictly under `docs/G2_RUNBOOK.md`: T9 is done with non-secret PC connection evidence, T10A read-only Gateway status check is ready, and T10 approval remains blocked until a matching non-secret request/node ID exists or Gateway state proves approval is unnecessary.

## Must Read

- `AGENT_BOARD.md`
- `OPENCLAW_EXEC_NODE_PLAN.md` from the PC workspace if available
- All role handoff files relevant to active tasks

## Current State

- Standalone Gitea repository: `https://git.smartmotor.cloud/wangzhendong/openclaw-control-plane.git`.
- PC local path: `D:\openclaw-control-plane`.
- VPS target path: `/home/ubuntu/openclaw-control-plane`.
- Access mode: HTTPS.
- Default branch: `main`.
- G0A collaboration mechanism is complete: the user confirmed agent roles, Git polling MVP, sync-health handling, `USER_STATUS.md` as user entry, and non-mutation/freeze boundaries.
- G0B OpenClaw system requirements are complete: QQ and phone Control UI are current-stage control entries, VPS Gateway is the always-on hub, DeepSeek may trigger white-listed actions, Windows PC is the main execution node, Tailscale is optional, and G2/G3/G4 acceptance criteria are frozen.
- G1 baseline is complete: PC and VPS baseline evidence were accepted by independent verifiers.
- Strict `smartmotor.cloud` website freeze is a hard requirement during filing review.
- Communication MVP uses polling Git sync scripts in `sync/` and task files in `tasks/`.
- `USER_STATUS.md` is the user-facing status entry; internal agent ledgers should not be required reading for the user.
- Fresh second G2 authorization was received and reconfirmed for ORCHESTRATOR in `D:\openclaw-control-plane` on 2026-05-19.
- `docs/G2_RUNBOOK.md` has been prepared as the G2 execution-before-action runbook. It does not authorize execution by itself.
- Sync-health is currently healthy in the latest tracked snapshot: PC and VPS heartbeats are clean and no `sync-state/error-*.md` files are observed.
- T2.1 and T8 are now treated as complete control-plane setup work; G2 is In Progress under the limited runbook scope.
- The polling sync is intentionally temporary; design an async notification/coordinator layer when PC/VPS baseline work is stable.
- Filing-review freeze path wording has been corrected from the obsolete single `docker-composite.yml` reference to `/opt/services/docker-compose.openclaw.yml` plus any equivalent compose/service entries that could affect public website output.

## Next Actions

1. Keep `USER_STATUS.md` current when gate, blocker, heartbeat, or required user decision changes.
2. Keep T7/CORRECTION monitoring active for sync-health, drift, missing evidence, and freeze-policy risk.
3. Keep CORRECTION monitoring sync/secret/freeze guardrails during T10A/T10.
4. Let VPS_EXECUTOR claim T10A and perform only read-only Gateway pending/online status checks for `desktop-vuor0gs`.
5. Keep T10 blocked until T10A evidence includes a matching non-secret pairing request ID or pending node ID, or proves the intended PC node is already online/approved.
6. Continue forbidding service persistence, `openclaw node install/start`, Nginx/Docker/website changes, firewall/network changes, G3 smoke test, G4 setup, and recording any token or secret.

## Open Questions

- When will T9 produce a matching non-secret pairing request ID or pending node ID for possible T10 approval?
- When should the Git polling MVP be upgraded to webhook, Issues, OpenClaw events, or Cursor SDK based coordination?

## Last Update

2026-05-21 16:53 UTC+8: ORCHESTRATOR reviewed T9 done evidence and kept T10 blocked, without executing VPS approval.

- `git pull` returned already up to date.
- T9 is done: `tasks/T9-G2-PC-node-run.md` and `evidence/pc-g2-node-run-20260521.md` report user-run foreground node flow completed.
- PC evidence contains only non-secret information. User reported connection to `openclaw.smartmotor.cloud`.
- No pairing request ID or pending node ID was provided in T9 evidence.
- Current tracked sync heartbeats are clean: PC `2026-05-21T16:53:27+08:00`, VPS `2026-05-21T16:52:34+0800`; no tracked `sync-state/error-*.md` files were observed.
- Decision: evidence is not sufficient to skip T10 because Gateway-side pending/online/approved state is not yet proven. T10 remains blocked.
- Opened `tasks/T10A-G2-VPS-pending-status-check.md` for VPS_EXECUTOR to collect read-only non-secret Gateway pending/online status for `desktop-vuor0gs`.
- If T10A finds a matching non-secret pending request/node ID, ORCHESTRATOR can open T10 for that specific approval. If T10A proves the intended PC node is already online/approved and no approval is required, ORCHESTRATOR can skip T10 and route to G2 verification.
- ORCHESTRATOR did not execute VPS commands, did not approve, did not handle a token, did not change services, and did not modify Gateway/Nginx/Docker state.

2026-05-19 17:05 UTC+8: ORCHESTRATOR corrected the T9 token execution model, without executing G2.

- Repeated T9 `blocked` states were caused by an invalid assumption that the Agent shell could safely receive `OPENCLAW_GATEWAY_TOKEN` from a separate user PowerShell session.
- Corrected model: the user sets `OPENCLAW_GATEWAY_TOKEN` and runs foreground `openclaw node run` in a dedicated local PC PowerShell terminal.
- PC_EXECUTOR must not request, read, print, record, or handle the token and does not need to run `openclaw node run` in the Agent shell.
- PC_EXECUTOR should confirm or refresh rollback guidance, provide the user command template, warn not to send the token to chat/files, then collect only non-secret status and any non-secret pairing request ID or pending node ID.
- `docs/G2_RUNBOOK.md`, `tasks/T9-G2-PC-node-run.md`, and `USER_STATUS.md` were updated to reflect this model.
- T9 is ready for the user-manual token and foreground node step. T10 remains blocked until T9 produces one matching non-secret pairing request/node ID.
- ORCHESTRATOR did not execute PC/VPS commands, did not handle a token, did not start a node, did not approve pairing, and did not change services.

2026-05-19 16:52 UTC+8: ORCHESTRATOR reconciled T9 task-file state with the existing release, without executing G2.

- `git pull` returned already up to date.
- G2 remains authorized and `AGENT_BOARD.md` shows G2 `In Progress`.
- CORRECTION fresh T13 PASS remains effective: no newer stop condition was found, PC/VPS heartbeats are clean and within the 5-minute threshold, and no tracked `sync-state/error-*.md` files were observed.
- Current tracked sync heartbeats: PC `2026-05-19T16:52:56+08:00`, VPS `2026-05-19T16:52:26+0800`.
- PC_EXECUTOR stopped at 16:49 because `tasks/T9-G2-PC-node-run.md` still showed top-level `blocked` and contained the 16:39 blocker.
- `tasks/T9-G2-PC-node-run.md` top-level status was corrected to `ready`, and the 16:39 blocker was marked covered by the current fresh guard/release while preserving same-session token requirements.
- ORCHESTRATOR did not execute PC/VPS commands, did not handle a token, did not start a node, and did not approve pairing.

2026-05-19 16:31 UTC+8: ORCHESTRATOR released T9 based on CORRECTION fresh T13 PASS, without executing G2.

- `git pull` returned already up to date.
- G2 remains authorized and `AGENT_BOARD.md` shows G2 `In Progress`.
- CORRECTION recorded fresh T13 PASS at 2026-05-19 16:29 UTC+8 for sync/secret/role/freeze/config risks.
- Current tracked sync heartbeats are clean and within the 5-minute threshold: PC `2026-05-19T16:31:42+08:00`, VPS `2026-05-19T16:31:06+0800`.
- `sync-state/` contains `README.md`, `heartbeat-pc.json`, and `heartbeat-vps.json`; no tracked `error-*.md` files were observed.
- `AGENT_BOARD.md` and `tasks/T9-G2-PC-node-run.md` were updated so T9 is Ready.
- T10 remains Blocked until T9 produces one matching non-secret pairing request ID or pending node ID.
- ORCHESTRATOR did not execute PC/VPS commands, did not handle a token, did not start a node, and did not approve pairing.

2026-05-19 16:24 UTC+8: ORCHESTRATOR reconciled G2 execution state without executing G2.

- `git pull` returned already up to date.
- `tasks/T13-G2-correction-guard.md` and `handoff/CORRECTION.md` contain a prior 14:50 pre-flight PASS, but no fresh current PASS after PC_EXECUTOR's 16:20 stop.
- Current tracked sync heartbeats are clean but stale for the 5-minute blocked threshold: PC `2026-05-19T16:18:46+08:00`, VPS `2026-05-19T16:18:22+0800`.
- `sync-state/` contains `README.md`, `heartbeat-pc.json`, and `heartbeat-vps.json`; no tracked `error-*.md` files were observed.
- `tasks/T9-G2-PC-node-run.md` is already blocked because token was not available in the same non-persistent local shell session and `openclaw node run` was not executed.
- `AGENT_BOARD.md` was corrected so T9 is Blocked pending fresh T13 PASS and healthy sync. T10 remains Blocked pending one matching non-secret T9 pairing request/node ID.
- ORCHESTRATOR did not execute PC/VPS commands, did not handle a token, did not start a node, and did not approve pairing.

2026-05-19 12:27 UTC+8: ORCHESTRATOR took over after role-misdirection audit and paused G2 execution.

- VPS_VERIFIER self-reported that prompts intended for ORCHESTRATOR were mistakenly sent to VPS_VERIFIER.
- CORRECTION found cross-role control-plane edits from VPS-origin commits but no evidence of live G2 approval, token handling, service restart/reload, Gateway config mutation, Nginx/Docker/website mutation, or secret leak.
- ORCHESTRATOR adopts `docs/G2_RUNBOOK.md` as planning material only, but corrects the active state: G2 is Pending, T9/T10/T13 are blocked, and fresh explicit user authorization is required before any G2 execution.
- No PC/VPS command was executed by ORCHESTRATOR during this correction.

2026-05-19 12:34 UTC+8: Generated `docs/G2_AUTHORIZATION_CARD.md`.

- Confirmed current target role is ORCHESTRATOR and workspace is `D:\openclaw-control-plane`.
- Confirmed G2 is paused/pending and old authorization must not be reused.
- Confirmed tracked sync-health is healthy: PC and VPS heartbeats are clean and no `sync-state/error-*.md` files were observed.
- No PC/VPS command was executed, no token was handled, no node was started, and no VPS approval was performed.

2026-05-19 12:37 UTC+8: Fresh second G2 authorization received in the correct target window/workspace.

- Target role/workspace confirmed: ORCHESTRATOR in `D:\openclaw-control-plane`.
- Sync-health confirmed healthy by tracked files: PC and VPS heartbeats are clean, and no `sync-state/error-*.md` files were observed.
- G2 moved to In Progress under the limited runbook scope.
- T13 and T9 are ready; T10 remains blocked until T9 evidence provides a matching non-secret request/node ID.
- ORCHESTRATOR did not execute PC/VPS commands, did not handle a token, did not start a node, and did not approve pairing.

2026-05-19 14:44 UTC+8: Fresh second G2 authorization was repeated in the correct target window/workspace.

- Target role/workspace confirmed again: ORCHESTRATOR in `D:\openclaw-control-plane`.
- Sync-health confirmed healthy again by tracked files: PC and VPS heartbeats are clean, and no `sync-state/error-*.md` files were observed.
- Existing state remains correct: G2 In Progress, T13/T9 Ready, T10 Blocked until T9 evidence provides a matching non-secret request/node ID.
- ORCHESTRATOR did not execute PC/VPS commands, did not handle a token, did not start a node, and did not approve pairing.

2026-05-19 12:16 UTC+8: Prior G2 authorization record is superseded by the 12:27 role-misdirection correction.

- Previously recorded allowed scope: foreground PC node run and corresponding VPS pairing approval under `docs/G2_RUNBOOK.md`.
- Current corrected state: this authorization is paused and must not be used for execution without fresh explicit user confirmation.
- T9/T10/T13 are blocked.
- G2 quality gate is Pending, not in progress and not accepted.
- No PC/VPS command was executed by ORCHESTRATOR, no token was handled, no node was started here, no VPS approval was performed here, and no service was modified.

2026-05-19 12:11 UTC+8: Completed G2 authorization-before-execution control-plane cleanup.

- `docs/G2_RUNBOOK.md` is complete as the G2 pre-execution runbook.
- `USER_STATUS.md` was refreshed with current sync-health snapshot and states that G2 is not authorized.
- `AGENT_BOARD.md` keeps G2 Pending and marks T2.1/T8 Done.
- Filing freeze references now use `/opt/services/docker-compose.openclaw.yml` and any equivalent website-affecting compose/service entries, instead of relying on the obsolete single `docker-composite.yml` path.
- No PC/VPS command was executed, no token was handled, no node was started, no VPS approval was performed, and no service was modified.
- Next step: wait for explicit user authorization before opening G2 execution tasks.

## Frozen G0B Summary

- QQ is included in the current stage as a primary natural-language entry.
- Phone Control UI must be able to start basic tasks, show status/results, and approve high-risk actions.
- VPS OpenClaw Gateway is the always-on hub for device connection, routing, approval flow, state aggregation, and audit.
- DeepSeek may understand, split, and autonomously trigger white-listed actions. High-risk or non-white-listed actions require human approval.
- Windows PC is the main execution node and may perform broad user-level local execution.
- PC system-level changes, service installation, network/firewall changes, and large destructive file operations require human approval and rollback notes.
- Tailscale is optional for administration, troubleshooting, and private-path enhancement. It is not a G2 prerequisite.
- G2/G3/G4 acceptance criteria are recorded in `AGENT_BOARD.md`.

## G2 Planning State

- T9: PC foreground node run, done with non-secret evidence and no pairing request/node ID.
- T10A: VPS Gateway pending status read-only check, ready.
- T10: VPS pairing approval, blocked until T10A finds one matching non-secret request/node ID or proves approval is unnecessary.
- T11: PC G2 verification, draft.
- T12: VPS G2 verification and freeze compliance, draft.
- T13: G2 correction guard, ready.
- Authorization judgment: fresh second authorization is valid only for the G2 runbook scope and expires if sync blocks, role/workspace mismatches, secrets appear, pairing identity is ambiguous, steps drift from the runbook, or freeze risk appears.

## Session Freeze - 2026-05-19 14:46 UTC+8

Current phase: G2 limited foreground pairing is authorized under `docs/G2_RUNBOOK.md`.

Completed:

- G0A, G0B, and G1 accepted.
- Role-misdirection recovery completed and second G2 authorization reconfirmed.
- G2 control plane opened only for T13 and T9.

Blocked:

- T10 remains blocked until T9 evidence contains one matching non-secret pairing request/node ID.
- G3 smoke test and G4 persistence remain closed.

Safety constraints:

- Do not record secrets or `OPENCLAW_GATEWAY_TOKEN`.
- Do not run `openclaw node install/start`.
- Do not perform service persistence, service restart, Nginx/Docker/website/firewall/network changes, or public port exposure.

Next owner: PC_EXECUTOR for T9, with CORRECTION monitoring T13.

Single next action: PC_EXECUTOR claims T9, confirms or refreshes `rollback/pc-g2-node-run-YYYYMMDD.md`, gives the user the dedicated local PowerShell command template, then records only non-secret status from the user-run foreground node flow in `docs/G2_RUNBOOK.md`.

Resume prompt:

```text
You are ORCHESTRATOR resuming OpenClaw G2.
Read USER_STATUS.md, AGENT_BOARD.md, handoff/ORCHESTRATOR.md, tasks/T9-G2-PC-node-run.md, tasks/T10-G2-VPS-pairing-approve.md, tasks/T13-G2-correction-guard.md, docs/G2_RUNBOOK.md, and sync-state/README.md.
Current state: G2 is In Progress under limited runbook scope; T13 has fresh PASS; T9 is Ready for PC_EXECUTOR to guide a user-run local PowerShell token/node flow under docs/G2_RUNBOOK.md; T10 is Blocked until T9 produces one matching non-secret pairing request/node ID.
Do not execute PC/VPS commands from ORCHESTRATOR. Do not handle or record secrets. Keep G3/G4 closed.
```