English Daily Report

生成每日英语学习报告，包含新闻摘要、中文翻译、词汇注释、PDF 和音频版本。适用于：(1) 接收每日英语新闻摘要进行学习，(2) 获取中文翻译和词汇注释，(3) 生成 PDF 和音频版本用于离线学习

English Daily Report Skill - 英语每日报告

生成每日英语学习报告，包含新闻摘要、中文翻译、词汇注释、PDF 和音频版本。

⚠️ 前置依赖要求

安装前请确认以下依赖已就绪：

🔒 安全说明

本技能包含 PDF 生成脚本，已实施以下安全措施：

• HTML 转义防护：所有用户输入内容（标题、内容、翻译、词汇）均经过 HTML 实体转义
• 沙箱建议：脚本在用户本地 workspace 运行，不访问外部网络
• 代码审查：脚本开源可审计，位于 scripts/generate-pdf-html.sh

建议：首次使用前可审查脚本代码，确认无恶意内容。

依赖	类型	用途	是否必需
Bash	Shell	运行生成脚本	✅ 必需
Chrome/Chromium	系统应用	无头模式渲染 PDF	✅ 必需
TTS 工具	OpenClaw 工具	生成音频 (MP3)	✅ 必需
web_fetch 工具	OpenClaw 工具	抓取新闻网页	✅ 必需
web_search 工具	OpenClaw 工具	搜索今日新闻	⚠️ 可选（需 API 密钥）
BRAVE_API_KEY	环境变量	web_search 的 API 密钥	⚠️ 可选

检查依赖

# 检查 Chrome/Chromium
# macOS:
test -f "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" && echo "Chrome OK"
# Linux:
command -v google-chrome || command -v chromium || command -v chromium-browser

# 检查 TTS 工具（OpenClaw 内置）
openclaw help tts

安装 Chrome（如未安装）

• macOS: https://www.google.com/chrome/
• Linux: sudo apt install chromium-browser 或 sudo yum install chromium
• Windows (WSL): 使用 Windows Chrome 路径

配置 TTS

TTS 使用 OpenClaw 内置工具，无需额外配置。可选配置语速：

// ~/.openclaw/openclaw.json
{
  "messages": {
    "tts": {
      "edge": {
        "rate": "-15%"  // 负值=更慢，适合英语学习
      }
    }
  }
}

配置 Brave API（可选，用于真实新闻搜索）

# 获取 API 密钥：https://brave.com/search/api/
openclaw configure --section web
# 或设置环境变量：export BRAVE_API_KEY=your_key

---

工作流程

1. 获取新闻

模式 A：真实新闻抓取（优先）

使用 web_search 或 web_fetch 获取今日英语新闻：

# 前提：需要配置 Brave Search API 密钥
# 配置方法：openclaw configure --section web 或设置 BRAVE_API_KEY 环境变量

# 方式 1：使用 web_search 搜索今日新闻（freshness="pd" 表示过去一天）
web_search query="tech news" freshness="pd" count="5"
# 从返回结果中选择 1-2 篇，用 web_fetch 抓取具体内容

# 方式 2：直接用 web_fetch 尝试多个新闻源（无需 API 密钥）
# 按顺序尝试，直到成功获取内容
web_fetch url="https://www.chinadaily.com.cn/world"
web_fetch url="https://news.cgtn.com/"
web_fetch url="https://www.shanghaidaily.com/"
web_fetch url="https://www.globaltimes.cn/"
# 选择 1-2 篇相关新闻进行摘要

⚠️ 重要：多链接尝试策略

单个链接失败时，应依次尝试多个备用链接：

1. 先试首页/栏目页（如 /world、/china）
2. 再试具体文章页（从首页提取链接）
3. 至少尝试 3 个不同来源
4. 全部失败后才降级为模拟新闻模式

模式 B：模拟新闻生成（降级方案）

当无法获取真实新闻时（如 API 未配置、网站无法访问），生成模拟新闻用于学习：

- 基于当前时事趋势生成合理的新闻主题
- 创建约 100 词的英语学习材料
- 内容用于语言学习，非真实新闻报道

⚠️ 重要：内容来源标注

生成的报告必须明确标注内容来源：

• 真实新闻：标注新闻来源和原始链接
• 模拟新闻：标注"学习材料 · 非真实新闻"

这样用户不会误将模拟内容当作真实新闻。

2. 创建摘要

创建约 100 词的英语摘要，包含：

• Title（标题）: 清晰、描述性的 headline
• Content（内容）: 约 100 词，涵盖关键事实
• Chinese translation（中文翻译）: 完整翻译（全文释义）
• Vocabulary（词汇）: 5-8 个不常见单词及中文释义

3. 生成 PDF

使用附带的脚本：

# 格式：scripts/generate-pdf-html.sh "DATE" "TYPE" "TITLE" "CONTENT" "TRANSLATION" "word1:meaning1" ...
# TYPE: "real" = 真实新闻，"study" = 学习材料（模拟新闻）

# 真实新闻示例：
scripts/generate-pdf-html.sh "2026-03-26" "real" "News Title" "English content..." "中文翻译..." "word1:释义 1" ...

# 学习材料示例：
scripts/generate-pdf-html.sh "2026-03-26" "study" "News Title" "English content..." "中文翻译..." "word1:释义 1" ...

脚本功能：

• 根据 TYPE 参数显示不同的内容类型徽章（真实新闻/学习材料）
• 学习材料模式自动添加黄色警告框
• 创建带有漂亮渐变标题的 HTML
• 使用系统默认字体（自动检测中文字体）
• 通过 Chrome 无头模式转换为 PDF
• 保存到 uploads/english-daily-DATE.pdf

4. 生成音频

使用 TTS 工具将英语摘要转换为语音，然后复制到 uploads 目录：

# 生成 TTS 音频
tts text="<English news summary>"

# TTS 工具返回类似 /tmp/openclaw/tts-xxx/voice-xxx.mp3 的音频路径
# 使用正确的命名复制到 uploads：
cp <tts-output-path> uploads/english-daily-DATE.mp3

保存到 uploads/english-daily-DATE.mp3

调整语速

如果音频语速太快，可以在 openclaw.json 中配置 TTS 语速：

{
  messages: {
    tts: {
      edge: {
        enabled: true,
        voice: "en-US-MichelleNeural",
        lang: "en-US",
        rate: "-15%",  // 负值 = 更慢，正值 = 更快（范围：-50% 到 +50%）
        pitch: "-5%",
      },
    },
  },
}

英语学习推荐语速：

• -10% 到 -20%: 较慢，更适合学习者
• 0%: 正常语速
• +10% 到 +20%: 较快，更自然的会话节奏

你也可以使用 /tts 命令在每个会话中调整设置。

5. 发送给用户

通过 Feishu（或其他渠道）发送三条消息：

1. 文本版本: 格式化的摘要和词汇注释
2. 音频版本: TTS 生成的 MP3，用于听力练习
3. PDF 版本: 精美的可打印 PDF

文件结构

english-daily-report/
├── SKILL.md（本文件）
├── scripts/
│   └── generate-pdf-html.sh  # PDF 生成脚本
└── references/
    └── example-report.md     # 示例报告格式

输出格式

文本版本

真实新闻模式：

📰 English Daily Report - 2026-03-26
【真实新闻 · Real News】

**China's Quantum Computing Breakthrough Achieves New Milestone**
来源：China Daily
原文链接：https://www.chinadaily.com.cn/a/202603/26/WSxxxxx.html

English content (~100 words)...

---

📖 全文释义

中文完整翻译...

---

📝 Vocabulary & Grammar Notes:

- **word1** (pos.): 中文释义
- **word2** (pos.): 中文释义
...

模拟新闻模式：

📰 English Daily Report - 2026-03-26
【学习材料 · Study Material · 非真实新闻】

**Global Education Technology Market Sees Rapid Growth**
⚠️ 本文为英语学习材料，基于真实时事趋势编写，非真实新闻报道

English content (~100 words)...

---

📖 全文释义

中文完整翻译...

---

📝 Vocabulary & Grammar Notes:

- **word1** (pos.): 中文释义
- **word2** (pos.): 中文释义
...

⚠️ 标注要求：

• 必须在报告开头清晰标注内容类型
• 真实新闻：注明来源和链接
• 模拟新闻：注明"非真实新闻"，避免误导

PDF 版本

• 带有标题和日期的渐变标题
• 英语摘要部分
• 中文翻译部分
• 词汇部分（高亮显示单词）
• 页脚带有学习计划品牌标识

音频版本

• TTS 生成的英语朗读
• 清晰的发音，适合学习
• 保存为 MP3 格式，支持离线收听

提示

新闻来源

国际新闻（某些地区可能需要代理）：

• Reuters: https://www.reuters.com/
• BBC: https://www.bbc.com/news
• NPR: https://www.npr.org/
• AP News: https://apnews.com/

国内英语新闻（无需代理即可访问）：

• China Daily: https://www.chinadaily.com.cn/
• CGTN: https://news.cgtn.com/
• Shanghai Daily: https://www.shanghaidaily.com/
• Global Times: https://www.globaltimes.cn/
• Xinhua English: http://www.xinhuanet.com/english/

其他提示

• 词汇选择: 选择 5-8 个不常见但实用的单词
• 音频长度: 保持在 1 分钟以内，提高参与度
• PDF 设计: 系统字体自动检测中文字符
• 一致性: 每天固定时间发送，帮助养成学习习惯

故障排除

依赖检查

检查所有依赖是否就绪：

# Bash (通常已预装)
bash --version

# Chrome/Chromium
# macOS:
test -f "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" && echo "Chrome OK" || echo "Chrome NOT FOUND"
# Linux:
command -v google-chrome || command -v chromium || echo "Chrome/Chromium NOT FOUND"

# OpenClaw 工具
openclaw help tts
openclaw help web_fetch

Chrome/Chromium 未找到

错误信息： ERROR: Chrome/Chromium not found

解决方案：

1. 安装 Chrome：https://www.google.com/chrome/
2. 或安装 Chromium：
   • Ubuntu/Debian: sudo apt install chromium-browser
   • CentOS/Fedora: sudo yum install chromium
   • macOS: 使用 Homebrew brew install --cask google-chrome

web_search 提示 "missing_brave_api_key"

web_search 需要 Brave Search API 密钥（可选）。

解决方案：

1. 申请 API 密钥：https://brave.com/search/api/
2. 运行 openclaw configure --section web 存储密钥
3. 或在 Gateway 环境中设置 BRAVE_API_KEY 环境变量
4. 或不配置：技能会降级为多链接 web_fetch 模式或模拟新闻模式

TTS 音频生成失败

错误信息： TTS conversion failed

原因： 未配置 TTS 提供商（Edge TTS 默认启用，无需 API 密钥）

解决方案：

1. 确认 OpenClaw 配置中启用了 Edge TTS（默认启用）
2. 检查网络连接（Edge TTS 需要访问微软服务）
3. 或配置 OpenAI/ElevenLabs API 密钥作为备选

web_fetch 失败，显示 "fetch failed"

这通常意味着网站被阻止或网络无法访问。

解决方案：

1. 尝试其他新闻来源（参见提示部分）
2. 使用国内英语新闻（China Daily、CGTN 等）
3. 在 Gateway 环境中配置网络代理
4. 降级为模拟新闻模式（用于学习目的）

PDF 中文字符显示为方框

macOS 上不应该出现此问题（自动检测中文字体）。如果出现方框：

• 检查 Chrome 是否已安装：/Applications/Google Chrome.app/Contents/MacOS/Google Chrome
• 确保系统支持中文字体

找不到 Chrome/Chromium

脚本会自动检测以下位置的 Chrome/Chromium：

• macOS: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
• Linux: google-chrome、chromium 或 chromium-browser（通过 PATH）
• Windows (WSL): /mnt/c/Program Files/Google/Chrome/Application/chrome.exe

如果未找到，请安装 Chrome 或确保它在 PATH 中。

TTS 音频未保存

TTS 工具会自动返回音频。使用 message 工具发送音频文件路径。

脚本权限被拒绝

确保脚本可执行：

chmod +x ~/.openclaw/workspace/skills/english-daily-report/scripts/generate-pdf-html.sh