把TuriX接入OpenClaw安装ClawHub技能让智能体远程操作你的桌面附run_turix.sh参数详解【免费下载链接】TuriX-CUAThis is the official website for TuriX Computer-use-Agent项目地址: https://gitcode.com/gh_mirrors/tu/TuriX-CUATuriX-CUA 是一个开源的计算机操作智能体Computer Use Agent简称 CUA本文介绍如何把 TuriX 接入 OpenClaw安装 ClawHub 技能包后OpenClaw 就能代替你点击、输入、跨应用执行多步桌面任务并附上run_turix.sh启动脚本的完整参数详解。全程无需修改 TuriX 源码装好技能包即可对话式驱动。 为什么把 TuriX 接入 OpenClawOpenClaw 本身擅长终端命令和文件操作但碰到 GUI 应用没有命令行或 API 的程序就无能为力。TuriX 恰好补上这块短板充当 OpenClaw 的眼睛和手打开并操作 GUI 应用浏览器、Safari、系统设置、Spotify 等点击按钮、填写表单应对复杂界面执行多步视觉工作流跨应用收集信息、生成文档、发消息TuriX 内部是多模型协作架构见 SKILL.mdBrain负责理解任务并生成计划Actor负责精确执行 UI 动作Planner做高层任务拆解Memory维护跨步骤上下文。上面的演示中智能体在 macOS 桌面上自动完成了跨多个应用的复杂任务——这类操作正是技能包让 OpenClaw 获得的能力。 一键安装从克隆仓库到技能就位第一步克隆仓库并准备 Python 环境git clone https://gitcode.com/gh_mirrors/tu/TuriX-CUA conda create -n turix_env python3.12 conda activate turix_env pip install -r requirements.txt第二步授予 macOS 两项强制权限macOS 安全机制要求显式授权缺一不可1. 屏幕录制权限System Settings → Privacy Security → Screen Recording需要添加的程序说明Terminal终端运行任务所需VS Code在 IDE 终端运行时所需Node.js 二进制运行 OpenClaw 的 node如/opt/homebrew/bin/node2. 辅助功能权限Accessibility建议同时加入 Terminal、VS Code、Node 和/usr/bin/python3。 小技巧如果文件选择器里找不到某个二进制按Cmd Shift G手动粘贴完整路径即可添加。详细步骤见 OpenCLaw_TuriX_skill/README.md。第三步安装 ClawHub 技能包官方技能包已发布在 ClawHubTongyu-Yan/turix-cua仓库中也内置了本地技能包OpenCLaw_TuriX_skill/。将其放置到 OpenClaw 的本地技能目录结构如下your_dir/clawd/skills/local/turix-mac/ ├── README.md ├── SKILL.md └── scripts/ └── run_turix.sh对应源文件技能定义 SKILL.md 与启动脚本 run_turix.sh。第四步对话触发看它干活装好之后直接对 OpenClaw 说出视觉任务即可例如Use Safari to go to turix.ai, and sign up with Google account.OpenClaw 会在后台自动执行run_turix.sh完成整个流程。几点使用注意首次启动需要2~5 分钟加载全部 AI 模型请耐心等待后台输出有缓冲任务完成或停止前看不到实时进度强制停止按CmdShift2可立即叫停智能体运行日志保存在.turix_tmp/logging.log可用tail -f实时跟踪每一步动作同一套 CUA 能力也可以经 MCP 协议对接其他智能体如 Claude上图即 Claude 调用 TuriX 的完整演示。 run_turix.sh 参数详解run_turix.sh是连接 OpenClaw 和 TuriX 的桥梁脚本它会自动更新 examples/config.json写入任务、resume、use_plan、use_skills 等字段做完预检conda 环境、配置文件、屏幕录制权限后启动examples/main.py。参数短选项作用TASK引号包裹—任务描述写入agent.task。如Open Chrome go to github.com--resume ID-r以指定agent_id恢复中断任务同时写入resume: true与agent_id--config FILE-c使用自定义配置文件替代默认的examples/config.json--no-plan—关闭规划模式同时禁用 skills简单任务更快--enable-skills—显式启用 skills 系统需要规划模式开启--dry-run—只打印将要执行的命令和配置不真正启动--help-h查看帮助典型用法# 常规任务 ./run_turix.sh Open Chrome and go to github.com # 恢复之前中断的任务 ./run_turix.sh --resume my-task-001 Continue task # 先预览配置确认无误再运行 ./run_turix.sh --dry-run Search for turix-cua on GitHub and star it恢复任务--resume注意事项agent_id必须与中断前那次运行保持一致任务文本task保持不变前提是先前的记忆文件src/agent/temp_files/agent_id/memory.jsonl存在⚠️ 脚本会改写examples/config.json。如果你想保留手工编辑的配置直接编辑配置文件即可不必通过参数传入任务。Skills 技能系统让智能体更懂你的业务TuriX 支持 Markdown 形式的技能剧本默认目录skills/。Planner 只看到技能的name description用于选择Brain 拿到完整内容指导每一步执行。仓库内置示例 github-web-actions.md--- name: github-web-actions description: Use when navigating GitHub in a browser (searching repos, starring, opening repo pages). --- # GitHub Web Actions - Open a browser first if the user did not specify the Github app. - ...启用 skills 需要在配置中满足use_plan: true且use_skills: true见 examples/config.json 中的agent字段。你也可以仿照该格式在skills/目录新建自定义技能内容建议控制在 4000 字符以内。写好任务描述的 3 个要点✅好的任务目标应用明确 步骤清晰Open Safari, go to google.com, search for TuriX AI, and click the first resultOpen Finder, navigate to Documents, and create a new folder named Project X❌避免模糊指令Help me、Fix this让智能体描述屏幕坐标未加警告的系统级危险操作进阶技巧GUI 智能体相对慢且不完全确定。像整理新闻再写文档这类任务更好的做法是用脚本生成文档只让 TuriX 负责发送文件——详见 SKILL.md 中的 Document Creation Best Practices。 常见故障排查速查表报错 / 现象解决方案NoneType has no attribute save屏幕录制权限缺失。给 Node.js 二进制加权限后执行openclaw gateway restartscreencapture: command not found确保运行环境 PATH 包含/usr/sbin脚本已内置export PATH缓解权限不生效从 Screen Recording / Accessibility 中删除后重新添加确认开关为 ON选择器里找不到程序按Cmd Shift G手动粘贴二进制完整路径Conda 环境报错确认turix_env存在conda create -n turix_env python3.12想立刻停止任务按CmdShift2或pkill -f python examples/main.py监控进度可以tail -f .turix_tmp/logging.log其中 Step N、✅ Eval: Success、✅ Task completed successfully等标记能帮你快速判断执行状态。✅ 小结只需四步——克隆仓库、授予权限、放置技能包、对话触发——OpenClaw 就拥有了 TuriX 的桌面操作能力配合run_turix.sh的--resume、--dry-run、skills 等参数你可以灵活恢复任务、预览配置、定制领域技能。任务描述写得越具体自动化成功率越高快去试试把重复的桌面工作交给智能体吧 【免费下载链接】TuriX-CUAThis is the official website for TuriX Computer-use-Agent项目地址: https://gitcode.com/gh_mirrors/tu/TuriX-CUA创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考