摘要：想要打造一个能自动搜索、整理信息并推送到飞书的智能工作助手？本文OpenClaw 为核心，详细讲解如何集成 飞书（Feishu） 和 Tavily AI 搜索，从零开始构建一个功能强大的个人 AI 助理。全程无坑，代码可直接复制，助你轻松打造 企业级自动化工作流！

标签：OpenClaw 飞书集成 Tavily AI 助手 Node.js 自动化办公 智能工作流

📖 前言：为什么选择 OpenClaw？

在 2026 年的今天，OpenClaw 作为一个新兴的个人助理平台，凭借其轻量级架构、丰富的技能生态和出色的扩展性，迅速成为了开发者社区的新宠。

OpenClaw 的核心优势

特性 说明 评分
🎯 轻量级 基于 Node.js，启动速度快，资源占用低 ⭐⭐⭐⭐⭐
🔌 技能丰富 支持飞书、Tavily、Notion 等多种技能插件 ⭐⭐⭐⭐⭐
🛠️ 易扩展 简单的配置文件，快速集成新服务 ⭐⭐⭐⭐
📊 可视化 内置 Dashboard，实时监控服务状态 ⭐⭐⭐⭐
🔄 自动化 支持定时任务和工作流编排 ⭐⭐⭐⭐⭐

本文你将学到

✅ OpenClaw 完整安装与配置流程
✅ 飞书应用创建与技能集成详解
✅ Tavily AI 搜索技能配置与优化
✅ 三大组件联动的完整工作流示例
✅ 常见问题排查与性能优化技巧

🛠️ 第一部分：OpenClaw 基础环境搭建

1.1 系统环境要求

在开始之前，请确保你的开发环境满足以下条件：

组件 最低版本 推荐版本 说明
Node.js v18.x v20.x+ LTS 长期支持版本
npm v9.x v10.x+ 随 Node.js 一起安装
操作系统 Win10/macOS 12+/Ubuntu 20.04+ 最新稳定版 主流系统均可
内存 4GB 8GB+ 运行更流畅
磁盘空间 500MB 2GB+ 预留缓存空间

1.2 详细安装步骤

步骤 1：安装 Node.js

Windows 用户：

  1. 访问 Node.js 官网
  2. 下载 LTS 版本（绿色图标）
  3. 双击安装，保持默认选项
  4. 打开 PowerShell，验证安装：
node --version
npm --version

安装成功后会显示版本号，如下：
在这里插入图片描述

macOS 用户（推荐使用 Homebrew）：

# 安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node@20

# 验证安装
node --version
npm --version

Linux 用户（Ubuntu/Debian）：

# 使用 NodeSource 仓库安装
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

⚠️ 避坑指南：

  • 不要使用系统自带的 Node.js（版本通常过旧）
  • 如果遇到权限问题，不要使用 sudo npm install -g，建议配置 npm 全局目录
  • 国内用户可使用淘宝镜像：npm config set registry https://registry.npmmirror.com
步骤 2：全局安装 OpenClaw
# Windows (PowerShell - 管理员身份)
npm install -g openclaw

# Linux/macOS (无需 sudo，配置 npm 全局目录后)
npm install -g openclaw

# 验证安装
openclaw --version

预期输出：
在这里插入图片描述

步骤 3：初始化 OpenClaw 工作空间
# 创建初始化和配置
openclaw init

# 查看配置目录位置
openclaw config show

配置目录说明：

系统 配置目录路径
Windows C:\Users\你的用户名\.openclaw\
macOS ~/.openclaw/
Linux ~/.openclaw/
步骤 4：启动 OpenClaw Gateway
# 启动网关服务
openclaw gateway start

# 查看服务状态
openclaw gateway status

# 查看实时日志
openclaw gateway logs --follow

成功启动后的输出：
在这里插入图片描述

步骤 5：访问 Dashboard 验证

打开浏览器，访问：http://127.0.0.1:18789/

你应该能看到 OpenClaw 的控制面板，包含：

  • 📊 服务状态监控
  • 🔌 已安装技能列表
  • 📝 日志查看器
  • ⚙️ 配置管理界面

🎉 恭喜！ 如果看到 Dashboard 界面，说明 OpenClaw 基础安装成功！

💬 第二部分：飞书（Feishu）深度集成

2.1 飞书技能概览

OpenClaw 提供了丰富的飞书技能插件，让你能够无缝对接飞书生态系统：

技能名称 功能描述 使用场景
feishu-doc 飞书文档读写操作 自动创建日报、会议纪要
feishu-drive 飞书云存储文件管理 备份文件、共享资料
feishu-perm 飞书权限管理 批量设置文档权限
feishu-wiki 飞书知识库导航 知识整理、团队 Wiki
feishu-chat 飞书消息发送 自动通知、消息推送
feishu-calendar 飞书日历管理 会议安排、提醒设置

