Easel README

The project's README from github.com/ZJU-REAL/Easel. As one markdown file: README.md.

Zhejiang University Zhejiang University     Peking University Peking University

Easel Easel
REAL Lab  OpenDCAI LabOpenDCAI Lab

简体中文 · English

你的私人、持续进化的社媒运营助手
从一个想法开始,完成发现、策划、创作、发布与复盘。

Easel Project Page Powered by OpenClaw Python 3.10+ 112 Skills GitHub Stars Latest release License: Apache 2.0 WeChat Group

Easel 产品宣传海报

🎨 Easel 是什么

Easel 是一个面向社交媒体创作者的开源内容工作台。它把 OpenClaw Agent、账号画像、内容技能和真实的媒体工具接在一起,让 Agent 不只回答“应该怎么做”,而是直接把内容做出来并归档,且可实现直接/按需发布。

你可以把它理解成一个会记住你的内容搭档:它了解账号定位、受众、风格、平台限制和历史表现,从热点发现一直陪你做到发布,再把结果带回下一次创作。

Easel 宣传演示:

https://github.com/user-attachments/assets/4dd060dc-53dd-4bb2-99a3-e65ab6f65166

Easel 围绕五个连续工作流展开:发现适合账号的热点与机会,策划选题、标题、脚本和排期, 创作图文、音频与视频内容,发布经过检查和平台适配的成品直接到对应平台,再通过归因分析表现并把有效经验沉淀回账号画像。

📌 使用提示与研究愿景

  • 推荐使用 Web 前端:前端提供完整的会话、素材、账号、画像、内容库和发布管理能力,体验和功能比单独使用 CLI 更全面。
  • 谨慎自动发布到小红书:小红书平台可能检测自动化操作,存在验证、限流或账号风控风险;建议使用预览与发布前检查,并由用户确认后手动发布,其他平台正常。
  • 从研究走向真实生活:Easel 是我们将研究成果应用到真实社媒创作场景的一次实践。后续我们会继续研究 AI 在社媒场景中的社交智能,让 Agent 更好地理解创作者、受众与真实互动。

✨ 为什么是 Easel

🧭 五层内容工作流

  1. 发现:聚合热榜、行业新闻、竞品动态和用户讨论,筛选真正适合账号的机会。
  2. 策划:把机会变成选题、标题、脚本和内容矩阵,写入内容日历。
  3. 创作:生成文案、卡片、海报、信息图、音频、视频、短剧和论文解读等可发布素材。
  4. 发布:按平台适配标题、正文、画幅和媒体要求,执行发布前检查并发送到已登录账号。
  5. 归因:读取播放、互动、评论和内容表现,把有效结构和偏好沉淀回账号画像。

🧰 已经落地的能力

能力层 已实现功能
发现 全网热搜聚合、垂类趋势研究、内容缺口分析、节日与事件日历、平台算法动态、竞品分析、行业资讯、跨平台差异、RSS 聚合、UGC 发现
策划 账号定位分析、受众画像、人设与声音构建、账号诊断、选题矩阵、选题评分、热点结合、系列内容规划、标题与 Hook、文章大纲、分镜脚本、内容日历、跨平台复用、直播策划、营销活动与商单方案
文字与视觉 社媒文案、短视频与中长视频脚本、小红书笔记、长文、小说、去 AI 感改写、风格迁移、论文解读、金句卡、小红书知识卡、海报、信息图、数据图表、思维导图、对比图、电商详情图、Meme、AI 生图、图片增强、去背景与批处理
音频与视频 文字转语音、多角色配音、声音克隆、AI 音乐、降噪、混音、语音转文字、音频可视化、AI 视频、AI 短剧、字幕与翻译、视频剪辑、长视频切片、直播高光、横竖版转换、片头片尾、相册视频、音乐卡点、绿幕换背景、视频转图文与章节目录
发布与归因 发布质量门禁、敏感与版权风险检查、平台搜索优化、发布 Checklist、多平台格式适配;小红书、抖音、快手、知乎、B 站、微信视频号登录与发布;内容日历回写、账号数据、评论洞察、内容复盘、ROI 与画像记忆

🖥️ 工作台功能示例

下面只展示 Easel 工作台中的四个代表性功能,并不是完整功能清单。更多发现、策划、创作、发布和归因能力, 可以在工作台的技能库或能力地图中查看。

🧬 账号画像
通过基础信息、社媒链接、运营意图和偏好红线建立账号上下文;一份画像可以跨多个平台和会话持续使用。

Easel 账号画像配置
🔥 热点雷达
聚合微博、抖音、知乎、B 站、百度和头条等平台热榜,帮助 Agent 从实时趋势中筛选适合当前账号的选题。

Easel 多平台热点雷达
📅 内容日历
统一管理选题、草稿、待发、已发和平台活动,结合节日节点规划内容,并记录每一天的发布安排。

Easel 内容日历
📣 发布中心
从一份母版内容生成多平台版本,集中完成格式适配、媒体附件、发布前检查、预览和真实发布。

Easel 多平台发布中心

