🚀 快速开始
欢迎使用 AI Agent！这个指南将帮助你在 15 分钟内完成安装和配置。
前置要求
- Node.js 18+ 或 20+
- Windows / macOS / Linux
- 一个 AI 模型 API key（Claude / GPT / Gemini）
💡 提示： 本项目基于 OpenClaw 构建。如果你还没有安装 OpenClaw，请先访问
OpenClaw 官方文档。
📦 安装
1 安装 OpenClaw
npm install -g openclaw
2 初始化配置
openclaw configure
按照提示完成基础配置：
- 选择 Gateway 运行模式（本地/远程）
- 配置 AI 模型和 API key
- 设置工作空间路径
3 启动 Gateway
openclaw gateway start
4 验证安装
openclaw status
如果看到 Gateway 状态为 "reachable"，说明安装成功！
⚙️ 配置
配置文件位置
OpenClaw 的配置文件位于：
~/.openclaw/openclaw.json
基础配置示例
{
"agents": {
"defaults": {
"model": {
"primary": "anthropic/claude-sonnet-4"
},
"workspace": "~/.openclaw/workspace"
}
},
"web": {
"braveApiKey": "your-brave-api-key"
}
}
配置 Brave Search API
获取免费 API key：
- 访问 Brave Search API
- 注册并获取 API key
- 在配置文件中添加
web.braveApiKey
⚠️ 注意： 修改配置文件后需要重启 Gateway 才能生效。
🔧 技能安装
克隆技能库
将本项目的技能文件复制到你的工作空间：
cd ~/.openclaw/workspace
mkdir skills
# 复制 skills/ 目录下的所有文件
可用技能
- 记忆系统 - 长期记忆和知识积累
- Heartbeat 自动巡检 - 7×24 主动监控
- 网页搜索 - Brave Search API 集成
- 深度研究 - 多源分析和报告
- 浏览器控制 - 网页自动化
- 语音合成 - 文字转语音
- 飞书卡片 - 互动消息
- 多 Agent 团队 - 团队协作
查看完整技能列表：技能商店
📘 使用指南
启动 Agent
通过飞书、Telegram、WhatsApp 等渠道与 Agent 对话。
基础命令
/status- 查看 Agent 状态/help- 查看帮助信息/reasoning on- 开启推理模式
使用技能
直接用自然语言告诉 Agent 你的需求：
搜索一下今天的科技新闻
深度研究 AI Agent 的发展趋势
用语音说：今天天气不错
发个投票让大家选择聚餐地点
配置 Heartbeat
编辑 workspace/HEARTBEAT.md 添加定期检查任务：
### 邮件检查（每 2 小时）
- 检查未读邮件
- 标记重要邮件
- 紧急邮件立即通知
### 日历检查（每天早上 8 点）
- 查看今天的日程
- 提醒即将到来的会议
❓ 常见问题
Q: 如何重启 Gateway？
openclaw gateway restart
Q: 如何查看日志？
openclaw logs --follow
Q: 如何更新 OpenClaw？
openclaw update
Q: Agent 不响应怎么办？
- 检查 Gateway 状态：
openclaw status - 查看日志：
openclaw logs - 重启 Gateway：
openclaw gateway restart - 检查 API key 是否正确配置
Q: 如何配置多个 Agent？
参考 多 Agent 团队配置 技能文档。
Q: 数据存储在哪里？
所有数据都存储在本地工作空间：~/.openclaw/workspace
💡 更多帮助：