📝 周报自动化配置手册
本手册介绍如何配置和使用 OpenClaw 自动生成技术周报。
版本 : v1.0
更新日期 : 2026 年 3 月 18 日
适用环境: OpenClaw / ClawX
📋 目录
🚀 快速开始
前置条件
-
OpenClaw 已安装并运行
bashopenclaw status -
工作区已初始化
- 确保
workspace/reports/目录存在 - 确保有可用的技能配置
- 确保
一键生成周报
bash
# 生成当周周报
openclaw run weekly-report
# 指定日期生成
openclaw run weekly-report --date 2026-03-18
生成的报告将保存在 workspace/reports/web-tech-weekly-YYYY-MM-DD.md
📁 目录结构
bash
workspace/
├── reports/ # 周报输出目录
│ └── web-tech-weekly-2026-03-18.md
├── skills/ # 技能配置
│ └── weekly-report/ # 周报生成技能
│ ├── SKILL.md # 技能说明
│ ├── config.json # 数据源配置
│ └── template.md # 报告模板
├── .openclaw/
│ └── config.json # OpenClaw 主配置
└── TOOLS.md # 本地工具配置
⚙️ 配置步骤
步骤 1: 创建周报技能目录
bash
mkdir -p workspace/skills/weekly-report
步骤 2: 配置数据源
创建 workspace/skills/weekly-report/config.json:
json
{
"name": "weekly-report",
"version": "1.0.0",
"description": "自动生成 Web 技术周报",
"dataSources": {
"github": {
"enabled": true,
"trendingLimit": 10,
"languages": ["TypeScript", "Python", "JavaScript", "Rust", "Zig"]
},
"microsoftBlogs": {
"enabled": true,
"feeds": [
"https://devblogs.microsoft.com/blog/feed/",
"https://devblogs.microsoft.com/azure-sdk/feed/",
"https://devblogs.microsoft.com/directx/feed/"
]
},
"hackerNews": {
"enabled": false,
"topLimit": 20
}
},
"output": {
"format": "markdown",
"directory": "reports",
"filenamePattern": "web-tech-weekly-{date}.md"
},
"publish": {
"juejin": {
"enabled": false,
"categoryId": "",
"tags": ["前端", "技术周报", "GitHub", "AI"]
}
}
}
步骤 3: 创建技能说明文件
创建 workspace/skills/weekly-report/SKILL.md:
markdown
# Weekly Report Skill
自动生成 Web 技术周报,包含:
- GitHub Trending 热门项目
- Microsoft Developer Blogs 精选
- 技术领域趋势分析
- 快速体验链接
## 使用方法
```bash
openclaw run weekly-report
配置
编辑 config.json 自定义数据源和输出格式。
yaml
### 步骤 4: 自定义报告模板(可选)
创建 `workspace/skills/weekly-report/template.md` 自定义报告格式。
---
## 📝 自定义周报模板
### 模板变量
模板支持以下变量:
| 变量 | 说明 | 示例 |
|------|------|------|
| `{date}` | 报告日期 | 2026 年 3 月 18 日 |
| `{weekNumber}` | 周数 | 第 12 周 |
| `{githubTrending}` | GitHub 热门项目列表 | Markdown 表格 |
| `{blogPosts}` | 博客文章列表 | Markdown 列表 |
| `{trendAnalysis}` | 趋势分析内容 | Markdown 文本 |
### 示例模板
```markdown
# 🌐 Web 前端技术周报
**日期**: {date}
**周数**: 第 {weekNumber} 周
---
## 🔥 GitHub Trending
{githubTrending}
---
## 📰 技术博客精选
{blogPosts}
---
## 🎯 趋势分析
{trendAnalysis}
🚀 发布到稀土掘金
方法一:手动发布(推荐首次使用)
-
打开稀土掘金
- 访问 juejin.cn
- 登录你的账号
-
创建文章
- 点击右上角「写文章」
- 选择「Markdown」模式
-
复制报告内容
bash# 查看最新报告 cat reports/web-tech-weekly-2026-03-18.md # 或者用编辑器打开 code reports/web-tech-weekly-2026-03-18.md -
粘贴并格式化
- 粘贴 Markdown 内容
- 检查格式是否正确
- 添加合适的封面图
-
设置分类和标签
- 分类:前端 / 人工智能 / 开源
- 标签:
前端技术周报GitHubAI 编程
-
发布
- 预览确认无误
- 点击发布
方法二:使用掘金 CLI 工具(自动化)
安装掘金 CLI
bash
npm install -g juejin-cli
配置认证
bash
juejin login
按提示输入账号密码或 Cookie。
发布命令
bash
# 发布最新周报
juejin publish reports/web-tech-weekly-2026-03-18.md \
--category frontend \
--tags "前端,技术周报,GitHub,AI" \
--title "Web 前端技术周报 | 2026-03-18"
方法三:通过 OpenClaw 自动发布
在 config.json 中启用自动发布:
json
{
"publish": {
"juejin": {
"enabled": true,
"cookie": "YOUR_JUEJIN_COOKIE",
"categoryId": "frontend",
"tags": ["前端", "技术周报", "GitHub", "AI"],
"autoPublish": true,
"publishTime": "Wednesday 09:00"
}
}
}
⚠️ 安全提示: Cookie 应存储在环境变量或加密配置中,不要提交到版本控制。
⏰ 定时任务配置
Windows 任务计划程序
-
打开任务计划程序
- Win + R 输入
taskschd.msc
- Win + R 输入
-
创建基本任务
- 名称:
OpenClaw Weekly Report - 触发器:每周三 08:00
- 操作:启动程序
- 名称:
-
配置程序
arduino程序/脚本:openclaw 参数:run weekly-report --auto-publish 起始目录:C:\Users\haoqianghu\.openclaw\workspace
使用 cron(Linux/Mac)
bash
# 编辑 crontab
crontab -e
# 添加每周三早上 8 点执行
0 8 * * 3 cd /path/to/workspace && openclaw run weekly-report --auto-publish
OpenClaw 内置定时
在 .openclaw/config.json 中配置:
json
{
"schedules": {
"weekly-report": {
"cron": "0 8 * * 3",
"command": "run weekly-report",
"enabled": true
}
}
}
❓ 常见问题
Q1: 生成的报告内容为空?
检查项:
- 网络连接是否正常
- 数据源 API 是否可访问
- 技能是否正确安装
bash
# 检查技能状态
openclaw skills list
# 重新安装技能
openclaw skills install weekly-report
Q2: 发布到掘金失败?
可能原因:
- Cookie 过期(重新登录获取)
- 网络问题(检查代理设置)
- 内容格式不符合掘金规范
解决方案:
bash
# 重新登录掘金
juejin login
# 检查 Cookie 是否有效
juejin info
Q3: 如何自定义数据源?
编辑 config.json 添加新的数据源:
json
{
"dataSources": {
"custom": {
"enabled": true,
"type": "rss",
"url": "https://example.com/feed.xml",
"limit": 5
}
}
}
Q4: 如何修改报告风格?
编辑 template.md 文件,可以:
- 调整章节顺序
- 修改标题格式
- 添加或删除章节
- 自定义 Emoji 和样式
Q5: 如何发布到多个平台?
在配置中添加多个发布目标:
json
{
"publish": {
"juejin": { "enabled": true, ... },
"zhihu": { "enabled": true, ... },
"wechat": { "enabled": true, ... }
}
}
🔧 高级配置
环境变量
bash
# 设置掘金 Cookie
export JUEJIN_COOKIE="your_cookie_here"
# 设置 GitHub Token(提高 API 限额)
export GITHUB_TOKEN="your_token_here"
# 设置代理
export HTTP_PROXY="http://proxy.example.com:8080"
自定义过滤规则
在 config.json 中添加过滤规则:
json
{
"filters": {
"minStars": 1000,
"excludeKeywords": ["deprecated", "archived"],
"includeKeywords": ["AI", "WebGPU", "Agent"],
"languageWeights": {
"TypeScript": 1.5,
"Python": 1.2,
"Rust": 1.0
}
}
}
📚 相关资源
🤝 贡献与反馈
如有问题或建议,欢迎:
- 提交 Issue 到 OpenClaw 仓库
- 在 Discord 社区讨论
- 邮件反馈至支持团队
最后更新 : 2026 年 3 月 18 日
维护者: OpenClaw Community