Research Assistant
Organize research and knowledge across sessions with structured, searchable notes.
Quick Start
Add a research note
CODEBLOCK0
List all research topics
CODEBLOCK1
Show all notes for a topic
CODEBLOCK2
Search across all notes
CODEBLOCK3
Export topic to markdown
CODEBLOCK4
Usage Patterns
For multi-session projects
When working on projects that span multiple sessions:
- 1. Add research findings as you discover them
- Tag notes with relevant categories (e.g., "experiments", "ideas", "resources")
- Use search to find relevant notes from past sessions
- Export completed research to markdown for sharing or archiving
For tracking ideas and experiments
CODEBLOCK5
For content planning
CODEBLOCK6
Security
Path Validation (v1.0.1+)
The
export function validates output paths to prevent malicious writes:
- - ✅ Allowed:
~/.openclaw/workspace/, /tmp/, and home directory - ❌ Blocked: System paths (
/etc/, /usr/, /var/, etc.) - ❌ Blocked: Sensitive dotfiles (
~/.bashrc, ~/.ssh, etc.)
This prevents prompt injection attacks that could attempt to write to system files for privilege escalation.
Data Storage
- - All research is stored in: INLINECODE8
- Topic metadata includes: creation date, last update time, note count
- Each note includes: content, timestamp, tags
- JSON format makes it easy to backup or migrate
Search Features
- - Case-insensitive search across all notes and topics
- Matches content and topic names
- Shows timestamp and preview for each result
- Perfect for finding information from previous sessions
Export Format
Markdown export includes:
- - Topic title with creation/last-updated dates
- All notes with timestamps and tags
- Hashtag-formatted tags for easy reference
- Clean formatting for sharing or publishing
Examples
Researching a new skill idea
CODEBLOCK7
Tracking autonomous income experiments
CODEBLOCK8
Best Practices
- 1. Use descriptive topic names -
income-experiments not INLINECODE10 - Add tags consistently -
experiment, resource, idea, INLINECODE14 - Write complete notes - context for future sessions
- Export completed research - clean markdown for sharing
- Search before adding - avoid duplicate notes
研究助手
通过结构化的可搜索笔记，跨会话组织研究和知识。
快速开始
添加研究笔记
bash
research_organizer.py add <主题> <笔记> [标签...]
列出所有研究主题
bash
research_organizer.py list
显示某个主题的所有笔记
bash
research_organizer.py show <主题>
搜索所有笔记
bash
research_organizer.py search <查询>
将主题导出为Markdown格式
bash
research_organizer.py export <主题> <输出文件>
使用模式
跨会话项目
处理跨多个会话的项目时：
- 1. 发现研究结果时及时添加
- 使用相关类别为笔记添加标签（例如实验、想法、资源）
- 使用搜索功能查找过往会话中的相关笔记
- 将完成的研究导出为Markdown格式，便于分享或归档
追踪想法和实验
bash
添加实验想法
research_organizer.py add 商业创意 为小企业提供自动化研究服务 服务 自动化
追踪实验结果
research_organizer.py add 商业创意 测试在ClawHub发布技能——零成本，有利于建立声誉 实验 结果
内容规划
bash
规划内容主题
research_organizer.py add 内容日历 撰写关于自主代理创收的指南 教程
存储参考资料
research_organizer.py add 内容日历 参考资料：ClawHub市场，网址clawhub.com 资源
安全性
路径验证（v1.0.1+）
export功能会验证输出路径，防止恶意写入：
- - ✅ 允许：~/.openclaw/workspace/、/tmp/和主目录
- ❌ 阻止：系统路径（/etc/、/usr/、/var/等）
- ❌ 阻止：敏感点文件（~/.bashrc、~/.ssh/等）
这可以防止可能试图写入系统文件以提升权限的提示注入攻击。
数据存储
- - 所有研究数据存储在：~/.openclaw/workspace/research_db.json
- 主题元数据包括：创建日期、最后更新时间、笔记数量
- 每条笔记包括：内容、时间戳、标签
- JSON格式便于备份或迁移
搜索功能
- - 在所有笔记和主题中进行不区分大小写的搜索
- 匹配内容和主题名称
- 显示每个结果的时间戳和预览
- 非常适合查找过往会话中的信息
导出格式
Markdown导出包括：
- - 主题标题及创建/最后更新日期
- 所有笔记及其时间戳和标签
- 使用井号标签格式，便于参考
- 格式整洁，便于分享或发布
示例
研究新技能创意
bash
初步头脑风暴
research_organizer.py add 技能创意：天气机器人 天气预警技能，针对特定条件发送通知 想法
技术研究
research_organizer.py add 技能创意：天气机器人 使用天气技能获取API访问，cron进行定时检查，消息进行投递 技术
市场研究
research_organizer.py add 技能创意：天气机器人 竞争对手：IFTTT、Zapier——但原生代理是差异化优势 市场
准备构建时导出
research_organizer.py export 技能创意：天气机器人 ./天气机器人计划.md
追踪自主收入实验
bash
实验1
research_organizer.py add 收入实验 在ClawHub发布技能——零成本，建立声誉 实验 已发布
实验2
research_organizer.py add 收入实验 内容自动化——YouTube转录为博客文章 实验 内容 已规划
稍后——搜索所有收入实验
research_organizer.py search 收入实验
最佳实践
- 1. 使用描述性主题名称——使用收入实验而非想法
- 一致地添加标签——实验、资源、想法、技术
- 撰写完整笔记——为未来会话提供上下文
- 导出已完成的研究——生成整洁的Markdown便于分享
- 添加前先搜索——避免重复笔记
