Skip to main content
这篇教程用五步带你从安装走到可工作的 mesh。你要搭建的是一个 Monad Mesh:由守护进程持有的持久 Agent 团队。它从一个成员开始——Monad Agent Runtime,Monad 随附的第一方 Agent——之后可以加入其他 Agent 运行时,而不必迁移任何工作。 Monad 把自身状态保存在你的设备上,但发送给所选模型服务商的请求仍会离开设备。 English: getting-started.md

1. 安装 Monad

使用根 README 中的一种安装方式。 在交互式终端中,macOS、Linux 和 Windows 安装器都会自动启动守护进程并打开 Web UI;全新安装会进入 初始化流程。自动化或静默安装完成后运行 monad up,效果相同。 mesh 持有团队及其工作。关闭浏览器或终端不会把权威状态转移给其他客户端。

2. 连接模型

你的第一个 mesh 成员是 Monad Agent Runtime,它需要模型服务商。Monad 不内置本地推理引擎。如果你只打算使用 Codex、Claude Code 等第三方 Agent 服务商,它们各自单独认证,可以直接跳到第 5 步。 选择一种设置方式: 初始化流程会先测试连接,再保存配置并让你选择默认模型。各服务商的特殊配置见模型服务商。 检查设置结果:

3. 运行第一个会话

会话是一条持久工作线程。它可以跨客户端关闭和守护进程重启存活,也可以从任意客户端操作。 运行一次性任务:
创建并观察命名会话:
同一个会话会出现在 Web UI 中,因为状态位于守护进程。会话分支、恢复与脚本化操作见会话和 CLI 参考。

4. 处理审批

当 Agent 请求受限动作时,当前轮次会停下等待决定。审批界面会说明请求的动作及其后果。 请记住这些规则:
  • 拒绝是正常结果:Agent 收到拒绝后可以继续工作
  • 审批门 fail closed:没有客户端可以回答时,高风险调用会被拒绝
  • 沙箱是独立边界:审批不能替代进程与网络隔离
扩大 Agent 自主权限前,请阅读沙箱后端。

5. 扩展 mesh

先加成员,再加能力。已有会话与历史保持不变。 随后再扩展单个成员的能力: 在聊天输入框中输入 / 可以查看当前可用的 Skills 与命令。

下一步