iFurySt /open-computer-use
👾 Open Computer Use – Open-Source Alternative to Codex Computer Use
★ 2,979⑂ 276👁 6⑃ 145● 31▤ 55
+5
日增长
2,979
stars
276
forks
6
watchers
145
prs
31
issues
55
releases
README
open-computer-use
[!TIP]
对 Browser Use 感兴趣的话,可以看看 open-browser-use。
---
open-computer-use 是一个开源的 Computer Use 服务,已经包装成 MCP 协议,支持所有的 AI Agent 或 MCP Client 快速调用,实现 macOS、Linux 和 Windows 上的 Computer Use 能力。
项目的背后是 OpenAI 刚发布的 Codex Computer Use,让我看到了基于 Accessibility 可以实现非抢占式 CUA 能力,因此决定复刻一个开源版本
在这期间我利用了之前写的 harness 模版 开启了这个新项目。这是一个可以快速拉起面向 AI 仓库的 template,非常适合 100% AI-Generated 的项目,也是这一个月来我们最大的实践和收获。现在我们可以基于这套方法论快速实现很多东西;如果你有兴趣,我也写了一篇文章专门介绍这套方法论
演示
Codex App 和 Codex CLI
open-computer-use 作为 Computer Use,在 Codex App 和 Codex CLI 里使用,和官方体验一致。
Gemini CLI
https://github.com/user-attachments/assets/eacb3b15-f939-46c7-b3b3-6f876977a58d
Gemini CLI 通过MCP接入使用 open-computer-use,实现完整的 Computer Use 操作。
Linux
https://github.com/user-attachments/assets/e036b1c8-2200-4896-abd4-19225915cf66
open-computer-use 在 Linux 里使用
Locked Use
目前支持Locked Use,OCU会在锁屏之后临时解锁使用电脑(仅支持macOS),期间会有一系列的安全配套服务比如遮罩层来保证安全性
!Open Computer Use Locked Use screen
Locked Use 的开启方式、安装组件和权限见文档
Quick Start
bash
npm i -g open-computer-use
通过 npm 安装后也会同时提供短命令 ocu。
[!IMPORTANT]
macOS 运行环境要求 macOS 14.0 或更高版本。
macOS 第一次使用前,需要授权 Accessibility 和 Screen Recording 的权限,windows和linux无需执行
bash
open-computer-use
或
ocu
开始用前可以通过一键安装到主流的Agent里:
bash
一键安装到 Codex,写到 ~/.codex/config.toml 中
open-computer-use install-codex-mcp
ocu install-codex-mcp
也可以手动配置到你自己的客户端里:
json
{
"mcpServers": {
"open-computer-use": {
"command": "open-computer-use",
"args": ["mcp"]
}
}
}
Skill
一键安装skill:
bash
安装到 Codex
npx skills add iFurySt/open-computer-use -g -a codex --skill open-computer-use -y
npx skills ls -g -a codex | rg 'open-computer-use'
安装到 Claude Code
npx skills add iFurySt/open-computer-use -g -a claude-code --skill open-computer-use -y
更新已有的全局安装,包括上面安装到 Codex 的那份:
bash
npx skills update open-computer-use -g -y
也可以手动下载 open-computer-use skill 安装
更多
除了直接用上面的 MCP JSON 配置,你也可以用一些内置子命令:
bash
一键安装到 Codex,写到 ~/.codex/config.toml 中
open-computer-use install-codex-mcp
一键安装到 Codex 插件,主要方便在 Codex App 中使用
open-computer-use install-codex-plugin
一键安装到 Claude Code,写到 ~/.claude.json 中
open-computer-use install-claude-mcp
一键安装到 Gemini CLI 当前项目,写到 ./.gemini/settings.json
open-computer-use install-gemini-mcp
一键安装到 Gemini CLI 用户级配置
open-computer-use install-gemini-mcp --scope user
一键安装到 opencode,写到 ~/.config/opencode/opencode.json(或当前生效的配置文件)
open-computer-use install-opencode-mcp
直接调用单个 Computer Use tool,输出 MCP 风格的 JSON result
open-computer-use call list_apps
ocu call list_apps
open-computer-use call get_app_state --args '{"app":"TextEdit"}'
在同一个进程里编排连续动作,复用 get_app_state 拿到的 element_index
连续动作默认会在成功的相邻操作之间 sleep 1 秒
open-computer-use call --calls '[{"tool":"get_app_state","args":{"app":"TextEdit"}},{"tool":"press_key","args":{"app":"TextEdit","key":"Return"}}]'
open-computer-use call --calls-file examples/textedit-overlay-seq.json --sleep 0.5
检查权限;只有缺失时才会拉起引导,已全部授权则只打印状态并退出
open-computer-use doctor
macOS:只查询权限 JSON,不弹引导界面
ocu doctor --jsTop issues
#53macOS: drag tool executes without error but performs no actual drag (window move / text selection)6 comments · 2026-08-05#57get_app_state/snapshot fail with 'Apple event error -10005: cgWindowNotFound' after logout+relogin (macOS 27 beta); fixed by reboot4 comments · 2026-08-25#91[Bug] Windows: coordinate click/drag post to the top-level HWND, not the child under the point; PostMessage failures (UIPI) reported as success2 comments · 2026-10-10#83[Bug] macOS 26 real-world findings on 0.3.5: wrong-window targeting, silent set_value, docs/version mismatch, and more2 comments · 2026-09-27#90[Bug] Windows: get_app_state screenshot uses CopyFromScreen, so a covered window returns the covering content (use PrintWindow PW_RENDERFULLCONTENT)1 comments · 2026-10-10#49windows上是不是用不了1 comments · 2026-07-28#142Locked Use fails when Karabiner-Elements is running (IOHIDManagerOpen returns kIOReturnExclusiveAccess)0 comments · 2026-11-01#98[Bug] Windows 1.0.0 scroll fallback rejects a visible target despite a fresh screenshot (repro for #97)0 comments · 2026-10-13
Latest release
v1.1.4 v1.1.4 2026-11-07What's Changed Fix Locked Use cleanup after idle timeout and Guardian reconnection so completed sessions can release protection and allow the next task. 158 Preserve visible controls and action buttons when large accessibility trees reach their node budget on macOS, Windows, and Linux. 145 Verify actual values after setting controls across platforms, including when action read-back is disabled; preserve whitespace and support clearing fields. 111 Full Changelog: https://github.com/iFurySt/open-computer-use/compare/v1.1.3...v1.1.4