本文给出一种可在Apple Silicon 远程 Mac上反复复盘的2026 年 OpenClaw 自托管组合:用 Active Memory 插件承接短生命周期的设计上下文;语音走本地 MLX 入出(采集与 TTS 回环均留在本机);再用防抖后的导出目录监听驱动后续步骤,并以结构化批注侧车(YAML)把评审意图写死在磁盘上。全程假设使用你可写入清单的本地网关绑定与Skills——不包含必须登录第三方控制台的运营后台。
安装与权限
先按《OpenClaw 多平台安装指南》完成 CLI 与依赖,再在下表矩阵内逐项勾齐,再打开麦克风或加载 MLX 权重。
| 能力面 | 为何需要 | 落地建议 |
|---|---|---|
| 麦克风与语音识别 | 即使音频不出网,MLX 采集仍走系统隐私闸 | 一次性授权;尽量用专用流水线账户,避免混入私人 iCloud「桌面/文稿」 |
| 完整磁盘访问(范围化) | 监听与归档须看到「已写稳」的导出,而非隔离中的半成品 | 只暴露 ~/design_jobs/ 一类本地 NVMe 树;避免云同步根目录作监听根 |
| 本机网络绑定 | 网关应面向环回或受控网段,而非公网随意可达 | 绑定 127.0.0.1,或在 RFC1918 内配合主机防火墙默认拒绝入站 |
保持 Xcode Command Line Tools 为当前主要版本;若语音与预览并行,建议 16 GB 及以上内存。为 launchd 与交互 Shell 固定同一 OPENCLAW_HOME。安装与批量校验的衔接见《Mac 安装、配置与批量校验》。
网关/技能最小配置
把网关视为可入库清单 + 环境变量,免 SaaS 登录。爆炸半径上通常只开三类 Skills:记忆、语音、监听。
- Active Memory:按项目 slug 设置 token 预算与淘汰策略;写入色板、命名茎、接口变更等短句摘要,不把整画布「搬进内存」。
- MLX 语音:ASR/TTS 图跑在设备内;权重放在例如
~/Library/Application Support/OpenClaw/mlx/,与校验和一并钉版。 - 白名单:仅允许
localhost上的 MCP 与你登记过的 Skills;阻断计划外的出站 Webhook。
与面板化启用技能、PNG 导出守护的对照见《Skills UI 与 PNG 导出守护》;素材审核与批量命名可并行参考《设计助手:部署、审核与批量命名》。
文件夹监听与批注模板
使用本地 SSD 收件箱,例如 ~/design_jobs/{job}/export_inbox。防抖规则:忽略 *.tmp、.DS_Store、零字节;对同一对象连续两次 stat 字节数一致再入队。批注侧车与图稿同目录,便于人机与自动化共用:
# 与导出的 PNG/PDF 同层的 .openclaw.yaml 示例
reviewers: ["[email protected]"]
intent: "icon-states-v3"
acceptance:
max_kb: 180
must_have_alpha: true
palette_notes: "单色源 #0A1F44;禁用烘焙阴影"
voice_notes_sha256: "可选:语音纪要摘要指纹"
向 Active Memory 只镜像摘要级线索,完整路径与终稿仍在本地目录树。字节阈值、磁盘水位与 JSONL 形态可与《PNG 监听、队列重试与日志归档》对齐,便于多篇文章间的 runbook 一致。
失败重试与日志
在既有「瞬时 / 数据 / 运维」三分法上,为语音链补充模型卡顿、麦克风争用、残缺转写等类别:
| 类别 | 典型例子 | 策略 |
|---|---|---|
| 瞬时 | MLX 预热延迟、权限竞态、短暂文件锁 | 自动重试 ≤5 次,指数退避 + 抖动;GPU 忙时暂停队列 |
| 数据 | 导出损坏、转写与磁盘哈希不一致 | 不重试;移入 failed/ 并通知评审人 |
| 运维 | 磁盘水位、Active Memory 剧烈淘汰抖动 | 写入全局 pause.flag,人工介入并打包日志快照 |
每次尝试落一行 JSONL:trace_id、skill、mlx_model、evicted_tokens、watch_trigger_ms;按日与体积轮转、压缩归档,审计路径与上文「监听归档」一文一致。
可复现步骤清单
- 安装 OpenClaw CLI,在远程 Mac 上跑通
openclaw doctor。 - 在本地 NVMe 上创建
export_inbox、work、out、failed、logs等目录契约。 - 授予麦克风与范围化磁盘访问;网关绑定环回;用校验和钉住 MLX 权重。
- 启用 Active Memory 与 MLX 语音 Skills,禁用未用 Skills,文档化允许的 MCP 工具。
- 注册监听:防抖 + 单飞锁;用合成文件做一次干跑。
- 固化
.openclaw.yaml模板并在 CI 中校验字段。 - 演练重试:模拟 GPU 忙碌,确认退避上限;确认数据类错误进入
failed/。 - 配置夜间日志打包与保留窗口(如热数据 7 天 + 冷归档)。
内链规划
横切阅读顺序建议:安装与校验见上文两篇;《Skills UI》讲技能与守护;《监听归档》对齐全站 runbook;《设计助手》覆盖命名治理。均为站内 HTML,免登录。
FAQ
无显示器、仅 SSH 时能否跑 MLX 语音?
可以。使用固定服务账户与稳定音频设备映射;TTS 若需远程 QC,可输出到已声明的虚拟 sink,并在 runbook 中写明设备 ID。
Active Memory 与「索引整棵素材树」有何不同?
前者是会话内、可淘汰的紧凑上下文,适合实时批注,不替代 DAM 检索;命名与门槛仍建议与《Mac 安装与批量校验》中的门禁一致。
能否直接监听云盘同步目录?
不建议。同步客户端易产生半写入对象,混淆防抖。应先落入本地磁盘,再由 OpenClaw 原子消费。
语音纪要若含内部代号,如何控泄密面?
保持 MLX 全链路在机内;任何可选外发 Webhook 前先清洗文本;voice_notes_sha256 仅作指纹字段,避免把明文代号写入侧车对外字段。