2.2 安装飞书技能插件

# 安装飞书技能包
npm install -g @openclaw/feishu

# 验证安装
openclaw skills list

预期输出：
在这里插入图片描述

2.3 创建飞书自建应用（详细步骤）

步骤 1：登录飞书开放平台
  1. 访问 飞书开放平台
  2. 使用企业账号登录（个人账号也可创建测试应用）
  3. 点击顶部导航栏的 “创建应用”
步骤 2：填写应用基本信息
应用名称：OpenClaw 智能助手
应用图标：选择一个机器人风格的图标
应用描述：基于 OpenClaw 的自动化工作助手
步骤 3：获取应用凭证

创建完成后，进入 “凭证与基础信息” 页面，记录以下信息：

凭证名称 说明 安全级别
App ID 应用的唯一标识 公开
App Secret 应用密钥 🔒 保密
Verification Token 事件订阅验证令牌 🔒 保密

⚠️ 重要提示：App Secret 和 Verification Token 请妥善保管，不要泄露到公开代码仓库！

步骤 4：配置应用权限

进入 “权限管理” 页面，添加以下权限：

✅ im:message          - 发送消息
✅ im:message.receive  - 接收消息
✅ doc:document        - 文档读写
✅ drive:file          - 云盘文件操作
✅ wiki:wiki           - 知识库操作
✅ calendar:calendar   - 日历操作

点击 “发布版本” 并提交审核（开发阶段可仅对应用可见范围生效）。

步骤 5：配置事件订阅

进入 “事件订阅” 页面：

  1. 启用事件订阅：打开开关
  2. 填写回调 URL：暂时填写 https://example.com（后续会配置）
  3. 订阅事件：
    • im.message.receive_v1 - 接收消息事件
    • app_ticket - 应用票据事件
  4. 保存配置，复制生成的 Verification Token
步骤 6：添加机器人

进入 “机器人” 页面：

  1. 开启机器人功能

  2. 设置机器人名称：OpenClaw 助手

  3. 设置机器人头像：上传一个清晰的图标

  4. 配置机器人功能：

    • ✅ 支持单聊
    • ✅ 支持群聊
    • ✅ 支持@机器人

  5. 将机器人添加到群组：

    • 在飞书中创建测试群
    • 邀请机器人加入群聊

2.4 配置 OpenClaw 飞书连接

方法 1：通过配置文件（推荐）

编辑配置文件 ~/.openclaw/openclaw.json：

{
  "plugins": {
    "entries": {
      "feishu": {
        "appId": "cli_xxxxx",
        "appSecret": "xxxxx",
        "verificationToken": "xxxxx",
        "encryptKey": "xxxxx"
      }
    }
  },
  "skills": {
    "feishu": {
      "enabled": true,
      "defaultChatId": "oc_xxxxx",
      "autoReply": false
    }
  }
}
方法 2：通过命令行配置
# 配置飞书 App ID
openclaw config set feishu.appId "cli_xxxxx"

# 配置飞书 App Secret
openclaw config set feishu.appSecret "xxxxx"

# 配置验证 Token
openclaw config set feishu.verificationToken "xxxxx"
方法 3：通过环境变量
# Windows (PowerShell)
$env:FEISHU_APP_ID="cli_xxxxx"
$env:FEISHU_APP_SECRET="xxxxx"
$env:FEISHU_VERIFICATION_TOKEN="xxxxx"

# Linux/macOS (Bash)
export FEISHU_APP_ID="cli_xxxxx"
export FEISHU_APP_SECRET="xxxxx"
export FEISHU_VERIFICATION_TOKEN="xxxxx"

2.5 重启并验证飞书集成

# 重启 OpenClaw Gateway 使配置生效
openclaw gateway restart

# 检查飞书技能状态
openclaw skills list --filter feishu

# 测试飞书连接
openclaw skills test feishu-chat

成功连接的输出：

┌─────────────────────────────────────────────────┐
│          Feishu Connection Test                 │
├─────────────────────────────────────────────────┤
│  App ID:       cli_xxxxx ✅          │
│  App Secret:   ************ ✅                  │
│  Token:        ************ ✅                  │
│  API Access:   ✅ Connected                     │
│  Bot Status:   ✅ Active                        │
└─────────────────────────────────────────────────┘

🔍 第三部分：Tavily AI 搜索技能配置

3.1 Tavily 技能介绍

Tavily 是专为 AI 代理设计的搜索引擎 API，与传统搜索引擎相比，它具有以下优势：

特性 Tavily 传统搜索引擎
结果格式 AI 友好的结构化数据 HTML 页面
内容提取 自动提取正文，去除广告 需要额外处理
搜索深度 支持基础/高级搜索 固定格式
响应速度 优化后的快速响应 相对较慢
API 友好 专为 AI 设计 需要爬虫处理

