🌱 初级入门教程

hermes config set OPENAI_API_KEY sk-your-api-key-here
hermes config set OPENAI_BASE_URL https://api.xidao.online/v1

# 验证
hermes config check

# 创建配置目录
mkdir -p ~/.hermes

# 写入环境变量
cat > ~/.hermes/.env << 'EOF'
OPENAI_API_KEY=sk-your-api-key-here
OPENAI_BASE_URL=https://api.xidao.online/v1
EOF

# 设置文件权限（仅本人可读）
chmod 600 ~/.hermes/.env

# 验证
hermes config check

# 临时设置（关闭终端后失效）
export OPENAI_API_KEY=sk-your-api-key-here
export OPENAI_BASE_URL=https://api.xidao.online/v1

# 持久化（写入 shell 配置文件）
echo 'export OPENAI_API_KEY=sk-your-api-key-here' >> ~/.bashrc
echo 'export OPENAI_BASE_URL=https://api.xidao.online/v1' >> ~/.bashrc
source ~/.bashrc

# 启动配置向导
openclaw onboard

# 向导步骤：
# 1. 选择 Provider → Custom Provider
# 2. 输入 Base URL → https://api.xidao.online/v1
# 3. 粘贴 API Key → sk-your-api-key-here
# 4. 选择默认模型 → anthropic/claude-sonnet-4
# 5. 确认保存

openclaw config set XIDAO_API_KEY sk-your-api-key-here
openclaw config set base_url https://api.xidao.online/v1
openclaw config set default_model anthropic/claude-sonnet-4

# 验证
openclaw config show

// ~/.openclaw/config.json
{
  "provider": "custom",
  "base_url": "https://api.xidao.online/v1",
  "api_key": "sk-your-api-key-here",
  "default_model": "anthropic/claude-sonnet-4",
  "fallback_models": [
    "openai/gpt-5.1",
    "google/gemini-2.5-flash"
  ],
  "max_tokens": 8192,
  "temperature": 0.7
}

# 交互式对话（最常用）
hermes chat

# 指定模型
hermes chat --model anthropic/claude-sonnet-4

# 单次问答（不进入交互模式）
hermes chat --print "你好，请介绍一下你自己"

# 管道模式（结合其他命令）
echo "分析这段代码的问题" | hermes chat --print

# 指定系统提示
hermes chat --system "你是一个 Python 专家" --print "如何优化列表推导式"

# 启动 Gateway 服务（必须先启动）
openclaw gateway start

# 命令行对话
openclaw chat

# 指定模型
openclaw chat --model anthropic/claude-sonnet-4

# Web 控制面板（更直观）
openclaw dashboard
# 浏览器打开 http://localhost:18789

# 查看 Gateway 状态
openclaw gateway status

# 停止 Gateway
openclaw gateway stop

# 任务1: 让 Agent 分析当前目录
> 请分析当前目录的项目结构，告诉我这是什么类型的项目

# 任务2: 让 Agent 读写文件
> 读取 package.json 文件，告诉我项目用了哪些依赖

# 任务3: 让 Agent 执行代码
> 用 Python 计算斐波那契数列的前 20 项

# 任务4: 让 Agent 搜索信息
> 搜索 Python 3.13 的新特性

# 任务5: 让 Agent 操作 Git
> 查看最近的 Git 提交记录

# 组合使用：读取 → 分析 → 修改
> 读取 src/utils.py，找到 calculate 函数，添加参数校验

# 批量操作
> 搜索所有 .tsx 文件中的 console.log 并删除

# 创建项目结构
> 创建一个新的 Express 项目结构：
> - src/
>   - routes/
>   - middleware/
>   - utils/
> - tests/
> - package.json

# 数据处理
> 用 Python 读取 data.csv，计算每列的平均值

# 安装依赖并使用
> 安装 requests 库，然后获取 https://api.example.com/data 的内容

# 系统操作
> 运行 df -h 查看磁盘使用情况

# 调试代码
> 运行 python tests/test_main.py 并分析失败的测试

# 搜索信息
> 搜索 Python 3.13 的新特性
> 搜索 Next.js 15 App Router 最佳实践

# 获取网页内容
> 获取 https://docs.python.org/3/whatsnew/3.13.html 的内容并总结

# API 调用
> 调用 https://api.github.com/repos/modelcontextprotocol/servers 获取仓库信息

# 技术文档查询
> 查找 FastAPI 的依赖注入用法

# 查看状态
> 查看 Git 状态和最近的提交
> 显示 main 和 feature 分支的差异

# 提交代码
> 暂存所有修改并提交，消息为 "feat: 添加用户认证"
> 修改最后一次提交的消息为 "fix: 修复登录 Bug"

# 分支管理
> 创建并切换到 feature/auth 分支
> 将 feature/auth 分支合并到 main

# 历史搜索
> 搜索包含 "fix" 的提交记录
> 查看谁修改了 src/auth.py 文件

# ~/.hermes/SOUL.md - 自定义 Agent 身份

你是一个经验丰富的全栈工程师，专精于：
- TypeScript / React / Next.js 前端开发
- Python / FastAPI 后端开发
- PostgreSQL 数据库设计

编码规范：
- 使用函数式组件和 Hooks
- 优先使用 const 和箭头函数
- 变量命名使用 camelCase
- 组件文件使用 PascalCase

沟通风格：
- 简洁直接，不废话
- 先给方案，再解释原因
- 代码示例优先