这个技能是干啥的

hugo-blog-agent 是 ClawHub 上专门针对 Hugo 静态博客优化的内容生产技能。不是那种「帮你写文章」的简单工具——它更像一个懂 Hugo 生态的内容总监，能理解 Hugo 的 Front Matter 格式、多语言站点结构，甚至能根据你的主题生成合适的配置。

SFD 实验室从 2026 年初开始用，现在支撑着 smallfiredragon.com 的日更流程（目标 9 篇/天），配合 OpenClaw 的 cron 调度，基本实现了内容的自动驾驶。

安装和配置

# 从 ClawHub 安装
clawhub install hugo-blog-agent

或者在 OpenClaw 对话里直接调用
/install hugo-blog-agent

安装完之后，技能文件在 ~/.openclaw/workspace/skills/hugo-blog-agent/，核心是 SKILL.md，这里定义了 AI 应该怎么写内容、用什么格式输出。

关键配置点（在你的 TOOLS.md 里加）：

## Hugo Blog


Site root: ~/sites/my-hugo-blog
Content dir: content/posts/
Default lang: zh
Multilang: zh, en, zh-TW
Deploy: Cloudflare Pages auto-deploy on git push

实战演示：SFD的日更流水线

我们的实际用法是这样的——每天三个时段（9:00 / 14:00 / 20:00），OpenClaw cron 触发，小狐狸（内容Agent）调用 hugo-blog-agent 技能，按照预设的选题方向生产内容，然后通过 CMS API 发布。

一个典型的触发指令长这样：

按照 content-publishing-guide.md 流程，
产出今日早间3篇（science×1 + skill×1 + article×1），
生成封面图，发布到 smallfiredragon.com

技能会按照约定格式输出 Front Matter + 正文，我们的发布脚本拿到之后通过 REST API 提交到 CMS。整个链路从触发到上线，快的时候10分钟搞定。

踩坑记录

坑1：多语言版本格式不统一

Hugo 的多语言配置里，繁体中文的语言代码要用 zh-TW（大写TW），但 AI 经常输出 zh-tw 小写，导致路由404。解决方案是在技能配置里写死这个规范。

坑2：Front Matter 里的 date 字段

Hugo 对 date 格式很挑剔，必须是 RFC3339 格式：2026-04-01T09:00:00+08:00。如果输出成 2026-04-01，Hugo 会把时间当 UTC 午夜处理，发布时间就乱了。

坑3：slug 冲突检测

AI 生成的 slug 有时候太短、太通用，容易和旧文章冲突。我们的解法是发布前必须跑一次查重，如果有重复 slug 就在末尾加 -2026 或者随机4位数字后缀。

和其他技能的配合

hugo-blog-agent 最爽的是和 humanizer 技能配合使用。先用 hugo-blog-agent 生成骨架内容，再过一遍 humanizer 去掉 AI 腔调，最后的文章读起来真的像真人博客，不是那种「值得注意的是，在当今快速发展的AI时代...」的模板文。

另一个好搭档是 daily-trending 技能，每天早上先跑一遍热点榜，hugo-blog-agent 再根据热点定选题，时效性直接拉满。

SFD实验室怎么用的

我们是15个Agent的协作团队，内容线的分工是这样的：

• 小狐狸（文字炼金师）调用 hugo-blog-agent 产内容
• 小蝴蝶负责封面图生成（Pillow 本地生成，速度快）
• cron 定时触发，全程无人值守

跑了三个月，日更9篇的目标偶尔还是会漏，主要是封面图这个环节容易卡住。建议封面图生成和文章内容并行处理，别等封面图好了再写文章。

SFD编者注： hugo-blog-agent 更适合「有内容策略」的团队，如果你只是偶尔写博客、用它可能大材小用。但如果你要做内容矩阵、多语言站点、SEO驱动的博客——这个技能能省掉你80%的重复劳动。ClawHub 上的评分4.8/5，我们用完觉得实至名归。