核心概念
一句话总结:MyClaws 拆为 Admin(配置与协调)/ Claw(在真实主机执行)/ Client(操作面),叠加 Agent / Skill / MCP / Trigger / Memory 几个组合积木。
一张表看懂所有角色
| 名词 | 是什么 | 跑在哪 |
|---|---|---|
| Admin | 账号、配置、协调入口、文档站 | 自托管服务器 |
| Claw | 执行引擎(Bash / 文件 / 工具链) | 你的真实主机 |
| Client | 操作面(桌面 / 移动) | 你的电脑、手机 |
| Agent | 角色 / system prompt / 工具白名单 | 由 Claw 加载 |
| Skill | host-local 技能包(含 SKILL.md) | Claw 主机文件系统 |
| MCP | 外部工具协议 | 由 Claw 拉起 |
| Trigger | Cron / Webhook 自动化 | Admin → Claw |
| Memory | 跨对话记忆(clue / dream) | Admin 中心存储 |
Admin、Claw、Client 三件套
- Admin:Fastify 后端,负责认证、Agent/MCP 配置 CRUD、下载页、推送代理、Memory API。你部署它,所有 Claw 与 Client 都连它。
- Claw:另一个 Fastify 后端 + WebSocket,负责拉起 Agent、执行工具、读写文件、运行 Bash。它部署在你想让 Agent 工作的真实主机上。
- Client:桌面端(Vue + Electron)与移动端(Expo + RN)。负责对话 UI、Claw 管理、设置面板。
三者通过 REST + WebSocket 联通。
Agent 是角色与工具白名单
每个 Agent 是一组 system prompt + 启用工具集合 + 模型偏好。 新建 Agent 时默认启用所有内置工具(write / read / bash / web_search 等),可按需收紧。 公开 Agent 对所有用户可见,私有 Agent 仅自己可见。 内置 Agent(如对话标题摘要、Bernard)由管理员维护,普通用户不可编辑 system prompt。
Skill 是装在 Claw 上的能力包
Skill 是一个目录,包含 SKILL.md(含 frontmatter name / description)。
Claw 主机文件系统下 ~/.myclaws/claw/data/skills/<name>/ 存放本机已安装 Skill。
Agent 在会话期间可通过 skill() 工具加载本机 Skill 的指令体。
日常使用直接让「通用助手」帮你装即可,详见 Skill 速览。
MCP 是外部工具协议
MCP(Model Context Protocol)让 Agent 通过统一协议调用外部工具(数据库、自动化、自有服务)。 你在 Claw 端维护 MCP Server 配置,会话发起时勾选要挂载的 MCP。
Trigger 是定时与事件入口
- Cron:按 cron 表达式定时拉起会话。
- Webhook:HTTP 入口(含 SDK),用于 GitHub / CI / 自有系统调用。
Memory 是跨对话长期记忆
user:用户画像feedback:行为纠正/确认project:项目背景事实reference:外部信息指针
Memory 数据中心化在 Admin,Claw 在会话内通过 memory_recall / memory_write 工具访问。
容易混淆的概念
Claw 不是「你的电脑」也不是「AI 后端」
Claw 是一个独立运行体,可以装在任何机器(包括你自己的电脑)。它不是模型,也不是浏览器扩展。
Skill 是 host-local,不要在 Admin 集中存
历史版本曾把 Skill 存在 Admin,已废弃。新流程:在目标 Claw 上由通用助手安装。