Quickstart
五分钟跑起来
从克隆仓库到第一次对话，只需要四步。
环境要求
- Python 3.10+（推荐用 uv 管理依赖）
- 任一模型 API Key（兼容 OpenAI 格式接口的各家模型均可）
- macOS / Linux / Windows 全平台支持
① 克隆与安装
bash
git clone https://github.com/1292917512/AnelfAgent.git cd AnelfAgent uv sync
② 配置模型
bash
cp config/llm_clients.example.json config/llm_clients.json # 编辑 llm_clients.json，填入你的 API Key
③ 启动
bash
./start.sh # 浏览器打开 → http://127.0.0.1:8092/webui/
④ 接入频道（可选）
按需启用频道适配器，让 AI 走进你的消息流：
| 频道 | 方式 | 说明 |
|---|---|---|
| QQ / Telegram 等 | 适配器 | 按需启用对应频道适配器，填入凭证即可 |
| WebUI | 内置 | 开箱即用，无需配置 |
| HTTP / CLI | 内置 | API 与命令行直接对话 |
提示：启动后打开 WebUI 的「状态」面板可以看到所有实体（工具/模型/频道）的注册情况，哪一步没起来一眼就能定位。