3.2 获取 Tavily API Key

步骤 1：注册 Tavily 账号
  1. 访问 Tavily 官网
  2. 点击 “Sign Up” 注册账号
  3. 验证邮箱完成注册
步骤 2：获取 API Key
  1. 登录 Tavily Dashboard
  2. 进入 “API Keys” 页面
  3. 点击 “Create New Key”
  4. 复制生成的 API Key（格式：tvly-xxxx）
步骤 3：了解配额限制
套餐类型 每月搜索次数 价格 适合场景
Free 1,000 次 $0 个人测试、学习
Starter 10,000 次 $29 个人项目、小团队
Pro 50,000 次 $99 企业应用
Enterprise 自定义 联系销售 大规模部署

💡 提示：新用户注册通常有免费试用额度，足够完成本文所有示例！

3.3 配置 Tavily 技能

方法 1：通过 TOOLS.md 配置（推荐）

编辑 ~/.openclaw/workspace/TOOLS.md 文件：

## API Keys

### 搜索服务
- **Tavily API Key:** `tvly-xxxxxxxxxxxxxxxxxxxxxxxx`

### 其他服务
- **OpenAI API Key:** `sk-xxxxxxxxxxxxxxxxxxxxxxxx`
- **飞书 App ID:** `cli_xxxxxxxxxxxxxxxx`
方法 2：通过环境变量配置
# Windows (PowerShell)
$env:TAVILY_API_KEY="tvly-xxxxxxxxxxxxxxxxxxxxxxxx"
# 永久设置
[System.Environment]::SetEnvironmentVariable("TAVILY_API_KEY", "tvly-xxxxxxxxxxxxxxxxxxxxxxxx", "User")

# Linux/macOS (Bash)
export TAVILY_API_KEY="tvly-xxxxxxxxxxxxxxxxxxxxxxxx"
# 永久设置（添加到 ~/.bashrc 或 ~/.zshrc）
echo 'export TAVILY_API_KEY="tvly-xxxxxxxxxxxxxxxxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc
方法 3：通过 OpenClaw 配置文件

编辑 ~/.openclaw/openclaw.json：

{
  "skills": {
    "tavily": {
      "apiKey": "tvly-xxxxxxxxxxxxxxxxxxxxxxxx",
      "defaultSearchDepth": "advanced",
      "maxResults": 10,
      "timeout": 30000
    }
  }
}
验证 Tavily 技能状态
# 检查 Tavily 技能
openclaw skills list --filter tavily

# 测试 Tavily 连接
openclaw skills test tavily

成功连接的输出：

┌─────────────────────────────────────────────────┐
│          Tavily Connection Test                 │
├─────────────────────────────────────────────────┤
│  API Key:      tvly-***** ✅             │
│  API Access:   ✅ Connected                     │
│  Quota:        1000 searches/month              │
│  Used:         0 searches                       │
│  Remaining:    1000 searches                    │
└─────────────────────────────────────────────────┘

3.4 Tavily 搜索参数详解

参数 类型 默认值 说明
query string 必填 搜索关键词
maxResults number 5 返回结果数量（1-20）
searchDepth string “basic” 搜索深度（basic/advanced）
includeDomains array [] 限定搜索域名
excludeDomains array [] 排除搜索域名
includeAnswer boolean false 是否包含 AI 生成的答案摘要
topic string “general” 搜索主题（general/news/science）

3.5 Tavily 技能使用示例

示例 1：基础搜索
// basic-search.js
async function basicSearch() {
  const results = await skills.tavily.search({
    query: "OpenClaw 安装教程",
    maxResults: 5
  });

  console.log(`找到 ${results.length} 条结果:\n`);
  
  results.forEach((result, index) => {
    console.log(`${index + 1}. ${result.title}`);
    console.log(`   URL: ${result.url}`);
    console.log(`   摘要: ${result.content.substring(0, 100)}...`);
    console.log(`   得分: ${result.score}`);
    console.log("");
  });
}

basicSearch().catch(console.error);
示例 2：高级搜索（带域名过滤）
// advanced-search.js
async function advancedSearch() {
  const results = await skills.tavily.search({
    query: "OpenClaw 飞书集成",
    maxResults: 10,
    searchDepth: "advanced",
    includeDomains: ["github.com", "openclaw.ai", "docs.openclaw.ai"],
    excludeDomains: ["stackoverflow.com"],
    includeAnswer: true
  });

  // 输出 AI 生成的答案摘要
  if (results.answer) {
    console.log("🤖 AI 答案摘要:");
    console.log(results.answer);
    console.log("\n---\n");
  }

  // 输出详细结果
  console.log(`找到 ${results.length} 条结果:\n`);
  results.results.forEach((result, index) => {
    console.log(`${index + 1}. ${result.title}`);
    console.log(`   URL: ${result.url}`);
    console.log(`   发布日期: ${result.publishedDate || '未知'}`);
    console.log(`   摘要: ${result.content}`);
    console.log("");
  });
}

