git-plugin-amc

v0.9.1

Published

an hour ago

F&B Content Engine — OpenClaw plugin for restaurant social media operations across 7 platforms with bilingual support, compliance gates, and automated reporting.

0High
0Medium
0Low

alextiannus

openclaw openclaw-plugin f&b restaurant social-media content-engine bilingual chinese-cuisine lark feishu

F&B Content Engine

OpenClaw Plugin · v0.8.1

A complete social media operations plugin for F&B brands.
Manages content from idea to publish across 7 platforms, with bilingual support,
compliance gates, owner escalation, and automated reporting.

安装流程 / Installation (6 Steps)

Step 1 · 创建 OpenClaw 实例 + 配置 Lark Bot

在 OpenClaw 里新建一个 Agent 实例，配置 Lark 机器人作为消息渠道。

Create a new OpenClaw instance and configure the Lark bot as the messaging channel.

Step 2 · 安装 Plugin

通过 OpenClaw 官方指令一键从全局 NPM 注册表安装：

openclaw plugins install git-plugin-amc

执行后，OpenClaw 会自动拉取最新的 NPM 包、安装依赖，并启动预设配置。

进阶安装方式： 如果你需要安装开发版（源码部署），可以克隆代码到本地后执行：openclaw plugins install ./

Step 3 · 重启 Gateway，等待 Lark 消息

openclaw gateway restart

插件的 gateway_start 钩子会自动把 SOUL.md.template 配置块写入你的 SOUL.md。下次会话启动时（session_start），检测到 {{PLACEHOLDER}} 后立即通过 Lark 发出 Bootstrap 开场消息，开始 13 问访谈。

打开 Lark，等待 AI 内容官主动发来第一条消息。

Recovery： 访谈中途中断，重启后向 Lark Bot 发送 /bootstrap 重新触发。

Step 4 · Bootstrap Mode 完成配置

Agent 通过 Lark 向品牌主提问（约 15 个问题，30 分钟），自动完成：

填写所有 {{PLACEHOLDER}} → 保存 SOUL_{brand}.md
更新品牌定制文件（brand-voice、allergen-gate、bilingual-gate）
调用 mcp.lark.drive 在 Lark 云盘创建品牌专属 vault 文件夹
上传 vault-templates/ 到 Lark Drive vault

The agent self-configures via conversation. No human needs to edit any files.

Step 5 · 正式开始运营

配置完成后 Agent 发送确认消息给品牌主，立即按 cron-jobs.md 日程开始运营。
第一批内容（3条）进入 Tier-1 审批队列，等待品牌主在 Lark 确认后发布。

Setup complete. Agent begins the daily automation schedule immediately.

Step 6 · 自动更新

完整的更新链路包含两层机制，确保每个安装实例都能及时收到更新通知：

层 A — 主动推送（新版本发布时立即推送）

每次发布新 tag，GitHub Actions 自动向共享 Lark 群发送广播消息。

接收广播的方式： 加入"F&B Content Engine 更新通知"Lark 群：

联系 12eat AI Lab 获取入群链接，或在 GitHub 提 Issue 申请。

如果你是 fork 部署，可以自建推送通道：

在你的 Lark 群里创建一个 Bot，获取 Webhook URL
在 GitHub repo → Settings → Secrets 添加：
- LARK_UPDATE_WEBHOOK — 主要通知群（正式版推送）
- LARK_DEV_WEBHOOK（可选）— 测试群（beta / rc 版推送）
之后每次 git tag vX.Y.Z && git push --tags，广播自动触发

层 B — 轮询兜底（每周一 09:00 UTC 自动检查）

即使没有加入广播群，Agent 也会每周自动执行 plugin-version-check 定时任务。
发现新版本时，自动向品牌 Lark 群推送通知，团队回复"更新插件"即可触发更新。

更新执行

无论是日常检查还是重大版本升级，只需一行命令即可极速拉取 NPM 最新版：

# 一键无痛更新到最新版
openclaw plugins update git-plugin-amc

(如果你需要强制触发更新并重载，可以使用项目根目录下的 ./update.sh)

更新策略：

✅ 自动更新：22 个通用技能文件、合规规则、平台策略、cron 计划
🔒 永不覆盖：brand-voice.md、allergen-gate.md、bilingual-gate.md（品牌定制内容）
🔒 永不覆盖：Lark Drive vault 里的所有运营记录
✅ 更新完成：post_update hook 自动发 Lark 通知，无需重启，无需确认

Plugin 结构

git-plugin-amc/
├── plugin.yaml              ← Plugin 清单（版本、技能列表、更新策略）
├── SOUL.md.template         ← 品牌配置薄层（复制后填写 8 个参数即可）
├── update.sh                ← 手动更新脚本（备用；OpenClaw 原生更新优先）
│
├── skills/                  ← 23 个技能模块（OpenClaw plugin install 后自动就位）
│   ├── core/                   repurpose-chain, hook-engine, scheduling, content-types
│   ├── compliance/             fda-ftc-rules, allergen-gate*, platform-policies, image-rights
│   ├── localization/           brand-voice*, bilingual-gate*
│   ├── platforms/              instagram, tiktok, rednote, facebook, youtube, googlemap, x
│   └── operations/             owner-approval, feedback-loop, vault-manager, cron-jobs, reporting
│                            (* = brand-customized by Bootstrap Mode, never auto-updated)
│
├── bootstrap/               ← Bootstrap Mode：13问访谈脚本 + 配置逻辑
│   └── onboarding-flow/SKILL.md
│
└── vault-templates/         ← 运营模板（Bootstrap Mode 上传到 Lark Drive vault）
    ├── vault-index.md
    ├── brand/               ownerreview.md, owner-profile.md
    ├── media/               (Empty directory — Native Bitable generated by create-vault.js)
    ├── post/                YYYYMMDD-post.md (Native Bitable generated by create-vault.js)
    └── report/              report-rules.md, weekly-template.md, monthly-template.md

