ClawdHome 1.8.0

中文

新功能

• 安全文件夹：每只虾拥有专属安全空间，虾之间数据完全隔离，管理员通过 Finder 与虾交换文件
• 公共文件夹：所有虾共享的通用资源空间，适合存放提示词模板、参考数据等
• 频道绑定管理：可视化查询频道绑定状态，支持飞书/微信通道配置
• 频道配对优化：配对完成后留在配置面板继续调整选项，不再自动关闭窗口
• ClawdHome CLI：新增命令行工具，支持脚本化管理
• Gateway 离线配置：Gateway 未运行时配置修改自动回退到本地直写
• 升级体验：升级动画效果、卡片内升级入口、App 更新弹窗提醒

改进与修复

• XPC 终端输出改为 Data 传输，修复 ANSI/UTF-8 截断导致的乱码问题
• 提取 UserEnvContract 统一用户隔离环境变量，消除硬编码路径
• 版本号加载态与已加载态区分显示，避免闪烁
• Skills 安装异常但验证通过时显示恢复消息而非直接报错
• 备份列表查询增加诊断日志
• 环境验证修复，诊断中心深度检查增强，恢复进度浮窗
• 进程列表列宽优化

---

English

Features

• Secure Vault: each Shrimp gets an isolated file space; data is invisible between Shrimps; admins exchange files via Finder
• Public Folder: shared resource space across all Shrimps for prompt templates, reference data, etc.
• Channel binding management: visual channel binding status with Feishu/WeChat configuration support
• Channel pairing UX: pairing completion now keeps the config panel open instead of auto-closing
• ClawdHome CLI: new command-line tool for scripted management
• Offline config writes: config changes fall back to local file writes when the Gateway is offline
• Upgrade UX: upgrade animations, in-card upgrade entry, and app update banner

Improvements & Fixes

• XPC terminal output switched to Data transport, fixing ANSI/UTF-8 truncation garbling
• Extracted UserEnvContract for unified user isolation environment variables
• Version label distinguishes loading vs loaded states, eliminating flicker
• Skills install shows recovery message when exit code is non-zero but verification passes
• Backup list queries now include diagnostic logging
• Environment validation fixes, deeper diagnostics checks, and recovery progress overlay
• Process table column widths optimized

ClawdHome 1.7.0

中文

新功能

• 分层备份与恢复系统：支持单个 Shrimp 备份和全局备份，可随时恢复到任意备份点
• 外观模式切换：支持跟随系统、浅色、深色三种模式循环切换
• 定时任务管理界面：可视化管理 Cron 定时任务，查看执行日志
• Skills 商店：浏览、安装、配置和管理 OpenClaw 技能
• 模型优先级管理：拖拽排序设置模型降级链
• 诊断中心：一站式检测环境、权限、配置、安全、Gateway、网络六大模块
• 配置热加载：修改配置后无需重启 Gateway 即可生效
• Ed25519 设备标识：增强 WebSocket 认证安全性
• Helper 健康面板：在设置页查看 Helper 运行状态，支持强制重启
• 记忆日志侧边栏：快速浏览和管理 Shrimp 记忆日志
• 初始化向导支持从自定义 Provider API 拉取模型列表

改进与修复

• XPC 通信全面增加超时保护，防止 Helper 无响应时界面挂起
• Watchdog 智能重试间隔，跳过未安装的用户
• Node.js 安装增加 SHA-256 完整性校验，防御 Zip Slip 路径穿越和 npm 注入
• 备份系统使用 rsync 替代双重 tar，显著提升大目录备份速度
• 备份目录迁移至用户可访问的位置
• 修复备份文件名中含连字符时用户名解析错误
• 修复 Cron/Skills API 因 scope 被清空导致的请求失败
• 修复 JSON 配置文件中斜杠被错误转义的问题
• Web UI 增加加载状态指示
• 进程列表移除冗余列，文件双击可直接编辑
• Helper 断连时显示浮动横幅提醒
• 升级过程中断连后自动恢复
• 管理员用户可查看可升级 Shrimp 数量

---

English

Features

• Hierarchical backup & restore: back up individual Shrimps or all at once, restore to any snapshot
• Appearance mode: cycle between System, Light, and Dark themes
• Cron task manager: visual UI for scheduled tasks with execution logs
• Skills Store: browse, install, configure, and manage OpenClaw skills
• Model priority management: drag-to-reorder fallback chains for model selection
• Diagnostics center: one-stop health checks across environment, permissions, config, security, Gateway, and network
• Hot config reload: apply configuration changes without restarting the Gateway
• Ed25519 device identity for enhanced WebSocket authentication
• Helper health panel: view Helper status in Settings with force-restart capability
• Memory log sidebar: browse and manage Shrimp memory logs
• Setup wizard fetches model lists from custom provider APIs

Improvements & Fixes

• XPC calls now enforce timeouts, preventing UI freezes when the Helper is unresponsive
• Watchdog uses smart retry intervals and skips uninstalled users
• Node.js installation validated with SHA-256 checksums; Zip Slip and npm injection defenses added
• Backup performance improved by replacing double-tar with rsync
• Backup directory moved to a user-accessible location
• Fixed username parsing for backup filenames containing hyphens
• Fixed Cron/Skills API failures caused by cleared scope
• Fixed incorrect slash escaping in JSON config files
• Web UI now shows loading indicators
• Process table streamlined; files open in editor on double-click
• Floating banner warns when Helper connection is lost
• Auto-recovery after disconnection during upgrades
• Admin users can see upgradable Shrimp count

