远程 Mac上做检索增强生成时，网关须暴露兼容云厂商的向量路径供记忆入库；权重与索引体积常远大于普通依赖。本文给出可复现：全局安装、doctor、onboard 守护进程、记忆与嵌入、最小令牌、探针、流水线预拉取对齐与告警回传。内链 网关健康自检、分层缓存、CI 版本一致。
痛点：① 未配嵌入则跨会话记忆静默失败；② 密钥未进 launchd 探针全错；③ 流水线与网关路径或维度不一致。
决策矩阵：云端嵌入与本地向量
先定合规再选型。
| 形态 | 优势 | 代价与令牌策略 |
|---|---|---|
| 云端嵌入接口 | 免本地大文件、运维简单 | 出站依赖与审计日志；密钥仅授向量与记忆只读范围 |
| 本机向量服务 | 离线可测、维度可控 | 占盘与升级成本；需与索引构建机锁同一模型标识 |
| 混合 | 开发走本地、生产走云 | 两套配置易漂移 → 用环境变量切换并写进 runbook |
全局安装、doctor 与 onboard 守护进程
Node 二十二及以上；对齐 shell 与 launchd 的 PATH 后安装。
npm install -g openclaw@latest
openclaw doctor
openclaw onboard --install-daemon
plist 注入代理与 NODE_EXTRA_CA_CERTS，避免守护进程缺证书。
记忆检索、嵌入路由与最小权限令牌
在配置中声明 memorySearch 与嵌入提供方。仪表板令牌与嵌入密钥分离；勿将主对话密钥写入流水线日志。launchd 须能读到同一组变量。
网关状态、健康探针与常见报错
openclaw gateway status 看监听；Bearer 探针健康与向量路径（端口以发行版为准，一八七八九 常作对照）。
| 现象 | 优先排查 |
|---|---|
| 连接被拒绝 | 是否仅绑定回环、端口是否被旧进程占用、反代路径前缀是否一致 |
| 未授权 | 探针令牌是否与 CI 一致 |
| 向量维数错误 | 嵌入模型与索引构建时是否同一版本与维度 |
与远程 Mac CI 拉取向量模型及索引的衔接
构建前预拉权重与索引到与网关同卷；版本库锁模型标识与校验和；失败二四八秒退避。磁盘与分层见内链。
doctor 与告警回传
LaunchAgent 定时跑 openclaw doctor 与 gateway status，失败则 Webhook 投递一行 JSON 摘要。
可引用参数（写入 Runbook）
直接复制到值班手册
- 退避：二四八秒；再败减半并发。
- 磁盘：缓存卷两成告警、一成二停拉。
- 令牌：探针、嵌入、主密钥三分离。
FAQ
记忆检索界面正常但跨会话召回为空？
查嵌入与 launchd 环境；向量探针须返回成功。
状态显示运行却探针连接被拒绝？
查监听、端口、反代；升级后全局路径是否漂移。
流水线已拉模型仍报维度不匹配？
锁模型与维度；必要时重建索引。