aionclaw需完成图形化安装、路径规范设置与模型通道绑定三步闭环操作。下载官网对应系统安装包，关闭安全软件，windows路径须全英文无空格，macos需授予权限，最后绑定taotoken通道方可启用ai任务执行功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Windows或Mac电脑上安装AionClaw并立即开始使用本地AI智能体执行任务，必须先完成图形化向导安装、路径规范设置与模型通道绑定三步闭环操作，缺一不可。
下载对应系统安装包
打开官网 https://www.hzopenclaw.com/，页面顶部直接显示「Windows 客户端」和「macOS 客户端」两个独立下载按钮，点击即开始下载。不要从第三方论坛、网盘或群文件获取安装包——这些来源的文件可能被篡改或缺少taotoken通道预置模块，导致后续模型切换失效。
Windows 用户请确认下载的是 【OpenClaw-AionClaw-Win-x64-1.0.0.exe】；macOS 用户注意区分芯片类型：Intel 机型选 【OpenClaw-AionClaw-Mac-Intel-1.0.0.dmg】，M 系列芯片（M1/M2/M3）必须选 【OpenClaw-AionClaw-Mac-ARM64-1.0.0.dmg】。
安装前关键准备
临时关闭 Windows Defender 实时防护、火绒、360 安全卫士等所有安全软件。AionClaw 需要读写本地文件、模拟键盘鼠标、调用 Outlook/微信/钉钉等办公软件，安全软件会将其核心进程（如 aionclaw-core.exe 或 AionClaw Helper）误判为风险行为并隔离，安装向导将卡在“权限配置”页无法继续。
macOS 用户需提前进入「系统设置 → 隐私与安全性 → 完全磁盘访问权限」，手动添加「终端」和「访达」；若未勾选，安装后首次启动会提示“无权访问桌面文件夹”，AI员工无法整理你桌面上的周报、发票、截图等原始素材。
Windows端图形化安装流程
第一步：双击运行下载好的 .exe 文件，跳过 SmartScreen 提示（点击「更多信息 → 仍要运行」）。
第二步：进入安装向导后，点击「开始使用」→ 在路径选择页输入安装位置。此处必须满足三个硬性条件：【路径全英文、无空格、不带中文】。例如 D:\AionClaw 或 E:\Tools\AionClaw 可通过，D:\AI工具\AionClaw 或 C:\Program Files\AionClaw 将触发校验失败并阻止下一步。
第三步：勾选《用户协议》与《免责声明》，点击「开始安装」。向导自动完成环境检测、Python 运行时注入、Node.js 绑定、Hermes Agent 引擎初始化。进度条走到 85% 时会暂停约 12 秒——这是在预加载 TaoToken 通道配置，切勿点取消或强制退出。
第四步：安装完成弹出「启动 AionClaw」按钮，点击后自动拉起主程序界面，右下角状态栏显示绿色「就绪」字样，表示本地智能体已激活。
macOS端安装与首次授权
方法一（推荐）：双击 .dmg 文件 → 将 AionClaw 图标拖入「应用程序」文件夹 → 右键「显示简介」→ 勾选「仍要打开」解除 Gatekeeper 限制 → 在「访达 → 偏好设置 → 通用」中将「已下载应用」设为允许任何来源。
方法二（M系列芯片专用）：若拖入后提示“已损坏”，打开终端执行：xattr -rd com.apple.quarantine /Applications/AionClaw.app，回车后重新双击启动。
首次启动时，系统会弹出三次权限请求：① 完全磁盘访问（必须允许，否则无法读取邮件附件）；② 自动化（允许控制其他应用，用于微信发消息、Excel填表）；③ 辅助功能（启用键鼠模拟，执行点击、滚动、复制粘贴）。三项全部点击「好」，否则 AI 员工将无法执行任何实际操作。
模型通道一键绑定（免填Key）
启动软件后，跳过登录页直接点击右上角「设置」图标 → 左侧选择「大模型服务」→ 在「供应商类型」下拉菜单中选择「TaoToken 统一通道」→ Base URL 栏自动填充为 https://taotoken.net/api → API Key 栏输入你在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 申请到的单把密钥（格式为 tk_ 开头的 32 位字符串）→ 点击「测试连接」，看到绿色「✓ 连接成功」即完成。
这一步不能跳过。即使你只想用本地小模型（如 Qwen2-0.5B），也必须先绑定 TaoToken 通道——因为 AionClaw 的 Hermes Agent 调度引擎依赖该通道做任务分发与结果聚合，未绑定状态下所有「主动执行」按钮均为灰色不可点击状态。
