automation: Docs update for OpenHands v1.23.0 release

The issue lists specific documentation files to update: openhands/usage/agent-canvas/setup.mdx, customize-and-settings.mdx, conversations.mdx, prebuilt-automations.mdx, and managing-automations.mdx. It also requires creating a new release notes page v1.23.0.mdx. Start by locating these files in the OpenHands/docs repository. Review the linked pull requests (e.g., #17225, #16632, #17519) to understand the changes. For each documentation item, confirm the exact wording or settings path with a maintainer if needed. 'Done' means all checklist items are addressed and the new release notes page is added.

Release

• Version: v1.23.0
• Published: 2026-09-23T17:24:03Z
• URL: https://github.com/OpenHands/OpenHands/releases/tag/v1.23.0
• Prerelease: no

Release summary

OpenHands v1.23.0 contains three features, eight bug fixes, and two maintenance items. The most user-visible
features are a universal macOS desktop DMG that runs on both Intel and Apple Silicon Macs, two new color themes
(Light+ and Solarized Light) in Canvas settings, and canonical deployment_kind tagging for Agent Canvas
telemetry. The fixes cover Canvas image package refresh, the change-agent button's mode label, a test-harness
drain, historical Markdown re-rendering, script-automation run logs and script display, the stale "Failed to send"
bubble, conversation tag keys in sidebar chips, and issue-readiness ownership in CI. Maintenance consumes SDK
1.49.5 / Automation 1.15.0 and removes merged PR artifacts from main. An Agent Canvas 1.23.0 release notes page
does not yet exist in OpenHands/docs.

Documentation review checklist

• Universal macOS DMG with per-arch bundled runtimes (#17225) — documentation needed. openhands/usage/agent-canvas/setup.mdx currently states "Pre-built desktop releases support Apple silicon Macs. On an Intel Mac, use the npm or from-source installation method." The PR ships a single universal DMG with per-arch uv/Node.js runtimes and an arch-selecting resolveBundledRuntimeDir(), so the Apple-silicon-only guidance appears outdated. Update the macOS install steps to reflect a universal installer.
• Light+ and Solarized Light theme support (#16632) — documentation needed. The PR lists Light+ and Solarized Light under a Canvas "Applications -> Color Theme" option and migrates hard-coded white utilities to theme-aware contrast utilities. No Canvas docs page currently describes a color-theme setting. Add an appearance/theme section; confirm the exact settings path with a maintainer before publishing it.
• Tag Agent Canvas telemetry by deployment kind (#17529) — probably no documentation change. Adds a frontend deployment_kind: "remote" | "local" telemetry property and stamps it in the PostHog before_send hook; internal analytics only, no documented user-facing setting.
• Refresh Canvas image packages (#17633) — probably no documentation change. Applies the SDK image hardening pattern to the Canvas final stage and resolves Debian packages from a dated Trixie snapshot; build/infrastructure only, no documented behavior or configuration change.
• Restore 11px mode label on the change-agent button (#17616) — probably no documentation change. Replaces a dead text-2.75 utility with text-[11px] on one button label; visual correction only.
• Drain MSW in-flight requests instead of 30 event-loop turns (#16890) — probably no documentation change. Test-harness reliability only.
• Avoid re-rendering unchanged historical Markdown (#17015) — probably no documentation change. Internal memoization/performance work; no documented behavior, setting, or output change.
• Load logs for script automation runs and show their script (#17519) — documentation needed. Script (tarball) automation runs now load run logs on cloud backends and the automation detail page renders the automation's script in a new script section. openhands/usage/agent-canvas/prebuilt-automations.mdx describes script bundles, and the automations docs describe runs; document where the run logs and script appear for script-bundle automations.
• Clear a "Failed to send" bubble once its message is echoed back (#17639) — documentation needed (small). openhands/usage/agent-canvas/conversations.mdx documents only manual Retry/Dismiss; the store now clears a stale error bubble when the server echoes the matching user message, so the bubble no longer persists after a delayed/reconnected delivery.
• Show conversation tag keys in sidebar chips (#16853) — documentation needed. openhands/usage/agent-canvas/conversations.mdx says tag chips show tags with a +N overflow chip; chips now render a Key: value pair (for example Artifacts: 1). Update the chip description and keep the overflow-count wording accurate.
• Let triage and repository writers own readiness (#17598) — probably no documentation change. Repository CI/issue-label policy only; not covered by the docs site.
• Consume SDK 1.49.5 and Automation 1.15.0 (#17650) — documentation needed (release notes maintenance line). Bumps the SDK, Agent Server, TypeScript client, and Automation defaults and mentions SDK 1.49.5's MCP restore hotfix (conversations with an attached MCP server failing to restore after the 1.21.0 fastmcp<4 pin). Record the dependency bumps in the 1.23.0 release notes; confirm with a maintainer whether the MCP restore fix should also be called out as a user-facing fix.
• Remove merged PR artifacts (#17591) — probably no documentation change. Removes a temporary .pr/ directory from main.

Pull request review

• #17225 — Desktop packaging. Touches electron-builder.config.mjs and runtime resolution only; the docs-relevant change is the universal macOS DMG, which contradicts the current Apple-silicon-only statement in setup.mdx.
• #16632 — Canvas UI theming. Large diff across components and tests migrating text-white/border-white/*/bg-white/* to contrast utilities; the docs-relevant change is the two new selectable color themes.
• #17519 — Automations UI. Adds use-automation-tarball-files.ts, tar-unpack.ts, and script-section.tsx, and fixes use-bash-command-logs.ts so a script run's logs resolve without a conversation_id. Docs-relevant: run logs for script automations and script visibility.
• #17639 — Chat send state. Changes optimistic-user-message-store.ts so a confirmed echo also clears an entry the 150 s watchdog marked as "error". Docs-relevant: the failed-message section in conversations.mdx.
• #16853 — Conversation panel. Changes only conversation-tag-chips.tsx (plus tests) to prefix the truncated value with the localized/humanized key. Docs-relevant: the tag-chip description in conversations.mdx.
• #17616 — One-line Tailwind class swap plus a regression test; no user-facing behavior to document beyond the corrected label size.
• #17015 — Rendering performance work (memo boundaries and stable props); no documented surface changed.
• #17529 — Telemetry property addition; no documented surface changed.
• #17650 — Dependency/version bump touching config/defaults.json, package.json, and version-sync scripts; no docs page documents these versions other than release notes.
• #17633 — Dockerfile and Debian snapshot automation; no documented surface changed.
• #16890 — Test harness only.
• #17598 and #17591 — CI/label policy and repository cleanup; no docs-site impact.

Human testing required

• Color themes — open Canvas Settings > Application and locate the color-theme selector; confirm Light+ and Solarized Light are listed and selectable, and that after selecting each one high-emphasis text, icons, borders, and hover/focus backgrounds remain legible in chat, the conversation list, and modals. (The PR author states the themes were tested; the exact settings label and path still need confirming.)
• Universal macOS DMG — on an Intel Mac, install the universal DMG from the v1.23.0 release and launch it; confirm the app starts with its bundled runtimes (no separate Node.js/uv install) and that the same DMG still runs on Apple Silicon. The PR's human section states the app was manually tested on an Intel Mac.
• Script automation run logs — create or import a script-bundle automation, run it against a cloud backend, and open the run's logs; expect logs to load instead of a perpetual "Loading logs…" state, and expect the automation detail page to show the script.
• Conversation tag chips — enable the Tags preference with both known and unknown tag keys; expect each visible chip to read Key: value (for example Artifacts: 1) and the +N overflow count to remain correct when the wider chips do not all fit.
• Failed-to-send bubble — submit a prompt while the event socket is reconnecting or the tab is backgrounded; once the server echoes the matching user message, expect any "Failed to send" bubble for that message to clear on its own.

Suggested documentation locations

• openhands/usage/agent-canvas/setup.mdx — Desktop App (Preview Build) install steps: the macOS section states pre-built releases support Apple silicon only and directs Intel Mac users elsewhere; update for the universal DMG.
• openhands/usage/agent-canvas/customize-and-settings.mdx (and/or openhands/usage/settings/application-settings.mdx) — no color-theme/appearance option is currently documented; add the Light+ and Solarized Light options once the settings path is confirmed.
• openhands/usage/agent-canvas/conversations.mdx — update the tag-chip description to the Key: value format and refine the failed-message section for the auto-clearing bubble.
• openhands/usage/agent-canvas/prebuilt-automations.mdx and openhands/usage/agent-canvas/managing-automations.mdx — script-bundle automations: where run logs and the automation script are shown.
• openhands/usage/agent-canvas/release-notes/v1.23.0.mdx (new page) plus a matching entry in docs.json — the release-notes series currently ends at v1.22.0.

Source links

• https://github.com/OpenHands/OpenHands/releases/tag/v1.23.0
• https://github.com/OpenHands/OpenHands/pull/17225
• https://github.com/OpenHands/OpenHands/pull/16632
• https://github.com/OpenHands/OpenHands/pull/17529
• https://github.com/OpenHands/OpenHands/pull/17633
• https://github.com/OpenHands/OpenHands/pull/17616
• https://github.com/OpenHands/OpenHands/pull/16890
• https://github.com/OpenHands/OpenHands/pull/17015
• https://github.com/OpenHands/OpenHands/pull/17519
• https://github.com/OpenHands/OpenHands/pull/17639
• https://github.com/OpenHands/OpenHands/pull/16853
• https://github.com/OpenHands/OpenHands/pull/17598
• https://github.com/OpenHands/OpenHands/pull/17650
• https://github.com/OpenHands/OpenHands/pull/17591

This issue was created by an AI agent (OpenHands) on behalf of the user.