Easel 详细部署教程

1. 项目简介

Easel 是浙江大学 REAL 实验室与北京大学 OpenDCAI 联合开源的 AI 社交媒体内容工作台，基于 OpenClaw Agent 框架构建。它覆盖“发现→策划→创作→发布→归因”五大工作流，内置 112 个可实际执行的 Skills，支持小红书、抖音、B站、微博、知乎、视频号等主流中文社媒平台的发布。

核心特性：

  • 热点雷达：聚合微博、抖音等平台热榜，筛选适合账号的选题
  • 内容日历：规划选题、标题和脚本，形成可执行的内容矩阵
  • 多平台发布：一稿多发，按各平台规范自动适配后一键发布
  • 发布数据归因：从时间、标签、类型、增长四维分析内容表现
  • 账号画像：建立可复用的账号上下文，包含定位、风格与受众

技术栈说明：

层级 说明
Agent 框架 OpenClaw（安装器会创建独立 easel profile）
LLM 支持 Anthropic Claude、OpenAI/OpenAI-compatible、Anthropic-compatible 服务
Web 工作台 React 构建，默认运行在 http://localhost:7860
媒体处理 依赖 FFmpeg、Playwright/Chromium

2. 部署前准备

2.1 系统要求

根据官方安装文档，Easel 支持 Linux、macOS 和 Windows 10/11。Windows 用户可直接使用 PowerShell 安装，无需 WSL。

2.2 环境要求

依赖项 版本要求 说明
Python 3.10+ 需包含 venv 模块
Node.js 22.19+ 用于构建 Web 工作台
FFmpeg — 媒体处理必需，安装器会尝试自动安装
Playwright/Chromium — 浏览器发布依赖，安装器会自动安装
Git — 拉取源码

注意：Easel 的环境依赖较重，新手第一次安装可能需要半小时左右。此外，必须至少配置一个 LLM Provider（如 Anthropic 或 OpenAI），否则聊天和创作功能无法运行。

3. 安装步骤

3.1 克隆项目仓库

1
2
git clone https://github.com/ZJU-REAL/Easel.git
cd Easel

3.2 一键安装（推荐）

Linux / macOS：

1
bash setup.sh

Windows（PowerShell）：

1
2
Set-ExecutionPolicy -Scope Process Bypass
.\setup.ps1

setup.sh 是可重复运行的引导式安装器，直接执行即可，不需要先手动安装 Easel 依赖。安装过程中会自动完成以下步骤：

  1. 检查 Python、Python venv、Node.js 和 Git；FFmpeg 缺失时尝试通过系统包管理器安装
  2. 询问是否创建或复用项目虚拟环境 .venv/，默认选择 Y
  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，安装器会复用配置，不会重复询问。

3.3 手动安装（备选）

如果你想手动控制安装过程，可以按以下步骤操作：

1
2
3
4
5
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -e .
python3 -m playwright install chromium
# 注意：手动安装时仍需提前安装 ffmpeg

4. 配置说明

4.1 最小配置

在项目根目录 .env 文件中提供一个可用的 LLM 即可。

使用 Anthropic（推荐）：

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

使用 OpenAI 或 OpenAI-compatible 服务：

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

使用其他 Anthropic-compatible 服务：

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

4.2 可选媒体模型配置

.env.example 还列出了视频、音乐、语音等可选模型配置。只需配置实际使用的能力，没有配置的媒体 Skill 不会影响聊天、策划和文本创作。

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

这些配置也可以在 Web 工作台的“技能库”中填写。

5. 启动与验证

5.1 环境检查

安装完成后，首先运行环境检查：

1
easel doctor

该命令会检查运行环境是否正常。

5.2 连通性测试

测试 gateway 和 Agent 的连通性：

1
easel ping

该命令会实际测试 gateway 和 Agent 是否可正常工作。

5.3 启动 Web 工作台（推荐）

1
easel web

启动后在浏览器中访问 http://localhost:7860 即可进入 Web 工作台。

5.4 启动终端对话（备选）

1
easel chat

5.5 直接运行 Skill

你也可以跳过 Web 界面，直接运行某个 Skill：

1
2
3
4
5
# 检查小红书文案
easel skill quality-gate -i "帮我检查这条小红书文案"

# 写一条介绍空间智能的微博
easel skill social-content -i "写一条介绍空间智能的微博"

6. 初始使用配置

6.1 创建账号画像

