本文记录使用 OpenClaw Agent 辅助 Hugo 博客管理的完整实践。通过将博客运维知识封装为 AgentSkills，实现：

• 技能化运维 — 将 Hugo 命令和工作流封装为可复用的技能
• 自然语言交互 — 用对话方式启动服务器、编译部署
• 自动化脚本 — 一键创建文章、编译发布
• 零成本部署 — 配合 GitHub Pages 搭建免费博客

一、为什么是 Hugo？

静态网站生成器的优势

Hugo 是一款用 Go 编写的静态网站生成器，核心特点是快和简单。

核心优势：

适合的场景

• 个人博客 — 专注写作，无需数据库
• 文档站点 — 技术文档、产品手册
• 作品集 — 摄影、设计作品展示
• 项目主页 — 开源项目介绍页

二、OpenClaw 如何辅助 Hugo？

核心理念：技能化运维

将博客运维的知识和经验封装为 AgentSkills，让 Agent 理解你的工作流，而不是死记命令。

传统方式：

# 每次都要查文档、记参数
hugo server --bind 0.0.0.0 --port 1313 -t hugo-theme-stack --buildDrafts

技能化方式：

用户：本地启动 Hugo 服务器
Agent：✅ 已启动，访问 http://localhost:1313/

技能结构设计

hugo-blog-sre/
├── SKILL.md              # 技能定义：工作目录、命令、注意事项
├── scripts/
│   ├── deploy.sh         # 一键部署脚本
│   └── new-post.sh       # 创建新文章模板
└── references/           # 参考资料

SKILL.md 核心内容：

1. 工作目录 — 博客根目录路径
2. 目录结构 — content/themes/public 等核心目录说明
3. 常用命令 — 本地预览、编译构建的完整参数
4. 部署流程 — Git 推送步骤
5. 注意事项 — 常见坑和解决方案

三、核心工作流

1. 本地预览

目的：写作时实时预览效果

关键参数：

• --bind 0.0.0.0 — 监听所有网络接口（默认只监听 localhost）
• --port 1313 — 指定端口（Hugo 默认就是 1313）
• --buildDrafts — 包含草稿文章（draft = true 的文章）

典型命令：

hugo server --bind 0.0.0.0 --port 1313 --buildDrafts

特性说明：

• 热重载 — 保存文件后浏览器自动刷新
• 快速渲染 — 默认启用 Fast Render Mode，只重新渲染变更部分
• 内存服务 — 不写磁盘，编译结果在内存中，速度快

2. 编译构建

目的：生成可部署的静态文件

关键参数：

• --theme — 指定主题
• --baseURL — 设置站点根 URL（生产环境必须正确配置）
• --minify — 压缩输出（HTML/CSS/JS）

典型命令：

hugo --theme=hugo-theme-stack --baseURL "https://winterorch.github.io" --minify

输出目录：public/

编译完成后，public/ 目录包含完整的静态网站文件，可以直接部署到任何 Web 服务器。

3. GitHub Pages 部署

核心思路：public/ 目录通过 Git 推送到 GitHub 仓库，GitHub Pages 自动托管。

方案一：Git Submodule（推荐）

将 public/ 目录配置为指向 GitHub Pages 仓库的 submodule：

# 初始化 submodule（一次性操作）
cd hugo-personal-blog-workspace
git submodule add -b main git@github.com:winterorch/winterorch.github.io.git public

# 日常部署
hugo --theme=hugo-theme-stack --baseURL "https://winterorch.github.io" --minify
cd public
git add .
git commit -m "Deploy blog update"
git push

优势：

• 博客源码和部署文件分离
• 可以在同一仓库管理内容和工作流
• 推送即部署，GitHub Pages 自动更新

方案二：独立仓库

将 public/ 目录内容手动复制到独立的 GitHub Pages 仓库：

# 编译
hugo --theme=hugo-theme-stack --baseURL "https://winterorch.github.io" --minify

# 复制到部署仓库
cp -r public/* ~/repos/winterorch.github.io/
cd ~/repos/winterorch.github.io/
git add .
git commit -m "Deploy blog update"
git push

四、自动化脚本

一键部署脚本 (deploy.sh)

将编译和推送封装为单命令：

#!/bin/bash
BLOG_DIR="/home/kumiko/repositories/hugo-personal-blog-workspace"
BASE_URL="https://winterorch.github.io"

cd "$BLOG_DIR"
hugo --theme=hugo-theme-stack --baseURL "$BASE_URL" --minify

cd "$BLOG_DIR/public"
git add .
git commit -m "Deploy blog update" || echo "无变更"
git push

使用：

./scripts/deploy.sh

新文章模板 (new-post.sh)

自动生成带 Front Matter 的文章模板：

#!/bin/bash
TITLE="$1"
FILENAME=$(echo "$TITLE" | tr '[:upper:]' '[:lower:]' | tr ' ' '-')
DATE=$(date +%Y-%m-%d)

mkdir -p "content/post/${FILENAME}"
cat > "content/post/${FILENAME}/index.md" << EOF
+++
author = "天心"
title = "$TITLE"
slug = "$FILENAME"
date = "$DATE"
draft = true
+++

<!-- 正文内容 -->
EOF

使用：

./scripts/new-post.sh "我的新文章"

五、OpenClaw 技能化实践

技能触发条件

当用户提到以下内容时唤起 hugo-blog-sre 技能：

1. Hugo 博客相关操作
2. 本地启动预览服务器
3. 编译构建博客
4. 询问目录结构或配置

技能封装的价值

知识沉淀：

• 将运维经验固化为技能文档
• 新人接手无需重新学习命令
• 避免"这个参数是什么来着？“的重复查询

效率提升：

• 自然语言交互，无需记忆命令
• Agent 自动处理参数和路径
• 错误提示和解决方案内置

可扩展性：

• 可以轻松添加新脚本（如图片优化、SEO 检查）
• 支持多博客仓库管理
• 可集成 CI/CD 流程

六、扩展方向

可能的改进

1. 草稿管理 — 自动检测草稿文章，提醒发布
2. 图片优化 — 编译前自动压缩图片
3. SEO 检查 — 验证 Front Matter 完整性
4. 多环境配置 — 区分开发/生产环境
5. 备份机制 — 定期备份 content 目录

与其他工具集成

• Obsidian — 在 Obsidian 写作，自动同步到 Hugo content 目录
• GitHub Actions — 推送代码后自动编译部署
• 域名管理 — 自动配置 Cloudflare DNS
• 统计集成 — 自动注入 Google Analytics / Umami

七、成本分析

时间成本

金钱成本

总计：零成本起步，可选域名升级

八、注意事项

1. baseURL 配置 — 生产环境必须正确设置，否则资源路径会错
2. 草稿文章 — 编译发布时确认去掉 --buildDrafts
3. Submodule 更新 — 拉取代码后记得 git submodule update --init
4. 主题依赖 — 主题更新可能破坏布局，先在本地测试
5. Git 历史 — public 目录的 Git 历史独立于主仓库，不要混在一起

九、参考资料

• Hugo 官方文档
• Hugo 中文文档
• Stack 主题
• GitHub Pages 文档
• OpenClaw AgentSkills 规范

本文记录了 OpenClaw 辅助 Hugo 博客管理的完整工作流，核心是将运维知识技能化，让 Agent 理解并执行你的意图。