ClawHub

Agent Reader

Document beautifier for AI Agents. Converts Markdown to styled webpages, Word, PDF, and image slideshows — the 'last mile' rendering engine for AI output. 专为 AI Agent 设计的文档美化引擎，一键把 Markdown 变成漂亮网页、Word、PDF 和幻灯片。

Audits

Pass
ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install agent-reader

Agent Reader

Document beautifier engine for AI Agents. Turn raw Markdown into delivery-ready documents. AI Agent 的文档美化引擎，把 Markdown 变成可交付的专业文档。

Tools / 工具

ToolWhat it does
render_markdownMarkdown → styled webpage with sidebar TOC, code highlighting; can pre-generate PDF/DOCX files 带目录导航的网页，可预生成 PDF/DOCX
export_documentMarkdown → PDF or Word (.docx) with smart formatting 导出 PDF/Word
create_slideshowImages → full-screen slideshow with keyboard nav & auto-play 图片幻灯片
export_slideshowSlideshow → PDF or standalone HTML 导出幻灯片
open_fileSmart open — auto-picks format based on user preferences 智能打开
configure_user_preferencesSet default output format, theme, etc. 设置偏好
get_user_preferencesRead current preferences 读取偏好

When to use / 什么时候调用

  • User wants a report formatted → export_document (format: "pdf" or "docx")
  • User says "make it a webpage" → render_markdown
  • User says "export to Word/PDF" → export_document
  • User has images for a presentation → create_slideshow or export_slideshow
  • User says "open this file" → open_file
  • No format specified → open_file (auto-selects based on preferences)

Setup / 接入

Add to your MCP config (Claude Desktop, Cline, OpenClaw, etc.):

{
  "mcpServers": {
    "agent-reader": {
      "command": "npx",
      "args": ["-y", "agent-reader", "mcp"]
    }
  }
}

Quick examples / 快速示例

Render a webpage 渲染网页

{ "content": "# My Report\n\nHello world...", "theme": "light" }

Render with pre-export 预生成导出文件

{ "content": "# My Report\n\nHello world...", "pre_export": ["pdf", "docx"] }

Export to PDF 导出 PDF

{ "content": "# My Report\n\n...", "format": "pdf" }

Export to Word 导出 Word

{ "content": "# My Report\n\n...", "format": "docx" }

Create slideshow from images 图片做幻灯片

{ "image_dir": "/path/to/images", "auto_play": 5 }

Key parameters / 关键参数

  • content — Markdown text to render/export Markdown 内容
  • format — "pdf" or "docx" (for export_document); "pdf" or "html" (for export_slideshow)
  • source_path — original .md file path, needed if Markdown references local images 原始文件路径（有本地图片时需要）
  • theme — "light" (default) or "dark"
  • pre_export — optional ["pdf"] or ["pdf", "docx"]; when returning a file path, MCP defaults to pre-generating PDF 可选预生成导出文件；MCP 返回文件路径时默认预生成 PDF
  • return_content — set true to get base64/HTML string instead of file path (for sandbox/Docker)

Notes / 注意事项

  • PDF export requires Puppeteer (auto-installed on first use) PDF 导出需要 Puppeteer
  • Word export works without Pandoc, but Pandoc produces better formatting Word 导出无需 Pandoc 也能用
  • return_content: true keeps inline HTML behavior unless pre_export is explicitly set return_content: true 默认保持内联返回；显式传 pre_export 时会落盘输出
  • All output writes to /tmp/agent-reader/ — no side effects 输出仅写入 /tmp
  • MIT licensed, open source 开源协议

Links