快速开始
快速开始:从安装到跑通第一班
下载 Munk AI,配置模型,通过导入开源团队模板或关联本地仓库,跑通你的第一个研发工作项或日常值班任务。
只需几步,你就可以在电脑上把一支多 Agent 团队跑起来。
1. 下载并安装
前往官网 下载页 获取对应系统的安装包:
- macOS:支持 Apple Silicon(M1–M4)与 Intel(
.dmg) - Windows:支持 x64 与 ARM64(
.exe) - Linux:支持 x86_64 与 ARM64(
.AppImage) - Android(可选):安装 Mobile Host(
.apk),用于手机扫码预览应用与远程处理审批
安装后启动 Munk AI,本地编排服务与内置运行环境会自动就绪。
2. 配置 AI 模型
开始工作前,先为 Agent 配置可用的大模型。打开 设置 → AI,你可以任选一种方式:
- 登录账号直接使用(零配置):登录 Munk 账号后,可直接使用官方提供的开箱即用模型服务。
- 自带 API Key(BYOK):填入任意兼容 OpenAI / Anthropic 协议的服务商信息(如 OpenRouter、OpenAI、DeepSeek 等),设置 Base URL、API Key 与 默认模型 后点击保存。

3. 选择你的起步方式
打开 Munk AI 首页,你会看到两种最常用的起步路径:

方式 A:一键导入现成的 Open Company 团队模板(推荐体验)
想最快看到多 Agent 团队如何协同运转,可以直接导入一套官方开源模板:
- 访问 opencompany.run,挑选一个团队模板(例如「开源软件团队」),点击 用 Munk AI 导入运行;或者复制模板链接,在桌面端点击 导入公司 并粘贴。
- 安全预览:Munk AI 会先列出包内的产品、任务(
tasks/*.md)与检查脚本(guards/*.mjs)。包内不含任何写死密钥。 - 确认导入:确认后,所有定时排班默认处于 关闭(Paused) 状态,不会在你未确认前消耗 Token。
方式 B:关联你自己的代码仓库
如果你想直接让 Agent 替你改现有项目或从零开发新产品:
- 新建工程:从零创建一个带完整开发环境的本地产品仓库。
- 打开本地 / 克隆仓库:将本机已有的 Git 目录或 GitHub 仓库关联为一条产品线(Codebase)。
4. 跑通你的第一次任务
进入产品工作区后,你可以立即体验其中一条航道:
跑一个代码工作项(Code)
- 在工作台新建一个 工作项(Work Item),用几句话描述你想加的功能或要修的 Bug。
- 在中间对话区与 Intake Agent 确认需求边界(Agent 生成
prd.md后交棒)。 - 观察右侧 Workflow 自动推进到 Coding 与 Code Gates。当门禁通过并停在交付硬闸时,由你点击确认合并到本地分支。
跑一次运营值班任务(Projects)
- 切换到 项目(Projects) 视图,选择一个具体项目(例如
github巡检或daily-patrol)。 - 点开任意一条任务,点击 立即运行一班(或打开它的定时开关)。
- 查看当前班次的实时执行过程,以及运行结束后自动沉淀的班次小结。
