飞书通知配置指南¶

功能说明¶

在每日日报发布到网页后，自动延迟 5 分钟向飞书发送通知消息，包含日报链接。

配置步骤¶

1. 选择发送通道¶

支持两种通道：

Webhook（推荐简单场景）
Bot API（无 webhook 时可用，支持精确目标）

1A. Webhook 方式（可选）¶

打开飞书群聊
点击右上角 ... → 设置 → 群机器人
点击 添加机器人 → 自定义机器人
设置机器人名称（如：日报通知）
复制生成的 Webhook URL（格式：https://open.feishu.cn/open-apis/bot/v2/hook/xxx）

1B. Bot API 方式（可选）¶

Bot API 复用 /root/.openclaw/openclaw.json 中的飞书应用凭据，额外只需目标会话：

FEISHU_CHAT_ID：目标群 ID（oc_...）
FEISHU_ACCOUNT：账号名（默认 main）

如果不设置 FEISHU_CHAT_ID，脚本会尝试使用 openclaw.json 中首个启用的飞书群。

2. 配置环境变量（统一口径）¶

支持两级配置，加载顺序与 pipeline 脚本一致：

全局 /root/.openclaw/.env
项目 /root/.openclaw/projects/daily-report/.env（可选覆盖）

也就是说：同名变量冲突时，项目 .env 优先。

推荐做法：

默认把 FEISHU_WEBHOOK_URL 放在全局 .env，便于统一管理。
只有当 daily-report 需要独立 webhook 时，再在项目 .env 设置同名变量覆盖。
若不使用 webhook，可配置 FEISHU_CHAT_ID（可选 FEISHU_ACCOUNT）走 Bot API。

示例：

# 全局配置（推荐）
/root/.openclaw/.env
FEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/你的webhook地址

# 项目覆盖（可选，仅该项目生效）
/root/.openclaw/projects/daily-report/.env
FEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/项目专用webhook

# Bot API（可选）
FEISHU_CHAT_ID=oc_xxx
FEISHU_ACCOUNT=main

3. 安装定时任务¶

cd /root/.openclaw/projects/daily-report

# 安装 crontab
crontab crontab.txt

# 验证安装
crontab -l

你应该看到以下任务：

# Hourly ingest at :00 minutes
0 * * * * cd /root/.openclaw/workspace/projects/daily-report && TZ=Asia/Shanghai bash scripts/run-pipeline.sh ingest >> logs/cron-ingest.log 2>&1

# Daily report generation at 23:15 (generates report for TODAY)
15 23 * * * cd /root/.openclaw/workspace/projects/daily-report && TZ=Asia/Shanghai bash scripts/run-pipeline.sh report >> logs/cron-report.log 2>&1

# Send Feishu notification 5 minutes after report is published (23:20)
20 23 * * * cd /root/.openclaw/workspace/projects/daily-report && TZ=Asia/Shanghai bash scripts/send-feishu-notification.sh >> logs/cron-feishu.log 2>&1

时间线¶

23:15 - 生成日报并发布到网站
23:20 - 发送飞书通知（延迟 5 分钟）

手动测试¶

测试发送通知（使用今天的日期）¶

cd /root/.openclaw/projects/daily-report
bash scripts/send-feishu-notification.sh

测试发送通知（指定日期）¶

bash scripts/send-feishu-notification.sh 2026-02-15

dry-run 预检查（不真实发送）¶

bash scripts/send-feishu-notification.sh --dry-run

查看日志¶

# 查看飞书通知日志
tail -f logs/cron-feishu.log

# 查看日报生成日志
tail -f logs/cron-report.log

通知内容¶

飞书卡片消息包含：

标题: 📊 行业雷达日报 YYYY-MM-DD
内容: 今日日报已发布！
按钮: 查看完整日报（链接到 https://daily-report-ev7.pages.dev/）

故障排查¶

1. 通知未发送¶

检查日志：

tail -20 logs/cron-feishu.log

常见问题： - Webhook URL 未配置或错误 - 未配置 FEISHU_CHAT_ID 且 openclaw.json 里没有可用飞书群 - 日报文件不存在（检查 output/YYYY-MM-DD.md） - feishu-bot 脚本路径错误

2. 验证 Webhook URL¶

# 测试 webhook 连通性
python3 /root/.openclaw/skills/feishu-bot/scripts/test-webhook.py

3. 检查环境变量¶

cd /root/.openclaw/projects/daily-report

# 先加载全局，再加载项目（项目可覆盖）
set -a
source /root/.openclaw/.env
[ -f .env ] && source .env
set +a

echo $FEISHU_WEBHOOK_URL

自定义配置¶

修改通知时间¶

编辑 crontab.txt，修改第三行的时间：

# 例如改为 23:25（延迟 10 分钟）
25 23 * * * cd /root/.openclaw/workspace/projects/daily-report && TZ=Asia/Shanghai bash scripts/send-feishu-notification.sh >> logs/cron-feishu.log 2>&1

然后重新安装：

crontab crontab.txt

自定义卡片内容¶

编辑 scripts/send-feishu-notification.sh，修改 cat > "$CARD_FILE" 部分的 JSON 内容。

参考 /root/.openclaw/skills/feishu-card/SKILL.md 了解卡片格式。