last30days-openclaw

归属声明：本技能是基于 @mvanhorn 的 MIT 许可项目所作的 OpenClaw 适配版本：https://github.com/mvanhorn/last30days-skill。

原始版本与适配版本的区别

原始版本（来自 @mvanhorn）

• 核心 Python 研究引擎（scripts/last30days.py + scripts/lib/*）
• 多源数据采集与排序逻辑
• 关注列表（watchlist）、简报（briefing）及历史记录数据库架构
• 内嵌的 bird-search X 客户端及数据源连接器

OpenClaw 适配版本（本目录）

• OpenClaw 技能包结构（skill.json、本 SKILL.md）
• 以 OpenClaw 为优先的存储路径，位于 ~/.openclaw/workspace
• OpenClaw 秘钥文件规范：~/.openclaw/workspace/.secrets/last30days.env
• OpenClaw 定时任务辅助脚本：scripts/openclaw_watchlist_run.sh
• 秘钥配置辅助脚本：scripts/setup_openclaw_env.sh

运行时路径（OpenClaw 默认配置）

• 密钥文件：~/.openclaw/workspace/.secrets/last30days.env
• 数据库：~/.openclaw/workspace/data/last30days/research.db
• 简报输出目录：~/.openclaw/workspace/data/last30days/briefs/
• 输出产物目录：~/.openclaw/workspace/data/last30days/out/

初始化设置

cd ~/.openclaw/workspace/skills/last30days-openclaw
./scripts/setup_openclaw_env.sh
python3 scripts/last30days.py --diagnose

macOS X-cookie 支持（Bird）

内嵌的 Bird 客户端支持在 macOS 上读取浏览器 Cookie。

• 请先在 Safari / Chrome / Firefox 中登录 x.com
• 验证认证状态：

node scripts/lib/vendor/bird-search/bird-search.mjs --whoami

若该命令失败，请在密钥文件中手动设置 AUTH_TOKEN 和 CT0。

命令路由机制

依据输入命令的第一个词决定执行模式：

• watch ... → 关注列表管理
• briefing ... → 简报生成
• history ... → 历史记录 / 全文检索查询
• 其他任意输入 → 单次研究（one-shot research）

单次研究（默认模式）

通过 OpenClaw exec 执行：

cd ~/.openclaw/workspace/skills/last30days-openclaw
python3 scripts/openclaw_run.py "TOPIC"
# 等效的核心引擎调用：
# python3 scripts/last30days.py "TOPIC" --emit=compact --no-native-web

• 使用 --quick 或 --deep 控制分析深度。
• 使用 --store 持久化本次研究成果。
• 使用 --search reddit,x,youtube,tiktok,instagram,hn,polymarket,web 指定启用的数据源子集。

关注列表模式

python3 scripts/watchlist.py add "TOPIC"
python3 scripts/watchlist.py list
python3 scripts/watchlist.py run-one "TOPIC"
python3 scripts/watchlist.py run-all

OpenClaw 定时任务集成

可在定时 exec/cron 任务中调用如下封装脚本：

~/.openclaw/workspace/skills/last30days-openclaw/scripts/openclaw_watchlist_run.sh

日志将写入：~/.openclaw/workspace/logs/last30days-watchlist.log

简报模式

python3 scripts/briefing.py generate
python3 scripts/briefing.py generate --weekly
python3 scripts/briefing.py show --date YYYY-MM-DD

历史记录模式

python3 scripts/store.py query "TOPIC" --since 7d
python3 scripts/store.py search "QUERY"
python3 scripts/store.py trending
python3 scripts/store.py stats

注意事项

• 若缺失原生网页（native web）密钥，请添加 --no-native-web 参数，并使用 OpenClaw 的 web_search 工具补充网页搜索结果。
• 合成结果时需保留各来源的权重顺序：Reddit / X / YouTube / TikTok / Instagram / HN / Polymarket 信号优先，网页结果次之。
• 在重新发布此适配版本时，不得移除对原作者 @mvanhorn 的归属声明。