30 分钟快速搭建 AI 项目

从零开始，30 分钟搭建一个可用的 AI 应用。

---

🎯 项目目标

完成一个飞书集成 AI 助理：

• ✅ 可以对话
• ✅ 自动回答问题
• ✅ 集成到飞书群
• ✅ 24 小时在线

---

⏱️ 时间分配

步骤	时间	内容
1	5 分钟	环境准备
2	10 分钟	OpenClaw 配置
3	10 分钟	飞书集成
4	5 分钟	测试上线

---

📋 前置要求

• ✅ 有服务器（本机或云主机）
• ✅ 已安装 Node.js 20+
• ✅ 有飞书账号
• ✅ 有 AI 模型 API Key

---

步骤 1：环境准备（5 分钟）

1.1 安装 OpenClaw

npm install -g openclaw

1.2 验证安装

openclaw --version
# 应该显示版本号

1.3 准备 API Key

访问 ModelStudio 获取 API Key。

---

步骤 2：OpenClaw 配置（10 分钟）

2.1 初始化配置

openclaw configure

按提示选择：

• 模型提供商：ModelStudio
• 输入 API Key
• 工作区路径：默认

2.2 验证配置

openclaw status

应该显示：

Gateway: running
Models: configured
Channels: ready

2.3 定义人格

编辑 ~/.openclaw/workspace/SOUL.md：

# SOUL.md

- **Name:** AI 助理
- **Creature:** AI 助手
- **Vibe:** 友好/专业
- **Emoji:** 🤖

2.4 启动网关

openclaw gateway start

---

步骤 3：飞书集成（10 分钟）

3.1 创建飞书应用

1. 访问 https://open.feishu.cn/app
2. 点击"创建企业自建应用"
3. 填写应用信息：
   • 名称：AI 助理
   • 图标：选择一个图标
4. 获取凭证：
   • App ID
   • App Secret

3.2 配置权限

添加以下权限：

• 发送消息
• 接收消息
• 群组机器人

3.3 配置事件订阅

1. 启用事件订阅
2. 添加事件：
   • 接收消息
   • 群组消息
3. 获取 Verification Token

3.4 配置 OpenClaw

编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxxx",
      "appSecret": "xxxxx",
      "connectionMode": "websocket"
    }
  }
}

3.5 重启网关

openclaw gateway restart

---

步骤 4：测试上线（5 分钟）

4.1 添加到飞书

1. 在飞书中找到创建的机器人
2. 点击"添加到群聊"
3. 选择一个测试群

4.2 测试对话

在群里@机器人：

@AI 助理 你好

应该收到回复：

你好！我是 AI 助理，有什么可以帮你的吗？

4.3 测试功能

测试几个问题：

@AI 助理 今天天气怎么样？
@AI 助理 帮我写个邮件
@AI 助理 解释一下人工智能

---

✅ 完成！

现在你有一个：

• ✅ 24 小时在线的 AI 助理
• ✅ 集成到飞书群
• ✅ 可以回答问题
• ✅ 支持群聊

---

🚀 下一步优化

1. 添加知识库

# 常见问题

## 发货时间
工作日 16:00 前下单，当天发货

## 退换货
7 天无理由退换

2. 配置自动回复

const rules = {
  '发货': '亲，16:00 前下单当天发货~',
  '退换': '支持 7 天无理由退换'
};

3. 集成更多平台

• 微信
• Telegram
• Discord

---

🛠️ 故障排查

问题 1：机器人不回复

检查：

# 查看网关状态
openclaw status

# 查看日志
openclaw logs --tail 50

问题 2：配置错误

解决：

# 重新配置
openclaw configure

# 验证配置
openclaw status

问题 3：飞书权限不足

解决：

1. 检查飞书应用权限
2. 确保已添加到群
3. 重启网关

---

提示

30 分钟完成基础功能，后续可以根据需求扩展！

🟢🐉 泡泡龙