chore(release): prepare v5.1.0

Author: SaladDay

.github/workflows/release.yml

@@ -315,7 +315,9 @@ jobs:
           body: |
             ## CC Switch CLI ${{ github.ref_name }}
 
-            All-in-One Assistant for Claude Code, Codex & Gemini CLI
+            All-in-One Assistant for Claude Code, Codex, Gemini, OpenCode & OpenClaw
+
+            New in this release: OpenClaw support, tighter upstream parity, and safer WebDAV / TUI behavior.
 
             ### 📦 下载 / Downloads
 

CHANGELOG.md

@@ -7,6 +7,50 @@ All notable changes to CC Switch CLI will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [5.1.0] - 2026-03-20
+
+### Added
+
+- **OpenClaw**: Add first-class OpenClaw support with upstream-aligned provider flows, additive `~/.openclaw/openclaw.json` sync, default model management, prompt support, and dedicated TUI entries for `Env`, `Tools`, `Agents Defaults`, and config health warnings.
+
+### Changed
+
+- **Provider / Config**: Align OpenClaw provider boundaries, config import/update/remove behavior, and common snippet live-sync handling more closely with upstream behavior.
+- **Proxy**: Align Claude backend behavior with upstream and split oversized proxy modules for easier maintenance without changing the release surface.
+
+### Fixed
+
+- **OpenClaw / TUI**: Close remaining live-config parity gaps, improve the ratatui flow, and restore provider add/save after JSON edits.
+- **Terminal Compatibility**: Improve ansi256 and `TERM=*-256color` fallback behavior, including SSH xterm sessions.
+- **WebDAV**: Reject false-positive sync success results instead of reporting a misleading successful sync.
+
+### Docs & Chore
+
+- **Docs / Repo Hygiene**: Remove branch-only OpenClaw planning notes from the PR payload and ignore the superpowers docs workspace.
+- **Internal Refactor**: Split oversized provider, i18n, and Claude proxy modules without intended behavior changes.
+
+### Commits (since v5.0.1)
+
+- 1aca886 feat(openclaw): add upstream-aligned provider support
+- dccb70d docs: remove openclaw plan notes from pr
+- 5f5c0c9 refactor: split oversized modules without behavior changes
+- b6d6564 fix(tui): honor TERM 256color fallbacks
+- b42e569 test(tui): isolate test terminals from real tty
+- da9298e fix(tui): fallback SSH xterm sessions to ansi256
+- 126d082 chore(git): ignore docs superpowers workspace
+- 3088a6b fix(tui): unblock provider add save after JSON edits
+- c4409be fix(provider): align common snippets with live sync
+- 56f8af7 fix(proxy): align Claude backend behavior with upstream
+- 4a8dd7c refactor(proxy): split Claude proxy modules and tests
+- 078deaf feat(openclaw): align config and provider parity flows
+- 969dcd0 feat(openclaw): align upstream provider boundaries
+- c4cce7c fix(webdav): reject false-positive sync success
+- cdb6c5a fix(openclaw): align live-config parity and TUI behavior
+
+### Thanks
+
+- Thanks `@saladday` for landing OpenClaw support, tightening provider/live-config parity, and cleaning up the upstream alignment work across the proxy and TUI layers.
+
 ## [5.0.1] - 2026-03-15
 
 ### Added

README.md

@@ -2,14 +2,14 @@
 
 # CC-Switch CLI
 
