English | 简体中文

xopc

工作与生活中的 AI 助理。
帮你理清想法，处理事务，
留出时间做自己在意的事。
开源、本地优先，运行在你选择的电脑上。

下载桌面应用 → · 使用文档 · 观看演示与实战教程

我们的愿景

让每个人都能拥有自己的 AI 助理，在工作和生活中获得持续的帮助，有更多时间和精力，去做自己在意的事。

我们希望 AI 能逐渐承担更多繁琐、重复和耗时的事务。省下的时间如何使用，由你决定。了解产品理念。

两种方式，从同一个 xopc 开始

先和 Ada 聊聊。 Ada 是 xopc 中的个人 Agent，无需单独安装。告诉它你的背景、回复偏好和想做的事；需要时交办任务，继续对话，再回来查看结果。认识 Ada。

直接进入工作空间。 带入文件和目标，处理资料、分析数据、修改代码或制作汇报。把对话、成果与项目留在一起，稍后接着做。工作空间指南。

对话和工作空间是两种开始方式，工作与生活中的事情都可以在这里处理。从整理工作资料到安排周末出行，在同一个 xopc 里开始。可用能力取决于连接的模型、工具和授权。

先完成一件实际的事

你想做什么	可以这样开始	检查什么
安排轻松的周末	“周末想带相机出去走走，只有半小时。帮我把想法整理成一页小计划。”	时间安排、待核实信息和可修改的计划
继续上次的项目	“结合这个项目的笔记与任务，告诉我目前卡在哪里，先给出下一步建议。”	背景来源、未决事项和下一步
把资料做成报告	“把这些销售文件整理为汇总表，保留来源、计算依据和异常项。”	保存的文件、汇总数字和异常项
交办后继续聊	“把本周计划整理成一页文件，做好后告诉我；我们继续讨论下周的重点。”	任务卡、实际文件和修改结果

资料处理需要相应文件访问权限、工具或技能；语音、图像、浏览器和外部服务也需要各自配置。交办与接收结果 · 实战教程。

核心能力

能力	用途
上下文与记忆	保存会话、项目背景和可查看、纠正、删除的用户理解
委派与交付	交办任务、处理补充问题、接收成果，并按验收条件检查结果
文件与项目	处理授权资料，保留文件、笔记、执行记录和下一步
工具与连接	技能、MCP、连接器、浏览器自动化、图像和语音；按需启用
多端访问	桌面、网页、终端、手机，以及 Telegram、微信、飞书/Lark

电脑控制目前是 macOS 桌面预览能力，需要兼容的 GUI 模型和系统权限。移动端能力随平台与版本变化，Agent 仍在连接的电脑上运行。

快速开始

桌面应用

1. 下载 xopc，选择 macOS、Windows 或 Linux。
2. 连接 XOPC Cloud、自己的模型 API Key，或本地模型服务。
3. 打开个人 Agent 或聊天，先发送一个小请求，再带入真实资料。

桌面安装说明 · 模型设置。

终端安装

macOS、Linux、WSL：

curl -fsSL https://xopc.ai/install.sh | bash
xopc onboard --quick
xopc

Windows PowerShell：

irm https://xopc.ai/install.ps1 | iex
xopc onboard --quick
xopc

已具备 Node.js 26.12.1+ 时，也可执行 pnpm add -g @xopcai/xopc。终端快速开始包含镜像与排障说明。

在手机上继续

下载渠道与连接步骤。扫码并在电脑上批准配对后，查看进展、发送指令；保持电脑唤醒且 xopc 正在运行。

数据与控制

核心状态默认存储在本机 ~/.xopc/。可使用云模型或本地模型；选择云服务时，相关请求上下文、图片或音频会由对应提供商处理。连接 XOPC Cloud 不会自动上传整个本地数据库或工作空间。

数据源、工具和频道按需授权。执行确认取决于工具策略和你的授权范围；浏览器控制不会为每次点击弹出确认。先明确任务范围，涉及发送、删除、购买或账号变更时，要求先展示结果并等待你确认。隐私与记忆。

