# Freebuff

为 Freebuff 安装 Felo Skill；它与 Cline 共享 ~/.agents/skills。

使用本指南为 Freebuff 安装 Felo Skill。Freebuff 没有自己的配置文件：它读取共享的 `~/.agents/skills` 目录，与 Cline 的目标相同；模型仍使用 Freebuff 原本的模型。

## 开始之前

- 一个 Felo API key：[创建一个](https://openapi.felo.ai/console/api-keys)。
- 如果要使用 FeloAPI CLI，需要 [Node.js 22 或更高版本](https://nodejs.org/en/download)。
- 已安装 Freebuff。

## 本指南会配置什么

| 项目 | 值 |
| --- | --- |
| 模型提供方 | 保持不变（沿用你现有的 Freebuff 模型） |
| Felo Skill 位置 | `~/.agents/skills` |
| 可选 Felo 模型所用协议 | OpenAI-compatible |

## 方式一：安装 Felo Skill

```bash
npm install -g feloapi-cli@latest
feloapi setup --agent freebuff --skills-only --yes
```

这里只安装 Skill，不会修改 Freebuff 的模型提供方。开一个新的 Freebuff 会话，然后让它使用 `feloapi` Skill，例如：“用 feloapi skill 搜索今天的 AI 新闻并总结一下。”Freebuff 没有模型／provider 配置；配置 Cline 或 Freebuff 写入的是同一个共享 Skill。

## 验证

```bash
feloapi doctor --agent freebuff
```

报告里 `freebuff` 显示 `ok: true`，就说明 Skill 状态正常。

## 切回／移除 Felo

当前模型提供方没有被改动，因此无需切回。如需移除 Skill：

```bash
feloapi disconnect freebuff --yes
```

## 故障排查

| 问题 | 处理方式 |
| --- | --- |
| `feloapi: command not found` | 重新打开终端再试；或运行 `npm install -g feloapi-cli@latest` 重新安装。 |
| Skill 没有被使用 | 开一个新的 Freebuff 会话；Skill 只在启动时才会被识别。 |
| Skill 调用 Felo 时认证失败 | 新建一个 key，运行 `feloapi auth login`（或导出 `FELO_API_KEY`）。 |
| Felo 模型没有响应 | 检查上面的手动 provider 字段；Base URL 和 key 必须一致。 |

## 相关

- [FeloAPI CLI 指南](https://openapi.felo.ai/zh-CN/docs/cli.md)
- [模型与价格](https://openapi.felo.ai/zh-CN/docs/guides/models-and-pricing.md)
- [其他 AI 工具](https://openapi.felo.ai/zh-CN/docs/agent-clients/other-tools.md)