-[![Version](https://img.shields.io/badge/version-5.0.1-blue.svg)](https://github.com/saladday/cc-switch-cli/releases)
+[![Version](https://img.shields.io/badge/version-5.1.0-blue.svg)](https://github.com/saladday/cc-switch-cli/releases)
 [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/saladday/cc-switch-cli/releases)
 [![Built with Rust](https://img.shields.io/badge/built%20with-Rust-orange.svg)](https://www.rust-lang.org/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
-**Command-Line Management Tool for Claude Code, Codex, Gemini & OpenCode CLI**
+**Command-Line Management Tool for Claude Code, Codex, Gemini, OpenCode & OpenClaw**
 
-Unified management for Claude Code, Codex, Gemini, and OpenCode CLI provider configurations, MCP servers, skills, prompts, local proxy routes, and environment checks.
+Unified management for Claude Code, Codex, Gemini, OpenCode, and OpenClaw provider configurations, plus app-specific support for MCP servers, skills, prompts, local proxy routes, and environment checks.
 
 [English](README.md) | [中文](README_ZH.md)
 
@@ -28,11 +28,16 @@ This project is a **CLI fork** of [CC-Switch](https://github.com/farion1231/cc-s
 
 ---
 
-## 🆕 What's New in 5.0.1
+## 🆕 What's New in 5.1.0
 
-- Self-update now follows GitHub release metadata more closely and has a safer signed upgrade path.
-- The v5 TUI palette now stays readable across Apple Terminal and ansi256 compatibility modes.
-- Claude and Codex now warn before a first switch would overwrite an existing live config, and show a one-time common-config tip after the first real provider change.
+<div align="center">
+  <h3><strong>🦞 OpenClaw (小龙虾) is now supported in CC-Switch CLI</strong></h3>
+</div>
+
+- OpenClaw now has first-class provider support with upstream-aligned `openclaw.json` handling, default model flows, prompt support, and dedicated TUI entries for `Env`, `Tools`, `Agents Defaults`, and config health warnings.
+- Provider and common-snippet syncing now stay closer to upstream behavior, especially for additive live-config apps.
+- WebDAV now rejects false-positive sync success results instead of reporting a misleading success.
+- TUI compatibility is better in SSH, ansi256, and `TERM=*-256color` sessions, and provider add/save works again after JSON edits.
 
 ---
 
@@ -107,8 +112,9 @@ cc-switch proxy show                 # Inspect proxy routes and status
 cc-switch --app claude provider list    # Manage Claude providers
 cc-switch --app codex mcp sync          # Sync Codex MCP servers
 cc-switch --app gemini prompts list     # List Gemini prompts
+cc-switch --app openclaw provider list  # Manage OpenClaw providers
 
-# Supported apps: `claude` (default), `codex`, `gemini`, `open-code`
+# Supported apps: `claude` (default), `codex`, `gemini`, `opencode`, `openclaw`
 ```
 
 See the "Features" section for full command list.
@@ -222,9 +228,9 @@ copy target\release\cc-switch.exe C:\Windows\System32\
 
 ### 🔌 Provider Management
 
-Manage API configurations for **Claude Code**, **Codex**, **Gemini**, and **OpenCode**.
+Manage API configurations for **Claude Code**, **Codex**, **Gemini**, **OpenCode**, and **OpenClaw**.
 
-**Features:** One-click switching, multi-endpoint support, API key management, speed testing, stream health checks, remote model discovery.
+**Features:** One-click switching, multi-endpoint support, API key management, remote model discovery, and per-app diagnostics such as speed testing or stream health checks where supported.
 
 ```bash
 cc-switch provider list              # List all providers
@@ -261,7 +267,7 @@ cc-switch mcp import --app claude    # Import from live config
 
 Manage system prompt presets for AI coding assistants.
 
-**Cross-app support:** Claude (`CLAUDE.md`), Codex (`AGENTS.md`), Gemini (`GEMINI.md`), OpenCode (`AGENTS.md`).
+**Cross-app support:** Claude (`CLAUDE.md`), Codex (`AGENTS.md`), Gemini (`GEMINI.md`), OpenCode (`AGENTS.md`), OpenClaw (`AGENTS.md`).
 
 ```bash
 cc-switch prompts list               # List prompt presets
@@ -396,7 +402,7 @@ cc-switch update --version vX.Y.Z    # Update to a specific version
 
 - **SQLite-backed state**: Core data lives in `~/.cc-switch/cc-switch.db`; legacy `~/.cc-switch/config.json` is kept only for older import and migration paths
 - **Skills SSOT**: Skill source files live in `~/.cc-switch/skills/`, while install state and app enablement stay in the database
-- **Safe Live Sync (Default)**: Skip writing live files for apps that haven't been initialized yet (prevents creating `~/.claude`, `~/.codex`, `~/.gemini`, or `~/.config/opencode` unexpectedly)
+- **Safe Live Sync (Default)**: Skip writing live files for apps that haven't been initialized yet (prevents creating `~/.claude`, `~/.codex`, `~/.gemini`, `~/.config/opencode`, or `~/.openclaw` unexpectedly)
 - **Atomic Writes**: Temp file + rename pattern prevents corruption
 - **Service Layer Reuse**: 100% reused from original GUI version
 - **Concurrency Safe**: RwLock with scoped guards
@@ -415,6 +421,7 @@ cc-switch update --version vX.Y.Z    # Update to a specific version
 - Codex: `~/.codex/auth.json` (auth state), `~/.codex/config.toml` (provider/common config + MCP), `~/.codex/AGENTS.md` (prompts)
 - Gemini: `~/.gemini/.env` (provider env), `~/.gemini/settings.json` (settings + MCP), `~/.gemini/GEMINI.md` (prompts)
 - OpenCode: `~/.config/opencode/opencode.json` (providers + MCP + runtime config), `~/.config/opencode/AGENTS.md` (prompts)
+- OpenClaw: `~/.openclaw/openclaw.json` (providers + env/tools/agents defaults), `~/.openclaw/AGENTS.md` (prompts)
 
 ---
 
@@ -425,7 +432,7 @@ cc-switch update --version vX.Y.Z    # Update to a specific version
 
 <br>
 
-First, make sure the target CLI has been initialized at least once (i.e. its config directory exists). CC-Switch may skip live sync for uninitialized apps; you will see a warning. Run the target CLI once (e.g. `claude --help`, `codex --help`, `gemini --help`, `opencode --help`), then switch again.
+First, make sure the target CLI has been initialized at least once (i.e. its config directory exists). CC-Switch may skip live sync for uninitialized apps; you will see a warning. Run the target CLI once (e.g. `claude --help`, `codex --help`, `gemini --help`, `opencode --help`, `openclaw --help`), then switch again.
 
 This is usually caused by **environment variable conflicts**. If you have API keys set in system environment variables (like `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`), they will override CC-Switch's configuration.
 
@@ -459,11 +466,12 @@ This is usually caused by **environment variable conflicts**. If you have API ke
 
 <br>
 
-CC-Switch currently supports four AI coding assistants:
+CC-Switch currently supports five AI coding assistants:
 - **Claude Code** (`--app claude`, default)
 - **Codex** (`--app codex`)
 - **Gemini** (`--app gemini`)
-- **OpenCode** (`--app open-code`)
+- **OpenCode** (`--app opencode`)
+- **OpenClaw** (`--app openclaw`)
 
 Use the global `--app` flag to specify which app to manage:
 ```bash

README_ZH.md

@@ -2,14 +2,14 @@
 
 # CC-Switch CLI
 
-[![Version](https://img.shields.io/badge/version-5.0.1-blue.svg)](https://github.com/saladday/cc-switch-cli/releases)
+[![Version](https://img.shields.io/badge/version-5.1.0-blue.svg)](https://github.com/saladday/cc-switch-cli/releases)
 [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/saladday/cc-switch-cli/releases)
 [![Built with Rust](https://img.shields.io/badge/built%20with-Rust-orange.svg)](https://www.rust-lang.org/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
-**Claude Code、Codex、Gemini 与 OpenCode CLI 的命令行管理工具**
+**Claude Code、Codex、Gemini、OpenCode 与 OpenClaw 的命令行管理工具**
 
-统一管理 Claude Code、Codex、Gemini 与 OpenCode CLI 的供应商配置、MCP 服务器、Skills 扩展、提示词、本地代理路由和环境检查。
+统一管理 Claude Code、Codex、Gemini、OpenCode 与 OpenClaw 的供应商配置，并按应用提供 MCP 服务器、Skills 扩展、提示词、本地代理路由和环境检查等能力。
 
 [English](README.md) | [中文](README_ZH.md)
 
@@ -26,11 +26,16 @@
 
 ---
 
-## 🆕 5.0.1 更新内容
+## 🆕 5.1.0 更新内容
 
-- 自更新流程进一步对齐 GitHub Release 元数据，签名升级和安装脚本升级路径更稳妥。
-- v5 TUI 配色在 Apple Terminal 和 ansi256 兼容模式下保持可读且一致。
-- Claude 与 Codex 在第一次切换可能覆盖现有 live 配置时会先提示，并在第一次真实切换后显示一次性“通用配置”提示。
+<div align="center">
+  <h3><strong>🦞 现已支持 OpenClaw（小龙虾）</strong></h3>
+</div>
+
+- OpenClaw 现已支持一等公民级别的供应商管理，包括对齐上游的 `openclaw.json` 读写、默认模型流程、提示词支持，以及 `Env`、`Tools`、`Agents Defaults` 与健康告警的专属 TUI 入口。
+- 供应商与通用配置片段的同步行为进一步向上游靠拢，尤其是 additive live-config 应用。
+- WebDAV 现在会拒绝误报的同步成功结果，不再把失败操作显示成“成功”。
+- TUI 在 SSH、ansi256 和 `TERM=*-256color` 场景下更稳定，JSON 编辑后的供应商新增/保存流程也恢复正常。
 
 ---
 
@@ -109,8 +114,9 @@ cc-switch proxy show                 # 查看代理路由和状态
 cc-switch --app claude provider list    # 管理 Claude 供应商
 cc-switch --app codex mcp sync          # 同步 Codex MCP 服务器
 cc-switch --app gemini prompts list     # 列出 Gemini 提示词
+cc-switch --app openclaw provider list  # 管理 OpenClaw 供应商
 
-# 支持的应用：`claude`（默认）、`codex`、`gemini`、`open-code`
+# 支持的应用：`claude`（默认）、`codex`、`gemini`、`opencode`、`openclaw`
 ```
 
 完整命令列表请参考「功能特性」章节。
@@ -224,9 +230,9 @@ copy target\release\cc-switch.exe C:\Windows\System32\
 
 ### 🔌 供应商管理
 
-管理 **Claude Code**、**Codex**、**Gemini** 与 **OpenCode** 的 API 配置。
+管理 **Claude Code**、**Codex**、**Gemini**、**OpenCode** 与 **OpenClaw** 的 API 配置。
 
-**功能：** 一键切换、多端点支持、API 密钥管理、速度测试、流式健康检查、远端模型发现。
+**功能：** 一键切换、多端点支持、API 密钥管理、远端模型发现，以及按应用提供的速度测试、流式健康检查等诊断能力。
 
 ```bash
 cc-switch provider list              # 列出所有供应商
@@ -263,7 +269,7 @@ cc-switch mcp import --app claude    # 从实时配置导入
 
 管理 AI 编码助手的系统提示词预设。
 
-**跨应用支持：** Claude (`CLAUDE.md`)、Codex (`AGENTS.md`)、Gemini (`GEMINI.md`)、OpenCode (`AGENTS.md`)。
+**跨应用支持：** Claude (`CLAUDE.md`)、Codex (`AGENTS.md`)、Gemini (`GEMINI.md`)、OpenCode (`AGENTS.md`)、OpenClaw (`AGENTS.md`)。
 
 ```bash
 cc-switch prompts list               # 列出提示词预设
@@ -398,7 +404,7 @@ cc-switch update --version vX.Y.Z    # 更新到指定版本
 
 - **SQLite 持久化**：核心数据存放在 `~/.cc-switch/cc-switch.db`；旧版 `~/.cc-switch/config.json` 仅保留给兼容与迁移路径使用
 - **Skills SSOT**：技能源文件保存在 `~/.cc-switch/skills/`，安装状态和启用状态由数据库统一记录
-- **安全 Live 同步（默认）**：若目标应用尚未初始化，将跳过写入 live 文件（避免意外创建 `~/.claude`、`~/.codex`、`~/.gemini` 或 `~/.config/opencode`）
+- **安全 Live 同步（默认）**：若目标应用尚未初始化，将跳过写入 live 文件（避免意外创建 `~/.claude`、`~/.codex`、`~/.gemini`、`~/.config/opencode` 或 `~/.openclaw`）
 - **原子写入**：临时文件 + 重命名模式防止损坏
 - **服务层复用**：100% 复用原 GUI 版本
 - **并发安全**：RwLock 配合作用域守卫
@@ -417,6 +423,7 @@ cc-switch update --version vX.Y.Z    # 更新到指定版本
 - Codex: `~/.codex/auth.json`（认证状态）, `~/.codex/config.toml`（供应商 / 通用配置 + MCP）, `~/.codex/AGENTS.md`（提示词）
 - Gemini: `~/.gemini/.env`（供应商环境变量）, `~/.gemini/settings.json`（设置 + MCP）, `~/.gemini/GEMINI.md`（提示词）
 - OpenCode: `~/.config/opencode/opencode.json`（供应商 + MCP + 运行时配置）, `~/.config/opencode/AGENTS.md`（提示词）
+- OpenClaw: `~/.openclaw/openclaw.json`（供应商 + Env/Tools/Agents Defaults）, `~/.openclaw/AGENTS.md`（提示词）
 
 ---
 
@@ -427,7 +434,7 @@ cc-switch update --version vX.Y.Z    # 更新到指定版本
 
 <br>
 
-首先确认目标 CLI 已经至少运行过一次（即对应配置目录已存在）。如果应用未初始化，CC-Switch 会出于安全原因跳过写入 live 文件，并提示一条 warning。请先运行一次目标 CLI（例如 `claude --help` / `codex --help` / `gemini --help` / `opencode --help`），然后再切换一次供应商。
+首先确认目标 CLI 已经至少运行过一次（即对应配置目录已存在）。如果应用未初始化，CC-Switch 会出于安全原因跳过写入 live 文件，并提示一条 warning。请先运行一次目标 CLI（例如 `claude --help` / `codex --help` / `gemini --help` / `opencode --help` / `openclaw --help`），然后再切换一次供应商。
 
 这通常是由**环境变量冲突**引起的。如果你在系统环境变量中设置了 API 密钥（如 `ANTHROPIC_API_KEY`、`OPENAI_API_KEY`），它们会覆盖 CC-Switch 的配置。
 
@@ -461,11 +468,12 @@ cc-switch update --version vX.Y.Z    # 更新到指定版本
 
 <br>
 
-CC-Switch 目前支持四个 AI 编程助手：
+CC-Switch 目前支持五个 AI 编程助手：
 - **Claude Code** (`--app claude`，默认)
 - **Codex** (`--app codex`)
 - **Gemini** (`--app gemini`)
-- **OpenCode** (`--app open-code`)
+- **OpenCode** (`--app opencode`)
+- **OpenClaw** (`--app openclaw`)
 
 使用全局 `--app` 参数指定要管理的应用：
 ```bash

src-tauri/Cargo.lock

@@ -1,7 +1,7 @@
 [package]
 name = "cc-switch"
-version = "5.0.1"
-description = "All-in-One Assistant for Claude Code, Codex, Gemini & OpenCode CLI"
+version = "5.1.0"
+description = "All-in-One Assistant for Claude Code, Codex, Gemini, OpenCode & OpenClaw"
 authors = ["Jason Young", "saladday"]
 license = "MIT"
 repository = "https://github.com/saladday/cc-switch-cli"