搭建你的第一个 AI 助理
手把手教你搭建个性化的 AI 助理。
🎯 项目目标
完成本教程后,你将拥有:
- ✅ 一个可对话的 AI 助理
- ✅ 集成到飞书/微信等平台
- ✅ 自定义人格和功能
- ✅ 长期记忆能力
📋 准备工作
硬件要求
| 配置 | 最低 | 推荐 |
|---|---|---|
| CPU | 2 核 | 4 核 |
| 内存 | 4GB | 8GB |
| 存储 | 10GB | 20GB |
| 网络 | 必需 | 稳定宽带 |
软件要求
- Node.js 20+
- Git
- 一个 AI 模型 API
🚀 快速开始
步骤 1:安装 OpenClaw
bash
npm install -g openclaw步骤 2:配置模型
bash
openclaw configure选择 ModelStudio(通义千问),输入 API Key。
步骤 3:创建工作区
bash
mkdir -p ~/my-agent
cd ~/my-agent步骤 4:定义人格
创建 SOUL.md:
markdown
# SOUL.md
- **Name:** 小助手
- **Creature:** AI 助理
- **Vibe:** 友好/专业
- **Emoji:** 🤖步骤 5:启动
bash
openclaw gateway start💬 集成到飞书
1. 创建飞书应用
- 创建企业自建应用
- 获取 App ID 和 App Secret
2. 配置权限
添加以下权限:
- 发送消息
- 接收消息
- 群组机器人
3. 配置 OpenClaw
编辑 ~/.openclaw/openclaw.json:
json
{
"channels": {
"feishu": {
"enabled": true,
"appId": "cli_xxxxx",
"appSecret": "xxxxx",
"connectionMode": "websocket"
}
}
}4. 重启网关
bash
openclaw gateway restart5. 添加到群组
在飞书中将机器人添加到群组,开始对话!
🧠 配置记忆系统
启用长期记忆
json
{
"memory": {
"enabled": true,
"type": "vector",
"maxEntries": 1000
}
}记忆文件
memory/main.sqlite- 向量数据库MEMORY.md- 长期记忆文本
🛠️ 添加自定义技能
创建技能文件
bash
mkdir -p ~/.openclaw/skills/weather创建 SKILL.md:
markdown
# Weather Skill
获取天气预报。
## Usage天气 北京
## Implementation
```bash
curl wttr.in/北京
### 启用技能
```bash
openclaw skills enable weather📊 监控与维护
查看状态
bash
openclaw status查看日志
bash
openclaw logs --follow备份配置
bash
tar -czf agent-backup.tar.gz \
~/.openclaw/workspace \
~/.openclaw/openclaw.json🎯 进阶优化
1. 性能优化
json
{
"agents": {
"maxConcurrent": 4,
"compaction": {
"mode": "safeguard"
}
}
}2. 安全加固
json
{
"gateway": {
"bind": "loopback",
"auth": {
"mode": "token"
}
}
}3. 多平台集成
json
{
"channels": {
"feishu": { "enabled": true },
"telegram": { "enabled": true },
"discord": { "enabled": true }
}
}