---

## 💎 Native Vault 架构 (v0.8.1 升级)

本插件不再使用纯文本 Markdown 管理关键排期。在初始化 Vault 时，底层脚本会自动调用飞书 API 凭空创建原生高级资产：

1. **多维表格 (Lark Bitable)**
   - **Content Schedule**：排期表自动生成为多维表格，自带单选标签（draft, approved, published）和时间过滤。
   - **Media Index**：素材库自动生成为多维表格，支持原生附件列存放原图/视频。
   - **Agent 交互**：Agent 使用 `lark.bitable` MCP Tool 实时读写表格状态。

2. **原生协作文档 (Lark Docx)**
   - Agent 会把草稿、月报通过 `lark.docs.create` 生成原生的飞书文档。
   - 老板可以直接在飞书里进行“划线评论”，Agent 会读取你的批注自动重写。

3. **交互式卡片审批 (Message Cards)**
   - 遇到合规风险或风控拦截时，不再使用枯燥的文本，Agent 会在飞书群推送带有【✅ 批准】和【❌ 打回】按钮的卡片，一键审批！

品牌定制文件

Bootstrap Mode 访谈结束后，3 个文件会被品牌信息自动填写：

| 文件 | 内容 | 填写来源 | |---|---|---| | skills/localization/brand-voice.md | 品牌个性、词汇表、禁用语 | 访谈 Q9/Q10 | | skills/compliance/allergen-gate.md | 菜品过敏原对照表 | 访谈 Q12 | | skills/localization/bilingual-gate.md | 中英文菜单词典 | 访谈 Q11 |

其余 20 个技能文件为通用内容，Plugin 更新时自动覆盖。

发布与互动工具栈

| 工具 | 作用 | 覆盖平台 | |---|---|---| | PostFast MCP (mcp.postfast) | 统一发布，原生 MCP Server，零开发 | Instagram, Facebook, TikTok, YouTube, X, Threads, LinkedIn | | GBP MCP (mcp.gbp) | Google Business Profile 发帖 + 评论回复 + 数据 | Google Maps / Google Search | | Metricool (mcp.analytics) | 跨平台数据聚合报告 | 所有已连接平台 | | 半自动（Lark） | 小红书及未连接平台：Agent 生成内容推送 Lark，团队手动发布 | 小红书 + pending_platforms |

PostFast 定价：€29/月（12个账号），含所有已支持平台。GBP API 免费。

Skill Packs（扩展技能库）

Skill packs 独立维护，不包含在本 plugin 的默认安装中。按需安装，不影响核心 plugin 更新。

# 安装单个 skill pack
openclaw skill-packs install \
  --repo https://github.com/alextiannus/acm-skill-packs \
  community/copywriting/aida-engine

# 安装整个分类
openclaw skill-packs install \
  --repo https://github.com/alextiannus/acm-skill-packs \
  community/copywriting

| 仓库 | 内容 | 许可 | |---|---|---| | acm-skill-packs | 8个社区 packs：文案框架、平台算法、F&B专项 | MIT 开源 | | @12eat-ai/skill-packs-premium | F&B深度、出海华人市场、节日营销、KOL Brief | 商业许可 |

版本历史

| 版本 | 日期 | 变更 | |---|---|---| | v0.8.1 | 2026-05 | Native Vault 架构大升级：初始化时脚本直接调用飞书接口生成原生多维表格（Bitable）和文档（Docx）；合规审批流全面升级为飞书 JSON 交互式卡片（Message Cards）；全面迁移至 NPM 极速安装与更新体系。 | | v0.6.3 | 2026-05 | 完整自动更新链路：post_update hook + GitHub Actions Lark 广播 + 更新命令处理；22个定时任务程序化注册；运行时凭证检测（PostFast API Key + GBP Location ID） | | v0.6.2 | 2026-05 | Skill Packs 拆分为独立 repo；发布层重构 PostFast MCP + GBP MCP；修复 npm build | | v0.5.0 | 2026-05 | 架构重构：src/index.ts 程序化钩子，openclaw.plugin.json，23个技能目录结构 | | v0.4.0 | 2026-05 | 初始发布，7平台支持，Bootstrap Mode，3级升级协议 |

路线图

v0.7 · 多品牌规模化

[ ] Mission Control 集成（abhi1693/openclaw-mission-control） — 一台服务器统一管理所有品牌 Agent 实例，无需 SSH + CLI — 统一监控 cron 状态、发布日志、异常告警，一键推送 plugin 更新
[ ] VPS 部署指南（systemd / Docker，保障 24/7 稳定运行）
[ ] npm publish + ClawHub 注册（openclaw plugins install clawhub:git-plugin-amc）

v0.8 · 自动化升级

[x] GitHub Actions → plugin 发版后自动向 Lark 广播更新通知（v0.6.3）
[ ] 多品牌跨平台数据聚合报告（Mission Control 层）

License

MIT · Built by 12eat AI Lab