账号画像是 Easel 的核心概念，用于建立可复用的账号上下文，包含身份、社交链接、目标、偏好和边界。一份画像可跨多个已登录平台使用。

方式一：命令行创建

1
cp -r profiles/_template "profiles/我的账号"

方式二：Web 界面创建

在 Web 工作台的“画像”页面创建和编辑。

6.2 登录社媒平台

第一次使用时，需要在小红书、抖音等平台登录。Web 工作台会引导你扫码登录。

6.3 平台发布风险提示

重要警告：Easel 的 README 明确提示，小红书会检测自动化操作。建议使用“预览 + 发布前检查 + 用户确认后手动发布”的流程，降低账号风险。

7. 核心功能使用流程

根据官方文档，Easel 的标准使用流程如下：

  1. 发现热点：在“热点雷达”聚合微博、抖音等平台热榜，筛选适合账号的选题
  2. 策划排期：使用“内容日历”规划选题、标题和脚本，形成可执行的内容矩阵
  3. 创作内容：通过对话或 easel skill 指令让 Agent 生成文案、卡片、视频等素材
  4. 检查发布：在“发布中心”完成敏感词/版权检查和多平台格式适配后一键发布

7.1 跨平台一键发布

Easel 支持一稿多发，会按各平台规范自动适配内容。支持的平台包括：

平台 发布 SKILL
小红书 skill-xhs-publisher
抖音 skill-douyin-upload
微信公众号 skill-wechat-publisher
B站 skill-bilibili-upload
快手 skill-kuaishou-upload
视频号 skill-channels-upload
知乎 skill-zhihu-publisher

使用方式是通过 manifest JSON 文件描述内容，然后执行派发计划：

1
python skills/openclaw/skill-cross-platform-publish/scripts/publish_dispatch.py plan --manifest content.json

7.2 发布数据归因

发布后可使用归因分析 Skill，从时间、标签、类型、增长四个维度分析内容表现：

1
python3 skills/openclaw/skill-publish-analytics/scripts/analyze.py all

该分析会读取 outputs/_analytics/publish-log.json 中的发布日志数据。

8. 常见问题与解决方案

8.1 安装时间过长

原因：Easel 环境依赖较重，需要安装 Python 依赖、Node.js、FFmpeg、Playwright/Chromium 等多个组件。

解决方案：这是正常现象，耐心等待即可。确保网络稳定，避免安装中断。

8.2 缺少 LLM 配置

问题：聊天和创作功能无法运行。

解决方案：必须至少配置一个 LLM Provider。检查 .env 文件是否已正确填写 API Key。

8.3 FFmpeg 安装失败

问题：安装器无法自动安装 FFmpeg。

解决方案：根据系统手动安装：

  • macOS：brew install ffmpeg
  • Ubuntu/Debian：sudo apt install ffmpeg
  • Windows：从 FFmpeg 官网下载并配置环境变量

8.4 媒体 Skill 不可用

问题：视频、音乐等 Skill 无法使用。

解决方案：这些 Skill 需要额外配置对应的 Provider。没有配置的媒体 Skill 不会影响聊天、策划和文本创作。如需使用，在 .env 或 Web 工作台的“技能库”中配置对应服务。

8.5 小红书发布被检测

问题：小红书检测到自动化操作。

解决方案：README 明确警告小红书会检测自动化操作。建议使用“预览 + 发布前检查 + 用户确认后手动发布”的方式。

9. 注意事项

根据官方文档和使用者反馈，部署和使用时请特别注意：

  • 早期项目：Easel 相比成熟项目还比较早期（437 Stars），遇到 Bug 需要主动反馈 Issue
  • 平台账号需各自登录：第一次用需要在小红书/抖音等平台分别登录，Web 工作台会引导扫码
  • Skill 命名是英文：如 social-content、quality-gate 等，但中文 README 很详细
  • Apache 2.0 许可：可商用，但需遵守许可证条款

10. 部署架构总结

部署方式 适用场景 安装命令 特点
一键脚本（Linux/macOS） 推荐方式 bash setup.sh 引导式安装，自动处理依赖
一键脚本（Windows） Windows 用户 .\setup.ps1 无需 WSL，原生支持
手动安装 开发者 pip install -e . 完全可控，便于调试

部署完成后，你可以通过 easel web 启动 Web 工作台进行可视化管理，或使用 easel skill 直接调用特定 Skill。建议先创建账号画像并配置好 LLM，然后从“热点雷达”开始体验完整的社媒内容工作流。