v0.3.1

亮点

• Gemini CLI 适配器 — Full local adapter support for Google’s Gemini CLI. Includes API-key detection, turn-limit handling, sandbox and approval modes, skill injection into ~/.gemini/, and yolo-mode default. (#452, #656, @aaaaron)
• 运行 transcript 打磨 — Run transcripts render markdown, fold command stdout, redact home paths and user identities, and display humanized event labels across both detail and live surfaces. (#648, #695)
• 收件箱细化 — Improved tab behavior, badge counts aligned with visible unread items, better mobile layout, and smoother new-issue submit state. (#613)
• 改进的 onboarding 向导 — Onboarding now shows Claude Code and Codex as recommended adapters, collapses other types, and features animated step transitions with clickable tabs. Adapter environment checks animate on success and show debug output only on failure. (#700)

改进

• 实例 heartbeat 设置侧栏 — View and manage heartbeat configuration directly from the instance settings page with compact grouped run lists. (#697)
• 项目与 agent 配置标签页 — New tabbed configuration UI for projects and agents, including execution workspace policy settings. (#613)
• 智能体运行标签 — —智能体详情页新增专用运行标签。
• 可配置附件内容类型 — The PAPERCLIP_ALLOWED_ATTACHMENT_TYPES env var lets operators control which file types can be uploaded. (#495, @subhendukundu)
• 默认最大轮次提升至 300 — Agents now default to 300 max turns instead of the previous limit. (#701)
• 侧栏显示任务创建者 — The issue properties pane now displays who created each issue. (#145, @cschneid)
• 公司域 404 — —界面显示公司范围内的未找到页，而非通用错误。
• 开发者 Worktree 工作流 — New paperclipai worktree:make command provisions isolated development instances with their own database, secrets, favicon branding, and git hooks. Worktrees support minimal seed mode, start-point selection, and automatic workspace rebinding. (#496, #530, #545)

修复

• Gemini Docker 构建 — Include the Gemini adapter manifest in the Docker deps stage so production builds succeed. (#706, @zvictor)
• Approval 重试幂等 — Duplicate approval submissions no longer create duplicate records. (#502, @davidahmann)
• Heartbeat 成本记录 — Costs are now routed through costService instead of being recorded inline, fixing missing cost attribution. (#386, @domocarroll)
• Claude Code 环境变量泄漏 — Child adapter processes no longer inherit Claude Code’s internal environment variables. (#485, @jknair)
• parentId query filter — The issues list endpoint now correctly applies the parentId filter. (#491, @lazmo88)
• Remove Cmd+1..9 shortcut — The company-switch keyboard shortcut conflicted with browser tab switching and has been removed. (#628, @STRML)
• IME 组合 Enter — Pressing Enter during IME composition in the new-issue title no longer moves focus prematurely. (#578, @kaonash)
• 改 hostname 后重启提示 — The CLI now reminds users to restart the server after changing allowed hostnames. (#549, @mvanhorn)
• Default dangerouslySkipPermissions for unattended agents — Agents running without a terminal now default to skipping permission prompts instead of hanging. (#388, @ohld)
• Remove stale paperclip property from OpenClaw Gateway — Cleaned up an invalid agent parameter that caused warnings. (#626, @openagen)
• 任务描述溢出 — —长描述不再破坏布局。
• Worktree JWT 持久化 — —环境相关的 JWT 配置现正确带入 worktree 实例。
• 开发迁移提示 — Fixed embedded db:migrate flow for local development.
• Markdown 链接对话框定位 — —插入链接对话框不再渲染到屏外。
• Pretty logger 元数据 — —服务端日志元数据保持单行不换行。

升级指南

Two new database migrations (0026, 0027) will run automatically on startup:

• Migration 0026 adds the workspace_runtime_services table for worktree-aware runtime support.
• Migration 0027 adds execution_workspace_settings to issues and execution_workspace_policy to projects.

Both are additive (new table and new columns) — no existing data is modified. Standard penclip startup will apply them automatically.

贡献者

感谢每一位为本版本贡献的人！

@aaaaron, @adamrobbie-nudge, @cschneid, @davidahmann, @domocarroll, @jknair, @kaonash, @lazmo88, @mvanhorn, @ohld, @openagen, @STRML, @subhendukundu, @zvictor