advancedSearch().catch(console.error);
示例 3：新闻主题搜索
// news-search.js
async function searchNews() {
  const results = await skills.tavily.search({
    query: "AI 人工智能 最新进展 2026",
    maxResults: 10,
    searchDepth: "advanced",
    topic: "news",
    includeAnswer: true
  });

  console.log("📰 今日 AI 新闻摘要:\n");
  console.log(results.answer);
  console.log("\n--- 详细报道 ---\n");
  
  results.results.forEach((result, index) => {
    console.log(`${index + 1}. 【${result.publishedDate || '未知'}】${result.title}`);
    console.log(`   来源: ${result.url}`);
    console.log(`   内容: ${result.content.substring(0, 150)}...\n`);
  });
}

searchNews().catch(console.error);
示例 4：搜索结果保存到飞书文档
// search-and-save.js
async function searchAndSaveToFeishu() {
  console.log("🔍 正在搜索 AI 最新进展...\n");
  
  // 1. 使用 Tavily 搜索
  const results = await skills.tavily.search({
    query: "AI 人工智能 最新进展 2026",
    maxResults: 10,
    searchDepth: "advanced",
    includeAnswer: true
  });

  // 2. 格式化搜索结果
  let content = `# AI 最新进展搜索结果\n\n`;
  content += `**搜索时间**: ${new Date().toLocaleString()}\n\n`;
  content += `**数据来源**: Tavily AI 搜索\n\n`;
  content += `---\n\n`;
  
  // 添加 AI 答案摘要
  if (results.answer) {
    content += `## 🤖 AI 摘要\n\n${results.answer}\n\n---\n\n`;
  }

  // 添加详细结果
  results.results.forEach((result, index) => {
    content += `## ${index + 1}. ${result.title}\n\n`;
    content += `**来源**: [${result.url}](${result.url})\n\n`;
    if (result.publishedDate) {
      content += `**发布日期**: ${result.publishedDate}\n\n`;
    }
    content += `${result.content}\n\n`;
    content += `---\n\n`;
  });

  // 3. 保存到飞书文档
  console.log("📄 正在创建飞书文档...");
  const doc = await skills.feishu-doc.create({
    title: `AI 最新进展 - ${new Date().toLocaleDateString()}`,
    content: content
  });

  console.log("\n✅ 任务完成！");
  console.log(`📄 文档标题: ${doc.title}`);
  console.log(`🔗 文档链接: ${doc.url}`);
  
  return doc;
}

searchAndSaveToFeishu().catch(console.error);

🌟 第四部分：完整工作流实战

4.1 场景一：每日 AI 动态日报

这是最实用的自动化场景之一，每天自动搜索 AI 领域最新动态，整理成日报并推送到团队飞书群。

完整代码
// daily-ai-news.js
// 每日 AI 动态日报生成器

const CONFIG = {
  searchQuery: "AI 人工智能 大模型 最新进展",
  maxResults: 15,
  chatId: "oc_xxxxxxxxxxxxxxxx",  // 替换为你的群聊 ID
  docFolder: "fld_xxxxxxxxxxxxxxxx"  // 替换为你的文档文件夹 Token
};

// 主题分类函数
function categorizeResults(results) {
  const categories = {
    "🤖 大模型": [],
    "👁️ 计算机视觉": [],
    "💬 自然语言处理": [],
    "🤖 机器人": [],
    "🏢 企业应用": [],
    "📊 其他": []
  };

  results.forEach(result => {
    const title = result.title.toLowerCase();
    const content = result.content.toLowerCase();
    const combined = title + content;

    if (combined.includes("模型") || combined.includes("gpt") || combined.includes("llm") || combined.includes("claude")) {
      categories["🤖 大模型"].push(result);
    } else if (combined.includes("视觉") || combined.includes("图像") || combined.includes("cv") || combined.includes("image")) {
      categories["👁️ 计算机视觉"].push(result);
    } else if (combined.includes("语言") || combined.includes("nlp") || combined.includes("文本") || combined.includes("对话")) {
      categories["💬 自然语言处理"].push(result);
    } else if (combined.includes("机器人") || combined.includes("robot") || combined.includes("机械")) {
      categories["🤖 机器人"].push(result);
    } else if (combined.includes("企业") || combined.includes("商业") || combined.includes("应用") || combined.includes("product")) {
      categories["🏢 企业应用"].push(result);
    } else {
      categories["📊 其他"].push(result);
    }
  });

  return categories;
}

