OpenClacky Windows 安装指南

Skill 名称: openclacky-install-windows

用途: 帮助 Windows 用户自动安装 OpenClacky。OpenClacky 是一个使用 Ruby 编写的类 OpenClaw 工具，兼容 OpenClaw 生态。

适用场景: 当用户询问如何在 Windows 上安装 OpenClacky、安装 OpenClacky、Windows 环境配置 OpenClacky 时使用此 Skill。

⚠️ Agent 行为约束（必须遵守）

必须读取相关文档再执行 - 每个阶段开始前先读对应的详细文档，严格按文档步骤执行
必须尝试自动执行 - 不允许直接让用户手动执行 PowerShell 命令
必须请求 UAC 提升权限 - 权限不足时使用 Start-Process -Verb RunAs
必须等待用户反馈 - 凡标注"等待确认"的步骤，未收到用户回复前禁止继续
严禁跳过验证 - 每个阶段完成后必须验证结果再继续

完整流程概览

[判定] 前置条件判定（是否跳过阶段一）
[阶段一] 语言环境准备（步骤 0-5）← 详见语言环境设置详细文档（如判定需执行）
[阶段二] WSL 离线安装（步骤 1-5）← 详见 WSL 安装详细文档
[阶段三] 安装 OpenClacky
[阶段四] 恢复语言设置            ← 详见语言环境设置详细文档「恢复」章节（如阶段一有执行）

🔍 前置条件判定（语言设置跳过逻辑）

请严格按以下判定树执行，不要跳过任何判断步骤

判定步骤：

步骤 1 - 检查当前 Agent
如果当前使用的是 minimax agent → 必须执行阶段一的语言设置步骤，直接跳至「阶段一」如果当前使用的不是 minimax agent → 继续步骤 2

步骤 2 - 检测 PowerShell 输出是否乱码
在 PowerShell 中执行：wsl --help 检查输出内容： → 如果输出为乱码（无法正常识别中文）→ 执行阶段一的语言设置步骤 → 如果输出为正常中文（非乱码）→ 跳过阶段一，直接进入阶段二

判定结果记录：

将判定结果告知用户，说明是否需要执行语言设置
如果判定为"跳过"，需向用户解释原因

阶段一：语言环境准备

📖 立即读取 语言环境设置详细文档，按文档中步骤 0-5 逐步执行。

📌 关键约束摘要（详情以详细文档为准）：
- 执行任何操作前，必须先向用户说明临时切换语言的原因并征得同意
- 步骤 0 检测到单语言版本时，必须征得用户同意才能执行版本升级
- 步骤 2 安装语言包后，必须等待用户确认安装完成才能继续
- 步骤 4 重启后，必须等待用户确认已重启才能继续
- 步骤 5 验证必须全部通过（含 wsl --help 英文输出）才能进入阶段二

阶段二：WSL 离线安装

📖 立即读取 WSL 安装详细文档，按文档中步骤 1-5 逐步执行。

📌 关键约束摘要（详情以详细文档为准）：
- 严禁使用 wsl --install 在线安装
- 步骤 1 启用组件重启后，必须等待用户确认已重启才能继续
- 步骤 2 下载 Kernel 后，必须告知用户文件路径并引导手动安装，等待用户确认安装完成

阶段三：安装 OpenClacky

在 WSL 中依次执行：

# 1. 配置清华 apt 镜像源
sudo sed -i 's|http://archive.ubuntu.com/|https://mirrors.tuna.tsinghua.edu.cn/|g' /etc/apt/sources.list
sudo apt update

# 2. 安装基础依赖和 Ruby（走清华源，无需访问 GitHub）
sudo apt install -y curl bash ruby ruby-dev

# 3. 验证 Ruby 安装
ruby -v
gem -v

Ruby 安装成功后继续：

# 4. 替换 gem 源为国内镜像（移除默认源，添加 ruby-china）
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.com/
gem sources -l

确认输出只有 https://gems.ruby-china.com/ 后继续：

# 5. 安装 OpenClacky
sudo gem install openclacky

如果 gem install 失败，尝试用 curl 安装：

curl -sSL https://oss.1024code.com/clacky-ai/openclacky/main/scripts/install.sh | bash

# 6. 验证
openclacky --version

阶段四：恢复语言设置

📖 读取语言环境设置详细文档中的「恢复语言设置」章节执行。