Mac / Windows / Linux 安装指南
选择你的平台，按步骤完成安装，1 分钟即可上手。
macOS
方式一：桌面安装器（推荐）
适合所有用户，双击即装，无需命令行。
- 下载 macOS 安装包：openclacky-installer.dmg
- 双击
.dmg文件，将 OpenClacky 拖入 Applications 文件夹 - 打开 OpenClacky，服务自动启动
- 点击「在浏览器中打开」进入 Web UI
支持 Apple Silicon（M1/M2/M3）和 Intel 两种芯片。
方式二：命令行安装
适合开发者或偏好命令行的用户。打开终端，运行：
/bin/bash -c "$(curl -sSL https://oss.1024code.com/clacky-ai/openclacky/main/scripts/install.sh)"
脚本自动安装 Ruby 和 OpenClacky。
安装完成后，有两种启动方式：
1. WebUI 方式（推荐新手）
启动本地服务器：
openclacky server
然后在浏览器访问：http://127.0.0.1:7070
2. CLI 方式（命令行交互）
直接在终端对话：
openclacky
Windows
系统要求：Windows 10 版本 2004（内部版本 19041）或更高版本，或 Windows 11
方式一：桌面安装器（推荐）
适合所有用户，一键完成安装。
- 下载 Windows 安装包：openclacky-installer.exe
- 双击安装包，按提示完成安装
- 从开始菜单或桌面快捷方式启动 OpenClacky
- 点击「在浏览器中打开」进入 Web UI
如果 Windows 弹出「未知发布者」提示，点击「仍要运行」即可。
方式二：命令行安装（PowerShell）
适合开发者，打开 PowerShell 运行：
powershell -c "& ([scriptblock]::Create((irm 'https://oss.1024code.com/clacky-ai/openclacky/main/scripts/install.ps1')))"
安装完成后，有两种启动方式：
1. WebUI 方式（推荐新手）
启动本地服务器：
openclacky server
然后在浏览器访问：http://127.0.0.1:7070
2. CLI 方式（命令行交互）
直接在终端对话：
openclacky
Linux
Linux 暂无桌面安装器，使用命令行安装。
命令行安装
打开终端，运行：
/bin/bash -c "$(curl -sSL https://oss.1024code.com/clacky-ai/openclacky/main/scripts/install.sh)"
脚本自动安装 Ruby 和 OpenClacky。
安装完成后，有两种启动方式：
1. WebUI 方式（推荐新手）
启动本地服务器：
openclacky server
然后在浏览器访问：http://127.0.0.1:7070
2. CLI 方式（命令行交互）
直接在终端对话：
openclacky
支持 Ubuntu 20.04+、Debian 11+、CentOS 8+ 等主流发行版。
安装完成后：配置 AI Key
首次启动会引导你配置 AI Key。OpenClacky 支持以下 AI Provider：
- OpenClacky — 推荐首选，自家托管，零配置直接购买 →
- Anthropic (Claude) — 效果最佳，推荐 claude-sonnet-4.6
- Kimi (Moonshot) — 国内直连，kimi-k2.5
- Minimax — 国内直连，MiniMax-M2.7
- GLM (ZhipuAI) — 智谱 AI，GLM-5.1
- MiMo (Xiaomi) — 小米大模型
- OpenRouter — 聚合多模型，一个 Key 用遍主流模型
在 Web UI 的 Settings → AI Keys 中填入你的 API Key 即可开始使用。
如何卸载
如需完全卸载 OpenClacky，运行卸载脚本即可：
/bin/bash -c "$(curl -sSL https://oss.1024code.com/clacky-ai/openclacky/main/scripts/uninstall.sh)"
卸载脚本会：
- 移除 OpenClacky 命令行工具和所有依赖
- 询问是否保留配置文件（API Keys、Skill 等）
- 自动清理安装过程中的临时文件
提示：桌面安装器用户也可以直接使用上述命令卸载。macOS 用户也可以从 Applications 文件夹中拖入垃圾桶。