ClawdHome 1.6.0

中文

新功能

• 新增基础环境工具链诊断与一键修复功能，快速排查和解决网关运行环境问题

改进与修复

• 优化应用更新检查及升级进度展示体验
• 修复 Shrimp 无法启动的问题
• 改进每只虾的基础环境隔离级别，并增加安装包缓存，加速启动多只虾

---

English

Features

• Added Node toolchain diagnosis with one-click repair to quickly troubleshoot and fix gateway runtime issues

Improvements & Fixes

• Improved app update check and upgrade progress UX

ClawdHome 1.5.0

中文

新功能

• 新增 Shrimp 初始化配置向导，引导完成首次设置
• 应用更新检测移至后台守护进程，提升检测可靠性

改进与修复

• 优化详情窗口布局与概览页交互体验
• 完善版本升级提示文案
• 加强代理配置与权限校验的安全性
• 提升隔离环境与初始化流程的稳定性

---

English

Features

• Added a setup wizard to guide first-time Shrimp initialization
• App update checks now run in the background for improved reliability

Improvements & Fixes

• Refined detail window layout and overview interaction experience
• Improved upgrade notification messages
• Hardened proxy configuration and permission checks
• Improved stability of isolation environments and the initialization flow

ClawdHome 1.4.0

中文

新功能

• 新增代理（Proxy）设置自动应用至托管用户
• 终端操作流程中新增身份验证辅助功能
• 角色中心新增更多预设角色，并支持中英双语

改进与修复

• 优化用户初始化引导流程，步骤更清晰
• 改进应用内更新及模型配置体验
• 安装包同时支持 Intel 与 Apple Silicon 双架构
• 默认启用公证签名，提升 macOS 安全信任

---

English

Features

• Proxy settings are now automatically applied to managed users
• Added authentication assist for terminal-based flows
• Expanded role presets in the Role Center with full localization

Improvements & Fixes

• Streamlined user onboarding with a clearer step-by-step flow
• Improved in-app update and model configuration experiences
• Universal packaging now supports both Intel and Apple Silicon
• App notarization enabled by default for improved macOS trust

ClawdHome 1.3.0

中文

新功能

• 新增角色市场，可快速浏览和采用预设角色配置
• 支持直接配置模型，无需依赖预设方案
• 全新引导设置体验，支持从已有 Shrimp 克隆配置
• 网关守护进程：自动监控并恢复异常退出的网关实例

改进与修复

• 优化新用户引导和用户管理流程的交互细节
• 改进应用内横幅通知的展示效果
• 增强用户目录权限的安全性处理
• 快速迁移功能文案优化

---

English

Features

• Added Role Market for browsing and adopting preconfigured role setups
• Direct model configuration without requiring a preset
• Redesigned onboarding experience with support for cloning from existing Shrimps
• Gateway watchdog: automatically monitors and recovers crashed gateway instances

Improvements & Fixes

• Polished onboarding and user management interaction details
• Improved in-app banner notifications
• Safer handling of user directory ownership and permissions
• Refined quick-transfer copy

ClawdHome 1.2.0

中文

新功能

• 微信引导入驻：新增微信渠道的 Shrimp 初始化引导流程，帮助用户快速完成入驻配置。
• 详情页快速文件传输：在 Shrimp 详情页中可直接上传/下载文件，无需跳转到文件管理器。
• 文件管理器终端直跳：在维护窗口打开终端时，自动定位到当前浏览路径，省去手动 cd 步骤。
• 模型状态快捷命令：新增模型运行状态的快速查看命令，方便在管理界面即时确认模型服务状态。

改进与修复

• 初始化向导稳定性提升：修复了初始化流程中偶发的卡顿与异常跳转问题，向导体验更加流畅可靠。
• Homebrew 权限自动修复：当检测到 Homebrew 相关权限异常时，应用可自动尝试修复，减少手动排查步骤。
• 模型标签本地化：备用模型的显示名称现已完整翻译为中文，不再出现英文原始标签。
• 日志输出优化：改进了运行日志的输出行为，使日志内容更清晰、噪声更少。

---

---

English

Features

• WeChat onboarding: Added a guided onboarding flow for WeChat-channel Shrimps to streamline initial setup.
• Quick file transfer in detail view: Upload and download files directly from the Shrimp detail panel — no need to open the full file manager.
• Terminal opens at current path: When launching a terminal from the file manager's maintenance window, the session starts in the directory you're already browsing.
• Model status quick command: A new shortcut command lets you instantly check the running status of model services from the management UI.

Improvements & Fixes

• Init wizard stability: Fixed intermittent freezes and unexpected navigation jumps during the Shrimp initialization flow for a smoother setup experience.
• Homebrew permission auto-repair: The app now detects and attempts to automatically fix Homebrew permission issues, reducing the need for manual troubleshooting.
• Localized model labels: Fallback model display names are now fully translated and no longer appear as raw English identifiers.
• Log output improvements: Refined logging behavior to produce cleaner, less noisy output.