📖 教程 · 8 分钟读完 · 2026-07-24

Lobe Chat 快速上手教程（GitHub README 中文整理）

从 Lobe Chat 官方 GitHub README 翻译整理的快速上手指南。

Lobe Chat Agents Index 快速上手

是什么

Lobe Chat Agents Index 是 Lobe Chat 官方维护的智能体（Agent）索引仓库。它收集了社区贡献的各种 AI 助手配置，让用户可以直接在 Lobe Chat 中一键加载和使用这些预设角色。

这个项目托管在 GitHub 上（lobehub/lobe-chat-agents），所有智能体配置以 JSON 格式存储在 agents 目录中。Lobe Chat 客户端会从该仓库拉取索引，展示可用的智能体列表。

能干什么

通过这个索引，你可以：

发现预设智能体：浏览社区贡献的各种角色，比如龟汤游戏主持人、美食评论家、学术写作助手、Minecraft 开发专家、开源许可证分析师等
一键加载使用：在 Lobe Chat 中直接选择并启用这些智能体，无需手动配置
提交自己的智能体：如果你有好的角色设定，可以提交到索引中分享给社区
自托管部署：可以将整个索引部署到自己的服务器上

怎么装

Lobe Chat Agents Index 不需要单独安装。它作为 Lobe Chat 的内置功能，当你部署 Lobe Chat 后，会自动从该仓库加载智能体列表。

部署 Lobe Chat 到 Vercel

如果你想自托管 Lobe Chat（包括智能体索引），推荐部署到 Vercel：

访问 Lobe Chat GitHub 仓库
点击 "Deploy to Vercel" 按钮
按照 Vercel 的引导完成部署
部署完成后，智能体索引会自动生效

本地开发

如果你想在本地运行和开发：

# 克隆仓库
git clone https://github.com/lobehub/lobe-chat-agents.git

# 进入目录
cd lobe-chat-agents

# 安装依赖
npm install

# 启动开发服务器
npm run dev

怎么用第一个例子

提交一个智能体

如果你想向索引提交自己的智能体，按照以下步骤操作：

Fork 本仓库
```
# 在 GitHub 上点击 Fork 按钮
```

复制模板文件

# 复制基础模板
cp agent-template.json my-agent.json

# 或者复制完整模板（包含更多参数）
cp agent-template-full.json my-agent.json

编辑配置文件

{
  "author": "你的名字",
  "systemRole": "你的智能体系统提示词",
  "homepage": "https://github.com/你的用户名",
  "identifier": "my-agent",
  "locale": "zh-CN",
  "meta": {
    "title": "智能体名称",
    "description": "简短描述",
    "tags": ["标签1", "标签2"]
  }
}