// 生成日报内容
function generateReportContent(categories, date) {
  let content = `# 📰 AI 动态日报\n\n`;
  content += `**日期**: ${date}\n\n`;
  content += `**生成时间**: ${new Date().toLocaleString('zh-CN')}\n\n`;
  content += `**数据来源**: Tavily AI 搜索\n\n`;
  content += `---\n\n`;

  // 目录
  content += `## 📑 目录\n\n`;
  for (const [category, items] of Object.entries(categories)) {
    if (items.length > 0) {
      content += `- ${category} (${items.length}条)\n`;
    }
  }
  content += `\n---\n\n`;

  // 各分类详细内容
  for (const [category, items] of Object.entries(categories)) {
    if (items.length > 0) {
      content += `## ${category}\n\n`;
      items.forEach((item, index) => {
        content += `### ${index + 1}. ${item.title}\n\n`;
        content += `**来源**: [链接](${item.url})\n\n`;
        if (item.publishedDate) {
          content += `**发布日期**: ${item.publishedDate}\n\n`;
        }
        content += `${item.content}\n\n`;
      });
      content += `---\n\n`;
    }
  }

  // 页脚
  content += `---\n\n`;
  content += `*本报告由 OpenClaw 智能助手自动生成*\n`;
  content += `*如有问题请联系管理员*\n`;

  return content;
}

// 主函数
async function generateDailyNews() {
  console.log("🚀 开始生成每日 AI 动态日报...\n");
  
  const today = new Date().toLocaleDateString('zh-CN', {
    year: 'numeric',
    month: '2-digit',
    day: '2-digit'
  });

  try {
    // 1. 搜索今日 AI 动态
    console.log("🔍 正在搜索 AI 最新动态...");
    const searchResults = await skills.tavily.search({
      query: `${CONFIG.searchQuery} ${today}`,
      maxResults: CONFIG.maxResults,
      searchDepth: "advanced",
      topic: "news",
      includeAnswer: true
    });

    console.log(`✅ 找到 ${searchResults.results.length} 条结果\n`);

    // 2. 分类整理
    console.log("📂 正在分类整理...");
    const categories = categorizeResults(searchResults.results);
    
    // 3. 生成报告内容
    console.log("📝 正在生成报告内容...");
    const reportContent = generateReportContent(categories, today);

    // 4. 保存到飞书文档
    console.log("📄 正在创建飞书文档...");
    const doc = await skills.feishu-doc.create({
      title: `📰 AI 动态日报 - ${today}`,
      content: reportContent,
      folderToken: CONFIG.docFolder
    });

    console.log(`✅ 文档创建成功: ${doc.url}\n`);

    // 5. 发送通知到飞书群
    console.log("💬 正在发送通知...");
    const message = `🤖 **AI 动态日报已生成！**\n\n` +
                   `📅 日期：${today}\n` +
                   `📊 收录文章：${searchResults.results.length}篇\n` +
                   `📄 文档链接：${doc.url}\n\n` +
                   `_由 OpenClaw 智能助手自动生成_`;
    
    await skills.feishu-chat.send({
      message: message,
      chatId: CONFIG.chatId,
      messageType: "text"
    });

    console.log("\n🎉 日报生成完成！");
    console.log(`📄 文档标题: ${doc.title}`);
    console.log(`🔗 文档链接: ${doc.url}`);
    
    return { success: true, doc, searchResults };

  } catch (error) {
    console.error("❌ 生成日报失败:", error);
    
    // 发送错误通知
    await skills.feishu-chat.send({
      message: `❌ **AI 动态日报生成失败**\n\n错误信息：${error.message}\n\n请稍后重试或联系管理员。`,
      chatId: CONFIG.chatId
    });
    
    return { success: false, error };
  }
}

// 执行
generateDailyNews().catch(console.error);
设置定时任务

Windows 任务计划程序：

  1. 打开 任务计划程序
  2. 点击 “创建基本任务”
  3. 名称：OpenClaw 每日 AI 日报
  4. 触发器：选择 “每天”，设置时间（如 9:00）
  5. 操作：选择 “启动程序”
    • 程序：node.exe
    • 参数：daily-ai-news.js
    • 起始于：脚本所在目录
  6. 完成设置

Linux/macOS Cron：

# 编辑 crontab
crontab -e

# 添加定时任务（每天 9:00 运行）
0 9 * * * cd /path/to/your/project && /usr/bin/node daily-ai-news.js >> daily-news.log 2>&1

# 验证 crontab
crontab -l

4.2 场景二：飞书消息自动回复机器人

让 OpenClaw 监听飞书群消息，自动回答常见问题。

// auto-reply-bot.js
// 飞书消息自动回复机器人

