🔥 Magic - 企业级开源 AI 助理平台

🦞 OpenClaw 是一款出色的家庭AI助手——它连接了所有主流即时通讯工具作为对话渠道，支持任意大模型，并能实现全天候自主运行。

然而，当将其应用于企业场景时，新的挑战便随之而来：数据分散在各个员工账户中、缺乏预算管控机制、输出仅限于纯文本、高风险操作无审批流程等。

Magic 正是为应对这些挑战而生：一个专为企业打造的AI助理平台，旨在实现安全性、可控性、直接业务价值以及24/7自主运行。

---

停止零散尝试，开始构建您的企业级AI引擎。

个人AI工具在规模化部署时往往会遇到相同的瓶颈。以下是Magic如何逐一解决这些问题：

• 数据被锁定在员工个人账户中，一旦离职即告丢失 → 统一的数据中心；机构知识将永久留存于组织内
• API费用不可预测，月底容易超支 → 可按部门、用户或任务设置预算上限
• 员工使用第三方工具，核心数据面临泄露风险 → 内部沙箱隔离；数据始终处于受控边界之内
• AI自动化删除文件、发送错误邮件 → 高风险操作需人工审批；确保人类始终掌握控制权
• 无法对接ERP、CRM系统 → 将内部系统封装为数字员工，供全员访问
• 输出仅为文本，仍需手动整理成演示文稿 → 直接生成成品：仪表盘、报告、PPT、Excel文件等

适用于任何规模

Magic并不局限于大型企业。无论是一人公司还是万人组织，它都能以一人的人力成本，实现百人的工作成果。

对于采用**OPC（一人公司）和OPT（单人团队）**模式的企业而言，Magic尤为契合——资产精简、零人力开销、快速交付可见成果，并可根据需求随时扩展新能力。无论是单打独斗的创始人，还是小型团队，都可以轻松驾驭一支完整的AI员工队伍。

单人创始人 / 单人团队

让AI承担您尚未招聘的角色——市场推广、运营、法务、数据分析、客户支持、设计、文案撰写、财务等。零人力成本，全天候持续产出。快速生成仪表盘、报告和合同初稿。若需新增功能，只需添加一名Agent即可。

企业 / 中型团队

通过集中式平台管理全公司的AI应用，彻底消除数据泄露风险。各部门预算透明且可追溯。内部专业知识被封装为数字员工，可在不同部门间共享复用——知识不会随着人员流动而流失。高风险操作必须经过审批。沙箱隔离机制确保数据绝不会外泄。

---

7项企业级核心能力

1. 企业知识整合

将分散的内部系统（ERP/CRM/数据库）及领域专业知识深度封装为人人可用的数字员工。打破信息孤岛，将零散的API调用转化为可大规模复用的核心数字资产。

2. 成果即交付物

不再停留在“聊天”阶段。内置的渲染框架可将AI输出直接转化为成品——PPT、数据仪表盘、会议摘要、专业报告、Excel文件、无限画布（图像生成）——即拿即用，无需后期处理。

3. 企业级安全与合规

每个Agent都在专有沙箱容器中运行，与主系统隔离于独立的VPC内，并通过私有端点连接——完全杜绝未经授权的访问风险。Sidecar网络代理会为每位用户独立管理流量，实现租户间的完全资源与数据隔离。严格的插件安全审核可在发布前拦截恶意代码，确保企业数据始终处于可信边界之内。

4. 人机协作控制

当Agent尝试执行高风险操作时，会触发审批流程。常规任务可自主完成；而诸如删除数据或发送邮件等破坏性操作，则需要明确的人工确认。决策权始终掌握在人类手中。

5. 精细的成本控制

企业级成本指南允许您为每个部门、每位用户以及每个Agent设定精确的日预算。这样一来，AI支出变得可预测、可控制——每一分钱都有据可依。

6. 全员协作

多人可共同参与一个项目，各自负责不同的模块，同步推进并实时查看进度。资深用户甚至可以随时介入同事的项目，提供即时帮助。经验会自然积累，并在团队中不断叠加。 进度还可自动同步至WeCom、钉钉或飞书群组——真正实现零摩擦协作。

7. 开放生态兼容性

完全兼容 Anthropic Skills 生态系统和 OpenClaw Skills 生态系统。现有工具和技能可直接接入——企业级应用无需任何迁移成本。

---

个人AI助理 + 专家智能体：人人掌控AI军团

Magic为企业带来两大互补能力：

每位员工都拥有一个个人AI助理

