x-grok-to-obsidian
Export Grok conversations from X (x.com) via browser-network capture and convert them into Obsidian-ready Markdown files. Use when a user wants to back up Grok chat history, preserve User vs Grok turns, and generate Markdown notes with YAML frontmatter (URL, created) from captured JSON.
Why use this skill?
Easily back up your Grok conversations from X into searchable Obsidian Markdown notes using this two-stage capture and conversion skill.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/hajekt2/x-grok-to-obsidianWhat This Skill Does
The x-grok-to-obsidian skill is a specialized utility designed to bridge the gap between volatile social media chat interfaces and permanent personal knowledge management systems. It provides a two-stage pipeline: a browser-based network capture mechanism and a robust local Python converter. By intercepting raw JSON data from X/Grok, the skill preserves the integrity of your conversations, including complex turn-based exchanges, timestamps, and metadata. It transforms this data into Obsidian-ready Markdown files, complete with YAML frontmatter, ensuring that your AI-assisted insights remain searchable, editable, and integrated into your personal notes.
Installation
To integrate this skill into your environment, use the OpenClaw CLI:
clawhub install openclaw/skills/skills/hajekt2/x-grok-to-obsidian
Ensure you have Python 3 installed on your local machine to execute the conversion script, as well as a modern browser with Developer Tools to run the capture script.
Use Cases
- Research Archival: Capture deep-dive research sessions with Grok and store them directly in your Obsidian vault for future reference.
- Content Repurposing: Convert AI brainstorming threads into clean Markdown documents to be used as drafts for blog posts or articles.
- Knowledge Management: Maintain a searchable history of AI interactions that aren't dependent on the X platform's availability or long-term retention policies.
- Trend Analysis: Export historical chat data to visualize how your queries and the AI's reasoning capabilities evolve over time.
Example Prompts
- "OpenClaw, please guide me through capturing my Grok history and saving the resulting Markdown notes into my 'Work/AI-Research' folder."
- "I've downloaded a capture file; use the x-grok-to-obsidian script to convert it, but make sure to include the reasoning traces this time."
- "My recent Grok export seems incomplete. How can I increase the pass counts in the script to ensure all my chats are captured?"
Tips & Limitations
- Lazy Loading: X employs aggressive lazy loading. If you find your export is incomplete, consistently increase the
INDEX_PASSESandCAPTURE_PASSESvariables in the capture script. - Data Privacy: Ensure you are not capturing private or sensitive information that you would not want stored in plain text files locally on your machine.
- Formatting: The converter defaults to excluding 'thinking_trace' blocks. If you want to see how Grok arrived at an answer, remember to use the
--include-reasoningflag during the conversion stage. - Collision Handling: By default, the script creates duplicate filenames (e.g., 'Title 2.md') if you export twice. Use the
--overwriteflag to maintain a clean vault if you prefer updating existing files.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-hajekt2-x-grok-to-obsidian": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-write, file-read, code-execution