用途:TuriX-Mac 技能让 Clawdbot 借助 TuriX Computer Use Agent 以视觉方式操作 macOS 桌面,适合打开应用、点击按钮、在缺少命令行界面的应用中导航,以及需要规划、推理并自主执行的多步骤视觉工作流。
主要能力:采用多模型架构,Brain 理解任务并生成分步计划,Actor 依据视觉理解执行精确 UI 操作,Planner 负责高层任务分解(use_plan: true 时启用),Memory 跨步骤保持上下文。支持 Skills 系统,即用 markdown 编写的领域操作手册(如 github-web-actions、browser-tasks,也可在 skills/ 目录添加自定义技能),Planner 依据名称与描述选择技能,Brain 使用完整内容指导执行。通过设置稳定的 agent_id 可恢复被中断的任务。
使用方式:基本任务运行 skills/local/turix-mac/scripts/run_turix.sh "Open Chrome and go to github.com";恢复任务运行 skills/local/turix-mac/scripts/run_turix.sh --resume my-task-001。run_turix.sh 会自动更新 examples/config.json(task、resume、use_plan、use_skills);若想保留手工编辑的配置,可不传任务而直接编辑该文件。运行前需先设置 PATH:export PATH="/usr/sbin:$PATH",再 cd your_dir/TuriX-CUA,然后 /opt/anaconda3/envs/turix_env/bin/python examples/main.py,原因是 screencapture 位于 /usr/sbin/screencapture,不在默认 PATH 中。强制停止热键为 Cmd+Shift+2,也可用 pkill -f "python examples/main.py"。日志位于 .turix_tmp/logging.log。
适用场景:目标应用明确、步骤清晰的任务,例如打开 Safari 搜索并点击结果、在系统设置中切换深色模式、在 Finder 中新建文件夹。应避免模糊指令(如“Help me”)、不可能的操作(如“Delete all files”)以及未加提示的系统级权限任务。
限制:TuriX 是 GUI 代理,速度较慢且确定性较低,建议仅用于 Clawdbot 无法完成或 TuriX 更快的任务;文档创建建议用 python-docx 自行生成,再让 TuriX 仅负责发送。首次启动需 2-5 分钟加载全部模型,后台输出有缓冲,任务完成或停止前看不到实时进度。常见问题包括缺少屏幕录制权限、Conda 环境缺失、模块导入错误及键盘监听权限错误。中文文本需通过环境变量或 stdin 传入,并以单引号 heredoc 避免 shell 插值。其余未在资料中说明的收费、平台与效果信息暂未提供。