可以将其视为为每位员工配备一位全天候待命的专属“数字助手”。这位个人助理不仅能够连接即时通讯工具，还能无缝对接所有系统：日历、邮件、内部业务系统、数据、各类工具以及专业领域的智能体。只需一条指令，即可调动所需资源与专业能力——真正实现“以一人之力，达成百人效率”。

专家智能体作为领域专家

将法务、财务、销售、运营等各职能的知识与工作流程沉淀为数字化员工。每个专家智能体在其专业领域内都具备深度与全面性，用户可通过个人助理随时调用。新员工只需简单请求，便能立即获得资深级别的专业判断。这样一来，领域专业知识不再依赖于特定人员，而是转化为组织可复用的核心资产。

如果您是决策者，请设想以下场景：

8人完成80人的工作量

一家跨境电商公司仅由8人团队运营。每位员工都配备了一个个人AI助理，该助理连接着产品选品、上架、广告投放、客服、物流及翻译等领域的专家智能体——全流程自动化运作。而其竞争对手则需要80人来完成同样的任务，且效率更低。

不再依赖月度报表——实时掌握运营真相

凌晨2点，一个问题浮现：“我们华东地区的毛利率本季度还能维持吗？”个人助理迅速连接ERP系统、财务系统和CRM，调用财务专家智能体，并在30秒内生成实时仪表盘。管理层的决策节奏不再受制于定期报告周期。

全球化业务，永不掉线

纽约客户凌晨3点发送了一封紧急邮件。客服专家智能体已第一时间响应，它熟悉产品信息、退货政策，并能用流利的英语与客户沟通。到清晨时分，呈现在您面前的不再是待办事项清单，而是一份已完成工单的总结报告。时区差异不再成为业务瓶颈。

风险在发生前即被拦截

每一份对外合同在正式签署前都会先经过法律专家智能体的审核。一旦发现潜在风险条款，智能体会立即标记并提出修改建议，必要时还会触发人工复核流程。合规管理不再是阻碍效率的绊脚石，而是默默运行在后台的安全保障机制。

组织记忆的持续积累与价值叠加

每一次商业决策、每一个问题的解决、每一次客户互动，都在不断让专家智能体变得更加智能。一年后，您的AI员工队伍所承载的不仅是某个人的经验，更是数百名员工共同积累的集体智慧——而且它们不会休假、不会离职，更不会隐瞒所学知识。

新员工入职第一天，即达资深水平

过去培养一名合格的项目经理通常需要半年时间。如今，新员工一入职，个人助理便会自动连接项目管理专家智能体、行业知识库以及历史案例库。所有常见陷阱已被记录在案，各类模板也已标准化封装完毕。新人的上手周期从半年缩短至一周，从第一天起就能高效产出。

3人开拓10个市场

一支仅有3人的国际化团队需进入10个国家市场。个人助理会调用市场拓展专家智能体，执行完整策略：调研当地法规、撰写合规的产品描述与营销文案、管理本地电商平台的店铺运营、追踪跨区域订单及售后服务等。这并非简单的几段翻译内容，而是一整套端到端的市场进入方案。

退休专家的知识永不失传

客服团队中有一位经验丰富的工程师，只要客户描述故障现象，他就能立刻诊断出问题所在——该检查哪些部位、如何修复、零件应从哪里采购。如今，这些宝贵经验已被完整编码进售后专家智能体：症状→诊断路径→解决方案→配件采购，形成完整的决策链条。当初级技术人员遇到棘手问题时，只需通过个人助理提问，便可获得与资深工程师同等水平的诊断结果。

再也不用参加毫无进展的两小时会议

以往：个人助理会自动汇总相关数据与待办事项。会议期间：会议智能体会实时记录会议内容，标记争议点，并跟踪每项行动任务。会议结束后仅5分钟，一份结构化的会议纪要——包含责任人与截止日期——便会推送给所有参会人员。会议从此回归本真——成为决策的场所，而非时间的无谓消耗。

---

🚀 快速入门

自行部署

所需环境： Docker + curl。支持macOS和Linux（Windows版本即将推出）。

curl -fsSL https://getmagicrew.sh | bash

该脚本将自动完成集群搭建、基础设施配置及服务部署等全部流程。部署完成后：

• Web界面：http://localhost:38080
• 清理命令：magicrew teardown

→ 完整部署指南

云服务

不想自行部署？直接使用云端版本，注册即用，无需任何配置：

• 中国地区：Magic
• 国际版：MagiCrew

