TuriX macOS 权限配置完全指南辅助功能、屏幕录制、Safari 自动化三大设置与常见坑位清单【免费下载链接】TuriX-CUAThis is the official website for TuriX Computer-use-Agent项目地址: https://gitcode.com/gh_mirrors/tu/TuriX-CUATuriX 是一个开源的桌面级计算机使用智能体Computer-Use-AgentCUA能让 AI 在 macOS 上真正动手操作电脑。要在 macOS 15 上跑通 TuriX核心就是完成macOS 权限配置辅助功能Accessibility、屏幕录制Screen Recording与 Safari 自动化三大设置。本文带你逐步完成配置并附上一份常见坑位清单帮你一次配好、少走弯路。为什么 TuriX 需要这三项 macOS 权限TuriX 每一步都会看屏幕 动手操作对应到系统权限上正好是三项权限系统入口TuriX 用它做什么辅助功能Accessibility系统设置 ▸ 隐私与安全性 ▸ 辅助功能模拟鼠标点击、键盘输入驱动 GUI实现见 src/mac/actions.py屏幕录制Screen Recording系统设置 ▸ 隐私与安全性 ▸ 屏幕录制每步截屏让视觉模型看到当前界面见 src/mac/tree.pySafari 自动化Safari ▸ 设置 ▸ 高级通过 AppleScript / osascript 驱动 Safari 完成网页任务见 src/controller/service.py一句话没有辅助功能它动不了手没有屏幕录制它看不见没有 Safari 开关它打不开网页。设置一辅助功能配置——让 TuriX 能点击和打字2 分钟打开系统设置 ▸ 隐私与安全性 ▸ 辅助功能点击添加你实际用来运行 TuriX 的程序Terminal终端和VS Code或你使用的任何 IDE如果 agent 仍然无法控制鼠标键盘再把/usr/bin/python3也加进来确认每一项的开关都是开启状态 ✅小技巧如果列表里找不到 python3、node 这类命令行二进制点 后按Command Shift G直接粘贴完整路径如/usr/bin/python3回车即可手动选中添加。配置好辅助功能后TuriX 就能像人一样完成点击、输入、滚动等操作下面是它自动处理 Numbers 图表并插入 PowerPoint 的演示设置二屏幕录制权限——让 TuriX 每一步都看得见TuriX 每个决策步骤都会先截屏再行动所以屏幕录制是硬性要求。启动脚本 examples/main.py 在运行前会先检查屏幕录制权限未授权时会直接提示并退出。最快配置方法打开系统设置 ▸ 隐私与安全性 ▸ 屏幕录制添加并开启Terminal、VS Code如果通过 OpenClaw 调用 TuriX还要把 Node.js 二进制如/opt/homebrew/bin/node一并加入修改权限后重启终端 / IDE再运行⚠️ 截图失败最典型的报错是AttributeError: NoneType object has no attribute save——基本都是屏幕录制权限没给到实际执行进程补齐后重启终端即可排错细节见 OpenCLaw_TuriX_skill/README.md。设置三Safari 自动化——两个开关 一条 osascript 命令TuriX 驱动 Safari 依赖 AppleScript需要先在 Safari 内部打开开发者能力Safari ▸ 设置 ▸ 高级→ 勾选Show features for web developers显示网页开发者功能菜单栏会出现新的Develop开发菜单进入后开启Allow Remote Automation允许远程自动化Allow JavaScript from Apple Events允许来自 Apple 事件的 JavaScript在每个 shell里各执行一次下面的命令弹框时点 Allowosascript -e tell application Safari \ to do JavaScript alert(\Triggering accessibility request\) in document 1注意Safari 的授权按哪个终端发起来记录。系统终端点过 Allow 之后还要在 VS Code 集成终端里再跑一次、再点一次 Allow两个入口互不通用。配置完成后TuriX 就能在 Safari 中完成订票、搜索等网页任务常见坑位清单10 个高频问题一次看全#症状原因解决办法1权限加了但无效开关没打开确认辅助功能 / 屏幕录制列表中每一项都是开启状态2权限不粘重启就丢macOS 权限记录失效把该应用删除后重新添加并打开开关3列表里找不到 python3 / node系统默认只列 GUI 应用点 后按Cmd Shift G粘贴完整路径手动添加4VS Code 里能跑外部终端不能跑或反之两者是独立进程Terminal 和 VS Code 分别授权5Safari 对话框只点了一次换个终端就失败每个 shell 都要单独授权在新终端里重新执行 osascript 并点 Allow6AttributeError: NoneType object has no attribute save截屏失败给实际执行进程含 node 二进制补屏幕录制权限重启终端7screencapture: command not found/usr/sbin不在 PATH在运行环境的 PATH 中补上/usr/sbin8报错-25204: Accessibility connection failed授权过的应用被关闭 / 重启过重新确认辅助功能权限保持应用进程不变9macOS 升级后权限集体失效系统更新重置了隐私设置更新系统后重新检查三大权限10任务执行中鼠标键盘无反应Python 进程未授权辅助功能补加/usr/bin/python3到辅助功能并重启会话验证跑一个最简单的任务权限配置完成后打开 examples/config.json 把agent.task改成一个简单任务例如打开系统设置切换到深色模式然后在配好的 Python 3.12 环境中运行 examples/main.pypython examples/main.py如果看到终端开始逐步输出、屏幕上出现红色圆圈点击高亮说明辅助功能 屏幕录制全部生效Safari 网页任务能正常打开并操作页面说明 Safari 自动化也配置成功 小结辅助功能给 Terminal / VS Code必要时加/usr/bin/python3→ 负责动手屏幕录制给 Terminal / VS CodeOpenClaw 场景再加 node 二进制→ 负责看屏幕Safari 自动化开发者功能 两个 Allow 开关 每个 shell 点一次 Allow → 负责开网页三项权限一次配齐TuriX 就能在 macOS 上稳定执行从打开应用到浏览器订票的长任务。更多细节可参考 README.md 的 Quick-Start 章节与 OpenCLaw_TuriX_skill/README.md 的排错部分。【免费下载链接】TuriX-CUAThis is the official website for TuriX Computer-use-Agent项目地址: https://gitcode.com/gh_mirrors/tu/TuriX-CUA创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
TuriX macOS 权限配置完全指南：辅助功能、屏幕录制、Safari 自动化三大设置与常见坑位清单
TuriX macOS 权限配置完全指南辅助功能、屏幕录制、Safari 自动化三大设置与常见坑位清单【免费下载链接】TuriX-CUAThis is the official website for TuriX Computer-use-Agent项目地址: https://gitcode.com/gh_mirrors/tu/TuriX-CUATuriX 是一个开源的桌面级计算机使用智能体Computer-Use-AgentCUA能让 AI 在 macOS 上真正动手操作电脑。要在 macOS 15 上跑通 TuriX核心就是完成macOS 权限配置辅助功能Accessibility、屏幕录制Screen Recording与 Safari 自动化三大设置。本文带你逐步完成配置并附上一份常见坑位清单帮你一次配好、少走弯路。为什么 TuriX 需要这三项 macOS 权限TuriX 每一步都会看屏幕 动手操作对应到系统权限上正好是三项权限系统入口TuriX 用它做什么辅助功能Accessibility系统设置 ▸ 隐私与安全性 ▸ 辅助功能模拟鼠标点击、键盘输入驱动 GUI实现见 src/mac/actions.py屏幕录制Screen Recording系统设置 ▸ 隐私与安全性 ▸ 屏幕录制每步截屏让视觉模型看到当前界面见 src/mac/tree.pySafari 自动化Safari ▸ 设置 ▸ 高级通过 AppleScript / osascript 驱动 Safari 完成网页任务见 src/controller/service.py一句话没有辅助功能它动不了手没有屏幕录制它看不见没有 Safari 开关它打不开网页。设置一辅助功能配置——让 TuriX 能点击和打字2 分钟打开系统设置 ▸ 隐私与安全性 ▸ 辅助功能点击添加你实际用来运行 TuriX 的程序Terminal终端和VS Code或你使用的任何 IDE如果 agent 仍然无法控制鼠标键盘再把/usr/bin/python3也加进来确认每一项的开关都是开启状态 ✅小技巧如果列表里找不到 python3、node 这类命令行二进制点 后按Command Shift G直接粘贴完整路径如/usr/bin/python3回车即可手动选中添加。配置好辅助功能后TuriX 就能像人一样完成点击、输入、滚动等操作下面是它自动处理 Numbers 图表并插入 PowerPoint 的演示设置二屏幕录制权限——让 TuriX 每一步都看得见TuriX 每个决策步骤都会先截屏再行动所以屏幕录制是硬性要求。启动脚本 examples/main.py 在运行前会先检查屏幕录制权限未授权时会直接提示并退出。最快配置方法打开系统设置 ▸ 隐私与安全性 ▸ 屏幕录制添加并开启Terminal、VS Code如果通过 OpenClaw 调用 TuriX还要把 Node.js 二进制如/opt/homebrew/bin/node一并加入修改权限后重启终端 / IDE再运行⚠️ 截图失败最典型的报错是AttributeError: NoneType object has no attribute save——基本都是屏幕录制权限没给到实际执行进程补齐后重启终端即可排错细节见 OpenCLaw_TuriX_skill/README.md。设置三Safari 自动化——两个开关 一条 osascript 命令TuriX 驱动 Safari 依赖 AppleScript需要先在 Safari 内部打开开发者能力Safari ▸ 设置 ▸ 高级→ 勾选Show features for web developers显示网页开发者功能菜单栏会出现新的Develop开发菜单进入后开启Allow Remote Automation允许远程自动化Allow JavaScript from Apple Events允许来自 Apple 事件的 JavaScript在每个 shell里各执行一次下面的命令弹框时点 Allowosascript -e tell application Safari \ to do JavaScript alert(\Triggering accessibility request\) in document 1注意Safari 的授权按哪个终端发起来记录。系统终端点过 Allow 之后还要在 VS Code 集成终端里再跑一次、再点一次 Allow两个入口互不通用。配置完成后TuriX 就能在 Safari 中完成订票、搜索等网页任务常见坑位清单10 个高频问题一次看全#症状原因解决办法1权限加了但无效开关没打开确认辅助功能 / 屏幕录制列表中每一项都是开启状态2权限不粘重启就丢macOS 权限记录失效把该应用删除后重新添加并打开开关3列表里找不到 python3 / node系统默认只列 GUI 应用点 后按Cmd Shift G粘贴完整路径手动添加4VS Code 里能跑外部终端不能跑或反之两者是独立进程Terminal 和 VS Code 分别授权5Safari 对话框只点了一次换个终端就失败每个 shell 都要单独授权在新终端里重新执行 osascript 并点 Allow6AttributeError: NoneType object has no attribute save截屏失败给实际执行进程含 node 二进制补屏幕录制权限重启终端7screencapture: command not found/usr/sbin不在 PATH在运行环境的 PATH 中补上/usr/sbin8报错-25204: Accessibility connection failed授权过的应用被关闭 / 重启过重新确认辅助功能权限保持应用进程不变9macOS 升级后权限集体失效系统更新重置了隐私设置更新系统后重新检查三大权限10任务执行中鼠标键盘无反应Python 进程未授权辅助功能补加/usr/bin/python3到辅助功能并重启会话验证跑一个最简单的任务权限配置完成后打开 examples/config.json 把agent.task改成一个简单任务例如打开系统设置切换到深色模式然后在配好的 Python 3.12 环境中运行 examples/main.pypython examples/main.py如果看到终端开始逐步输出、屏幕上出现红色圆圈点击高亮说明辅助功能 屏幕录制全部生效Safari 网页任务能正常打开并操作页面说明 Safari 自动化也配置成功 小结辅助功能给 Terminal / VS Code必要时加/usr/bin/python3→ 负责动手屏幕录制给 Terminal / VS CodeOpenClaw 场景再加 node 二进制→ 负责看屏幕Safari 自动化开发者功能 两个 Allow 开关 每个 shell 点一次 Allow → 负责开网页三项权限一次配齐TuriX 就能在 macOS 上稳定执行从打开应用到浏览器订票的长任务。更多细节可参考 README.md 的 Quick-Start 章节与 OpenCLaw_TuriX_skill/README.md 的排错部分。【免费下载链接】TuriX-CUAThis is the official website for TuriX Computer-use-Agent项目地址: https://gitcode.com/gh_mirrors/tu/TuriX-CUA创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
