v0.6.0

ComfyUI-OpenClaw v0.6.0

This release focuses on assist UX improvements, runtime/operations hardening, admin query robustness, and API contract maturity. It also adds a generated OpenAPI spec and opt-in structured logging for better integration and observability workflows.

Highlights

• Optional streaming Assist UX for Planner/Refiner with incremental preview and safe fallback
• Runtime guardrails diagnostics and safer config/runtime contract handling
• Crypto lifecycle drill automation with machine-readable evidence output
• Compatibility matrix governance checks and refresh workflow
• Hardened admin query pagination and bounded scans for deterministic behavior
• Graceful shutdown/reset consistency hooks for runtime state
• Opt-in structured JSON logging for core execution paths
• Generated OpenAPI spec (docs/openapi.yaml) for integrator tooling

Added / Improved

Assist UX and Frontend Reliability

• Added optional streaming assist paths for Planner/Refiner
• Added frontend live preview updates with staged progress events
• Added capability-gated streaming enablement with automatic fallback to non-stream endpoints
• Added idempotent fetch-wrapper composition guard to prevent duplicate wrapper stacking during frontend bootstrap/setup

Automation and Operator UX

• Added admin-only automation payload composer endpoint for safe trigger/webhook draft generation
• Added server-side validation/normalization for draft payloads
• Added tool-calling schema support for automation payload composition
• Improved Parameter Lab UX with dynamic dimension picker hardening and expanded E2E coverage

Reliability and Operability Hardening

Runtime Lifecycle Consistency

• Added graceful shutdown/reset consistency hooks for scheduler/failover runtime state
• Improved runtime state flush/reset determinism
• Added atomic writes for runtime state files to reduce partial-write corruption risk

Management Query Robustness

• Hardened /events and /approvals pagination normalization
• Added bounded scans and deterministic malformed-input handling
• Improved cursor/scan diagnostics for admin-facing query paths

Helper Consolidation

• Consolidated shared frontend helper logic (cancellation / JSON parsing paths)
• Consolidated backend import-fallback helper logic
• Reduced duplicated compatibility code and maintenance risk across environments

Security and Governance

Runtime Guardrails

• Added runtime-only guardrail diagnostics visibility
• Prevented runtime-only safety limits from being persisted back into config

Crypto Lifecycle Drill Automation

• Added scripted drills for:
  • planned rotation
  • emergency revocation
  • key-loss recovery
  • token compromise
• Outputs machine-readable evidence for audit/verification workflows

Compatibility Matrix Governance

• Added machine-readable metadata to compatibility matrix documentation
• Added refresh workflow tooling
• Added operator-doctor freshness/drift checks

API and Integration Maturity

OpenAPI Spec Generation

• Added generated OpenAPI spec at docs/openapi.yaml
• Added generator workflow from docs/release/api_contract.md
• Improves integration review, tooling, and contract drift checks

Naming and Compatibility Cleanup

• Continued OpenClaw naming unification across UI/API/session surfaces
• Preserved core legacy compatibility routes while aligning canonical OpenClaw paths/selectors

Logging and Diagnostics

• Added opt-in structured JSON logging for selected core paths (queue submit and LLM client)
• Default logging remains plain text unless enabled:
  • OPENCLAW_LOG_FORMAT=json
  • or OPENCLAW_STRUCTURED_LOGS=1

Verification

This release scope was validated through the project SOP gates, including:

• detect-secrets
• pre-commit --all-files
• backend unit test suites
• frontend Playwright E2E

Upgrade Notes

• Streaming Assist is optional and capability-gated; frontend falls back automatically when unavailable
• Generated OpenAPI spec is now available at docs/openapi.yaml
• Structured JSON logging is opt-in only (no default log format change)
• Legacy /moltbot/* compatibility remains supported for core routes; /openclaw/* is the recommended path