MateClaw 麦灵
立即下载

使用文档 · 新手向导

从安装到进阶配置，一步步带你用好麦灵（含常见问题 FAQ）

📦 1 · 安装引导

  1. 从 Mac App Store 下载「MateClaw 麦灵」（安装包约 1.1~1.2GB，建议 Wi-Fi 下载）
  2. 双击安装，首次启动时按提示授予基础权限
  3. 启动后，桌面右下角出现 Live2D 桌宠小人，即可开始对话

🔐 2 · 首次启动权限设置（重要）

要让麦灵使用「屏幕视觉识别 + 键鼠控制」能力（UI-TARS GUI 操控），需要开启 macOS 辅助功能权限。请按以下步骤操作：

  1. 打开 系统设置（点击左上角 → 系统设置）
  2. 左侧选择 「隐私与安全性」
  3. 在右侧列表中找到并点击 「辅助功能」
  4. 点击列表下方的 「+」 或开关按钮，在弹窗中选择 MateClaw 麦灵 并开启开关
  5. （可选）如需屏幕捕获能力，同样在「隐私与安全性」→「屏幕录制」中开启麦灵
  6. 重新启动麦灵，权限即生效
系统设置 · 隐私与安全性 · 辅助功能
🧭 屏幕录制
🦞 MateClaw 麦灵
⌨️ 输入监控
→ 将「MateClaw 麦灵」开关打开

示意图：在「辅助功能」列表中开启 MateClaw 麦灵（界面以实际系统为准）

💡
提示屏幕视觉识别与键鼠控制依赖该权限；若关闭，麦灵仍可正常对话，但无法执行 GUI 界面操作。

💬 3 · 快速上手

  1. 点击桌面上的 Live2D 小人，唤起对话窗口
  2. 直接打字或语音下达指令，例如「帮我打开天气网页」「整理桌面文件」
  3. 麦灵会调用对应能力执行，并把结果告诉你

🫘 4 · 豆包火山方舟专区操作步骤

  1. 打开麦灵设置 → 豆包火山方舟专区
  2. 账号实名：按引导前往火山引擎控制台完成账号注册与实名认证
  3. 进入火山方舟：在控制台进入「火山方舟」模型服务平台
  4. 模型激活：找到目标模型并开通/激活（火山方舟对部分模型有单独激活步骤，麦灵专区已做专门适配与引导）
  5. 复制 API Key：在控制台创建并复制 API Key，回到麦灵粘贴确认
  6. 弹窗引导完成后，即可切换到云端 API 大脑

⬇️ 5 · 模型下载教程

所有模型均为权重数据文件，在软件内按需下载、自动部署，不打包进主安装包：

  • 视觉模型（UI-TARS）：设置 → 视觉模型 → 选 2B / 7B / 72B → 一键下载
  • 本地大模型（Ollama）：设置 → 本地模型 → 选 32B+ 规格 → 一键下载（需预留足够磁盘空间）
  • 离线语音音色包：设置 → 语音 → 一键下载音色（多款可选，每款约 130MB），装好即用，断网也能说话
📶
提示模型体积较大，建议 Wi-Fi 网络下载。

⚙️ 6 · OpenClaw 高级设置专区

  • Skill 开关：按需启用 / 停用技能，定制麦灵的能力范围
  • CMD 命令权限：控制 AI 能否执行本机终端命令
  • 端口配置：自定义本地服务端口，避免冲突
⚠️
风险提示：CMD 命令权限 开启后，AI 可执行本机终端命令，存在误操作风险（例如误删文件、修改系统配置）。新手默认关闭，进阶用户请按需手动开启，并自行承担操作风险。

🔄 7 · 本地模式 / 云端 API 模式切换

  1. 打开设置 → 大脑/模型区域
  2. 本地模式：选择已下载的本地 32B 大模型（免费离线，无需 Key）
  3. 云端模式：在豆包火山方舟专区（或兼容的 DeepSeek 等）粘贴 API Key 完成接入
  4. 随时可来回切换，一个开关决定用哪个大脑

🛠️ 8 · 常见故障排查

  • 模型下载失败：检查网络连接，切换 Wi-Fi 后重试；确认磁盘剩余空间充足
  • 端口冲突：在高级设置中修改端口为其他空闲值并重启麦灵
  • 权限报错：按本文档第 2 节重新检查「辅助功能 / 屏幕录制」授权，授权后重启麦灵
  • 仍未解决？欢迎通过「关于麦灵」页反馈渠道联系我们

❓ 9 · 常见问题 FAQ

关于麦灵，你最关心的问题都在这里

Q1麦灵安装包多大？

安装包约 1.1~1.2GB，建议 Wi-Fi 下载；AI 模型、离线语音音色包在软件内按需额外下载。

Q2麦灵是开源项目吗？

麦灵本体上层封装代码为独立开发；底层依赖 OpenClaw、UI-TARS、Ollama、sherpa-onnx 等开源项目，全部遵循对应开源协议，详情见开源声明页面。

Q3本地模型为什么只提供 32B 以上，没有 7B/13B 小模型？

低参数小模型在 Agent 任务规划、长记忆、工具调用场景容易理解偏差、任务失败，严重影响使用体验，因此不开放低参模型入口，保障产品基础体验。

Q4豆包火山方舟 API 如何收费？

火山引擎新用户提供免费试用 token 额度；额度耗尽后，由用户自行在火山引擎充值，麦灵不收取任何 API 相关费用，用户自备 API Key。

Q5离线语音音色包支持什么语言？效果怎么样？

离线语音音色包支持中文朗读，情绪自然；多款音色可选（清亮女声 / 温柔女声 / 男声等），每款约 130MB，16G Mac 即可流畅使用。

Q6CMD 命令开关有什么风险？

开启 CMD 命令权限后，AI 可执行本机终端命令，存在误操作风险，新手默认关闭，进阶用户按需手动开启。

Q7我的 Mac 是 M4 Air 16G 内存，可以跑哪些模型？

可以流畅运行 UI-TARS 2B 视觉模型、离线语音音色包；32B 本地大模型硬件压力较大，不推荐。

Q8数据会上传服务器吗？

本地模式下，对话、记忆文件全部保存在本机；使用云端 API 模式时，对话内容会发送至对应大模型服务商（火山方舟/DeepSeek 等），遵循对应服务商隐私政策。