ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Open Computer Use macOS 权限教程:一次配置好 Accessibility 与屏幕录制,附 doctor 排障清单

Open Computer Use macOS 权限教程:一次配置好 Accessibility 与屏幕录制,附 doctor 排障清单 Open Computer Use macOS 权限教程一次配置好 Accessibility 与屏幕录制附 doctor 排障清单【免费下载链接】open-codex-computer-use Open Computer Use – Open-Source Alternative to Codex Computer Use项目地址: https://gitcode.com/gh_mirrors/op/open-codex-computer-useOpen Computer Use是一个开源的 Computer Use 服务Codex Computer Use 的开源替代方案通过 MCP 协议让 AI Agent 操作你的桌面应用。在 macOS 上第一次使用它只需要完成一件事授权Accessibility辅助功能和Screen Recording屏幕录制两项系统权限。本文是一份面向新手的完整指南教你一次配置好这两项权限并附上doctor命令的排障清单让你不再卡在权限问题上。为什么 macOS 上需要这两项权限Open Computer Use 采用「非抢占式」的 Computer Use 方案AI 通过系统的无障碍接口读取界面元素、用截屏定位点击位置而不是强行劫持你的鼠标键盘。这就对应了 macOS 的两类系统权限权限对应系统设置页它的作用Accessibility辅助功能隐私与安全性 → 辅助功能让 Open Computer Use 读取和操其他 App 的界面元素点击、输入、滚动Screen Recording屏幕录制隐私与安全性 → 屏幕与系统音频录制让 Open Computer Use 截屏知道「该点在哪里」权限的运行时检测逻辑可以直接在项目源码中查看Permissions.swift 中定义了Accessibility与Screen Recording两种权限类型并会同时检查系统持久化授权TCC 数据库和运行时状态确保状态判断准确。 前置条件macOS 运行时要求macOS 14.0 及以上Windows 和 Linux 不需要这一步权限配置。一次性授权从安装到打开引导窗口的 3 步第 1 步安装 Open Computer Use在终端执行npm i -g open-computer-use安装完成后open-computer-use和短别名ocu都可以使用。第 2 步运行 doctor 检查权限open-computer-use doctordoctor命令会打印当前权限状态例如Permissions: accessibilitygranted, screenRecordingmissing只有当检测到缺失权限时才会自动拉起官方的权限引导窗口如果已经全部授权它只会打印状态并直接退出——这正是「一次配置」的关键配好后无需再动。命令的入口实现位于 OpenComputerUseMain.swift 的doctor分支先调用PermissionDiagnostics.current()汇总两项权限再在缺失时启动PermissionOnboardingApp。第 3 步在引导窗口中完成授权弹出的「Open Computer Use」引导窗口会列出需要授权的权限项。点击对应权限后系统会自动跳转到系统设置的对应页面辅助功能 / 屏幕与系统音频录制按照引导提示将Open Computer Use添加/打开开关完成后回到窗口状态会更新为已授权关闭即可。这个引导体验并非简单甩给你一个设置页面——项目内建了权限窗口状态机和带拖拽引导的面板相关设计调研记录见 permission-onboarding.md。doctor 排障清单权限不生效时按顺序检查当 AI 报「找不到应用」「快照为空」或动作执行失败时先别慌按下面的清单逐项排查。完整的官方排障参考在 troubleshooting.md。✅ 检查 1macOS 版本是否达标sw_vers -productVersion低于 14.0 时程序无法启动此时doctor和任何权限授权都救不了你只能升级系统。✅ 检查 2跑一遍标准三件套open-computer-use -h # 确认 CLI 可用 open-computer-use doctor # 查看权限状态 open-computer-use call list_apps # 验证能否列出正在运行的应用doctor输出中某项是missing→ 重新拉起引导窗口完成授权list_apps报错或为空 → 多半是辅助功能权限没真正生效。✅ 检查 3授权后重启相关进程macOS 的权限变更有时需要目标进程重启才生效。如果刚授权完仍报权限缺失退出并重开终端再跑一次doctor。注意不要尝试绕过系统 TCC 权限弹窗这会破坏 macOS 的安全边界。✅ 检查 4目标应用是否可见「快照为空」不一定是权限问题目标应用需要有可见的窗口未最小化、未被隐藏。先让目标 App 出现在屏幕上再重新执行。✅ 检查 5版本是否过旧权限引导窗口出现旧面板、状态不刷新等问题通常是版本较老。升级到最新 release 即可历史修复记录可在 docs/histories/ 中检索。小结两项权限Accessibility Screen Recording缺一不可一条命令open-computer-use doctor自动检查并按需拉起授权引导一个原则权限只授权给官方 App「Open Computer Use」不要绕过系统弹窗一份清单权限问题 90% 的排查路径就是「版本 → doctor → 重启进程 → 窗口可见性」四步。配置完成后你可以在 README.md 中继续查看如何将 Open Computer Use 接入 Codex、Claude Code、Gemini CLI 等 Agent让你的 AI 真正开始操作桌面。【免费下载链接】open-codex-computer-use Open Computer Use – Open-Source Alternative to Codex Computer Use项目地址: https://gitcode.com/gh_mirrors/op/open-codex-computer-use创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表