const REPLY_RULES = {
  "你好": "👋 你好！我是 OpenClaw 智能助手，有什么可以帮你的吗？",
  "帮助": "📚 我可以帮你：\n1. 搜索最新信息\n2. 创建飞书文档\n3. 生成日报周报\n\n直接告诉我你的需求吧！",
  "日报": "📰 正在为你生成今日日报...",
  "搜索": "🔍 请告诉我你想搜索什么内容？"
};

async function startAutoReply() {
  console.log("🤖 自动回复机器人已启动...\n");
  
  // 监听飞书消息事件
  await skills.feishu-chat.listen({
    onMessage: async (message) => {
      const text = message.text.toLowerCase();
      const sender = message.sender;
      
      console.log(`收到消息 from ${sender.name}: ${text}`);
      
      // 检查是否匹配回复规则
      for (const [keyword, reply] of Object.entries(REPLY_RULES)) {
        if (text.includes(keyword)) {
          console.log(`匹配关键词: ${keyword}`);
          
          // 特殊处理搜索请求
          if (keyword === "搜索") {
            await skills.feishu-chat.send({
              message: "🔍 请告诉我你想搜索什么内容？",
              chatId: message.chatId
            });
            return;
          }
          
          // 特殊处理日报请求
          if (keyword === "日报") {
            await skills.feishu-chat.send({
              message: "📰 正在为你生成今日日报，请稍候...",
              chatId: message.chatId
            });
            
            try {
              const result = await generateDailyNews();
              if (result.success) {
                await skills.feishu-chat.send({
                  message: `✅ 日报已生成！\n链接：${result.doc.url}`,
                  chatId: message.chatId
                });
              }
            } catch (error) {
              await skills.feishu-chat.send({
                message: `❌ 日报生成失败：${error.message}`,
                chatId: message.chatId
              });
            }
            return;
          }
          
          // 普通回复
          await skills.feishu-chat.send({
            message: reply,
            chatId: message.chatId
          });
          return;
        }
      }
      
      // 无匹配时的默认回复
      await skills.feishu-chat.send({
        message: "🤔 我还在学习中，你可以试试说「帮助」看看我能做什么~",
        chatId: message.chatId
      });
    }
  });
}

startAutoReply().catch(console.error);

🔧 第五部分：常见问题与解决方案

5.1 OpenClaw Gateway 无法启动

问题 可能原因 解决方案
端口被占用 18789 端口已被其他程序使用 检查端口占用并修改配置
权限不足 没有管理员权限 以管理员身份运行
Node.js 版本过低 版本低于 v18 升级 Node.js 到 v20+
配置文件错误 JSON 格式错误 检查 openclaw.json 语法

详细排查步骤：

# Windows - 检查端口占用
netstat -ano | findstr :18789

# 查看占用端口的进程
tasklist | findstr <PID>

# 终止占用进程
taskkill /F /PID <PID>

# 或者修改 OpenClaw 端口
openclaw gateway stop
openclaw gateway start --port 18790

# Linux/macOS - 检查端口占用
lsof -i :18789

# 终止占用进程
kill -9 <PID>

# 修改端口
openclaw gateway stop
openclaw gateway start --port 18790

5.2 飞书认证失败

错误信息 原因 解决方案
invalid_app_id App ID 错误 检查飞书开放平台配置
invalid_app_secret App Secret 错误 重新生成并更新配置
token_expired Token 过期 刷新 access_token
permission_denied 权限不足 在飞书开放平台添加权限

排查步骤：

# 1. 检查配置
openclaw config show feishu

# 2. 测试连接
openclaw skills test feishu-chat

# 3. 查看日志
openclaw gateway logs --filter feishu

# 4. 重新安装飞书插件
npm uninstall -g @openclaw/feishu
npm install -g @openclaw/feishu

# 5. 重启服务
openclaw gateway restart

飞书权限检查清单：

✅ im:message - 发送消息
✅ im:message.receive - 接收消息
✅ doc:document - 文档读写
✅ drive:file - 云盘文件操作
✅ 应用已发布并启用
✅ 机器人已添加到目标群组

5.3 Tavily 搜索无结果

问题 原因 解决方案
API Key 无效 Key 错误或过期 重新获取并更新配置
网络问题 无法访问 Tavily API 检查网络连接/代理设置
配额用尽 超出月度限制 升级套餐或等待下月
搜索词问题 关键词太冷门 尝试更通用的关键词

排查步骤：

# 1. 检查 API Key 配置
openclaw config show tavily

# 2. 测试连接
openclaw skills test tavily

# 3. 查看配额
curl -H "Authorization: Bearer $env:TAVILY_API_KEY" https://api.tavily.com/v1/quota

# 4. 简单搜索测试
openclaw skills exec tavily search --query "test"

# 5. 查看日志
openclaw gateway logs --filter tavily

5.4 脚本执行错误

