docs/release-notes/v3.12.1-en.md
Stability Fixes, StepFun Presets, OpenClaw authHeader, and New Sponsor Partners
CC Switch v3.12.1 is a patch release focused on stability improvements and bug fixes. It resolves a Common Config modal infinite reopen loop, a WebDAV sync foreign key constraint failure, and several i18n interpolation issues. It also adds StepFun provider presets, OpenClaw input type selection and authHeader support, upgrades the default Gemini model to 3.1-pro, and welcomes four new sponsor partners.
Release Date: 2026-03-12
Update Scale: 19 commits | 56 files changed | +1,429 / -396 lines
provider_health during WebDAV syncauthHeader field for vendor-specific auth header supportAdded provider presets for StepFun (阶跃星辰), a leading Chinese AI model provider.
Enhanced the OpenClaw configuration with more granular control and better vendor compatibility.
authHeader boolean to OpenClawProviderConfig for vendor-specific auth header support (e.g. Longcat), and refactored form state to reuse the shared typeprovider_health table during WebDAV syncauthHeader: true to Longcat provider preset (#1377, thanks @wavever)www.x-code.cn to x-code.ccThanks to all contributors for their contributions to this release!
@hengm3467 @liuxxxu @bigsongeth @zuoliangyu @wavever @Mason-mengze
Visit Releases to download the appropriate version.
| System | Minimum Version | Architecture |
|---|---|---|
| Windows | Windows 10 or later | x64 |
| macOS | macOS 10.15 (Catalina) or later | Intel (x64) / Apple Silicon (arm64) |
| Linux | See table below | x64 |
| File | Description |
|---|---|
CC-Switch-v3.12.1-Windows.msi | Recommended - MSI installer with auto-update |
CC-Switch-v3.12.1-Windows-Portable.zip | Portable version, extract and run, no registry write |
| File | Description |
|---|---|
CC-Switch-v3.12.1-macOS.zip | Recommended - Extract and drag to Applications, Universal Binary |
CC-Switch-v3.12.1-macOS.tar.gz | For Homebrew installation and auto-update |
Note: Since the author doesn't have an Apple Developer account, you may see an "unidentified developer" warning on first launch. Please close it, then go to "System Settings" -> "Privacy & Security" -> click "Open Anyway", and it will open normally afterwards.
brew tap farion1231/ccswitch
brew install --cask cc-switch
Update:
brew upgrade --cask cc-switch
| Distribution | Recommended Format | Installation Method |
|---|---|---|
| Ubuntu / Debian / Linux Mint / Pop!_OS | .deb | sudo dpkg -i CC-Switch-*.deb or sudo apt install ./CC-Switch-*.deb |
| Fedora / RHEL / CentOS / Rocky Linux | .rpm | sudo rpm -i CC-Switch-*.rpm or sudo dnf install ./CC-Switch-*.rpm |
| openSUSE | .rpm | sudo zypper install ./CC-Switch-*.rpm |
| Arch Linux / Manjaro | .AppImage | Add execute permission and run directly, or use AUR |
| Other distributions / Unsure | .AppImage | chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage |