qclaw接入腾讯新闻的实现教程（API Key配置 + Skills部署）

关键词：qclaw接入腾讯新闻、qclaw配置API Key、腾讯新闻Skills使用、腾讯新闻API对接、Agent部署技能、CLI配置API Key

---

作为前端开发，在做内容聚合、资讯类应用或者 AI Agent 能力扩展时，新闻数据是非常核心的一环。

这篇文章系统讲清楚：

• 腾讯新闻 Skills 是什么
• 如何获取 API Key
• 如何在 qclaw / Agent 中部署技能
• 如何通过 CLI 完成配置
• 常见问题与安全注意事项

---

一、腾讯新闻 Skills 是什么？

腾讯新闻 Skills 提供：

7×24 小时新闻资讯能力
覆盖国内信息与国际热点内容

在技能体系中包含多个能力模块：

Skill 名称	中文展示名	英文展示名	说明
tencent-news	腾讯新闻	Tencent News	新闻资讯能力
tencent-weather	腾讯天气	Tencent Weather	天气查询能力
jiaozhen-factcheck	较真查真假	Jiaozhen Factcheck	事实查证能力

其中：

jiaozhen-factcheck 是什么？

这是一个事实查证工具，适用于：

• 判断某条信息是否真实
• 识别谣言
• 判断“是真的吗？”
• 资讯真实性校验
• 常识可靠性判断

当用户提出类似：

• “这个消息是真的吗？”
• “能不能这样做？”
• “是不是谣言？”

时，应该调用该能力。

开发文档参考：
https://skillhub.cn/skills/jiaozhen-factcheck

---

二、获取 API Key

访问页面：

https://news.qq.com/exchange?scene=appkey

在页面中：

1. 生成 API Key
2. 复制保存

⚠ 注意事项：

• API Key 用于接口鉴权
• 每个账号仅支持生成一个 API Key
• 不要提交到 GitHub
• 不要写死在前端代码中
• 不要暴露在公网接口中

建议存储方式：

.env
TENCENT_NEWS_API_KEY=你的key

---

三、qclaw 接入腾讯新闻（Agent 部署方式）

如果你使用的是 Agent / qclaw 形式部署 Skills：

第一步：部署技能

复制提示词发送给 Agent：

请部署 tencent-news 技能

如果需要查证能力：

请部署 jiaozhen-factcheck 技能

Agent 会自动安装对应能力。

---

第二步：配置 API Key

将生成的 API Key 发送给 Agent：

配置 API Key：xxxxxx

配置完成后即可使用。

---

四、CLI 安装方式

如果使用 CLI 工具安装 Skills：

第一步：安装 CLI

在终端执行官方提供的安装命令。

（具体命令以页面为准）

---

第二步：配置 API Key

安装完成后，在终端执行：

skill config set TENCENT_NEWS_API_KEY=<value>

将 <value> 替换为你的 API Key。

---

五、前端项目中的调用场景

作为前端开发，可以这样使用：

1️⃣ 资讯聚合平台

Vue + uniapp 场景：

• 首页展示新闻列表
• 分类：国内 / 国际 / 科技 / 体育
• 实时刷新

2️⃣ AI 对话增强

在智能助手中：

用户问：

今天有什么热点？

自动调用：

tencent-news

用户问：

这个新闻是真的吗？

自动调用：

jiaozhen-factcheck

这是一个非常典型的能力路由场景。

---

六、安全设计建议（工程实践角度）

不要这样做：

// ❌ 错误示范
const apiKey = "直接写死在代码里"

正确方式：

后端代理模式

// express 示例
app.get('/api/news', async (req, res) => {
  const result = await fetchTencentNews(process.env.TENCENT_NEWS_API_KEY)
  res.json(result)
})

前端：

axios.get('/api/news')

这样：

• API Key 不暴露
• 可以做缓存
• 可以做限流
• 可以做日志统计

---

七、能力组合设计建议

可以将以下能力组合：

能力	作用
tencent-news	获取实时新闻
jiaozhen-factcheck	真实性校验
自己的AI总结模块	摘要压缩
情绪分析模块	判断新闻倾向

形成一个：

新闻获取 → 摘要生成 → 真实性判断 → 舆情分析

的完整链路。

---

八、常见问题

Q1：一个账号能生成多个 API Key 吗？

不能。每个账号仅支持生成一个。

---

Q2：可以直接前端调用吗？

技术上可以，但不建议。

理由：

• 会暴露 API Key
• 容易被滥用
• 无法控制调用频率

---

Q3：事实查证适合什么场景？

• 自媒体内容审核
• 评论区信息校验
• AI 回复真实性增强
• 谣言识别系统

---

九、总结

qclaw 接入腾讯新闻核心只有两步：

1. 获取 API Key
2. 部署并配置 Skills

但工程实践中要注意：

• 鉴权安全
• 后端代理
• 能力路由设计
• 组合式能力扩展

如果你在做：

• AI Agent
• 内容聚合系统
• 新闻类应用
• 资讯校验工具

这个能力非常实用。

---