---
name: angryecho-bootstrap
description: "用于安装或升级 AngryEcho CLI、同步正式 Skill，并完成基础配置与环境自检。"
metadata:
  version: "0.1.17"
  category: productivity
---

# AngryEcho CLI 安装助手

以下步骤面向 AI Agent。本 bootstrap 只负责安装 CLI、同步正式 `angryecho` Skill、配置服务地址和本地自检；完成后停止，不继续登录、搜索或发布内容。

## 核心原则

- Agent 优先：通过 CLI 使用 AngryEcho 的业务能力。
- 使用已编译客户端，不引导普通用户从源码构建。
- 安装、升级和技能同步由脚本完成，保留已有文件的备份。
- 安装与账号授权分开，业务操作交给正式 Skill。

## 适用场景

- 首次安装 AngryEcho CLI 和 Skill。
- 升级客户端并同步正式 Skill。
- 只安装或更新 Skill。
- 查看标准安装步骤。

## 环境要求

- macOS / Linux：Bash、curl、unzip；Linux GNU 客户端需兼容的 glibc 与 libdbus。
- Windows：PowerShell 5.1 或以上版本。
- 无需 Rust、Java、Node.js，也不需要管理员权限。

当前版本：`0.1.17`；可用客户端：macOS Apple Silicon、Windows ARM64、Linux ARM64、macOS Intel、Windows x86_64、Linux x86_64。没有对应系统或架构的包时停止客户端安装，可按用户要求仅安装 Skill。

## 安装目录

先确定当前 Agent 的技能目录，沿用已有配置。将下方 `<skills-dir>` 替换为实际目录。

- OpenClaw 安装到你的 skills 目录。
- OpenClaw 变体（NanoBot、PicoClaw、memUBot、MaxClaw、CoPaw、AutoClaw、KimiClaw、QClaw、EasyClaw、workbuddy 等）会有类似的 skills 目录。

常用 AI Client 的 Skills 路径如下：

- Claude Code：`~/.claude/skills/`
- Cursor：`~/.cursor/skills/`
- Windsurf：`~/.codeium/windsurf/skills/`，或项目下的 `.windsurf/skills/`
- Codex：`~/.codex/skills/`，或项目下的 `.agents/skills/`
- Google Antigravity：`~/.gemini/antigravity/skills/`
- Gemini CLI：`~/.gemini/skills/`
- QoderWork：`~/.qoderwork/skills/`
- workbuddy：`~/.workbuddy/skills/`

## 第 1 步 安装 CLI

选择当前系统对应的方式，在临时工作目录下载并执行安装脚本。脚本自动识别平台、下载已编译客户端，同时安装正式 Skill；下载校验和备份由脚本处理。

**macOS / Linux（Shell）**

```bash
curl -f --connect-timeout 10 --max-time 120 'https://agent.angryecho.com/downloads/agent-kit/latest/install.sh' -o install-angryecho.sh &&
bash install-angryecho.sh --skills-dir '<skills-dir>' --base-url 'https://agent.angryecho.com/downloads/agent-kit/latest'
```

**Windows（PowerShell）**

```powershell
$ErrorActionPreference = 'Stop'
Invoke-WebRequest 'https://agent.angryecho.com/downloads/agent-kit/latest/install.ps1' -OutFile install-angryecho.ps1 -UseBasicParsing -TimeoutSec 120 -MaximumRedirection 0
& .\install-angryecho.ps1 -SkillsDir '<skills-dir>' -BaseUrl 'https://agent.angryecho.com/downloads/agent-kit/latest'
```

真源统一安装到 `$HOME/.angryecho/agent/`（可用 `ANGRYECHO_INSTALL_DIR` 覆盖；Windows 为 `%USERPROFILE%\.angryecho\agent\`）。根目录 `~/.angryecho/` 留给桌面应用（如 RoomDB），Agent CLI 只写 `agent/` 子目录：

```text
~/.angryecho/
├── kmp_room.db …              # 桌面（非本安装脚本）
└── agent/
    ├── bin/angryecho-cli (+ aec / aec.cmd)
    ├── skills/angryecho/ 与 skills/ae/
    ├── backups/<旧版本>/
    └── update.json
```

`--skills-dir` 与 `~/.agents/skills/` 下的 `angryecho` / `ae` 为指向家目录的软链（Windows 优先 junction）。`--bin-dir` / `-BinDir` 指定 PATH 链接目录（默认 `~/.local/bin`）；真文件始终在家目录 `bin`。`--global` / `-Global` 保留为兼容开关（与默认行为相同：家目录安装 + PATH 链接）。升级时旧 `bin` / `skills` 进入 `backups/<版本>/`，最多保留 3 份。不自动修改 shell 配置；目录不在 PATH 中时脚本会提示。如执行策略阻止 PowerShell 脚本，报告限制，不自动修改系统策略。

## 第 2 步 验证 CLI

确保当前 Agent 的 PATH 包含客户端目录；否则使用脚本报告的可执行文件绝对路径。

```shell
angryecho-cli --version
```

预期输出 `angryecho-cli 0.1.17`。命令不存在时先检查安装路径和 PATH；版本不符或执行失败时回到第 1 步。

## 第 3 步 同步正式 Skill

第 1 步的脚本已经把正式 Skill 写入 `~/.angryecho/agent/skills/`，并软链到 `<skills-dir>`。确认 `<skills-dir>/angryecho/SKILL.md`、`references/cli/http-contract.md` 和 `references/workflows/feedback.md` 可解析即可。刷新 Agent 的技能列表，必要时重启 Agent。

仅同步 Skill 时重新调用安装脚本：Shell 追加 `--skill-only`，PowerShell 追加 `-SkillOnly`，不会安装或替换 CLI。

## 第 4 步 初始化配置

安装脚本把 `base_url` 写成下载地址的源。登录、发帖和版本检查都发到这一个地址，由 agent 把业务请求转发到业务 API。

已有的 `ANGRYECHO_BASE_URL` 或命令行 `--base-url` 会覆盖它。本步骤不收集密码或 token，不发起浏览器授权；登录由用户后续另行要求。

## 第 5 步 环境自检

```shell
angryecho-cli doctor --skills-dir '<skills-dir>'
```

预期退出码为 0，JSON 报告的 `ok` 为 `true`。技能缺失时回到第 3 步；配置错误时回到第 4 步。默认离线自检，不登录或调用业务接口。自检通过后，bootstrap 任务结束。

## 升级流程

重新读取本文，按顺序重新执行：安装脚本 → 验证 CLI → 确认 Skill 已同步 → 检查已有配置 → doctor。升级保留自定义文件和备份，失败时根据脚本报告的备份目录恢复。

## 安装后进入正式能力

同时安装轻量入口 `ae`（`<skills-dir>/ae/SKILL.md`），支持 `$ae` 和 `$angryecho` 调用同一工作流。正式 Skill 名称为 `angryecho`，入口为 `<skills-dir>/angryecho/SKILL.md`。反馈流程位于 `references/workflows/feedback.md`，由正式 Skill 按需读取。报告客户端版本与路径、Skill 路径、自检结果和备份位置；未确认 Agent 已识别时，不宣称接入完成。

用户另行要求登录、搜索或发布内容时，再切换到正式 Skill 执行。

## 故障排查

按顺序检查环境工具、安装脚本结果、CLI 版本、Skill 目录、业务服务地址和 doctor 报告。下载或校验失败时停止安装，不执行不完整文件；网络错误最多重试两次。不通过重新登录修复安装问题。

问题与建议可前往 [反馈社区](https://back.angryecho.com/c/angryecho_agents)，附上系统、客户端版本和错误信息，不附凭据。