# Freebuff

為 Freebuff 安裝 Felo Skill；它與 Cline 共用 ~/.agents/skills。

使用本指南為 Freebuff 安裝 Felo Skill。Freebuff 沒有自己的設定檔：它讀取共用的 `~/.agents/skills` 目錄，與 Cline 的目標相同；模型仍使用 Freebuff 原本的模型。

## 開始之前

- 一組 Felo API 金鑰：[建立一組](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 沒有模型／供應商設定；設定 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 時驗證失敗 | 建立新的金鑰，執行 `feloapi auth login`（或匯出 `FELO_API_KEY`）。 |
| Felo 模型沒有回應 | 檢查上方的手動供應商欄位；Base URL 和金鑰必須一致。 |

## 相關

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