CPTR 太棒了!open-webui/computer: 你的电脑,无处不在。
摘要
Open WebUI Computer (cptr) 是一款开源工具,让你能够通过任何浏览器访问整个电脑,从而实现对文件、终端、编辑器、git 等的远程访问。它可以自托管,并且跨设备使用。
查看缓存全文
缓存时间: 2026/07/14 04:24
open-webui/computer 源码:https://github.com/open-webui/computer
Open WebUI Computer
GitHub星标 · GitHub复刻 · GitHub关注者 · GitHub仓库大小 · GitHub语言数量 · GitHub主要语言 · 最近提交
Discord (https://discord.gg/5rJgQTnV4s)
Open WebUI Computer 演示
Open WebUI Computer(cptr)在你的机器上运行,并将整台计算机呈现给任何浏览器:文件、终端、编辑器、Git、浏览器标签页、正在运行的会话、AI代理和工具。它实质上就是你的计算机。可在手机、平板、笔记本、另一台计算机或运行它的机器上使用。专为在每个屏幕上呈现原生体验而设计。通过API密钥连接你自己的AI,插入你已订阅的代码代理,或直接在终端中工作。一个工具,完整工作站,任意设备。
从这里开始:Open WebUI Computer文档 (https://docs.openwebui.com/ecosystem/computer/)
安装
pip install cptr
cptr run
MCP工具服务器需要可选的MCP依赖项:pip install 'cptr[mcp]'。要安装所有可选功能组,请使用 pip install 'cptr[all]'。Docker镜像包含所有可选功能组。
或者使用 uv (https://docs.astral.sh/uv/):uvx cptr@latest run
在Windows上,如果打开终端报告缺少 VCRUNTIME140.dll 或 Universal CRT DLL,请安装 Microsoft Visual C++ Redistributable (https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist) 并重启 cptr。
在浏览器中打开 http://localhost:8000。
从手机访问
同一Wi-Fi?绑定到所有接口:
cptr run --host 0.0.0.0
在手机上打开 http://<IP>:8000。
不在同一网络?使用隧道远程访问你的机器:
- Tailscale (https://tailscale.com):在你的设备间创建私有网状网络。推荐。
- Cloudflare Tunnel (https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/):通过Cloudflare边缘提供永久URL。
- ngrok (https://ngrok.com):一条命令即可获得公共URL。
大多数隧道转发到 localhost,因此默认的 cptr run 即可工作。如果隧道连接到特定接口,请使用 --host 相应绑定。
或者完全跳过网络,连接消息机器人。
整台机器
Open WebUI Computer 是真实的工作站界面:文件、Shell、Git状态、工作区、聊天、工具和会话都保持在一起,无论你在哪里打开它。
| 📁 真实文件 | 导航、创建、重命名、上传、拖放。按类型显示图标,一眼看尽大小。 |
| ✏️ 编辑器 | 带语法高亮的编辑,支持标签页。并排打开多个文件。 |
| 🔀 Git | 暂存、提交、比较、分支、推送。可视化更改视图。无需命令行。 |
| ⌨️ 终端 | 浏览器中的完整Shell。运行你的工具、脚本或你喜欢的代码代理。 |
| 🌐 浏览器 | 通过代理、私有Managed Chrome配置文件或你自己的个人Chrome会话浏览。 |
| 🔄 会话持久化 | 关闭标签页时终端继续运行。可在任何设备上回来继续。 |
| 🗂️ 标签页 | 在单独的标签页中打开浏览器、终端、文件、聊天和工具。重新排列或拆分布局。 |
| 📂 工作区 | 多个项目,一个实例。切换时不丢失位置。 |
| 🔍 搜索 | 按文件名或内容查找文件,然后直接跳转到匹配行。⌘K 也搜索聊天历史。 |
| 📱 移动优先 | 并非缩小版的桌面UI。专为你口袋里的屏幕而构建。 |
AI代理
AI在你实际工作的环境中工作。自带API密钥(OpenAI、Anthropic、Ollama或任何兼容OpenAI的端点),或连接你已订阅的代码代理。它可以读取工作区、编辑文件、运行命令、浏览网页、使用工具、自动化重复性工作,并能在同一台机器上生成并行的子代理。
| 💬 聊天 | 内置AI,支持流式响应和工具调用。不仅仅是对话:它可以行动。 |
| 🎙️ 语音模式 | 免提与计算机对话。它聆听、回应,并将答案读回给你。麦克风会自动重新启用,让你进行真正的对话。 |
| 🔊 文本转语音 | AI响应逐句朗读。适用于任何兼容OpenAI的TTS API。 |
| 💭 推理 | 查看AI的思考过程。像o3和Claude这样的模型会以可展开的区块显示其思维链。 |
| 🔧 文件工具 | AI直接读取、写入、编辑和搜索你的代码库。 |
| ▶️ 运行命令 | AI执行Shell命令并读取输出。前台或后台。 |
| 🌐 网页浏览 | 导航页面、点击元素、填写表单、截取屏幕截图。 |
| 🔍 网络搜索 | Brave、DuckDuckGo、Exa、Tavily、Perplexity或任何聊天完成端点。 |
| 🖼️ 图像理解 | AI读取并描述工作区中的图像和屏幕截图。 |
| 📋 计划模式 | 在AI编写一行代码之前请求实现计划。 |
| ✏️ 输出编辑 | 在应用之前审查和编辑AI生成的更改。 |
| 📎 文件提及 | 输入 @ 为AI提供关于特定文件的上下文。 |
| 🧩 技能 | 可重用的指令集(SKILL.md文件)。输入 $ 提及一个。 |
| ⏱️ 定时任务 | 安排重复的AI任务。“每天早上运行测试。”“每周五部署。” |
| 🤖 子代理 | AI为复杂任务生成并行工作线程。每个都有完整的工具访问权限。 |
| 🔌 工具服务器 | 通过MCP或OpenAPI连接外部工具。 |
| 🧠 上下文压缩 | 长对话会被自动摘要以保持速度。 |
代码代理
将你已经付费订阅的服务作为本地后端的本地机器上使用。无需单独的API密钥。
Codex · Claude Code · Cursor · Grok · OpenCode · Cline · Gemini · Pi
从设置中添加代理配置文件,选择你的模型,它就会像其他提供商一样出现在模型选择器中。对话在你的工作区中运行,具有完整的工具访问权限,并可从你离开的地方继续。
更喜欢自己运行代理?任何终端代理(Kilo Code、Pi等)都可以像往常一样在终端标签页中工作。
消息机器人
随时随地给你的计算机发消息。将AI连接到你的聊天应用,具有完整的工具访问权限、流式响应以及同步回Web UI的对话。
Telegram · Discord · Slack · WhatsApp · Signal
让它检查构建、推送修复或解释文件。使用 /workspace 切换工作区,使用 /new 开始新对话。
网关API
将每个工作区变成一个具有真实机器访问权限的、兼容OpenAI的代理模型。Open WebUI Computer 暴露 /v1/chat/completions,因此任何支持OpenAI的客户端(包括 Open WebUI (https://github.com/open-webui/open-webui))都可以使用具备完整代理功能的工作区:文件访问、终端、网络搜索、工具。
更多
| 🎙️ 语音备忘录 | 录制音频,自动转录为Markdown。 |
| 💬 消息队列 | 在AI响应时排队后续消息。 |
| 🔔 通知 | 浏览器通知,外加针对聊天事件的命名Webhook或机器人目标。 |
| 📊 使用情况 | 每次响应的Token计数和耗时。 |
| 📄 系统提示 | 按模型、按工作区或全局设置。包含模板变量。 |
| 📋 审计日志 | 所有API突变的结构化审计跟踪,自动屏蔽敏感数据。 |
| 🪵 诊断日志 | 可配置的结构化日志(文本或JSON),可选的上游请求捕获。 |
| ⌨️ 键盘快捷键 | 可自定义的键绑定,带有设置面板。 |
| 🌍 10种语言 | English, Deutsch, Español, Français, Português (Brasil), Русский, 日本語, 한국어, 简体中文, 繁體中文。 |
| 🔐 认证 | 用户名/密码搭配JWT会话。管理员可控制注册开关。 |
设计原则
移动是头等舱。 该界面专为手机构建。天然的触摸操作、竖屏优先、专为人们随身携带的屏幕设计。会话能在断开连接后存活,因为手机上这种情况必然会发生。如果某个功能只能在桌面上使用,那它就不算完成。
你的机器。 Open WebUI Computer 服务于它所运行的机器。本地文件系统、本地Shell、本地状态。那台机器在哪里由你决定。
计算机,而非聊天。 核心是文件系统、终端和Git。文件优于应用。机器上的普通文件,而非被另一个产品困住的内容。AI对话也是文件:可搜索、可编辑、可移动、可提交。Open WebUI Computer 是通向真实系统的窗口,而非其上的一个容器。
Open WebUI Computer 在你的机器上运行,并将整个内容放入浏览器标签页。掏出手机,你就进来了。文件、编辑器、终端、Git,都在你已经拥有的计算机上运行。在火车上推送热修复。躺在床上检查部署。在公园里发布一个副项目。无需接触命令行即可暂存和提交,或者打开终端用老办法操作。跨文件搜索。预览Markdown。拖放元素。切换项目而不丢失位置。关闭标签页。明天在任何设备上回来。一切都还在。会话在断开连接后存活。你的工作不在乎你在哪个屏幕上。
生命短暂。去接触草地。阅读我们的宣言。
帮助我们构建开放的、赋能于人的工具,让AI掌握在人们手中。 我们正在招聘 (http://careers.openwebui.com/)。
Docker
使用Docker运行Open WebUI Computer:
docker run --rm -it \
-p 8000:8000 \
-v cptr-data:/data \
-v "$PWD:/workspace" \
-w /workspace \
ghcr.io/open-webui/computer:latest
然后打开日志中打印的URL,通常是 http://localhost:8000/?token=...。
Open WebUI Computer 将其状态存储在 /data 中。将你的项目挂载到容器中,例如 -v "$PWD:/workspace",以便Open WebUI Computer可以访问它。
默认镜像包含Git和GitHub CLI (gh)。当代理的浏览器自动化需要Chromium时,使用 ghcr.io/open-webui/computer:browser。
如果你将主机目录绑定挂载到 /data,请确保该目录对容器用户可写。SQLite需要创建和更新 /data/app.db,并且主机目录权限优先于镜像内置的 /data 所有权。
还提供了 :dev 镜像,追踪 main 分支。
离线安装
Open WebUI Computer 安装后不需要互联网访问。Python wheel包含构建好的前端资源,Docker镜像是自包含的。
在有网络的机器上:
pip download --dest wheelhouse 'cptr[all]'
docker pull ghcr.io/open-webui/computer:latest
docker save ghcr.io/open-webui/computer:latest -o cptr-image.tar
传输工件,然后离线安装或运行:
python -m venv .venv
. .venv/bin/activate
pip install --no-index --find-links ./wheelhouse 'cptr[all]'
cptr run --host 0.0.0.0
docker load -i cptr-image.tar
docker run --rm -it \
--network=none \
-p 8000:8000 \
-v cptr-data:/data \
-v "$PWD:/workspace" \
-w /workspace \
ghcr.io/open-webui/computer:latest
核心本地功能从本地资源运行。外部服务(如托管的模型API、网络搜索提供商、消息适配器、Git远程仓库以及MCP/OpenAPI服务器)仍然需要可访问的端点。
安全模型
Open WebUI Computer 被设计为你的计算机,为你服务。一旦通过身份验证,用户将拥有对主机文件系统和Shell的完全访问权限,相当于SSH会话。没有路径沙盒,也没有每个用户的隔离。
当你自己是唯一用户且控制网络时,这是安全的。如果不受信任的用户共享该实例、暴露在公共互联网上,或者反向代理转发了可伪造的认证头,则不安全。请将共享的Open WebUI Computer视作开放的SSH端口。
许可协议
开放使用许可证。源码可用。保留所有权利。参见 LICENSE。提供商业许可证 (https://openwebui.com/computer/license) 和企业许可证。
相似文章
能够控制多台机器的 Computer-use MCP(可与 Claude、Cursor、Codex 或自定义框架集成)
opendesk 是一款免费开源工具,它通过 Computer-use MCP 协议,让 AI 智能体能够通过本地 WiFi 网络控制多台计算机,并可集成 Claude、Cursor、Codex 以及自定义工作流。
OpenComputer | 一款为智能体打造的开源计算机
OpenComputer 是一个面向AI智能体的开源虚拟机环境,提供人类可操作的电脑界面,让智能体安全运行的同时,用户能够观察并协作。它可在本地运行并使用小型上下文模型,避免基于截图的导航方式,以提高效率。
Open Computer Use
Open Computer Use 是一个开源的 MCP (模型上下文协议),用于 AI 代理控制计算机界面。
Cursor Party
Cursor Party 是一款工具,可在任意网址上实现实时多人光标共享和聊天,以增强远程协作。
wonderwhy-er/DesktopCommanderMCP
Desktop Commander MCP 是一个开源工具,允许 AI 通过模型上下文协议搜索、更新、管理文件以及运行终端命令,并增强了文件预览和命令执行功能。