错误类型 常见原因 解决方案
skills is not defined 脚本执行环境错误 确保在 OpenClaw 环境中运行
API timeout 网络超时 增加 timeout 参数或检查网络
内存不足 结果数据过大 减少 maxResults 参数
文件路径错误 路径不存在 检查文件路径是否正确

调试技巧：

// 添加详细日志
async function debugScript() {
  console.log("🔍 调试模式启动");
  console.log("当前目录:", process.cwd());
  console.log("环境变量:", process.env);
  
  try {
    // 测试技能可用性
    console.log("测试 Tavily...");
    const testSearch = await skills.tavily.search({
      query: "test",
      maxResults: 1
    });
    console.log("Tavily 测试成功");
    
    console.log("测试 飞书...");
    const testChat = await skills.feishu-chat.list();
    console.log("飞书测试成功");
    
  } catch (error) {
    console.error("❌ 错误详情:", error);
    console.error("错误堆栈:", error.stack);
  }
}

debugScript().catch(console.error);

🚀 第六部分：性能优化与最佳实践

6.1 搜索优化技巧

// 优化前
const results = await skills.tavily.search({
  query: "AI",
  maxResults: 20
});

// 优化后
const results = await skills.tavily.search({
  query: "AI 人工智能 大模型 2026 最新进展",  // 更具体的关键词
  maxResults: 10,  // 减少结果数量
  searchDepth: "advanced",  // 使用高级搜索
  includeDomains: ["github.com", "arxiv.org", "medium.com"],  // 限定高质量来源
  excludeDomains: ["spam-site.com"],  // 排除低质量来源
  topic: "news"  // 指定主题类型
});

关键词优化建议：

场景 推荐关键词格式 示例
技术新闻 技术名 + 年份 + 进展 “大模型 2026 最新进展”
竞品监控 公司名 + 产品名 “公司 A 产品 B 发布”
行业报告 行业 + 趋势 + 报告 “AI 行业 趋势 分析报告”
学术研究 主题 + paper/research “transformer architecture research”

6.2 飞书文档优化

// 优化文档结构
function createOptimizedDocument() {
  let content = `# 📊 报告标题\n\n`;
  
  // 添加元信息
  content += `| 项目 | 值 |\n|------|-----|\n`;
  content += `| 生成时间 | ${new Date().toLocaleString()} |\n`;
  content += `| 数据来源 | Tavily AI 搜索 |\n`;
  content += `| 文章数量 | 15篇 |\n\n`;
  content += `---\n\n`;
  
  // 添加目录
  content += `## 📑 目录\n\n`;
  content += `- [第一部分](#part1)\n`;
  content += `- [第二部分](#part2)\n\n`;
  
  // 使用代码块
  content += `## 💻 代码示例\n\n`;
  content += `\`\`\`javascript\n`;
  content += `const result = await search();\n`;
  content += `\`\`\`\n\n`;
  
  return content;
}

6.4 错误处理与重试机制

// 使用 tenacity 风格的重试装饰器
async function retryable(fn, maxRetries = 3, delay = 1000) {
  let lastError;
  
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      lastError = error;
      console.log(`⚠️ 重试 ${i + 1}/${maxRetries}: ${error.message}`);
      
      if (i < maxRetries - 1) {
        // 指数退避
        await new Promise(resolve => 
          setTimeout(resolve, delay * Math.pow(2, i))
        );
      }
    }
  }
  
  throw lastError;
}

// 使用示例
const results = await retryable(() => 
  skills.tavily.search({
    query: "AI 最新进展",
    maxResults: 10
  }),
  3,  // 最大重试次数
  1000  // 初始延迟（毫秒）
);

📋 第七部分：配置参考大全

7.1 openclaw.json 完整配置示例

