OpenClaw 配置文件详解 05:skills/wewrite/config.yaml —— 技能配置实战

摘要：以 wewrite 技能为例，详解 OpenClaw 技能的三层配置结构（ config.yaml + style.yaml + writing-config.yaml ），掌握技能配置的完整逻辑。

---

一、这是什么文件？

wewrite/config.yaml = 公众号写作技能的「总配置」

它包含： – 公众号 API 凭证（ appid 、 secret ） – 输出目录设置 – 封面图配置（ AI 生成/Unsplash/手动上传） – 发布流程开关 – 作者信息、 CTA 引流文案 – 行业定位、目标受众、内容主题

位置： C:\Users\admin\.openclaw\workspace\skills\wewrite\config.yaml

加载时机： 调用 wewrite 技能时自动加载

---

二、核心配置项详解

2.1 基础信息

name:"李宏阳讲AI"author:"李宏阳"industry:"AIGC培训/数智化咨询"target_audience:"自由创业者、自由职业者、职场办公人员、企事业单位人员、学生"topics:-"AIGC应用"-"AI工具实战"-"数智化转型"-"效率提升"-"AI变现路径"

作用： 定义账号定位， AI 写作时围绕这些主题展开。

关键点： – topics：限定内容范围，避免 AI 跑题 – target_audience：帮助 AI 选择适合的案例和语言风格

---

2.2 内容风格配置

tone:"实践导向，有理论有案例有步骤，技术有深度但表达易懂"content_style:"干货"voice:"第一人称，像一个有实战经验的讲师在分享干货"writing_persona:industry-observerword_count:1500-2500theme:professional-clean

作用： 定义文章的语言风格、字数、排版主题。

关键点： – tone：整体基调（实践导向、有深度但易懂） – voice：叙述视角（第一人称、讲师口吻） – writing_persona：写作人格（ industry-observer 行业观察者） – word_count：字数范围， AI 自动把控篇幅 – theme：排版主题（ professional-clean 专业简洁风）

---

2.3 公众号 API 配置

wechat:appid:wx9bba02c677e86d3dsecret:f759577c7be9a86d4330ade38960e7e2cover_media_id:quH2UC1MughDBYOPff-Mlq7fdzPZ46j5uOmqWAbrKive9TGoxsQs8DeIURch-Cdn

作用： 公众号发布所需的 API 凭证和封面图素材 ID 。

获取方式： 1. 登录微信公众号后台 2. 开发 → 基本配置 → 获取 AppID 和 AppSecret 3. 封面图通过 API 上传后获得 cover_media_id

注意： – cover_media_id 有有效期（通常 3 天），需定期更新 – 发布失败时，检查 cover_media_id 是否过期

---

2.4 封面图配置

image:provider:doubaobase_url:https://ark.cn-beijing.volces.com/api/v3api_key:ark-d4994605-44fb-46ea-8495-f5a8d5218ab9-1d0abmodel:doubao-seedream-5-0-260128auto_generate:truegenerate_inner_images:falsefallback_to_unsplash:true

作用： 配置 AI 生成封面图的参数。

关键点： – provider：图床服务商（ doubao/unsplash 等） – auto_generate：是否自动生成封面图 – generate_inner_images：是否生成内文配图（建议 false ，节省成本） – fallback_to_unsplash： AI 生成失败时，是否降级用 Unsplash 免费图

封面风格：

cover_style:"简洁专业感，蓝白色调，科技与教育结合"

---

2.5 发布流程配置

output_dir:D:\MyCode\Workskip_cover:falseskip_image_gen:falseskip_publish:false

作用： 控制发布流程的开关。

关键点： – output_dir：文章保存路径 – skip_cover：是否跳过封面图上传（ false=需要封面） – skip_image_gen：是否跳过 AI 配图（ false=生成封面） – skip_publish：是否跳过自动推送（ false=推送到草稿箱）

常用组合： – 完整流程：全部设为 false – 仅写作不发布：skip_publish: true – 手动选封面：skip_cover: true

---

2.6 引流文案配置

lead_generation:enabled:truecta:|---**如果你觉得这篇文章有帮助：**1. **点个「在看」**，让更多需要的人看到2. **转发朋友圈**，说不定能够帮助到更多正在探索 AI 的朋友3. **关注我，获取更多 AI 实战干货：**- 📌 公众号：李宏阳讲 AI（深度文章、培训资讯）- 🎬 视频号：李宏阳讲 AI（短视频、直播回放）- 💬 微信：添加请注明「公众号」（优先通过）每周二、四晚 8 点，公众号准时更新。author_bio:|**关于作者：**李宏阳，AIGC 培训讲师，AI 自媒体博主。- 人工智能训练师（高级）- 人社部 / 阿里达摩院双认证- 曾任戴尔、安踏、乔丹、欣贺股份、斯凯奇等世界 500 强企业 CIO- 全国优秀 CIO、全国优秀 CDO、TOGAF 认证企业架构师- 持有 PMP、COBIT、ITIL、CISP 等国际认证- 2025 年 AIGC 培训 50 场，受众 5000+ 人**专注领域：**- AIGC 培训与咨询- AI+ 行业数字化项目定制- 企业业务价值链端到端闭环落地**商务合作/培训咨询：** 请公众号后台留言或添加微信（备注「公众号」优先通过）**全平台：** 公众号/视频号/小红书 → 李宏阳讲 AI

