AI大模型与Agent实战入门

学员手册

目录

  1. 课前准备
  2. 命令速查表
  3. 常见问题FAQ
  4. 环境配置脚本
  5. 扩展学习资源

1. 课前准备

gantt title AI Agent 课程学习路径 dateFormat HH axisFormat %H:%M section 第一模块 大模型原理与幻觉 :done, des1, 00, 60min OpenClaw架构讲解 :done, des2, after des1, 60min section 第二模块 Hermes安装与配置 :active, des3, 02:00, 60min Skill实战练习 : des4, after des3, 60min 企业应用集成 : des5, after des4, 90min 服务器管理演示 : des6, after des5, 30min section 认证考试 理论考试 : exam1, 06:00, 30min 实操考核 : exam2, after exam1, 30min

1.1 硬件要求

1.2 软件要求

1.3 Windows用户必看：WSL2安装

方法1：一键安装（推荐）

# 以管理员身份打开PowerShell
wsl --install

方法2：手动安装

# 启用WSL功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 启用虚拟机平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 下载并安装WSL2内核更新包
# 重启电脑
# 设置WSL2为默认版本
wsl --set-default-version 2

# 安装Ubuntu
wsl --install -d Ubuntu

验证安装

wsl --list --verbose
# 应该看到：Ubuntu Running version 2

1.4 API Key准备

推荐：DeepSeek（性价比最高）

  1. 访问：https://platform.deepseek.com/
  2. 注册账号
  3. 充值：最低10元，足够用2-3个月
  4. 创建API Key
  5. 复制保存（只显示一次！）

备选：字节豆包（国内访问快）

  1. 访问：https://console.volcengine.com/ark/
  2. 注册账号
  3. 创建API Key

备选：OpenAI（能力最强）

  1. 需要海外手机号
  2. 需要魔法
  3. 成本较高

2. 命令速查表

2.1 Hermes基础命令

命令 功能
hermes --version 查看版本
hermes --help 查看帮助
hermes setup 初始化配置向导
hermes chat 进入对话模式
hermes chat "问题" 单次对话
hermes config list 查看所有配置
hermes config set key value 设置配置项
hermes config get key 获取配置项

2.2 模型相关命令

命令 功能
hermes model list 查看所有可用模型
hermes model set provider 设置默认模型提供商
hermes model set model-name 设置默认模型

2.3 Skill相关命令

命令 功能
hermes skills list 查看所有Skill
hermes skills list --installed 查看已安装Skill
hermes skills search 关键词 搜索Skill
hermes skills install skill-name 安装Skill
hermes skills uninstall skill-name 卸载Skill
hermes skills info skill-name 查看Skill详情

2.4 常用Linux命令

命令 功能
pwd 查看当前目录
ls -la 列出所有文件
cd 目录名 切换目录
mkdir 目录名 创建目录
rm 文件名 删除文件
rm -rf 目录名 删除目录（小心！）
cat 文件名 查看文件内容
nano 文件名 编辑文件
python --version 查看Python版本
pip list 查看已安装Python包

2.5 Git常用命令

命令 功能
git --version 查看Git版本
git clone 仓库地址 克隆代码仓库
git status 查看状态
git add 文件名 添加文件
git commit -m "消息" 提交
git push 推送
git pull 拉取

3. 常见问题FAQ

3.1 安装相关问题

Q1: pip install hermes-agent 报错怎么办？

A: 尝试以下方法：

方法1：用国内源

pip install hermes-agent -i https://pypi.tuna.tsinghua.edu.cn/simple

方法2：升级pip

pip install --upgrade pip
pip install hermes-agent

方法3：用--user安装

pip install hermes-agent --user

Q2: 输入 hermes 提示 command not found

A: 原因是Python的bin目录不在PATH里

解决方法：

Linux/macOS：

# 把以下内容加到 ~/.bashrc 或 ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"

# 然后刷新
source ~/.bashrc  # 或 source ~/.zshrc

Windows (WSL2)：

# 在WSL终端执行
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

验证：

which python
which pip
# 确认路径正确

Q3: Python版本不够怎么办？

A: 要求Python 3.10+

检查版本：

python --version
python3 --version

如果版本不够：

Ubuntu/WSL2：

sudo apt update
sudo apt install python3.10 python3.10-pip
python3.10 -m pip install hermes-agent

macOS：

brew install python@3.10

3.2 API相关问题

Q4: API Key无效怎么办？

