openclaw-visual

🖼️ 本地渲染的精美图文生成器

基于 node-html-to-image 的本地图文生成工具,将 OpenClaw 日志、聊天记录转为精美排版图片,纯本地渲染无需外部 API,适合社交分享场景。

收藏
1.2k
安装
503
版本
v0.0.1
CLS 安全性认证2026-05-20
点击查看完整报告 >

使用说明

核心用法

OpenClaw Visual 是一款本地图片生成技能,核心流程为「内容识别 → 模板选择 → HTML 生成 → 本地渲染 → 输出图片」。支持五种预设模板:quote-card(金句卡片)、moment-card(瞬间卡片)、daily-journal(日记手账)、social-share(社交分享)、dashboard(数据仪表盘)。用户可通过自然语言指令触发,如"帮我把这段话做成图片"或"生成今日日志分享图",系统自动识别内容类型并匹配最佳模板。

显著优点

纯本地处理:所有渲染通过 node-html-to-image(Puppeteer)或可选的 Playwright 在本地完成,无需调用外部 API,保障数据隐私。模板丰富:覆盖金句、日记、数据仪表盘等多种场景,采用瑞士风格网格系统和现代极简设计。零外部依赖:使用系统字体栈,无需下载网络字体;SVG 图标内联,无外部资源依赖。灵活扩展:支持自定义模板和主题,开发者可按规范添加新模板。

潜在缺点与局限性

资源消耗较高:Chromium 实例峰值内存可达 500MB,在低配设备上可能影响性能。沙箱降级:使用 --no-sandbox 参数运行 Chromium,虽为容器环境必要配置,但安全隔离级别有所降低。外部图片风险moment-card 模板支持加载外部 URL 图片,存在理论 SSRF 风险。模板变量注入:虽使用安全的正则替换,但用户输入的 HTML 内容仍可能在 Puppeteer 渲染时执行脚本。无实时预览:生成过程黑盒,用户无法中途调整样式。

适合的目标群体

  • 个人知识管理用户:使用 PhoenixClaw 记录日志,希望将每日复盘转为可视化分享图
  • 内容创作者:需要将金句、读书笔记快速生成社交媒体配图
  • 效率工具爱好者:追求本地优先、隐私优先的工作流,不愿依赖云端设计工具
  • OpenClaw 生态用户:已深度使用 OpenClaw 会话记录和日志系统,希望增强内容呈现形式

使用风险

性能风险:首次运行需下载 Chromium,可能耗时较长;并发请求可能导致内存溢出。依赖风险node-html-to-image 和 Playwright 版本更新可能引入 Breaking Changes。输入风险:恶意构造的 {{CONTENT}} 变量可能包含脚本,虽在隔离环境执行,但仍建议对敏感场景启用内容过滤。路径风险:输出路径由调用方控制,需确保写入目录无敏感文件,防止覆盖攻击。

安全解读

核心用法

OpenClaw Visual 是一款本地图文生成工具,核心流程为:内容识别 → 模板选择 → HTML/CSS 生成 → 本地图片渲染 → 发送结果。用户可通过自然语言指令(如"帮我把这段话做成图片""生成今日日志分享图")触发,系统自动识别内容类型并匹配最佳模板。

模板体系

  • quote-card:800×800 方形金句卡片,适合社交媒体分享
  • moment-card:800×1000 竖版照片+描述,杂志风格
  • daily-journal:800×1200 日记手账,瑞士网格排版
  • social-share:1200×630 横向 OG 图片,适合成就展示
  • dashboard:1200×800 数据仪表盘,支持周/月汇总

渲染引擎

默认使用轻量快速的 node-html-to-image,当用户要求"精美/复杂"效果时自动切换至 playwright(Chromium)。所有操作本地完成,零外部 API 依赖。

显著优点

1. 完全本地化处理:图片生成不依赖外部服务,保障隐私与稳定性,适合敏感内容处理
2. 设计专业度高:采用瑞士风格网格系统、system-ui 字体栈、Lucide SVG 图标,视觉效果精致

3. 场景覆盖全面:从单条消息到完整日志、从静态卡片到数据仪表盘,满足多样化分享需求

4. 零配置开箱即用:依赖均为知名 npm 包,安装后即可使用,可选 Playwright 增强

潜在局限

1. 图片 URL 限制moment-card 模板中的照片需为公开可访问 URL,本地文件需先处理
2. 容器环境适配:使用 --no-sandbox 参数运行 Chromium,虽必要但需注意容器安全策略

3. 模板扩展门槛:新增模板需掌握 HTML/CSS,无可视化编辑器

4. 中文排版优化:系统字体栈在 Windows 环境可能回退至 Microsoft YaHei,非专业中文字体

适合人群

  • 重视隐私、不愿将内容上传至云端图像服务的用户
  • 需要统一视觉风格输出个人日志、思考碎片的知识管理爱好者
  • 在 Telegram/Discord/Slack 等即时通讯场景中频繁分享内容的社群运营者
  • OpenClaw/PhoenixClaw 生态的现有用户

常规风险

  • 输入验证缺失:JSON 内容参数缺乏 Schema 验证,畸形输入可能导致渲染失败
  • 依赖版本漂移package.json 使用 ^ 前缀,建议生产环境锁定版本
  • 输出路径覆盖:若用户指定已存在文件路径,将直接覆盖无提示

安全认证亮点

CLS-Certify 六维扫描全部满分:静态代码无危险函数、动态行为仅本地文件读写、依赖无 CVE、零网络请求、隐私合规完整、T2 可信来源认证。

openclaw-visual 内容

assets文件夹
css文件夹
templates文件夹
references文件夹
scripts文件夹
手动下载zip · 35.8 kB
base-styles.csstext/plain
请选择文件