作用： 文章末尾的引流文案和作者介绍。

关键点： – enabled：是否启用（ true=自动添加到文章末尾） – cta：行动号召（引导点赞、转发、关注） – author_bio：作者介绍（增强信任背书）

---

2.7 内容黑名单

blacklist:topics:-"政治敏感"-"宗教"-"色情"-"赌博"words:-"震惊"-"必看"-"不转不是中国人"-"赶紧收藏"-"干货满满"-"建议收藏"

作用： 过滤敏感话题和 AI 味词汇。

关键点： – topics：敏感话题， AI 会自动避开 – words：禁用词， AI 写作时不会使用

---

2.8 参考账号

reference_accounts:-"刘润"-"笔记侠"-"混沌学园"

作用： AI 写作时参考这些账号的风格和选题。

---

三、三层配置结构

wewrite 技能有三层配置，优先级从低到高：

层级	文件	作用	优先级
L1	config.yaml	全局配置（ API 凭证、输出目录、引流文案）	低
L2	style.yaml	风格配置（语气、禁用词、主题领域）	中
L3	writing-config.yaml	写作配置（框架、 SEO 、字数）	高

覆盖逻辑： – L3 覆盖 L2 ， L2 覆盖 L1 – 单篇文章可单独覆盖（通过 CLI 参数）

示例：

python3scripts/build_openclaw.py  python3scripts/build_openclaw.py--tone"casual"  python3scripts/build_openclaw.py--topic"职场效率"

---

四、最佳实践

4.1 敏感信息管理

建议： – API 密钥不要上传到 GitHub – 用环境变量覆盖配置文件中的敏感字段

示例：

wechat:appid:${WECHAT_APPID}# 从环境变量读取secret:${WECHAT_SECRET}

---

4.2 封面图管理

流程： 1. AI 自动生成封面（节省时间） 2. 检查生成效果 3. 不满意则手动上传，更新 cover_media_id 4. 定期（每 3 天）检查是否过期

---

4.3 配置备份

建议： – 保留 config.example.yaml 作为模板 – 正式配置 config.yaml 加入 .gitignore – 用脚本定期备份配置到安全位置

---

五、避坑指南

坑 1 ： API 凭证泄露

❌ 错误：把 config.yaml 上传到公开 GitHub 仓库

风险： AppSecret 泄露，公众号可能被恶意操作

✅ 正确： – 用环境变量覆盖敏感字段 – config.yaml 加入 .gitignore – 只上传 config.example.yaml（不含真实凭证）

---

坑 2 ：cover_media_id 过期

❌ 错误：上传一次封面，几个月不管

现象： 发布失败，提示「 media_id 无效」

✅ 正确： – 每次发布前检查 cover_media_id 是否过期 – 发布失败时，重新上传封面图并更新配置

---

坑 3 ：配置项冲突

❌ 错误：

skip_image_gen:true# 不生成封面skip_cover:false# 需要封面

后果： 发布失败（需要封面但没生成）

✅ 正确：

skip_image_gen:false# 生成封面skip_cover:false# 需要封面

---

坑 4 ：配置从不更新

❌ 错误：配置写完一年不改

问题： 你的定位、风格、受众可能变了， AI 还在按旧配置输出

✅ 正确： – 每季度 review 一次配置 – 发现 AI 输出不符合预期 → 检查配置是否需要调整

---

六、行动清单

任务 1 ：检查你的 wewrite 配置（ 20 分钟） – 打开 skills/wewrite/config.yaml – 确认 API 凭证有效 – 确认 cover_media_id 未过期

任务 2 ：优化引流文案（ 15 分钟） – 检查 cta 和 author_bio 是否最新 – 更新过时的业绩数据 – 补充新增的平台账号

任务 3 ：设置配置备份（ 10 分钟） – 复制 config.yaml 为 config.yaml.bak – 将 config.yaml 加入 .gitignore – 创建 config.example.yaml 模板（不含真实凭证）

---

下一篇预告：HEARTBEAT.md —— 定时检查与自动化任务配置

---

全平台： 公众号/视频号/小红书 → 李宏阳讲 AI