企业版

我们为企业和团队提供增强的管理功能与特性，包括私有化部署、专属模型集成以及与贵公司内部系统的深度定制对接。如需了解详情，请发送邮件至business@magicrew.com与我们联系。

---

贡献

如您希望参与代码贡献，请参阅贡献指南 / 中文贡献指南。同时，我们也欢迎您通过社交媒体、活动及会议等方式支持Magic项目——项目的成长离不开社区的积极参与。

安全漏洞

若您发现任何安全漏洞，请发送邮件至team@dtyq.com。我们将第一时间处理所有安全相关问题。

📄 许可证

本仓库采用Magic开源许可证，基于Apache 2.0协议，并附加了额外限制条款。

🙏 致谢

感谢所有为Magic项目做出贡献的开发者！

Magic 企业级开源 AI Agent 平台快速上手指南

Magic 是一款专为企业打造的企业级开源 AI Agent 平台，旨在解决数据安全、成本管控、业务流程自动化及人机协作等核心挑战。它支持将内部系统（ERP/CRM）封装为“数字员工”，并直接输出 PPT、报表、Excel 等可交付成果。

环境准备

在部署之前，请确保您的服务器满足以下要求：

• 操作系统：推荐 Linux (Ubuntu 20.04+/Debian 11+) 或 macOS。Windows 用户建议使用 WSL2。
• 容器运行时：必须安装 Docker (版本 20.10+) 和 Docker Compose (版本 2.0+)。
• 硬件资源：
  • CPU：至少 4 核
  • 内存：至少 8 GB RAM (推荐 16 GB 以运行多个 Agent)
  • 磁盘：至少 20 GB 可用空间
• 网络：服务器需能访问外网以拉取镜像和连接大模型 API。
• API Key：准备至少一个大模型服务商的 API Key（如 OpenAI, Anthropic, 或国内的大模型服务）。

安装步骤

Magic 采用容器化部署，最简单的方式是使用官方提供的 Docker Compose 脚本。

1. 克隆项目仓库

git clone https://github.com/dtyq/magic.git
cd magic

提示：如果国内访问 GitHub 较慢，可使用镜像源加速： git clone https://ghproxy.com/https://github.com/dtyq/magic.git

2. 配置环境变量

复制示例配置文件并根据实际需求修改（主要是填入你的 LLM API Key）：

cp .env.example .env

使用编辑器打开 .env 文件，配置关键参数：

# 示例：配置大模型 API Key
LLM_PROVIDER=openai
OPENAI_API_KEY=sk-your-actual-api-key-here

# 可选：配置国内模型源 (如适用)
# BASE_URL=https://api.your-domestic-provider.com/v1

3. 启动服务

使用 Docker Compose 一键启动所有核心服务（包括数据库、后端、前端及沙箱环境）：

docker compose up -d

等待容器启动完成后，检查服务状态：

docker compose ps

确保所有服务状态均为 Up。

基本使用

1. 访问管理平台

在浏览器中打开默认地址： http://localhost:3000

首次登录时，请使用初始化管理员账号（默认账号密码通常在启动日志或 .env 文件中指定，建议登录后立即修改）。

2. 创建第一个个人 AI 助手

1. 进入 Dashboard，点击 "New Assistant"。
2. 选择连接的即时通讯工具（IM）或直接使用 Web 界面。
3. 在提示词框中输入基础指令，例如：“你是我的运营助理，负责每日数据汇总。”

3. 调用专家 Agent 生成可交付成果

Magic 的核心优势在于直接输出成品。尝试以下指令体验“数字员工”能力：

场景：生成市场分析报表

在对话框中输入：

@Finance-Agent 请分析上个季度的销售数据，生成一份包含图表的 Excel 财务报告，并总结关键风险点。

系统将自动执行：

1. 调用 Finance-Agent（财务专家 Agent）。
2. 连接内部数据源（需在后台预先配置数据连接器）。
3. 执行数据分析。
4. 直接渲染并下载 生成的 .xlsx 文件和可视化仪表盘，而非仅返回文本结论。

4. 配置高风险操作审批（人机协同）

若 Agent 执行删除文件或发送邮件等高风险操作，系统会自动触发审批流：

1. 操作请求会挂起并通知管理员。
2. 管理员在 Approval Center 查看详细信息。
3. 点击 Approve 后，Agent 将继续执行后续动作。

---

更多高级功能（如私有化技能开发、多租户隔离配置）请参考官方完整文档。