前两篇我们聊了 Agent 是什么、怎么选工具。很多新手选好了 Agent，结果卡在下一步：怎么搭？为什么跑不通？为什么配了模型它还是不说话？
这篇不讲具体安装命令——每个 Agent 的安装文档都写得很清楚。这篇讲的是搭建的正确顺序和新手最容易踩的坑。
因为踩坑比学技巧更费时间。一个坑卡你两小时，但提前知道只要两分钟。
一、搭 Agent 的正确顺序（不是先装 Agent）
90% 的新手犯的第一个错就是：一上来就装 Agent。
错。正确顺序是这样的：
第一步：准备好 Linux 环境
一台干净的 Debian / Ubuntu / Armbian 系统。更新好软件包，装好 Python、Node.js、git、curl 这些基础工具。确保网络通畅。
第二步：先搞定模型 API
不要先装 Agent 再想模型。先注册一个 API，确认你能调通。DeepSeek、讯飞星火、OpenRouter 都有免费额度可以试。记下三个东西：API Key、Base URL、模型名。这三个后面一定用得到。
第三步：再装 Agent 框架
环境好了、模型准备好了，这时候装 Agent 才顺。装完配好 API Key 和 Base URL，先试一下能不能正常对话。
第四步：完成一个真实小任务
不要装完就开始加各种工具。先让它做一件最简单的事，比如”帮我查看当前磁盘空间”或者”帮我写一个 Hello World 脚本”。能完成一个真实任务，说明基本流程跑通了。
第五步：逐步加工具
终端和文件工具一般默认就有。后面再加浏览器、搜索、消息平台、定时任务这些。一次加一个，加完测试，不要一次加一堆。
这个顺序的核心逻辑是：先确认最基础的东西能跑，再往上加。
很多人一上来就想让 Agent 帮他写文章发 WordPress，结果发现 Agent 都还没配模型，或者环境缺依赖，或者网络不通——一步卡住，后面全白费。
二、5 个新手最容易踩的坑
坑 1：装了 Agent 但没配模型
这是最常见的。Agent 框架和模型是两回事。Agent 是框架，模型是大脑。你装了框架但没给它大脑，它当然什么都做不了。
症状：Agent 安装成功，启动也正常，但一问问题就报错或者不回应。
解法：确认你配好了 API Key 和 Base URL。不同的 Agent 配置方式不同，但本质都是告诉 Agent”用哪个模型、从哪里调用、用什么密钥”。
比如 Hermes Agent 的配置大概长这样：
provider: openrouter # 或 deepseek、anthropic 等
model: deepseek-chat # 模型名
api_key: sk-xxx # 你的 API Key
base_url: https://api.deepseek.com/v1 # API 地址
三个都填对，Agent 才能正常对话。缺一个都不行。
坑 2：权限给太大或者太小
新手容易走两个极端：
极端一：什么权限都不给。 Agent 要读文件你说不行，要跑命令你说不行，要联网你说不行——那它就只能聊天，跟普通 AI 没区别。
极端二：什么权限都给。 Agent 要删文件你就让它删，要改系统配置你就让它改——万一它理解错了你的意思，后果可能是灾难性的。
正确做法：
- 刚开始只给它测试目录的权限，不要让它碰重要数据
- 需要执行命令时，先让它把命令打印出来给你看，确认后再执行
- 慢慢建立信任后再放宽权限
- 涉及删除、覆盖、修改系统配置的操作，始终保持人工确认
拿 Hermes Agent 举例，你可以先限制它只能操作 /home/agent-test/ 下的文件。等确认它做事靠谱了，再逐步开放。
坑 3：期待一次到位
很多人看完 Agent 的宣传视频或文章，以为装好就是全自动管家——写文章、管服务器、自动发布、定时巡检，全自动。
实际上 Agent 是一个逐步进化的过程：
| 阶段 | 能做什么 | 你要做什么 |
|---|---|---|
| 刚装好 | 对话 | 配模型、测试基本功能 |
| 加了终端+文件工具 | 跑命令、读写文件 | 从小任务开始试 |
| 加了浏览器+搜索 | 查资料、看网页 | 给它搜索类的任务 |
| 加了消息平台 | Telegram/QQ 随时接收指令 | 配置消息通道 |
| 加了记忆 | 记住你的偏好 | 整理常用指令和偏好 |
| 加了定时任务 | 自动巡检、定时执行 | 设计巡检流程 |
每个阶段都需要你花时间调试和测试。不要跳步，不要急。先让 Agent 能跑通一个最简单的任务，比什么都重要。
坑 4：不知道怎么选模型
Agent 要接模型，但模型太多了：DeepSeek、GPT-4、Claude、讯飞星火、Qwen、Llama……选哪个？
新手最常见的错误是：上来就选最贵最强的。
正确思路：
- 日常任务：用便宜模型（DeepSeek-V3、Qwen-Plus），速度够快，成本极低
- 复杂任务：用强模型（GPT-4、Claude Sonnet），质量好但贵
- 最好配置主模型 + 备用模型：主模型日常用，备用模型在主模型挂掉时自动接管
这样 Agent 不会因为一个 API 出问题就完全不能用，成本也更可控。
坑 5：不会排错
Agent 跑不通的时候，新手最容易做两件事：
1. 反复重启，希望它自己好
2. 换一个 Agent 框架，觉得是框架的问题
其实 90% 的问题都可以通过看日志解决：
- Agent 启动报错：看启动日志，通常是依赖没装或配置格式错
- 模型调用失败：看 API 返回的错误码——401 是 Key 不对，429 是限流，500 是服务端问题
- 工具执行失败：看工具返回的错误信息，通常是权限不够或路径不对
- Agent 不响应：先检查模型 API 能不能单独调通，再检查网络
排错的基本顺序：模型 API 能通吗 → Agent 能对话吗 → 工具能执行吗 → 权限对吗
从底层往上查，不要一上来就怀疑 Agent 框架有问题。
三、第一次就跑通的最简方案
如果你不想折腾，只想最快跑通一个 Agent，这是我推荐的方案：
硬件：任何能跑 Linux 的机器（2GB 内存就够）
系统：Debian 12 或 Ubuntu 22.04
Agent：Hermes Agent
模型：DeepSeek API（注册送额度，国内直连）
任务：让 Agent 帮你查看当前系统信息
具体步骤：
1. 装 Debian，更新系统
2. 注册 DeepSeek API，拿到 Key
3. 安装 Hermes Agent
4. 配置 DeepSeek 的 API Key 和 Base URL
5. 对 Agent 说：”帮我查看当前系统的磁盘空间、内存使用率和运行时间”
6. 如果它返回了正确结果——恭喜，你的 Agent 跑通了
这整个流程，新手半小时到一小时能搞定。
四、搭好之后，怎么让它进化？
跑通不是终点，是起点。你的 Agent 可以一步步变成更强大的助手：
- 加文件工具：让它能读写文件、编辑代码
- 加浏览器：让它能打开网页、截图、搜索
- 加消息平台：通过 Telegram 或 QQ 随时给它发指令
- 加记忆：让它记住你的偏好和常用配置
- 加定时任务：让它每天自动巡检服务器、检查网站链接
- 加发布工具：让它帮你写文章、配图、发布到 WordPress
每加一个工具，你的 Agent 就能多干一类活。不要一次全加，一个一个来，每次加完都测试一下。
下期预告
下一篇聊：AI Agent 用本地模型还是在线 API？怎么选最省钱。
模型费用是 Agent 长期使用的最大成本。选对了省钱，选错了可能一个月烧几百块。下一篇会帮你算清楚：不同模型的价格、不同使用场景的成本、怎么用混合方案把月花费降到最低。
觉得有用？
- 收藏一下方便下次看
- 留言告诉我你搭建时卡在哪里了
- 关注本站，后面持续更新
本文基于真实 Agent 搭建和使用经验整理。本站用 Hermes Agent 运行，经历过文中提到的每一个坑。
by 数码罗记 · godsun.pro
