Changelog

Unified OperationsLogger module in @better-openclaw/core — structured NDJSON logging for every significant action across CLI, API, and MCP packages.

Three pluggable log sinks: ConsoleSink (human-readable terminal output), FileSink (NDJSON with size-based rotation), and CallbackSink (custom handlers for tests, Sentry, WebSocket streaming).

StepTracker class for multi-step operations (deployments, generation pipelines) with per-step timing, status, and outcome tracking.

timed() helper wraps async operations with automatic start/end/duration/outcome logging — zero overhead on the happy path.

API middleware creates per-request loggers using X-Request-Id as correlation ID, logging method/path/status/duration for every request.

CLI, API, and MCP all pass loggers through to core's generate() and deployer.deploy() for full end-to-end tracing.

Automatic redaction of sensitive context keys (apiKey, password, token, secret, authorization, credentials, private_key) before writing to any sink.

Choose from 8 agent frameworks as primary orchestrator: OpenClaw, CoPaw, NanoClaw, NanoBot, ZeroClaw, MemU, Claude Code, Codex.

Companion framework support — run multiple agent frameworks side-by-side in hybrid stacks.

Framework-aware CLI wizard with primary/companion selection steps.

FrameworkSelector component in the web builder for visual framework selection.

MCP generate-stack tool now accepts primaryFramework and companionFrameworks parameters.

Resolver honors framework-specific mandatory services. Non-OpenClaw frameworks skip Convex/Mission-Control/Tailscale.

Composer generates framework-specific gateway containers, CLI services, and network names.

README generator produces framework-aware documentation tailored to the selected primary framework.

Added OpenSandbox service definition — secure, containerized code execution for AI agents with multi-language support (Python, JS/TS, Java, Go, Bash).

New `code-sandbox` skill with 8 actions: execute_code, execute_shell, upload/download files, sandbox management, and VNC desktop preview via create_desktop and get_preview_url.

Automatic `sandbox.toml` config generation via new `additionalFiles` field in AddonStackResult, supporting gVisor runtime, capability dropping, and PID limits.

Pre-pull image declarations with 3-tier priority system (8 images: server, execd, desktop, chrome, vscode, and code interpreters).

Port conflict resolution between OpenSandbox and SearXNG (both port 8080) with automatic remapping.

Extended schema with `additionalFiles` and `prePullImages` metadata fields for richer stack output.

Added Better-Auth integration with support for Email/Password, Magic Links, and Passkey authentication.

Users can now save their generated architecture stacks to their account to revisit or redeploy later.

Implemented 'Favorites' functionality for easy access to heavily used stacks.

Integrated `usesend-js` for branded transactional emails (Welcome, Reset Password, Magic Links).

Optimized test suites using `better-auth/testUtils` and in-memory database adapters.

Expanded the knowledge base to 40 highly detailed, SEO-optimized blog articles.

Automated the injection of 5 unique, animated SVG infographics across the blog to enrich learning (Architecture, Costs, Data Sovereignty, Workflows, Infrastructure).

Refactored `blogPosts.ts` into individual, maintainable files for easier editing and extension.

Configured Google Analytics site-wide and added robots.txt + sitemap support.

Resolved several Hono OpenAPI route handler TypeScript mismatches.

Launched the initial version of better-openclaw with 94 supported services across 21 categories.

Interactive CLI Wizard to select services and define configuration options.

Visual Web Builder UI with live rendering of Docker Compose architecture.

REST API for programmatic generation of stacks.

Smart dependency resolution (e.g., n8n auto-wires PostgreSQL).

Direct one-click deployments to Dokploy and Coolify environments.