Skip to content

v0.5.0 — Delegated workflows and reliable delivery

Latest

Choose a tag to compare

@github-actions github-actions released this 15 Nov 04:04
12ee50c

OpenClaw.NET v0.5.0 adds user-delegated workflow authentication and hardens outbound delivery, payment retries, and gateway file access. Built from main commit 12ee50cd2d619aa21b7f74195b815e08f9f6fb1d.

Highlights

  • User-delegated workflows: authenticated HTTP integration and MCP workflow calls can use Entra on-behalf-of or RFC 8693 token exchange. Verified request identity reaches the workflow host through bounded token acquisition and caching, without persisting user assertions or silently falling back to shared credentials. Existing static authentication remains the default.
  • Consistent channel delivery: adapters distinguish transport acceptance, suppression, rejection, partial delivery, cancellation, and unknown outcomes. Retries are limited to known transient rejections; partial or uncertain sends are not replayed. Discord preserves message chunks and handles malformed rate-limit metadata safely. Provider rejection details remain available to operators.
  • Payment retry safety: durable, caller-scoped machine-payment idempotency records prevent redispatch after uncertain outcomes or restart. Payment environment, permissions, approval, and one-time secret handling are hardened.
  • Gateway hardening: restrict workspace and archive operations, reject filesystem-link escapes, protect media uploads and downloads, tighten webhook delivery reservations and file publication, and redact corrupt-memory payloads from logs.
  • Runtime and maintenance: upgrade Microsoft Agent Framework to 1.28, repair scheduling and inbound-delivery boundaries, update the Go toolchain and pinned dependencies, and validate delegated workflows against published JIT and NativeAOT gateways.

Upgrade notes

  1. Preserve configuration, memory, and payment-idempotency state during upgrades. Pending or unreadable payment records represent potentially completed provider operations and must not be deleted to force a retry. Reconcile uncertain payments against provider records; separate storage directories do not share duplicate protection.
  2. IChannelAdapter.SendAsync keeps its signature, but failures that previously appeared successful are now surfaced. WhatsApp.BridgeSuppressSendExceptions remains readable but no longer hides failed sends. Unsupported content is rejected explicitly. Plugin send handlers must confirm transport acceptance; missing acknowledgments are failures. See channel delivery outcomes.
  3. Delegated workflows require explicit HTTPS/OIDC and backend configuration. Cookies, bootstrap/account tokens, chat, and background jobs cannot supply a delegated user assertion. Workflow hosts must authorize run ownership and approvals themselves. See workflow authentication setup and boundaries.
  4. Workspace administration and digital-employee installation require an administrator; media uploads require an operator or administrator. Cookie-authenticated mutations require CSRF protection. See workspace administration.

Downloads

Start with the desktop bundle for your platform:

Platform Desktop archive
Windows x64 openclaw-desktop-win-x64.zip
Apple Silicon macOS openclaw-desktop-osx-arm64.zip
Linux x64 openclaw-desktop-linux-x64.zip

Each desktop bundle includes AgentQi Companion, the NativeAOT gateway, and the NativeAOT CLI. Standalone gateway and CLI archives are also included. Each ZIP has a matching .sha256 file.

Windows and macOS archives are unsigned; macOS archives are not notarized because signing secrets are not configured. No signed update manifest is included; use the release downloads for this version.

The native orchestrator remains the default; the supported Microsoft Agent Framework orchestrator is opt-in. Optional integrations retain their documented runtime boundaries, including JIT-only dynamically loaded native plugins and Vault/OpenBao support. Transport acceptance does not guarantee recipient delivery, and payment retry protection does not claim provider-side exactly-once execution. Live-provider and production identity-provider acceptance remain deployment-specific.

See the release and first-run guide and payment retry contract.

Validation

  • Exact-main CI passed standard and optional-integration tests, published JIT and NativeAOT workflow tests, both native orchestrators, public compatibility, Docker, Go security checks, live Nacos acceptance, and code analysis.
  • Local Release build: zero warnings/errors. Full solution tests: 3,733 passed and 13 environment-dependent cases skipped. Focused delivery regression suite: 204 passed. HelloAgent smoke passed.
  • NuGet vulnerability audit: 43 projects checked; no vulnerable direct or transitive packages reported.
  • Release workflow passed documentation, deterministic desktop contract, pinned public compatibility, and all three platform build/extraction gates. All nine ZIP digests match their checksum files.
  • Downloaded Apple Silicon desktop archive passed checksum/extraction checks and the packaged Ollama Agentic setup, gateway start, and sequential tool round trip.
  • Manual isolated macOS Companion smoke passed setup/config creation, connection, stop/restart/reconnection, recoverable missing-config handling, and shutdown of the managed gateway. Windows and Linux desktop UI flows were not manually exercised.
  • Release documentation and packaged-smoke fixture tests passed.

What's Changed

  • chore(deps): bump docker/login-action from 4.6.0 to 4.7.0 by @dependabot[bot] in #284
  • Maf 1.28 by @geffzhang in #285
  • chore(deps): bump actions/setup-dotnet from 6.0.0 to 6.1.0 by @dependabot[bot] in #289
  • chore(deps): bump docker/login-action from 4.7.0 to 4.8.0 by @dependabot[bot] in #286
  • chore(deps): bump actions/setup-java from 6.1.0 to 6.2.0 by @dependabot[bot] in #287
  • chore(deps): bump github.com/mattn/go-sqlite3 from 1.14.52 to 1.14.53 in /src/whatsapp-whatsmeow-worker by @dependabot[bot] in #288
  • fix(ci): update Go toolchain to 1.26.11 by @Telli in #291
  • Workflow http runner user delegation by @geffzhang in #292
  • Fix review findings in payment safety, permissions, delivery, and scheduling by @Telli in #293
  • fix: enforce consistent channel delivery outcomes by @Telli in #294

Full Changelog: v0.4.2...v0.5.0