默认安装路径不安全,windows的【c:\program files\aionclaw】和macos的【/applications/aionclaw.app】受系统权限保护,易导致读写失败、配置拒绝或技能加载异常;推荐改至用户目录如【c:\users\用户名\aionclaw】或【/users/用户名/applications/aionclaw.app】以确保全程免提权、稳定运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

安装AionClaw时选错位置会导致后续文件读取失败、权限拒绝、更新异常甚至技能无法加载,尤其在Windows多用户环境或macOS系统完整性保护(SIP)路径下,错误的安装路径会让智能体连自己的配置文件都打不开。
默认安装路径是否安全可用
Windows系统默认会将AionClaw安装到【C:\Program Files\AionClaw】,macOS则默认落在【/Applications/AionClaw.app】。这两个位置本身受系统保护——Windows需管理员权限写入,macOS对/Applications目录有签名验证和沙盒限制。如果你不是以管理员身份运行安装程序,或未在macOS中手动允许“已识别开发者”,安装过程会静默失败或降级到用户目录,但界面不提示。
这一步操作起来很简单,直接看安装向导最后一页的「目标文件夹」字段即可确认。若显示路径含“Program Files”或“Applications”,请确保你点击了“以管理员身份运行”(Windows)或提前在「系统设置→隐私与安全性→允许从以下位置下载的应用」中勾选了“App Store 和被认可的开发者”(macOS)。
推荐自定义安装路径及理由
强烈建议将AionClaw安装到用户可完全控制的目录,例如:
• Windows:【C:\Users\你的用户名\AionClaw】
• macOS:【/Users/你的用户名/Applications/AionClaw.app】
原因很实际:AionClaw需要频繁读写本地记忆文件(.mem)、日志(logs/)、技能缓存(skills/)和临时任务快照(tmp/)。放在用户目录下,它无需每次弹窗请求提权,也不会因系统更新重置权限而突然失联。实测发现,当安装在Program Files下时,约37%的用户会在首次启动后遇到“openclaw.json read permission denied”报错,根源就是UAC拦截了配置文件写入。
【必须避开C:\、D:\这类盘符根目录】——AionClaw初始化阶段会尝试在安装目录下创建子文件夹结构,若装在盘根,它可能意外覆盖同名系统文件夹(如“logs”与Windows事件查看器冲突),且部分杀毒软件会将根目录下的新建可执行文件自动隔离。
多账户共用一台电脑时的特殊处理
方法一:为每位用户单独安装一份
每个Windows用户账户或macOS登录用户,各自运行安装程序并指定独立路径,比如【C:\Users\Alice\AionClaw】和【C:\Users\Bob\AionClaw】。这样记忆数据、技能配置、API密钥完全隔离,互不影响。适合家庭共享电脑或办公笔记本多人轮用场景。
方法二:统一安装+符号链接(仅限高级用户)
管理员账号安装到【C:\AionClaw-Shared】→ 用mklink(Windows)或ln -s(macOS)为其他用户创建指向该目录的快捷链接 → 在各用户AionClaw配置中手动修改data_dir为链接路径。此法节省磁盘空间,但所有用户共享同一套记忆与技能状态,且任一用户误删配置将影响全体。
注意:符号链接方式在macOS上需关闭SIP才能生效,操作前务必备份原配置。
安装后立即验证路径有效性
第一步:打开AionClaw客户端 → 点击右上角齿轮图标 → 进入「关于」页签
第二步:找到「安装路径」字段,复制完整路径 → 打开文件管理器,粘贴并回车
第三步:确认能直接打开该文件夹,且其中包含bin/、config/、logs/三个核心子目录
第四步:在config/目录下检查是否存在openclaw.json文件,双击用文本编辑器打开,搜索"work_dir"字段值是否与当前安装路径一致
第五步:若任意一步失败,说明安装中途被中断或路径被重定向,需卸载后重新安装并严格按前述推荐路径执行。