🖼️ 真实产物

这些文件来自 Easel 的实际工作流,主页中也有同一批案例的分类展示。 README 的品牌图、海报、案例图片和视频统一保存在 assets/readme/;产品主页使用独立的 web/static/showcase/ 素材,其中视频保持为 6 秒轻量预览。

📚 论文解读与知识卡片

SpatialEvo 论文解读卡片 SpatialLadder 论文解读卡片

SpatialEvo · 论文解读 / SpatialLadder · VLM 视觉叙事

CULTURE-MT 研究卡片 KnowU-Bench 论文解读卡片

CULTURE-MT · 文化翻译 / KnowU-Bench · 侦探漫画

AGENT G2 论文解读卡片 Pause or Fabricate 论文解读卡片

AGENT G2 · 暗夜英雄 / Pause or Fabricate · 角色化科普

📖 小说与故事

外门弟子整顿修仙界 中元节那晚 我和相亲对象互演正常人 第七格

搞笑修仙 / 恐怖短篇 / 爱情喜剧 / 悬疑故事

🌿 生活分享与梗内容

丰富多彩的生活 大山大水

生活方式 / 自然记录

成都乡土生活 开学趣事梗卡

城市生活 / 梗内容

🎬 视频成片

为便于快速浏览,这里使用可点击的视频封面。点击封面查看最长 1 分钟的轻量预览,点击封面下方的标题 查看完整成片。

论文解读视频

播放 SpatialLadder 论文解读预览 播放 CULTURE-MT 论文解读预览

▶ 点击封面播放预览 · 查看完整视频:SpatialLadder / CULTURE-MT

口播、连续剧与 AI 角色短视频

播放普通人口播剧预览 播放花子的转变预览 播放赛博修仙预览 播放赛博吃播甲鱼预览

▶ 点击封面播放预览 · 查看完整视频:普通人 / 花子的转变 / 赛博修仙 / 赛博吃播甲鱼

氛围影像与横版内容

播放西藏吉隆泥石流预览 播放盗墓笔记小说介绍预览 播放浙江大学介绍预览

▶ 点击封面播放预览 · 查看完整视频:西藏吉隆泥石流 / 盗墓笔记小说介绍 / 浙江大学

🚀 快速开始

环境要求:Linux、macOS 或 Windows 10/11、Python 3.10 及以上、Python venv 模块和 git。安装向导会检查 Node.js 22.19+、FFmpeg、Playwright/Chromium;缺少 Node.js 时会按系统给出安装引导。

git clone https://github.com/ZJU-REAL/Easel.git
cd Easel
bash setup.sh

Windows 原生安装请在 PowerShell 中执行(不需要 WSL):

git clone https://github.com/ZJU-REAL/Easel.git
cd Easel
Set-ExecutionPolicy -Scope Process Bypass
.\setup.ps1

Windows 安装器会优先通过 winget 自动安装缺失的 Python 3.10+、Node.js 22.19+、Git 和 FFmpeg;如果系统没有 winget,再使用官方安装器安装并加入 PATH。随后安装器会创建项目内 .venv,安装 Python/Node 依赖、前端生产包和 Playwright Chromium,并使用独立的 easel OpenClaw profile。安装完成后可运行 .venv\Scripts\easel.exe doctor 检查环境。

bash setup.sh 是可重复运行的引导式安装器,直接执行即可,不需要先手动安装 Easel 依赖。安装过程中会:

  1. 检查 Python、Python venv、Node.js 和 Git;FFmpeg 缺失时会尝试通过系统包管理器安装,仍无法安装则停止并提示处理方式。
  2. 询问是否创建或复用项目虚拟环境 .venv/;默认选择 Y。如果系统缺少 venv,会提示安装对应系统包(例如 Debian/Ubuntu 的 python3-venv)。
  3. 检查或安装 OpenClaw,并创建独立的 easel profile,不覆盖用户已有的 ~/.openclaw/。
  4. 安装 Python、Web、媒体和浏览器发布依赖,构建 React Web 工作台并安装 Chromium;这些步骤任一失败都会停止,不会回退成不完整安装。
  5. 在终端中引导配置 Agent 模型:可选择 Anthropic、OpenAI/OpenAI-compatible、其他 Anthropic-compatible 服务,API Key 输入不会回显。
  6. 同步 skills、校验 OpenClaw 配置并启动 gateway。

如果已经提前配置了有效的 .env,安装器会复用配置,不会重复询问;如果使用重定向或 CI 等非交互模式,安装器会跳过提问并明确提示缺少的配置。

安装完成后,easel 命令安装在项目的 .venv 中。先激活虚拟环境再运行(每次新开终端都要先激活):

source .venv/bin/activate    # 激活后 easel 命令才可用(Windows:.venv\Scripts\activate)
easel doctor                 # 检查运行环境
easel ping                   # 实际测试 gateway 和 Agent
easel web                    # 启动 Web 工作台
# 或:easel chat              # 启动终端对话

