A comprehensive automation skill for managing HackMD documents, supporting full CRUD operations and intelligent change tracking.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install hackmd
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install hackmd using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is HackMD Integration?
The HackMD skill for Openclaw Skills provides a robust interface for AI agents to interact with the HackMD platform. It allows for the seamless reading, creation, and synchronization of markdown documents across both personal and team-based workspaces. By leveraging this skill, developers can bridge the gap between their local coding environment and collaborative online documentation.
Built on top of the HackMD CLI, this integration ensures that your AI agent can maintain a consistent knowledge base, update project specifications in real-time, and manage document lifecycles without manual intervention. It is a vital component for teams utilizing Openclaw Skills to streamline their technical documentation and PKM workflows.
HackMD Integration Use Cases
- Automating the publication of local markdown documentation to HackMD team workspaces.
- Monitoring specific notes for external changes to trigger AI-driven updates or notifications.
- Synchronizing meeting notes or project logs from the terminal directly to collaborative documents.
- Managing a decentralized knowledge base through Openclaw Skills for better team transparency.
How HackMD Integration Works
- The agent authenticates with the HackMD API using a secure access token provided via environment variables.
- Commands are issued through the hackmd-cli to perform operations such as listing notes, exporting markdown content, or updating existing files.
- For team environments, the skill identifies specific team paths to route updates to the correct shared workspace.
- An integrated tracking script stores document metadata locally to compare timestamps and identify modifications.
- The agent processes these changes to keep the local state and remote documents in perfect synchronization.
HackMD Integration Setup
To get started with this skill within Openclaw Skills, install the HackMD CLI and set up your environment:
npm install -g @hackmd/hackmd-cli
export HMD_API_ACCESS_TOKEN='your_api_token'
Ensure that the hackmd-track.js script is placed in your scripts/ directory to enable the advanced change tracking features.
HackMD Integration Data Schema & Taxonomy
The skill organizes tracking data and document metadata to optimize performance and rate limiting.
| Feature | Implementation |
|---|---|
| State Storage | Local JSON file at .\/.hackmd\/tracked-notes.json |
| Metadata Fields | lastChangedAt, lastChangeUser, titleUpdatedAt, tagsUpdatedAt |
| Authentication | HMD_API_ACCESS_TOKEN environment variable |
| Workspace Support | Supports both personal notes and teamPath identifiers |
HackMD Integration Advanced Features
- Smart change detection that only outputs document content when modifications are detected, saving on API overhead.
- Multi-workspace support allowing Openclaw Skills to toggle between personal PKM and enterprise team folders.
- Detailed metadata extraction including user photos and timestamps for granular audit logs.
- Automated rate limit management to stay within the 100 calls per 5 minutes threshold.
SKILL.md
Loading
Related Openclaw Skills
Odoo ERP Connector
A comprehensive Odoo 19 ERP connector for OpenClaw that enables full business management through natural language chat commands.
Submit to AgentBeat
A comprehensive workflow to onboard autonomous AI agents into the on-chain economy via ERC-8004 registration and AgentBeat indexing.
Writing
A communication framework for AI agents to eliminate fluff and deliver clear, specific, and impactful content.
Trend & Intent Scout
A real-time intelligence tool that scouts social signals from X and Reddit to reveal trending topics, competitor weaknesses, and high-value content gaps.
NFT Artist Skill
An autonomous AI agent skill for generating, minting, and managing NFT art collections on the Base blockchain.
Agent Safehouse Client
A minimal, zero-dependency bash client for facilitating communication between AI agents via GitHub Issues.
Featured*
