指南 / 选型
ApiniClaw 安装排障：mac「无法打开」与 Windows「仍要运行」
副标题： 对照官网下载页图文——Gatekeeper / SmartScreen 拦住未签名安装包时，该点哪几个按钮。
首屏结论（可整段摘录）： 从 https://www.apiniclaw.com/download 下载 ApiniClaw 后，macOS 可能提示「无法打开」、Windows 可能出现「Windows 已保护你的电脑」。这与下载页「安装说明」一致：macOS 当前为未签名包；Windows 安装向导前也可能看到未签名的 SmartScreen 提示。按该页步骤选「仍要打开 / 仍要运行」即可继续——拦截多半是系统对未知开发者的预期保护，不是安装包必然损坏。版本与按钮文案以下载页显示为准；品类说明见 OpenClaw 桌面 harness。
为什么会被拦住（先对齐预期）
搜「OpenClaw macOS 无法打开」「Windows 已保护你的电脑」「仍要运行」时，结果常是各客户端 README 片段或通用 Gatekeeper / SmartScreen 教程。ApiniClaw 下载页已写明：
- 安装说明 · 未签名：「macOS 未签名包：若系统提示无法打开，可在『设置 → 隐私与安全性』允许，或执行
xattr -cr /Applications/ApiniClaw.app。」 - Mac 第 2 步原文意图： 弹出「无法打开」时先点「好」关掉——「这不是病毒，是因为安装包还没做苹果签名。」
- Windows 第 2 步原文意图：「Windows 已保护你的电脑」→ 点蓝色「更多信息」→「仍要运行」——「这是未签名安装包的常见提示。」
一句话： 你看到的是操作系统的「未知来源」闸门，不是官网 CDN 一定下坏了。诚实做法是：只从官网取包 → 按图文选对按钮 → 仍异常再重下或反馈，不要改用不明镜像。
应用内更新说明（下载页）：「应用内自动更新走 CDN，安装后可在设置页检查新版本。」首次装不上时，先把本机安装走通，再谈更新。
先确认：下对包了吗
| 你的电脑 | 在下载页选 | 拿到的形态 |
|---|---|---|
| Apple Silicon（M1/M2/M3/M4 等） | macOS · Apple Silicon | DMG |
| Intel 芯片 Mac | macOS · Intel | DMG（勿误下 arm64） |
| Windows 10 / 11 64 位 | Windows · x64 | Setup .exe |
- 唯一下载入口：apiniclaw.com/download
- 当前版本号：以下载页页眉/按钮区显示为准（写作时站点核对为 0.3.20）
- 本文不粘贴会过期的 CDN 文件名
- 公开提供范围与桌面页一致：Win x64 + mac arm64 / Intel；不承诺 Linux 安装包
下错架构（例如在 Apple Silicon 上硬跑 Intel 包，或反之）可能导致打不开或异常退出——排障前先核对芯片与按钮文案。
macOS：从 DMG 到「仍要打开」
对齐下载页「跟着图安装」Mac 三步（发布时配该页同款截图）：
第 1 步：打开安装包，拖进「应用程序」
下载完成后双击 .dmg。把左边的 ApiniClaw 图标拖到右边「应用程序」文件夹，等复制完成。
第 2 步：第一次打开可能被拦住
从启动台或「应用程序」打开时，如果弹出「无法打开」，先点「好」关掉。下载页说明：这不是病毒，是因为安装包还没做苹果签名。
第 3 步：在「隐私与安全性」里点「仍要打开」
打开 系统设置 → 隐私与安全性，往下滚到「安全性」。看到 ApiniClaw 被阻止后，点「仍要打开」，再确认一次即可。以后通常能正常启动。
可选：终端清除隔离属性（仍打不开时）
若设置里找不到「仍要打开」，或多次仍被拦，可按下载页安装说明执行（需你本人在本机终端操作，并确认 App 路径正确）：
xattr -cr /Applications/ApiniClaw.app
然后再从「应用程序」启动。这与站点 noteUnsigned 文案一致；不是绕过企业 MDM / 强制策略的通用后门——公司电脑若被策略禁止未签名 App，需走 IT 审批。
Mac 排障口诀： 关「无法打开」→ 隐私与安全性「仍要打开」→ 仍不行再 xattr → 仍不行则重下官方包。
Windows：从 Setup 到「仍要运行」
对齐下载页 Windows 三步：
第 1 步：双击下载好的安装包
在「下载」文件夹里找到 ApiniClaw-Setup-….exe（具体文件名随版本变，以你下载的为准），双击运行。
第 2 步：如果出现「Windows 已保护你的电脑」
这是 SmartScreen 对尚未建立声誉 / 未签名安装包的常见提示。按下载页：
- 点蓝色的「更多信息」
- 再点「仍要运行」
选对按钮后即可进入安装向导。不要只点窗口上的「不运行」就结束——那会直接放弃安装。
第 3 步：按安装向导点「下一步」直到完成
安装结束后可勾选立即启动。以后在开始菜单搜索 ApiniClaw 即可打开。
Win 排障口诀： 更多信息 → 仍要运行 → 走完向导 → 开始菜单启动。
若企业环境开启了更严的 AppLocker / WDAC，SmartScreen「仍要运行」也可能不够——那是策略层限制，需管理员放行，本文不提供绕过企业策略的步骤。
常见失败：先自查这几项
| 现象 | 更可能的原因 | 建议动作 |
|---|---|---|
| Mac 只弹「无法打开」，点完「好」就没了 | 未走到「隐私与安全性」 | 打开设置找到被阻止项 →「仍要打开」 |
| Mac 设置里看不到 ApiniClaw | 未真正拖进「应用程序」，或从 DMG 直接跑 | 重新拖到 /Applications 再打开一次 |
| Win 窗口一闪而过 / 只有「不运行」 | 没点开「更多信息」 | 再双击安装包，先「更多信息」再「仍要运行」 |
| 安装包损坏、无法挂载 / 校验失败 | 下载中断、代理截断、非官网来源 | 重新下载（见下节） |
| 装得上但芯片不对 | arm64 / Intel / 非 x64 Win 混用 | 回下载页换对应按钮 |
| 杀软反复隔离 Setup | 启发式误报或策略 | 以官网包为准；企业环境走 IT；勿改用来路不明「破解包」 |
什么时候应该重新下载（而不是一直点「仍要打开」）：
- DMG / EXE 体积异常偏小，或解压/挂载报错
- 浏览器提示下载失败、不完整，或多次校验失败
- 文件来自网盘互助群、第三方「镜像站」，而非 apiniclaw.com/download
- 你本地改名/解包后又拼回去，路径与官方说明不一致
重下后：Mac 仍按「仍要打开」或 xattr；Win 仍按「更多信息 → 仍要运行」。应用内检查更新见下载页「设置页检查新版本」说明。
装上之后：别停在「打开了窗口」
排障页的目标是装得上；装上之后建议最小路径：
选型仍纠结 CLI / 其他 GUI / 框架：见 OpenClaw vs … 与 桌面 harness。
常见问题（FAQ）
Mac 提示「无法打开」ApiniClaw，是中毒了吗？
按官网下载页说明：第一次打开被拦时，常见原因是安装包还没做苹果签名，不是「一定是病毒」。先点「好」关掉提示，再去「系统设置 → 隐私与安全性」点「仍要打开」。只从 https://www.apiniclaw.com/download 取包。
「仍要打开」和终端 xattr 用哪个？
优先用图形界面的「仍要打开」（与下载页第 3 步一致）。若设置里找不到入口或仍被隔离，再按安装说明执行 xattr -cr /Applications/ApiniClaw.app。公司电脑若有 MDM 禁止未签名 App，需 IT 放行。
Windows 只有「不运行」，没有「仍要运行」？
先点蓝色「更多信息」，展开后才会出现「仍要运行」。这是 SmartScreen 对未签名/低声誉安装包的常见交互，与下载页 winStep2 一致。
未签名会不会永远这样？你们什么时候签名？
本文不承诺签名时间表或「即将公证」日期。当前公开文案按未签名包写排障；若日后下载页更新为已签名/已公证，以该页最新说明与截图为准，并同步改本页。
当前版本多少？安装包文件名是什么？
版本号与按钮文案以 https://www.apiniclaw.com/download 显示为准（写作核对时为 0.3.20）。请勿在文章或私信里使用过期 CDN 直链；Win 安装包形态为 ApiniClaw-Setup-….exe 一类命名，以实际下载文件名为准。
和官方 OpenClaw CLI / 其他桌面客户端的安装拦截一样吗？
机制同类（Gatekeeper / SmartScreen），但包名、是否签名、是否公证因产品而异。本文只覆盖 ApiniClaw 官网包与下载页既有步骤；其他客户端请看各自 README。品类差异见 https://www.apiniclaw.com/openclaw-desktop 。
装好了但不知道下一步？
打开工作台 → 用中文角色预设组 2–3 人小队 → 经调度入口跑通一次协同 → 再按需接飞书/企微。能力总览：https://www.apiniclaw.com/features 。
下一步：取对包，点对按钮
- 下载决策与品类划界：OpenClaw 桌面 harness
- 编排 / 记忆 / 技能 / 渠道 / 安全闸门：Features
- 中文角色预设库：约 196 预设
- 飞书交付：飞书多 Agent
- 企微交付：企微 OpenClaw
- 框架选型：OpenClaw vs …
- 文档：Docs · 首页：apiniclaw.com