{
  "version": "2026.3.7",
  "gateway": {
    "port": 18789,
    "host": "127.0.0.1",
    "logs": {
      "level": "info",
      "format": "json",
      "output": "~/.openclaw/logs/"
    }
  },
  "plugins": {
    "entries": {
      "feishu": {
        "appId": "cli_xxxxxxxxxxxxxxxx",
        "appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "verificationToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "encryptKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      },
      "tavily": {
        "apiKey": "tvly-xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  },
  "skills": {
    "feishu": {
      "enabled": true,
      "defaultChatId": "oc_xxxxxxxxxxxxxxxx",
      "autoReply": false,
      "timeout": 30000
    },
    "tavily": {
      "enabled": true,
      "defaultSearchDepth": "advanced",
      "maxResults": 10,
      "timeout": 30000
    }
  },
  "automation": {
    "enabled": true,
    "tasks": [
      {
        "name": "daily-ai-news",
        "schedule": "0 9 * * *",
        "script": "./daily-ai-news.js"
      }
    ]
  }
}

7.2 环境变量参考

# OpenClaw 配置
export OPENCLAW_PORT=18789
export OPENCLAW_LOG_LEVEL=info

# 飞书配置
export FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxx
export FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export FEISHU_VERIFICATION_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export FEISHU_ENCRYPT_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Tavily 配置
export TAVILY_API_KEY=tvly-xxxxxxxxxxxxxxxxxxxxxxxx

# 其他服务配置
export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
export NODE_ENV=production

7.3 常用命令速查表

命令 说明 示例
openclaw --version 查看版本 openclaw --version
openclaw init 初始化工作空间 openclaw init
openclaw gateway start 启动网关 openclaw gateway start
openclaw gateway stop 停止网关 openclaw gateway stop
openclaw gateway restart 重启网关 openclaw gateway restart
openclaw gateway status 查看状态 openclaw gateway status
openclaw gateway logs 查看日志 openclaw gateway logs --follow
openclaw skills list 列出技能 openclaw skills list
openclaw skills test 测试技能 openclaw skills test tavily
openclaw config show 查看配置 openclaw config show feishu
openclaw config set 设置配置 openclaw config set feishu.appId xxx

📚 第八部分：参考资料与社区

8.1 官方文档

资源 链接 说明
OpenClaw 文档 https://docs.openclaw.ai 官方完整文档
OpenClaw GitHub https://github.com/openclaw/openclaw 源代码仓库
ClawHub 技能市场 https://clawhub.com 技能插件市场
飞书开放平台 https://open.feishu.cn 飞书 API 文档
Tavily 文档 https://docs.tavily.com Tavily API 文档

8.2 社区资源

平台 链接 说明
Discord 社区 https://discord.com/invite/clawd 官方 Discord
CSDN 专栏 https://www.csdn.net/tag/openclaw 中文技术文章
知乎专栏 https://www.zhihu.com/topic/openclaw 讨论与问答
GitHub Issues https://github.com/openclaw/openclaw/issues 问题反馈

8.3 学习路线推荐

第 1 周：基础入门
├── 安装 OpenClaw
├── 配置基础环境
└── 运行 Hello World 示例

第 2 周：飞书集成
├── 创建飞书应用
├── 配置飞书技能
└── 实现消息发送功能

第 3 周：Tavily 搜索
├── 获取 API Key
├── 配置搜索技能
└── 实现搜索功能

第 4 周：工作流实战
├── 每日日报生成
├── 自动回复机器人
└── 竞品监控系统

第 5 周：进阶优化
├── 性能优化
├── 错误处理
└── 部署上线

🎯 第九部分：总结与展望

9.1 本文回顾

通过本文，你已经掌握了：

✅ OpenClaw 的完整安装与配置流程
✅ 飞书应用的创建与技能集成方法
✅ Tavily AI 搜索的配置与优化技巧
✅ 三大组件联动的完整工作流实现
✅ 常见问题的排查与解决方案
✅ 性能优化与最佳实践建议

9.2 常见问题 FAQ

Q: OpenClaw 是免费的吗？
A: OpenClaw 核心框架是开源免费的，但部分技能插件可能需要付费 API（如 Tavily）。

Q: 可以在公司内网使用吗？
A: 可以，但需要确保内网能访问飞书和 Tavily 的 API 服务器。

Q: 支持多人协作吗？
A: 支持，可以通过飞书群组实现多人使用同一个助手。

Q: 数据安全吗？
A: OpenClaw 本地运行，数据存储在本地。但飞书和 Tavily 的数据传输遵循各自的安全政策。

Q: 如何备份配置？
A: 备份 ~/.openclaw/ 目录即可，包含所有配置和技能数据。

📝 结语

恭喜你完成了这篇超长教程！🎉

现在你已经拥有了一个功能完整、可扩展、自动化的 AI 智能助手系统。从安装配置到实战应用，从问题排查到性能优化，我们覆盖了所有关键环节。

开始行动吧！

  1. 按照教程完成安装配置
  2. 运行第一个示例脚本
  3. 根据需求定制你的工作流
  4. 分享给团队成员，提升整体效率

💡 记住：最好的工具是那些真正被使用的工具。不要停留在配置阶段，尽快让它为你的工作创造价值！

🚀 让我们一起用 AI 提升工作效率！

# 人工智能 # github
Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

openclaw配置多个agent实现飞书群聊

本文介绍了基于飞书的多Agent系统架构设计，通过OpenClaw Gateway实现飞书应用与AI Agent的对接。系统采用多Agent架构，每个飞书机器人对应独立的AI Agent，拥有专属的工作空间、知识库和模型配置。

avatar 龙虾开发者社区
cover

ClawHub 小红书 Skills 完整盘点：136 个技能分类梳理

avatar 龙虾开发者社区
cover

OpenClaw安全配置解决方案 - 开源AI助手安全部署指南

avatar 龙虾开发者社区