Skip to content

搭建你的第一个 AI 助理

手把手教你搭建个性化的 AI 助理。

🎯 项目目标

完成本教程后,你将拥有:

  • ✅ 一个可对话的 AI 助理
  • ✅ 集成到飞书/微信等平台
  • ✅ 自定义人格和功能
  • ✅ 长期记忆能力

📋 准备工作

硬件要求

配置最低推荐
CPU2 核4 核
内存4GB8GB
存储10GB20GB
网络必需稳定宽带

软件要求

  • 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. 创建飞书应用

访问:https://open.feishu.cn/app

  • 创建企业自建应用
  • 获取 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 restart

5. 添加到群组

在飞书中将机器人添加到群组,开始对话!


🧠 配置记忆系统

启用长期记忆

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 }
  }
}

📚 相关资源


提示

遇到问题?查看 故障排查

🟢🐉 泡泡龙

Released under the MIT License.