A: 检查以下几点：

  1. Key是否正确复制（有没有多复制空格）
  2. Key是否还有余额
  3. Key是否被禁用
  4. 网络是否能访问API服务器

测试命令：

curl https://api.deepseek.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

如果返回401，说明Key有问题；如果超时，说明网络问题。

Q5: API连接超时怎么办？

A: 配置代理（如果你有代理的话）

# 临时配置
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# 永久配置（加到 ~/.bashrc）
echo 'export HTTP_PROXY=http://127.0.0.1:7890' >> ~/.bashrc
echo 'export HTTPS_PROXY=http://127.0.0.1:7890' >> ~/.bashrc

或者在Hermes配置里设置：

hermes config set proxy http://127.0.0.1:7890

3.3 Skill相关问题

Q6: Skill安装失败怎么办？

A: 检查网络，或者手动安装：

# 方法1：重试（可能是网络波动）
hermes skills install skill-name

# 方法2：查看详细错误
hermes skills install skill-name --debug

Q7: Skill执行没反应怎么办？

A: 确保对话中明确提到Skill名称：

❌ 错误："帮我设计一个功能"
✅ 正确："使用brainstorming skill帮我设计一个功能"

3.4 集成相关问题

Q8: 飞书API调用失败怎么办？

A: 检查：

  1. App ID和App Secret是否正确
  2. 应用是否已发布（未发布只能自己用）
  3. 应用权限是否开通（需要申请相应权限）
  4. IP白名单是否配置

Q9: 微信登录失败/掉线怎么办？

A: 微信机器人常见问题：

  1. 扫码后没反应 → 重试，可能是网络问题
  2. 频繁掉线 → 正常，微信限制，需要重登
  3. 被微信封号 → 不要频繁发消息，控制频率

3.5 其他问题

Q10: Agent执行命令卡死了怎么办？

A: 按 Ctrl+C 中断，或者：

# 另开一个终端，杀死进程
pkill -f hermes

Q11: 怎么重置所有配置？

A: 删除配置目录：

# 注意：这会删除所有配置！
rm -rf ~/.hermes

# 然后重新初始化
hermes setup

Q12: Windows和WSL2怎么传文件？

A: WSL2可以直接访问Windows文件

# Windows的C盘在 /mnt/c/
cd /mnt/c/Users/你的用户名/Desktop
ls

# 把文件复制到Windows桌面
cp 文件名 /mnt/c/Users/你的用户名/Desktop/

4. 环境配置脚本

4.1 WSL2一键配置脚本

保存为 setup-wsl.sh：

#!/bin/bash
# WSL2环境一键配置脚本

echo "=== 开始配置WSL2环境 ==="

# 更新系统
echo "[1/5] 更新系统软件包..."
sudo apt update && sudo apt upgrade -y

# 安装基础工具
echo "[2/5] 安装基础工具..."
sudo apt install -y git curl wget vim nano build-essential

# 安装Python
echo "[3/5] 安装Python 3.10..."
sudo apt install -y python3.10 python3.10-pip python3.10-venv

# 配置pip源
echo "[4/5] 配置pip国内源..."
mkdir -p ~/.config/pip
cat > ~/.config/pip/pip.conf << EOF
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
EOF

# 安装Hermes
echo "[5/5] 安装Hermes Agent..."
pip install hermes-agent --user

# 配置PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

echo ""
echo "=== 配置完成 ==="
echo "请执行：source ~/.bashrc"
echo "然后执行：hermes --version 验证安装"
echo "然后执行：hermes setup 进行初始化配置"

使用方法：

chmod +x setup-wsl.sh
./setup-wsl.sh

5. 扩展学习资源

5.1 官方文档

5.2 大模型学习资源

5.3 Agent相关论文

5.4 社区交流

培训后反馈

如果在培训中遇到问题，或者有改进建议，欢迎反馈！

培训师联系方式：
- 邮箱：xxx@example.com
- 微信：xxxxxx

附录：考试知识点清单

理论题考点（30题）

  1. 大模型核心工作原理
  2. 幻觉的定义与产生原因
  3. 约束幻觉的两种方法
  4. 六大模型类型及分工
  5. OpenClaw五层架构
  6. Agent的核心闭环
  7. Skill的作用与价值
  8. MCP协议的作用
  9. 安全最佳实践
  10. 多API配置的意义

实践题考点

  1. Hermes安装命令
  2. 查看版本命令
  3. 配置API命令
  4. Skill安装命令
  5. 对话模式使用

祝学习愉快！🚀