weekly-report-openclaw（weekly report OpenClaw 文档）

Weekly Report - 周报自动生成系统

自动化工作周报生成工具，支持从周报系统获取数据、AI 智能总结、生成 Word 文档。

快速开始

1. 环境准备

首次使用前，运行自动安装脚本配置环境：

Windows (PowerShell):

cd skills/weekly-report/scripts
./setup.ps1

macOS / Linux (Bash):

cd skills/weekly-report/scripts
chmod +x setup.sh
./setup.sh

安装脚本会自动检测并安装：

• Python 3.10+ (需要预先安装)
• uv 包管理器
• Python 依赖包
• Playwright Chromium 浏览器

国内用户: 脚本会自动检测网络环境，在无法访问 Google 时使用国内镜像源加速下载。

<details> <summary>手动安装（可选）</summary>

如果不想使用自动脚本，可以手动安装：

# 安装 uv (Windows)
irm https://astral.sh/uv/install.ps1 | iex

# 安装 uv (macOS/Linux)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安装依赖
cd skills/weekly-report/scripts
uv sync

# 安装 Playwright Chromium
uv run playwright install chromium
uv run playwright install-deps chromium  # Linux 需要

</details>

2. 配置环境变量

export WEEKLY_REPORT_USERNAME="your_username"
export WEEKLY_REPORT_PASSWORD="your_password"
export DEEPSEEK_API_KEY="your_api_key"

3. 生成周报

# 生成本周周报
uv run python generate.py --week today

# 生成上周周报
uv run python generate.py --week last

# 生成指定日期所在周的周报
uv run python generate.py --week 2026-03-07

命令说明

generate.py - 生成周报

主脚本，执行完整的周报生成流程。

python generate.py [OPTIONS]

选项：

• --week, -w: 周日期，支持 today（本周）、last（上周）、YYYY-MM-DD（指定日期）
• --team, -t: 团队名称，默认使用配置中的团队
• --output, -o: 输出文件名，不指定则自动生成
• --force-login, -f: 强制重新登录，不使用缓存的 token
• --headless: 无头模式运行浏览器
• --verbose, -v: 详细输出模式

输出格式（JSON）：

{
  "success": true,
  "output_file": "output/周报_科创研发组_2026-03-02-2026-03-08.docx",
  "items_count": 25,
  "filtered_count": 25,
  "week_range": "2026.03.02-2026.03.08"
}

login.py - 登录管理

单独执行登录操作，用于获取和缓存认证 token。

python login.py [OPTIONS]

选项：

• --force, -f: 强制重新登录
• --headless, -H: 无头模式

输出格式（JSON）：

{
  "success": true,
  "message": "Login successful, token cached"
}

工作分类说明

周报内容按以下分类整理：

团队成员配置

可在 config/settings.yaml 或通过 --team-members 参数配置团队成员列表，只有列表中的成员周报会被包含在最终文档中。

示例用法

# 生成科创研发组本周周报
uv run python generate.py --team "科创研发组" --week today

# 强制重新登录后生成上周周报
uv run python generate.py --week last --force-login

# 无头模式生成周报（适用于 CI/CD）
uv run python generate.py --week today --headless

# 指定输出文件名
uv run python generate.py --week today --output "周报_2026年第10周.docx"

详细文档

• 配置说明
• 工作流程