AiTimes 智能时代

Appearance

30 分钟快速搭建 AI 项目 ​

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

🎯 项目目标 ​

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

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

⏱️ 时间分配 ​

步骤时间内容
15 分钟环境准备
210 分钟OpenClaw 配置
310 分钟飞书集成
45 分钟测试上线

📋 前置要求 ​

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

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

1.1 安装 OpenClaw ​

bash
npm install -g openclaw

1.2 验证安装 ​

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

1.3 准备 API Key ​

访问 ModelStudio 获取 API Key。

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

2.1 初始化配置 ​

bash
openclaw configure

按提示选择：

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

2.2 验证配置 ​

bash
openclaw status

应该显示：

Gateway: running
Models: configured
Channels: ready

2.3 定义人格 ​

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

markdown
# SOUL.md

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

2.4 启动网关 ​

bash
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：

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

3.5 重启网关 ​

bash
openclaw gateway restart

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

4.1 添加到飞书 ​

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

4.2 测试对话 ​

在群里@机器人：

@AI 助理 你好

应该收到回复：

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

4.3 测试功能 ​

测试几个问题：

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

✅ 完成！ ​

现在你有一个：

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

🚀 下一步优化 ​

1. 添加知识库 ​

markdown
# 常见问题

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

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

2. 配置自动回复 ​

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

3. 集成更多平台 ​

  • 微信
  • Telegram
  • Discord

🛠️ 故障排查 ​

问题 1：机器人不回复 ​

检查：

bash
# 查看网关状态
openclaw status

# 查看日志
openclaw logs --tail 50

问题 2：配置错误 ​

解决：

bash
# 重新配置
openclaw configure

# 验证配置
openclaw status

问题 3：飞书权限不足 ​

解决：

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

提示

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

🟢🐉 泡泡龙