如果提示 easel: command not found,就是虚拟环境没激活。也可以不激活、直接用完整路径运行,例如 .venv/bin/easel doctor(Windows:.venv\Scripts\easel.exe doctor)。

启动 Web 工作台后访问 http://localhost:7860。安装完成后可以运行 easel doctor 检查环境, 运行 easel ping 检查 gateway 和 Agent 连通性。

安装器会统一安装 Web、媒体处理和浏览器发布所需的 Python 依赖:

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -e .
python3 -m playwright install chromium
# 手动安装时仍需提前安装 ffmpeg

⚙️ 配置说明

最小配置只需要在项目根目录 .env 中提供一个可用的 LLM:

ANTHROPIC_API_KEY=你的_API_Key
CLAUDE_MODEL=anthropic/claude-sonnet-4-6

也可以使用 OpenAI 或 OpenAI-compatible 服务:

OPENAI_API_KEY=你的_API_Key
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_MODEL=gpt-4o

如果聊天 API 不提供向量模型,请单独配置 Embedding API;否则 OpenClaw 会默认请求 text-embedding-3-small,可能得到“模型不可用”。不配置独立向量 API 时,Easel 会显式使用关键词记忆检索,不会反复请求聊天端点的 embedding 模型:

EASEL_EMBEDDING_API_KEY=你的向量_API_Key
EASEL_EMBEDDING_BASE_URL=https://your-embedding-provider.example/v1
EASEL_EMBEDDING_MODEL=你的向量模型名

修改向量 provider 或模型后,使用对应 profile 重建一次索引:

openclaw --profile easel memory index --force

或者使用其他 Anthropic-compatible 服务:

EASEL_LLM_API_KEY=你的_API_Key
EASEL_LLM_BASE_URL=https://你的服务地址/v1
CLAUDE_MODEL=你的模型名

安装器会把这些标准配置同步到 OpenClaw。OpenClaw 支持但 Easel 没有预设环境变量映射的其他 provider, 可以按 OpenClaw 自身的 provider/auth 配置方式配置;Easel 不会覆盖这些自定义配置。

.env.example 还列出了视频、音乐、语音等可选模型配置。只需要配置实际使用的能力,也可以在 Web 工作台的“技能库”中填写;没有配置的媒体 Skill 不会影响聊天、策划和文本创作。常见可选项包括:

能力 配置入口 额外依赖
AI 视频 VIDEO_PROVIDER 及对应服务的 Key、URL、模型 相应视频生成服务
AI 音乐 MUSIC_PROVIDER 及对应服务配置 相应音乐生成服务
云端配音 VOICE_PROVIDER 及对应服务配置 相应语音生成服务

Easel (ZJU-REAL/Easel)

social-media
Searching Database…

3.8K ·GitHub
What is this?Easel is an open-source content workbench built around an AI agent that discovers trends, plans topics, creates text/image/audio/video content, publishes it to Chinese social platforms, and learns from performance data to improve future content.
Is this a CLI tool or a web app?It is both: a Python/React web workbench (recommended for full session, asset, account and publishing management) plus an 'easel' CLI built on the OpenClaw agent framework.
How do I get it running?Run the bootstrap installer: 'bash setup.sh' on Linux/macOS (re-runnable, sets up venv, Node deps, OpenClaw profile, builds the React web UI and installs Chromium), or the native PowerShell installer on Windows 10/11 which uses winget to fetch dependencies.
What do I need before installing it?You need Python 3.10+ with venv, Git, Node.js 22.19+, FFmpeg, and Playwright/Chromium (the installer checks and can auto-install most of these), plus an LLM key from Anthropic, OpenAI or an Anthropic-compatible provider.
Is auto-publishing to every platform safe to use?Publishing works for Xiaohongshu, Douyin, Kuaishou, Zhihu, Bilibili and WeChat Channels, but auto-publishing to Xiaohongshu specifically carries risk since the platform can detect automation and trigger verification or account restrictions, so Easel recommends manual confirmation there.
Which operating systems does it run on?Linux, macOS, and Windows 10/11 (native, no WSL required) are all supported.
What is OpenClaw and why does Easel depend on it?OpenClaw is the underlying agent framework that powers Easel; the installer creates a dedicated 'easel' OpenClaw profile so it does not overwrite the user's existing OpenClaw configuration.
What does the five-stage content workflow look like?Easel moves through Discover (aggregate trends and gaps), Plan (topics, titles, scripts, calendar), Create (text, images, audio, video, short dramas), Publish (platform-adapted checks and posting), and Attribution (reading engagement data back into the account profile).
What kinds of content can it actually produce out of the box?It can generate social copy, long articles, Xiaohongshu cards, posters, infographics, AI images, text-to-speech voiceovers with voice cloning, AI music, AI video and short dramas, subtitles with translation, and edited video clips.
Which LLM providers can power the agent?Easel can be configured with Anthropic, OpenAI or OpenAI-compatible services, or other Anthropic-compatible providers via the .env file, with optional separate embedding/video/music/voice provider keys.
Creator
ZJU-REAL
Size
325.4 MB
Stars
3.8K
Age
1mo
Commits · 90 Days