## 项目概述

AiToEarn 是一个开源的 AI 内容营销智能体平台，旨在帮助 OPC（一人公司）、创作者、品牌与企业在全球主流平台上构建、分发并变现内容。项目口号为“Monetize · Publish · Engage · Create”，通过 AI Agent 自动化实现内容创作、发布、互动与变现的一站式管理。项目使用 TypeScript 开发，基于 Electron 与 React 构建桌面应用，并支持 Docker 部署。

## 核心功能

- **内容赚钱（Monetize）**：创作者可在平台出售内容以完成商家的推广任务，支持 CPS（按成交额）、CPE（按互动量）、CPM（按播放量）三种结算模式。
- **内容发布（Publish）**：一键将内容分发到抖音、快手、B站、小红书、视频号、微信公众号、TikTok、YouTube、Facebook、Instagram、Threads、X（Twitter）、Pinterest、LinkedIn 等 10+ 平台，支持日历排期。
- **内容互动（Engage）**：通过浏览器插件实现自动点赞、收藏、关注，AI 智能回复评论，挖掘高转化评论信号，以及品牌监测。
- **内容创作（Create）**：Agent 自动调用视频生成模型（如 Grok、Veo、Seedance）、视频翻译、视频剪辑模块完成视频制作；支持 Nano Banana 等图片模型生成图文内容；支持批量生成任务。
- **多方式接入**：提供 Web 在线使用、OpenClaw（龙虾）插件、MCP 协议（支持 Claude、Cursor 等）、Docker 自部署、源码开发五种使用方式。

## 适用与不适用场景

**适用场景：**

- 一人公司（OPC）或小型团队需要低成本、自动化地进行多平台内容分发与变现。
- 内容创作者需要批量生成视频/图文并一键发布到多个社交媒体。
- 品牌或企业需要自动化互动运营（点赞、评论回复、品牌监测）以提升线上曝光。
- 线下商户（餐厅、零售店、民宿等）希望将线下推广转化为线上传播任务。

**不适用场景：**

- 需要完全离线、无外部 API 依赖的内容管理场景。
- 对数据隐私要求极高，且不愿使用官方 Relay 或第三方 AI 模型服务的场景。
- 需要深度定制发布平台原生功能（如平台特有算法优化）的场景。

## 技术架构与依赖

- **语言与框架**：TypeScript，前端使用 React，桌面端使用 Electron。
- **后端**：基于 Node.js（要求 20.18.x），使用 pnpm 和 Nx 管理 monorepo。
- **数据库**：MongoDB 与 Redis（Docker 部署时自动安装）。
- **AI 与集成**：支持 OpenAI、Gemini、Anthropic 等模型服务商，通过 MCP 协议与外部 Agent 集成。
- **部署**：支持 Docker Compose 一键部署，也支持源码开发模式。

## 安装与快速开始

### 方式一：直接使用 Web 版

- 中国用户访问 [aitoearn.cn](https://aitoearn.cn/)，国际用户访问 [aitoearn.ai](https://aitoearn.ai/)，注册登录即可使用。

### 方式二：在 OpenClaw 中使用

在服务器终端执行：

```bash
npx -y @aitoearn/openclaw-plugin-cli
```

按提示选择环境并输入 API Key。

### 方式三：在 Claude / Cursor 等 AI 助手中使用

配置 MCP 地址（根据环境选择）：

- 中国版：`https://aitoearn.cn/api/unified/mcp`
- 国际版：`https://aitoearn.ai/api/unified/mcp`

认证 Header 为 `x-api-key: 你的API-Key`。

### 方式四：Docker 一键部署

```bash
git clone https://github.com/yikart/AiToEarn.git
cd AiToEarn
docker compose up -d
```

启动后访问 `http://localhost:8080`。

### 方式五：源码开发

```bash
cd project/aitoearn-backend
pnpm install
cp apps/aitoearn-ai/config/config.yaml apps/aitoearn-ai/config/local.config.yaml
cp apps/aitoearn-server/config/config.yaml apps/aitoearn-server/config/local.config.yaml
pnpm nx serve aitoearn-ai
# 另一个终端
pnpm nx serve aitoearn-server
```

前端：

```bash
pnpm install
pnpm run dev
```

## 典型使用方法

1. **获取 API Key**：登录 Web 版，在“设置”中创建 API Key。
2. **配置 Relay**（自部署时）：在“配置管理”中分别配置 Server Relay（用于发布平台授权）和 AI Relay（用于 AI 模型）。
3. **创建内容**：使用 Create Agent 输入需求，自动生成视频或图文。
4. **发布内容**：选择目标平台，一键发布或排期发布。
5. **互动运营**：安装浏览器插件，启用自动点赞、评论回复等功能。
6. **变现**：在内容交易市场接取商家任务，按 CPS/CPE/CPM 结算。

## 配置与部署要点

- **环境与 Key 匹配**：中国版 API Key 必须搭配 `aitoearn.cn` 地址，国际版搭配 `aitoearn.ai`，否则会返回 401。
- **Relay 配置**：自部署时需配置 Relay 以借用官方 OAuth 凭据，避免自行申请各平台开发者账号。
- **模型服务商**：可在“AI → 模型服务商”中填写 OpenAI、Gemini、Anthropic 等 API Key 和地址。
- **生产环境**：完整部署指南（生产配置、AI 服务、OAuth、存储等）见 `DOCKER_DEPLOYMENT_CN.md`。
- **Electron 桌面端**：需运行 `npm run rebuild` 编译 better-sqlite3，依赖 node-gyp 和 Python。

## 限制、风险与许可证

- **许可证**：MIT License。
- **依赖外部服务**：核心功能依赖官方 Web 服务、API Key 及第三方 AI 模型，完全离线不可用。
- **平台合规风险**：自动发布与互动可能违反部分社交媒体平台的服务条款，使用者需自行评估风险。
- **数据安全**：自部署时需自行保障 MongoDB/Redis 及配置数据的安全。
- **版本更新**：项目迭代较快，部分功能（如内容交易市场）可能仅限特定版本或地区。

## 官方链接

- GitHub 仓库：https://github.com/yikart/AiToEarn
- 官方网站（国际）：https://aitoearn.ai
- 官方网站（中国）：https://aitoearn.cn
- 文档中心：https://docs.aitoearn.cn
- 最新版本：v2.5.0（2026-06-24 发布）

## 信息来源和分析时间

- 信息来源：GitHub 仓库 README、CONTRIBUTING.md、最新 Release 信息。
- 分析时间：2026-06-24（基于仓库最新动态）。