桌面端 60 秒启动——双击打开、登录、配模型、开工

桌面端是最快的路径

如果你的目标是 60 秒跑起来、看到第一条消息，选桌面端。它打包了 Electron + JRE 21 + 后端 JAR，用户完全不需要知道底下跑的是 Java。

四步走

1. 下载安装器

从 GitHub Releases 拿对应平台的安装包：

• Windows：MateClaw-Setup-x.y.z.exe
• macOS：MateClaw-x.y.z.dmg
• Linux：MateClaw-x.y.z.AppImage

没有 Java 要装、没有 Node 要装、没有 Maven。桌面端自包含 JRE 21。

2. 双击启动

首次启动需要 10 到 30 秒——后端进程在 Electron 窗口里悄悄 boot。动态挑一个空闲端口，所以看不到常见的端口冲突报错。

如果启动失败：

• Windows：右键安装器 → 属性 → 解除锁定（解除下载文件的 Mark-of-the-Web 标记）
• macOS：系统设置 → 隐私与安全里允许未签名应用
• 后端日志位置：macOS 在 ~/Library/Application Support/MateClaw/logs/mateclaw.log，Windows 在 %APPDATA%\MateClaw\logs\mateclaw.log

3. 登录

默认用户名 admin，密码 admin123。进去第一件事就是改密码——Settings → Security 里改。你的未来自己会感谢你。

4. 配一个模型

进入 Settings → Models → Add Provider。选一个就够了：

• DashScope：阿里云 DashScope 控制台拿 API Key
• OpenAI / Anthropic：有 key 直接粘
• Ollama：本地 GPU 用户，MateClaw 启动时自动探测 localhost:11434
• ChatGPT OAuth：有 Plus/Pro 账号的话走浏览器 OAuth 流程，不需要 API Key

保存后，模型出现在聊天屏幕的模型选择器里。

说第一句话

点左侧导航的 Chat，选一个 Agent（默认「通用助手」模板就够用），选刚配好的模型，敲一句：

Hi. What can you do right now?

回车，看 tokens 流式输出。如果你看到了回答——系统就是活的，你就是在产品里了。

三条无 Key 的路径

MateClaw 启动不需要在环境变量里设任何 API Key。所有供应商配置都在启动后通过 UI 的 Settings → Models 来做。就算你暂时没有任何云 API Key，也有三条路能跑起来：

1. Ollama 本地推理
2. ChatGPT OAuth 订阅
3. OpenRouter 免费档