AI大模型与Agent实战入门

第二模块：实践操作

第1节：Agent生态全景与选型指南

本节目标

了解当前Agent产品格局
掌握选型原则
理解为什么强烈推荐WSL2

1.1 当前Agent产品格局全景

第一类：本地原生方案

代表：OpenClaw / Hermes Agent

✅ 优点：
- 完全开源，代码透明
- 数据100%本地，隐私安全
- 架构清晰，可深度定制
- 社区活跃，更新快
- 长期演进有保障

⚠️ 缺点：
- 需要一定技术基础
- 需要自己配置环境

第二类：SaaS服务平台

代表：Dify、Coze、扣子、各类云端Agent平台

✅ 优点：
- 开箱即用
- 无需维护环境
- 集成丰富
- 界面友好

⚠️ 缺点：
- 数据在第三方服务器
- 定制能力有限
- 成本随用量上涨
- 被平台锁定

第三类：IDE集成Agent

代表：Claude Code、GitHub Copilot Workspace、Cursor

✅ 优点：
- 深度集成开发环境
- 编程能力强
- 开发者体验好

⚠️ 缺点：
- 主要面向开发者
- 非编程场景能力一般
- 成本较高

第四类：第三方二次开发产品

代表：龙虾、各种Claude桌面封装版、Trae等

✅ 优点：
- 界面好看
- 上手简单

⚠️ 缺点：
- ⚠️ 绝大多数都不成熟
- 功能阉割
- 更新滞后于官方
- 安全隐患（可能偷API Key）
- 无社区支持

1.2 选型建议与理由

✅ 首选：原生OpenClaw / Hermes

核心理由：

架构清晰： 学习成本最低
社区活跃： 遇到问题有人帮
可扩展： 想加什么功能自己加
完全可控： 数据、代码、部署全在自己手里
长期演进： 不会突然跑路或涨价

✅ 可以用：成熟SaaS平台

适用场景：

不想折腾环境
快速验证想法
非核心业务场景

注意：

敏感数据不要上传
核心业务不要依赖

⚠️ 谨慎使用：第三方二次开发封装产品

为什么不推荐：

功能阉割： 很多高级功能用不了
更新滞后： 官方更新后几个月才更
安全隐患： 你的API Key可能被窃取
无社区支持： 出问题没人管
收费陷阱： 免费版吸引，核心功能收费

1.3 Windows用户特别强调：WSL2

为什么强烈建议安装WSL2？

Windows原生开发的痛点：

❌ 路径问题：C:\ vs / 各种不兼容
❌ 权限问题：管理员权限、文件锁定
❌ Python版本：各种版本冲突
❌ 编译问题：C++扩展编译失败
❌ 脚本兼容：bash脚本跑不了

WSL2是什么？

简单说：在Windows里面跑一个真正的Linux

Windows 主机
    ↓
WSL2 虚拟机
    ↓
真正的 Ubuntu / Debian
    ↓
完美的开发环境

好处：

✅ 所有Linux工具直接用
✅ 没有路径问题
✅ 没有权限问题
✅ 性能接近原生Linux

1.4 环境检查清单

课前检查：

[ ] Windows用户：WSL2已安装
[ ] Python 3.10+ 已安装
[ ] Git 已安装
[ ] 网络畅通（能访问PyPI、GitHub）
[ ] 至少一个API Key（OpenAI / DeepSeek / 豆包）

本节小结

四类产品： 原生方案、SaaS、IDE集成、第三方封装
首选： 原生OpenClaw / Hermes
Windows用户： 一定要装WSL2
课前准备： 环境检查清单

AI大模型与Agent实战入门

第二模块：实践操作

第2节：Hermes Agent 安装与基础配置

本节目标

成功安装Hermes Agent
配置至少一个API
完成第一次对话
理解配置文件结构

2.1 安装Hermes Agent

步骤1：安装命令

pip install hermes-agent

常见坑及解决：

坑1：权限问题

# 解决：加--user
pip install hermes-agent --user

坑2：源太慢

# 解决：用国内源
pip install hermes-agent -i https://pypi.tuna.tsinghua.edu.cn/simple

坑3：Python版本不对

# 检查版本
python --version
# 要求：3.10+

2.2 验证安装成功

命令：

hermes --version

预期输出：

hermes-agent, version x.y.z

如果显示"command not found"：

# 解决1：刷新环境变量
source ~/.bashrc  # 或 ~/.zshrc

# 解决2：用python -m调用
python -m hermes --version

2.3 初始化配置向导

命令：

hermes setup

向导会问你：

选择默认模型提供商
输入API Key
配置其他选项

按提示一步步来即可

2.4 API配置详解

支持的API提供商：

提供商	推荐场景	成本
OpenAI (GPT-4o)	通用、高质量	中高
DeepSeek	代码、推理	便宜
字节豆包	中文、速度快	便宜
Anthropic (Claude)	长文本、推理	高

2.5 配置你的第一个API

以DeepSeek为例（推荐新手）：

访问 https://platform.deepseek.com/
注册账号
充值（最低10元，足够用很久）
创建API Key
复制保存好

配置到Hermes：

hermes config set provider deepseek
hermes config set api_key YOUR_API_KEY

2.6 查看配置文件

配置文件位置：

~/.hermes/config.yaml

查看配置：

hermes config list

配置文件结构示例：

provider: deepseek
api_key: sk-xxxxxxxxxxx
model: deepseek-chat
temperature: 0.7
max_tokens: 2000

2.7 第一次对话！

命令：

hermes chat

输入：

你好，请介绍一下你自己

预期：

Agent回复，说明安装成功！

按Ctrl+C退出对话模式

2.8 常用基础命令

# 查看版本
hermes --version

# 查看帮助
hermes --help

# 查看可用模型
hermes model list

# 对话模式
hermes chat

# 单次对话
hermes chat "你好，请讲个笑话"

2.9 第一个Skill体验

步骤：

进入对话模式
输入任务：

帮我写一个Python脚本，计算斐波那契数列

观察Agent的执行过程：
思考过程
调用工具
生成结果
对比：和直接用ChatGPT有什么不同？

2.10 常见问题排查

问题1：API Key无效

错误：Invalid API Key
解决：检查Key是否正确，是否有余额

问题2：网络连接失败

错误：Connection timeout
解决：检查网络、配置代理

问题3：命令找不到

错误：command not found: hermes
解决：确认安装成功，刷新环境变量

本节小结

安装： pip install hermes-agent
初始化： hermes setup
配置API： 推荐DeepSeek（便宜好用）
验证： hermes --version + hermes chat
常用命令： chat、model list、config