研究助理

通过结构化、可搜索的笔记，在多个会话中统一组织研究与知识。

快速开始

添加一条研究笔记

research_organizer.py add "" "" [tags...]

列出所有研究主题

research_organizer.py list

显示某主题下的全部笔记

research_organizer.py show ""

在全部笔记中搜索

research_organizer.py search ""

将主题导出为 Markdown 文件

research_organizer.py export "" ""

使用模式

适用于跨多会话的项目

当处理跨越多个会话的项目时：

1. 在发现新信息时即时添加研究结果
2. 为笔记打上相关分类标签（例如：experiments、ideas、resources）
3. 使用 search 命令检索过往会话中的相关内容
4. 将已完成的研究导出为 Markdown 格式，便于分享或归档

适用于追踪创意与实验

# 添加实验创意
research_organizer.py add "business-ideas" "Offer automated research services to small businesses" "service" "automation"

# 记录实验结果
research_organizer.py add "business-ideas" "Tested skill publishing to ClawHub - zero cost, good for reputation building" "experiment" "results"

适用于内容规划

# 规划内容主题
research_organizer.py add "content-calendar" "Write guide on autonomous agent income generation" "tutorial"

# 存储参考资料
research_organizer.py add "content-calendar" "Reference: ClawHub marketplace at clawhub.com" "resource"

安全性

路径校验（v1.0.1+）

export 功能会对输出路径执行校验，防止恶意写入：

• ✅ 允许路径：~/.openclaw/workspace/、/tmp/ 及用户主目录
• ❌ 禁止路径：系统路径（如 /etc/、/usr/、/var/ 等）
• ❌ 禁止路径：敏感点文件（如 ~/.bashrc、~/.ssh 等）

此举可防范利用提示注入（prompt injection）尝试向系统文件写入以实现权限提升的攻击。

数据存储

• 所有研究数据均存于：~/.openclaw/workspace/research_db.json
• 主题元数据包含：创建时间、最后更新时间、笔记数量
• 每条笔记包含：内容、时间戳、标签
• 采用 JSON 格式，便于备份或迁移

搜索功能

• 不区分大小写的全文搜索，覆盖所有笔记与主题名称
• 匹配笔记内容及主题名
• 对每个搜索结果展示时间戳与内容预览
• 特别适合从过往会话中快速定位信息

导出格式

Markdown 导出内容包括：

• 主题标题，附带创建时间与最后更新时间
• 全部笔记，含各自时间戳与标签
• 标签以井号格式（#tag）呈现，便于引用
• 格式简洁清晰，适合分享或发布

示例

调研一项新技能创意

# 初始头脑风暴
research_organizer.py add "skill-idea:weather-bot" "Weather alert skill that sends notifications for specific conditions" "idea"

# 技术调研
research_organizer.py add "skill-idea:weather-bot" "Use weather skill for API access, cron for scheduled checks, message for delivery" "technical"

# 市场调研
research_organizer.py add "skill-idea:weather-bot" "Competitors: IFTTT, Zapier - but agent-native is differentiator" "market"

# 准备开发时导出
research_organizer.py export "skill-idea:weather-bot" "./weather-bot-plan.md"

追踪自主收入实验

# 实验 1
research_organizer.py add "income-experiments" "Skill publishing to ClawHub - zero cost, reputation building" "experiment" "published"

# 实验 2  
research_organizer.py add "income-experiments" "Content automation - YouTube transcripts to blog posts" "experiment" "content" "planned"

# 后续 —— 搜索全部收入相关实验
research_organizer.py search "income-experiments"

最佳实践

1. 使用描述性强的主题名 —— 如 income-experiments，而非模糊的 ideas
2. 一致地添加标签 —— 推荐使用 experiment、resource、idea、technical 等标准标签
3. 撰写完整的笔记内容 —— 包含足够上下文，方便后续会话理解
4. 及时导出已完成的研究 —— 生成整洁的 Markdown 文件用于共享
5. 新增前先搜索 —— 避免重复记录相同内容