研究助手

通过结构化、可搜索的笔记，跨会话整理研究资料与知识。

快速开始

添加研究笔记

research_organizer.py add "<topic>" "<note>" [tags...]

列出所有研究主题

research_organizer.py list

显示某个主题的所有笔记

research_organizer.py show "<topic>"

在所有笔记中搜索

research_organizer.py search "<query>"

将主题导出为 Markdown 格式

research_organizer.py export "<topic>" "<output_file>"

使用模式

适用于多会话项目

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

1. 随时添加研究发现
2. 用相关类别标记笔记（例如："实验"、"想法"、"资源"）
3. 使用搜索功能查找过往会话的相关笔记
4. 将已完成的研究导出为 Markdown 格式以便分享或存档

用于追踪想法和实验

# Add experiment ideas
research_organizer.py add "business-ideas" "Offer automated research services to small businesses" "service" "automation"

# Track experiment results
research_organizer.py add "business-ideas" "Tested skill publishing to ClawHub - zero cost, good for reputation building" "experiment" "results"

用于内容规划

# Plan content topics
research_organizer.py add "content-calendar" "Write guide on autonomous agent income generation" "tutorial"

# Store references
research_organizer.py add "content-calendar" "Reference: ClawHub marketplace at clawhub.com" "resource"

安全性

路径验证 (v1.0.1+)

此导出该功能会验证输出路径以防止恶意写入：

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

这能防止试图通过写入系统文件进行权限提升的提示注入攻击。

数据存储

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

搜索功能

• 在所有笔记和主题中进行不区分大小写的搜索
• 匹配内容和主题名称
• 为每个结果显示时间戳和预览内容
• 非常适合查找以往会话中的信息

导出格式

Markdown导出包含：

• 带创建/最后更新日期的主题标题
• 所有带时间戳和标签的笔记
• 标签采用井号格式，便于引用
• 格式简洁，便于分享或发布

示例

研究一个新的技能想法

# Initial brainstorming
research_organizer.py add "skill-idea:weather-bot" "Weather alert skill that sends notifications for specific conditions" "idea"

# Technical research
research_organizer.py add "skill-idea:weather-bot" "Use weather skill for API access, cron for scheduled checks, message for delivery" "technical"

# Market research
research_organizer.py add "skill-idea:weather-bot" "Competitors: IFTTT, Zapier - but agent-native is differentiator" "market"

# Export when ready to build
research_organizer.py export "skill-idea:weather-bot" "./weather-bot-plan.md"

追踪自主收入实验

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

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

# Later - search for all income experiments
research_organizer.py search "income-experiments"

最佳实践

1. 使用描述性的主题名称-收入实验不想法
2. 一致地添加标签-实验,资源,想法,技术性的
3. 撰写完整的笔记- 为未来的会话提供背景信息
4. 导出已完成的研究- 干净的Markdown格式以便分享
5. 添加前先搜索- 避免重复笔记