OpenClaw 集成飞书机器人实战指南

团队协作场景下，Docker 隔离更干净。

# docker-compose.yml
services:
  openclaw:
    image: node:22-alpine
    ports:
      - "8765:8765"
    environment:
      - NODE_ENV=production
      - FEISHU_APP_ID=${FEISHU_APP_ID}
      - FEISHU_APP_SECRET=${FEISHU_APP_SECRET}

启动服务后，检查配置文件 /root/.openclaw/config.json，确保 plugins.entries.feishu.enabled 为 true。

飞书插件配置详解

环境变量配置

创建 .env.openclaw 文件，设置连接模式。WebSocket 模式适合实时双向通信。

FEISHU_APP_ID=cli_xxxxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
FEISHU_CONNECTION_MODE=websocket
FEISHU_LOG_LEVEL=debug

启用插件

使用 CLI 命令快速启用。

openclaw plugins enable feishu
openclaw gateway start

验证连接状态，查看日志输出是否显示 Connected to IM Cloud Server。

核心功能实战

发送文本消息

基础用法非常简单，指定频道和目标即可。

openclaw message \
  --channel feishu \
  --target oc_group_chat_id_here \
  --message "你好，我是 OpenClaw 机器人！"

富媒体交互

支持发送图片和卡片消息。图片可以是本地路径或网络 URL。

# 发送本地图片
openclaw message \
  --channel feishu \
  --target oc_target_id \
  --media /path/to/image.png \
  --caption "项目架构图"

卡片消息需要预先定义 JSON 结构，包含标题、内容和按钮等信息。

提及与回复

在群聊中@特定人员或所有人。

# @特定用户
openclaw message \
  --channel feishu \
  --target oc_group_id \
  --message "这个问题需要跟进一下" \
  --mention-user ou_user_open_id

# 回复指定消息
openclaw message \
  --channel feishu \
  --target oc_group_id \
  --reply-to om_original_message_id \
  --message "好的，这个需求我已经理解了"

文档与知识库操作

OpenClaw 支持对飞书云文档进行读写。

# 新建文档
openclaw doc create \
  --channel feishu \
  --title "2026 年 Q1 工作计划"

# 追加内容
openclaw doc append \
  --channel feishu \
  --token doc_xxx \
  --file update.txt

多维表格（Bitable）操作

用于结构化数据管理，支持查询和写入。

# 查询记录
openclaw bitable query \
  --channel feishu \
  --app-token app_xxx \
  --table-id table_xxx \
  --filter "Status='进行中'"

# 插入记录
openclaw bitable insert \
  --channel feishu \
  --app-token app_xxx \
  --table-id table_xxx \
  --fields '{"Task":"编写技术文档","Owner":"王五"}'

定时任务

通过 crontab 格式配置周期性任务。

# 每天早上 9 点发送总结
0 9 * * * openclaw message --channel feishu --target oc_team_chat --template daily-summary

进阶技巧与最佳实践

安全与性能

凭证管理建议使用加密存储库，如 keytar。API 调用需注意速率限制，实现指数退避重试策略。

async function sendWithRetry(message, maxAttempts = 5) {
  let attempt = 0;
  while (attempt < maxAttempts) {
    try {
      await sendMessage(message);
      return { success: true };
    } catch (error) {
      if (error.code === 'RATE_LIMITED') {
        const delay = Math.pow(2, attempt) * 1000;
        await sleep(delay);
        attempt++;
      } else {
        throw error;
      }
    }
  }
  return { success: false };
}

监控与调试

开启详细日志级别有助于排查问题。

export OPENCLAW_LOG_LEVEL=debug
openclaw gateway status

常见问题排查

1. 无法连接服务器：检查防火墙是否放行 443 端口，确认 DNS 解析正常。
2. Token 无效：重新刷新认证令牌，清除过期缓存。
3. 消息被限流：实施请求间隔控制或使用批量接口。
4. @提及无响应：确认权限包含 im:message.group_at_msg:readonly，检查 Webhook 配置。

结语

通过以上步骤，你已经掌握了 OpenClaw 与飞书集成的核心流程。从基础的消息收发到复杂的文档操作，这套方案能够灵活适配多种办公场景。后续可根据业务需求自定义技能插件，进一步扩展 AI 助手的能力边界。