- name
- blogger-auto-publish
- description
- Automatically publish Markdown articles to Google Blogger. Supports batch publishing, draft management, and automatic HTML conversion.
Blogger Auto-Publish Skill
版本: 1.1.0 发布日期: 2026-03-28 更新日期: 2026-03-28 (Live Implementation) 兼容性: OpenClaw >= 2026.3.0 状态: 生产就绪 ✅
⚠️ 重要前提条件
使用此技能前，你必须准备好以下文件：
1. Google API凭据 (credentials.json)
- 从Google Cloud Console创建项目
- 启用Blogger API v3
- 创建OAuth 2.0凭据（Web应用类型）
- 下载
credentials.json文件
2. 博客ID
- 登录你的Blogger账户
- 找到要发布的博客
- 获取博客的数字ID（查看博客URL中的数字部分）
3. 首次授权
- 运行授权脚本生成
token.json - 完成浏览器OAuth流程
🎯 技能描述
自动将Markdown文章发布到Google Blogger博客。支持：
- 批量发布文章
- 定时发布
- 草稿管理
- 英文内容验证
- Markdown到HTML转换
📋 功能特性
核心功能
- ✅ 自动发布Markdown文章到Blogger
- ✅ 支持草稿和已发布状态
- ✅ 批量处理多个文章
- ✅ 自动HTML转换
管理功能
- ✅ 列出所有博客文章
- ✅ 删除测试文章
- ✅ 管理草稿
- ✅ 查找博客ID
工具功能
- ✅ 完整的授权流程
- ✅ 配置管理
- ✅ 错误处理和日志
- ✅ 环境变量支持
🚀 快速开始
步骤1：安装依赖
npm install googleapis@latest步骤2：配置项目
- 复制
credentials.json到项目根目录 - 设置博客ID（环境变量或config.js）
- 运行首次授权
步骤3：使用示例
# 列出所有博客
node list_blogs.js
# 发布文章
node publish.js --file posts/my-article.md
# 管理草稿
node delete-all-drafts.js📁 项目结构
blogger-auto-publish/
├── auth.js # 授权模块
├── blogger.js # 主发布模块
├── config.js # 配置文件
├── credentials.json # Google API凭据（用户提供）
├── token.json # 授权token（自动生成）
├── list_blogs.js # 列出博客
├── publish.js # 发布文章
├── delete-all-drafts.js # 删除所有草稿
├── delete-test-posts.js # 删除测试文章
├── direct-delete-drafts.js # 直接删除草稿
├── find-blog-id.js # 查找博客ID
├── complete-auth.js # 完整授权流程
├── index.js # 主入口文件
├── package.json # 项目配置
├── posts/ # 文章目录
│ └── example-post.md # 示例文章
└── scripts/ # 工具脚本
└── setup-blogger.sh # 安装脚本🔧 详细使用指南
1. 获取Google API凭据
- 访问 Google Cloud Console
- 创建新项目或选择现有项目
- 启用Blogger API v3
- 创建OAuth 2.0凭据（Web应用）
- 设置重定向URI：
http://localhost:3000/oauth2callback - 下载
credentials.json
2. 获取博客ID
- 登录 Blogger
- 进入博客设置
- 查看URL中的数字ID，或使用
find-blog-id.js脚本
3. 首次授权
# 设置环境变量
export BLOG_ID="你的博客ID"
# 运行授权
node auth.js login
# 或使用完整授权脚本
node complete-auth.js4. 发布文章
# 发布单篇文章
node publish.js --file posts/my-article.md --title "文章标题"
# 发布为草稿
node publish.js --file posts/draft.md --draft
# 批量发布
for file in posts/*.md; do
node publish.js --file "$file"
done📝 文章格式要求
Markdown文件结构
---
title: 文章标题
labels: 标签1,标签2,标签3
draft: false
---
# 文章内容
这里是文章的Markdown内容...
- 支持标准Markdown语法
- 支持代码块
- 支持图片链接元数据字段
title: 文章标题（必需）labels: 标签，逗号分隔（可选）draft: 是否作为草稿发布，true/false（可选，默认false）
⚙️ 配置选项
环境变量
export BLOG_ID="YOUR_BLOG_ID_HERE"
export CREDENTIALS_PATH="./credentials.json"
export TOKEN_PATH="./token.json"
export POSTS_DIR="./posts"config.js 配置
module.exports = {
blogId: process.env.BLOG_ID || "YOUR_BLOG_ID_HERE",
credentialsPath: process.env.CREDENTIALS_PATH || "./credentials.json",
tokenPath: process.env.TOKEN_PATH || "./token.json",
postsDir: process.env.POSTS_DIR || "./posts",
maxRetries: 3,
retryDelay: 1000,
};🔍 故障排除
常见问题
- 授权失败
- 检查credentials.json文件是否正确 - 确保重定向URI配置正确 - 删除旧的token.json重新授权
- 博客ID错误
- 使用find-blog-id.js查找正确ID - 确保有博客的编辑权限
- 发布失败
- 检查网络连接 - 验证API配额是否充足 - 查看错误日志详细信息
错误代码
401: 授权无效，重新运行授权403: 权限不足，检查博客权限404: 博客ID错误，验证博客ID429: API配额超限，等待后重试
📊 性能优化
批量处理建议
- 一次处理不超过10篇文章
- 添加延迟避免API限制
- 使用草稿模式先验证
资源管理
- 定期清理旧的
token.json - 备份
credentials.json - 使用环境变量管理敏感信息
🔄 更新日志
v1.0.0 (2026-03-28)
- 初始稳定版本
- 完整的发布功能
- 详细的文档
- 打包为OpenClaw技能
📞 支持与反馈
如有问题或建议：
- 查看
references/目录中的详细文档 - 运行
node index.js --help查看帮助 - 检查错误日志获取详细信息
🎯 技能触发条件
当OpenClaw检测到以下需求时自动触发：
- 自动发布文章到Blogger
- 批量或定时发布
- Blogger API集成需求
- Markdown到Blogger转换
🚀 实际应用案例
此技能已经过完整测试和验证：
✅ 已验证功能
- 博客连接: 成功连接到Google Blogger平台
- OAuth授权: 完整的Google OAuth 2.0流程已实现
- 文章发布: Markdown文章可成功发布为草稿或正式文章
- API集成: Blogger API v3 完全集成
🔧 配置要求
- 凭据文件: 用户需要提供自己的
credentials.json - 授权令牌: 首次运行时会自动生成
token.json - 博客ID: 用户需要提供自己的Blogger博客ID
- 依赖包: 需要安装
googleapis@latest
📝 测试流程
- ✅ API连接测试: 验证与Google API的连接
- ✅ 博客列表测试: 检索用户博客信息
- ✅ 发布测试: 示例文章发布测试
- ✅ 授权测试: OAuth授权流程测试
🛠️ 包含的文件
auth.js- OAuth授权模块publish.js- 发布主模块config.js- 配置文件package.json- 项目配置README.md- 使用说明posts/example-post.md- 示例文章SETUP.md- 详细设置指南credentials-example.json- 凭据模板文件
重要: 此技能不包含任何敏感凭据文件。用户需要按照SETUP.md指南自行配置Google API凭据和博客ID。