Runtime Profiles, Multi-Floor Offices, Remote Collaboration, and Diagnostics

This release converges the runtime-profiles, office-systems, claw3doctor, and selective vera_lane work into one branch. Backends become named profiles, the office becomes a multi-floor building, remote offices gain server-backed messaging and handoffs, and a new diagnostics CLI makes setup and troubleshooting first-class.

Highlights

• Named runtime profiles for openclaw, hermes, demo, local, claw3d, and custom backends — each with its own saved URL and token in Studio settings instead of one global pair.
• Multi-floor office runtime model with one runtime binding per floor and persistent per-floor state. Includes lobby, openclaw-ground, hermes-first, local-runtime, claw3d-runtime, custom-second, training, traders-floor, and campus.
• Remote office messaging & handoffs for cross-office collaboration via new /api/office/remote-message and /api/office/remote-handoff routes.
• Local file uploads for chat attachments with allowlisted MIME types and a 10 MB cap.
• claw3doctor diagnostics CLI with profile-scoped or --all-profiles runs, OpenClaw / Hermes / demo / custom-runtime probes, gateway failure classification, and JSON output. Available as npm run doctor.
• Hardened security defaults around CSP, Studio access gating, proxy handling, and runtime boundaries.

Added

• Named runtime profiles and profile-aware connection behavior across all backends.
• Multi-floor office model with floor roster persistence and a floor navigation HUD.
• Remote office messaging API with structured assistant-history reply resolution.
• Remote office handoff API supporting task / context / deliverables / acceptance criteria.
• Local file upload route for chat attachments.
• claw3doctor CLI plus a doctor package script.
• New product and architecture docs: runtime profiles, multi-floor architecture, claw3doctor spec, runtime profile architecture, refreshed roadmap, multi-agent beta, plus bulletin-board, desk-progression, hierarchy-and-teams, meeting-room-workflow, QA-department, and whiteboard specs.

Changed

• Runtime provider selection is now profile-aware instead of collapsing into one generic path.
• Studio settings persist per-profile URL/token entries with a coordinated bootstrap and hydration path.
• Remote agent chat panel and remote office presence updated for the new server-backed delivery and reply behavior.
• Production CSP drops 'unsafe-eval' (kept in dev for HMR), adds strict Referrer-Policy, X-Content-Type-Options, X-Frame-Options: SAMEORIGIN, restrictive Permissions-Policy, Cross-Origin-Resource-Policy: same-origin, and HSTS in production.
• Access gate rewritten with constant-time token comparison, a per-IP rate limiter (10 attempts / 60s), and TRUSTED_PROXY=1-gated X-Forwarded-For handling.
• Custom runtime provider and proxy URL handling tightened around runtime boundaries and allowlists.

Fixed

• Repaired merge-corrupted files and removed tracked merge artifacts from the earlier overlapping branch stack.
• Resolved a UTF-8 / Turbopack parsing issue and cleaned up Turbopack root and optional openclaw resolution warnings.
• Office navigation and pathfinding tightened around floor-aware routing and runtime persistence.

Tests

• Added unit coverage for claw3doctor, office floors, floor roster, runtime connection, gateway connection, office floor runtime persistence, agent fleet hydration derivation, and studio settings coordinator behavior.

Docs

• Replaced top-level MULTI_AGENT_BETA.md and ROADMAP.md with stubs that point to canonical docs under docs/.
• Expanded README.md to describe Local and Claw3D runtime modes, persistent backend profile configuration, and the additional local and claw3d values for CLAW3D_GATEWAY_ADAPTER_TYPE.

Notes

This is still an early-stage release. Remote office workflows, runtime profiles, multi-floor offices, and the diagnostics CLI will continue to iterate quickly in upcoming versions.

Full Changelog: v0.1.3...v0.1.4

This release expands Claw3D from a single-office viewer into a more complete AI workplace, with guided setup, richer agent operations, remote office support, and stronger security hardening.

Highlights

• New onboarding wizard for first-time setup, including gateway connection, prerequisites, company details, and initial agent configuration.
• New packaged skills marketplace with trigger-driven office routing, including starter skills like Todo Board and SOUNDCLAW.
• New office agent management wizard for creating and managing agents directly from the office experience.
• New multi-agent beta support for remote office layouts, presence sync, and remote messaging.
• New company builder wizard with AI-assisted organization generation and bootstrap planning.
• Improved UI polish, responsiveness, and accessibility across the main app and office surfaces.

Security and Reliability

• Hardened access control so gating applies across all routes, not only /api.
• Closed multiple path traversal and file-path validation gaps in local file operations.
• Resolved symlink handling issues in path suggestions.
• Added runtime gateway URL fallback through /api/studio for more reliable environment-specific setup.
• Improved office navigation and pathfinding by fixing diagonal corner-cutting, metadata-driven blockers, collision-aware routing, and A* failure behavior.
• Enforced voice upload size limits before buffering.
• Removed a TypeScript TS2367 build blocker in skillGymDirective.

Docs

• Added an Agent Bus integration guide for visualizing AI sessions in Claw3D.
• Refreshed the public roadmap.

Notes

This is still an early-stage release. The platform is moving quickly, especially around remote office workflows, skills, and guided setup, so expect rapid iteration in upcoming versions.

This release introduces a major upgrade to how agents are visualized and managed inside Claw3D.

Agents now have fully customizable 3D avatars with persistent profiles, and a unified editing experience that brings together both visual identity and agent brain configuration.

Highlights

• Full 3D avatar customization system with live preview
• Unified agent editor (visual + brain files in one place)
• Persistent avatar profiles across sessions
• Improved office HUD and agent management flows

Why this matters

Claw3D is moving toward a more immersive and controllable AI workspace.

This release is a big step toward making agents feel like real entities you can see, edit, and manage in one environment instead of scattered tools.

Notes

This is still an early version. Expect rapid iteration and breaking changes as the platform evolves.

What's Changed

• First Release of Claw3D by @iamlukethedev in #11
• docs: add .env.example for local development setup by @asimons81 in #14
• Fix WS auth + gym release directive TypeScript error by @asimons81 in #16
• Avatar Customization + Update Agent Brain by @iamlukethedev in #23
• Feature/avatar customization by @iamlukethedev in #25

New Contributors

• @iamlukethedev made their first contribution in #11
• @asimons81 made their first contribution in #14

Full Changelog: https://github.com/iamlukethedev/Claw3D/commits/v0.1.2