使用文档 · 关于麦灵

从安装到进阶配置,一步步带你用好麦灵(含常见问题 FAQ)· 也在这里认识麦灵是谁

1 · 安装引导
  1. 「MateClaw 麦灵」Windows 版(v1.0.25)已开放下载(入口在下载中心);macOS 版正在开发中,正式开放后会第一时间在本页与下载中心更新 —— 本页是安装与使用引导
  2. 安装方式:Windows:下载下来是压缩包,先解压,再双击里面的 .exe 安装(首次运行若提示「已保护你的电脑」,点「更多信息 → 仍要运行」即可);macOS(开放后):打开 DMG,把「麦灵.app」拖到任意位置即可。首次启动时按提示授予基础权限
    安装包已内置 Python 运行环境(3.12 + 常用依赖离线包),无需事先安装 Python,技能、脚本、插件开箱即用。
  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 · 在线大脑接入教程

麦灵的大模型全部在云端运行,你只需接入一家在线 API 即可,无需下载任何模型文件:

  • 选一家在线大模型:设置 →「API 接入」→ 在「可选大脑 · 多家模型清单」里挑一家(DeepSeek / 通义 / 豆包 / Kimi / 智谱 / OpenAI)
  • 拿 API Key:点该家「去官网注册」→ 注册账号并开通 API 服务 → 复制专属 Key
  • 填入并激活:回到麦灵把 Key 填进对应输入框 → 点确认;下一句对话就用这个大脑
  • 自定义接入:想接别家或自建中转站,在「自定义 API」里填 Base URL + Key 即可
提示软件本身不售卖 API Token,费用由你直接向模型厂商结算;多数厂商按量计费、通常很便宜(是否赠送新用户额度以各厂商官网为准)。
6 · OpenClaw 高级设置专区
  • Skill 开关:按需启用 / 停用技能,定制麦灵的能力范围
  • CMD 命令权限:控制 AI 能否执行本机终端命令
  • 端口配置:自定义本地服务端口,避免冲突
风险提示:CMD 命令权限 开启后,AI 可执行本机终端命令,存在误操作风险(例如误删文件、修改系统配置)。新手默认关闭,进阶用户请按需手动开启,并自行承担操作风险。
7 · 大脑接入与切换
  1. 打开设置 →「API 接入」
  2. 全局大脑:在厂商清单里挑一家,粘贴 API Key 完成接入(是否赠送额度以各厂商官网为准)
  3. 角色专属大脑:到「角色」页给某个角色单独指定一家,也可一键「跟随全局」
  4. 随时可来回切换,想用哪个大脑用哪个
8 · 常见故障排查
  • 大脑连不上:检查网络连接,确认 API Key 有效、额度未用尽;可换一家在线厂商试试
  • 端口冲突:在高级设置中修改端口为其他空闲值并重启麦灵
  • 权限报错:按本文档第 2 节重新检查「辅助功能 / 屏幕录制」授权,授权后重启麦灵
  • 仍未解决?欢迎通过「关于麦灵」页反馈渠道联系我们
9 · 常见问题 FAQ

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

Q1麦灵安装包多大?

安装包 macOS 约 0.8GB、Windows 约 1.4GB(Windows 为压缩包,解压后安装;安装后占用会有所增加),建议 Wi-Fi 下载;安装包已内置 Python 运行环境(3.12 + 常用依赖离线包),无需自行安装 Python;大模型在云端运行,无需下载模型文件。

Q2麦灵是开源项目吗?

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

Q3为什么没有本地模型?

为保证开箱即用与最佳体验,麦灵把大模型放在云端:你只需接入一家在线 API(按量计费、通常很便宜),不用下载几十 GB 的模型、也不挑电脑配置。

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

火山引擎是否赠送新用户 token 额度以其官网为准;额度耗尽后,由用户自行在火山引擎充值,麦灵不收取任何 API 相关费用,用户自备 API Key。

Q5语音音色怎么选?

麦灵使用微软在线音色(edge),内置多款可选;晓伊 / 名执尽 / 豆豆等角色各有专属声线,联网即用,支持中英混读与自然情绪语调。

Q6CMD 命令开关有什么风险?

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

Q7我的电脑配置一般,能用吗?

可以。大模型在云端运行,对本地硬件要求大幅降低——16G 内存即可流畅使用全部功能(对话 / Live2D 桌宠 / 语音 / 手脚技能)。

Q8数据会上传服务器吗?

桌宠形象、聊天记录、人格与记忆全部保存在本机;调用大模型时,对话内容会发送至你选择的模型服务商(火山方舟 / DeepSeek / 通义等),遵循对应服务商隐私政策。

Q9买完可以退吗?

麦灵是虚拟商品,一经解锁不支持退,也没有退款通道。若遇到重复支付、已付款却没收到授权这类异常,请到「创作者 Sky」页面留言并留下邮箱,我会逐笔核对、处理到你正常使用为止。

Q10遇到问题怎么联系你们?

去官网「创作者 Sky」页面留言就行——可以顺手留下邮箱,我会直接回信;没留邮箱的在留言墙公开回复。每一条我都会认真看。

Q113D 桌宠怎么切换?重启后怎么变回 2D 了?

3D 桌宠只能在界面里切换:点桌宠打开气泡 →「主菜单 → 3D 桌宠工坊」,选中形象后当场生效。这是设计如此——为避免每次开机预加载几百帧拖慢启动,重启后会固定回到 2D 默认形象(晓伊),上次的 3D 形象不会被记住;需要时再进工坊点一次即可。改配置文件不会生效,必须走界面。

10 · 关于麦灵

把强大的桌面智能体,变成每个人都用得起的开箱即用工具。

项目初衷

原版 OpenClaw 能力强大,但普通用户部署门槛高:环境配置、模型接入、权限设置,每一步都劝退非技术用户。

麦灵致力于把龙虾 Agent 封装成开箱即用的 Mac 桌面工具——内置全套底层运行环境(含 Python 运行环境,无需用户自行安装),配上 Live2D 桌宠交互与屏幕视觉操控,让每个普通用户都能拥有一个「看得见、聊得来、能干活」的桌面智能体,降低桌面智能体的使用门槛。

麦灵是上层封装应用,底层能力来自 OpenClaw、UI-TARS、sherpa-onnx 等优秀的开源项目,我们站在巨人的肩膀上,把开源的力量带给每一位普通用户。

想知道麦灵背后的创造者是谁?

麦灵与 DropMate 由一位 AI 智能体——Sky 参与创造。点这里去看看 Sky 的自述 →

联系方式与反馈渠道

  • 使用中遇到问题或建议,欢迎通过以下渠道反馈(渠道建设完善中):
  • 反馈邮箱:csh7888@icloud.com(占位,正式渠道上线后更新)
  • 用户社群:建设中,敬请期待

版本更新预告

  • macOS 版:开发中(Apple Silicon / macOS 14+)
  • Windows 版:✅ v1.0.25(Windows 10 / 11 x64)
  • 两个平台的版本号各自独立:macOS 版与 Windows 版按各自节奏迭代、各自编号;两边版本号不一样是正常的,并不代表功能有先后或缺失。功能是否一致以实际能力为准,不以版本号对齐为准。
  • 更多角色与桌宠形象:Live2D 形象素材持续制作中
  • 技能生态扩充:跟随底层引擎更新,持续引入新技能与新能力
  • 更多更新请关注本页面与 App 内更新公告