找到对应指南

你想做什么	指南
设置个人助手	认识 Ada
交办并修改成果	任务交付
处理文件与项目	工作空间
检查结果与重试	任务验收
增加服务和能力	模型 · 技能 · MCP · 连接器
配置实例与扩展	配置 · 扩展 · XOPC Platform
查看更新	近期变化 · GitHub Releases

社区交流

欢迎加入 xopc 社区，交流使用经验、分享作品，并一起参与项目建设。

渠道	适合内容
GitHub Discussions	技术问答、想法讨论和长期可检索的信息
Discord	实时交流、作品展示和贡献者协作
微信群	中文交流、上手帮助和版本动态
GitHub Issues	已确认的 Bug 和可执行的功能建议

参与前请阅读社区指南和行为准则。安全漏洞请通过 GitHub Security Advisories 私下提交，不要发布到公开讨论区或交流群。

---

常见问题

xopc 是云服务吗？ — xopc 应用运行在你的机器上，配置与状态默认保存在 ~/.xopc/。它可以保持独立运行，也可以显式连接 XOPC Cloud 或企业自己的平台；连接不会自动迁移本地数据库。

“本地优先”是否意味着数据绝不会离开电脑？ — 不一定。如果选择云端模型，与当前请求相关的对话和上下文会发送给对应模型服务商；需要完全留在本机的工作，请使用本地模型并检查数据源和工具权限。

xopc 会自动记住关于我的一切吗？ — 不会。用户理解可以被查看、确认、纠正和删除；未经确认的推断不应该被当作权威事实。密码、密钥和其他高度敏感信息不应交给记忆系统。

必须使用付费云端模型吗？ — 不必须。自带 API Key 或用本地模型（Ollama、LM Studio、vLLM）。

最快怎么试用？ — 桌面端 适合 GUI 用户，终端用户执行 xopc onboard --quick && xopc。

它和普通聊天 UI 有什么区别？ — 聊天只是入口。xopc 会把对你的理解、长期目标、项目、Task、决定和执行记录保留下来，让同一个助手可以跨越时间和入口继续工作。

能在手机或即时通讯里用吗？ — 可以。用 移动端 App 扫码连接，或配置 Telegram、微信、飞书/Lark。

还有问题？ — 去 GitHub Discussions 提问。

---

安全

xopc 会接触个人上下文，也可能获得执行工具，因此能力边界与模型选择同样重要：

• 只启用当前需要的数据源、工具和频道；
• 使用云端模型前，确认可以发送给服务商的上下文范围；
• 来自即时通讯的消息一律视为不可信输入，私聊建议使用 pairing（配对） 或 allowlist（白名单）；
• 保持 gateway 监听地址、访问 token 和 API Key 私密；
• 对发送、删除、购买以及其他高影响动作保留人工确认。

详见用户理解与隐私、频道安全和配置参考。

---

参与贡献

pnpm install && pnpm run dev
pnpm run dev:gateway            # 开发 gateway 使用 ~/.xopc-dev + info 日志
pnpm run build && pnpm run test:all && pnpm run lint

AGENTS.md · CONTRIBUTING.md（英文）

反馈： Bug 反馈 · 功能建议 · Q&A 讨论 · 安全漏洞反馈（请勿公开发布漏洞细节）

技术栈： TypeScript、Node.js ≥ 26.12.1、pnpm workspace。内置 LLM 层 @earendil-works/pi-ai，React 网关控制台，Electron 桌面端。

致谢

• 大模型接入：@earendil-works/pi-ai · 运行时：@earendil-works/pi-agent-core
• 用户理解：受 OpenWiki 从证据沉淀知识的思想启发，在 XOPC 中重新实现为带治理合成和逐轮上下文规划的原生能力，详见用户理解
• 灵感来自 openclaw/openclaw 与 NousResearch/hermes-agent

---

_{由 xopcai 维护 · xopc.ai}

Code signing policy（代码签名政策）

Windows 签名申请状态、拟定职责和桌面隐私说明见代码签名政策。当前下载尚未由 SignPath 签名。