本地优先的多 Agent 智能平台
TomatoClaw 是一款本地优先的多 Agent 智能平台，主打「私人长期助手 + 办公效率工具」双场景，以桌面应用为载体，内置 Agent 运行时、工具系统、长期记忆与办公生态联动能力，面向普通用户与办公人群开箱即用，同时也支持开发者自定义扩展。
1.1 产品定位
它既可以作为个人长期助手，持续记住偏好、项目上下文和历史任务结论；也可以作为桌面端的智能工作台，帮助用户完成文件处理、自动化执行、团队协作、内容生成等任务。
1.2 核心特性
| 特性 | 说明 |
|---|---|
| 本地优先 | 数据、记忆、执行逻辑默认本地存储，保护隐私，并支持部分离线使用场景。 |
| 多 Agent 协作 | 内置多角色协作机制，适合拆解复杂任务并持续接力执行。 |
| 长期记忆 | 自动沉淀用户偏好、项目约定与历史结论，越用越贴合习惯。 |
| 安全工具执行 | 支持文件操作、命令执行、浏览器自动化等能力，并自带安全护栏。 |
| 办公生态联动 | 可对接飞书等办公场景，实现消息、文档、任务流协同。 |
| 一键安装 | 面向桌面用户直接交付安装包，无需额外部署复杂环境。 |
1.3 界面预览
系统要求与安装步骤
2.1 系统要求
- 支持操作系统：macOS 12+ / Windows 10+
- 硬件建议：内存 ≥ 8GB，磁盘可用空间 ≥ 10GB
- 网络要求：首次安装与模型调用需要联网，基础本地功能支持离线使用
2.2 安装步骤
- 下载对应系统安装包：DMG（macOS）或 EXE（Windows）。
- 双击安装包启动安装流程，按提示完成安装。
- 首次启动时自动初始化本地运行时与数据目录，无需手动部署额外服务。
2.3 关键目录说明
| 路径 | 用途 |
|---|---|
| ~/Library/Application Support/agentx-desktop | 核心数据目录，存储记忆、会话记录和配置信息（macOS 示例） |
| ~/.agentx/workplace | 工作区目录，Agent 默认在这里执行任务 |
| ~/.agents/skills | 已安装技能的存储目录 |
从协作到工具执行的一体化能力
3.1 多 Agent 协作系统
TomatoClaw 内置完整的 Agent 调度体系，支持不同角色在同一任务中自动分工、接力执行，并将执行进度回传到会话中统一展示。
- 角色分工：如 Planner、Developer、Designer 等
- 自动任务拆解与分发
- 执行过程可视化、结果统一汇总
3.2 长期记忆系统
长期记忆系统实现「越用越懂你」，可以自动沉淀用户偏好、项目约定、工作方法和阶段性结论，在后续会话中继续复用。
| 类别 | 用途 | 范围 | 有效期 |
|---|---|---|---|
| Preference | 用户习惯、语言偏好、交互风格 | 全局 | 长期 |
| Fact | 项目约定、技术规则、稳定决策 | 全局 | 长期 |
| Skill | 可复用的方法、排障方案、工作流程 | 全局 | 长期 |
| Episode | 任务过程与阶段性结论 | 频道 / 会话 | 默认 7 天 |
3.3 安全工具执行系统
平台内置文件操作、命令执行、浏览器自动化、定时任务、网页抓取、图片生成等能力，并通过安全规则限制高风险操作。
| 工具类别 | 支持能力 | 典型场景 |
|---|---|---|
| 文件操作 | 读 / 写 / 编辑本地文件，自动创建目录 | 批量重命名、文件整理、日志分析 |
| 命令执行 | 安全执行命令，长任务支持后台运行与通知 | 构建部署、自动化运维 |
| 浏览器自动化 | 网页抓取、点击、表单填写、截图 | 数据采集、自动化测试 |
| MCP 插件体系 | 接入第三方 MCP 服务，扩展外部能力 | 企业系统集成、外部 API 连接 |
| 定时任务 | 支持延迟任务与周期性调度 | 报表、提醒、周期任务 |
| 图片生成 | 内置视觉生成能力 | 营销素材、产品图、社媒配图 |
3.3.2 安全防护规则
- 禁止交互式命令，如 vim、top、tail -f 等
- 执行时长超过 60 秒的任务自动转入后台
- 高危命令执行前进行安全确认
- 工具执行日志可追溯，便于审计与回查
3.4 办公生态联动
TomatoClaw 支持对接办公场景，尤其适合消息联动、文档处理、日报周报、会议纪要、任务追踪等效率型工作流。
3.5 技能扩展体系
支持通过 Skill 扩展能力，也可通过 MCP 接入更多工具与服务，让平台从聊天助手进一步升级为可执行工作台。
从安装到第一次完成任务
4.1 基础使用流程
- 启动 TomatoClaw 桌面应用。
- 新建会话，直接输入需求，例如整理会议纪要、写脚本、生成海报等。
- Agent 自动拆解任务并调用对应工具执行。
- 实时查看执行进度，等待最终结果回传。
- 结果沉淀到记忆库，后续类似任务自动复用。
4.2 高级使用技巧
- 在群聊中通过 @ 指定角色，提高任务分工清晰度。
- 用自然语言创建定时任务，例如日报、提醒、周期同步。
- 直接输入技能触发词，快速调用对应 Skill。
- 通过记忆管理功能查看、删除或修正沉淀内容。
适合个人、团队与开发者的使用方式
5.1 个人长期助手场景
- 持续记录偏好，让回答风格越来越贴近个人习惯。
- 整理个人笔记、学习资料与工作资料，形成可检索知识库。
- 自动处理重复性任务，例如整理目录、批量命名、生成周报。
5.2 企业办公场景
- 对接办公消息，自动整理群聊信息与任务状态。
- 自动读取表格、生成报表并同步给相关人员。
- 辅助研发、测试、文档整理、项目跟进等流程。
5.3 开发者场景
- 使用命令执行能力进行构建、部署、调试和监控。
- 开发私有 Skill，贴合团队工作流和业务场景。
- 连接开发、测试、生产环境，构建多环境自动化流程。
FAQ
Q1：TomatoClaw 的数据会上传到云端吗？
默认所有记忆、会话和本地文件操作数据都保存在本地。只有在调用大模型、外部平台联动等场景下，才会传输必要数据。
Q2：支持离线使用吗？
基础的本地工具执行、记忆查询、历史会话查看支持离线使用；涉及大模型、办公生态联动、网页抓取等功能时需要网络。
Q3：可以和 OpenClaw 一起使用吗？
可以。TomatoClaw 更偏向桌面成品和使用体验，OpenClaw 更偏向底层平台和深度扩展，两者可以互补。
TomatoClaw 与 OpenClaw 对比
| 维度 | TomatoClaw | OpenClaw | 适用建议 |
|---|---|---|---|
| 产品形态 | 桌面成品应用，安装即用 | 更偏平台底座，需要部署与配置 | 普通用户、办公场景优先 TomatoClaw |
| 易用性 | 高，开箱即用 | 中等，需要工程基础 | 日常使用更适合 TomatoClaw |
| 扩展性 | 支持 Skill 与 MCP 扩展 | 更适合深度定制和系统集成 | 轻量扩展选 TomatoClaw，深度开发选 OpenClaw |
| 办公适配 | 更偏个人助手与办公效率场景 | 更偏多渠道接入与工程场景 | 飞书办公、个人助手场景优先 TomatoClaw |
适合直接落地使用的多智能体平台
TomatoClaw 更像一辆可直接上路的成品车：安装即用、体验完整、适合个人长期使用与办公场景；如果需要更深度的平台级定制和系统集成，则可以结合 OpenClaw 使用。