Skip to content
View openocta's full-sized avatar

Block or report openocta

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
openocta/README.md

GitHub stars GitHub forks Latest release Go 1.24+

OpenOcta 八爪鱼中国首个开源个人桌面级智能体

官网 · English

双击安装 · 本机运行 · 毫秒启动 · 数据留在本机

OpenOcta 八爪鱼 是中国首个开源的个人桌面级 AI 智能体,国产开源智能体,开源工作伙伴。电脑端双击安装,一个运行在你自己电脑上、由你完全掌控的 Agent,用自然语言即可实现电脑办公、IT运维、推广运营、经营分析、软件测试。

最新版本 v1.0.5(2026-07-02)— 全平台安装包 · 修复工具调用历史消息异常 · 单一 Go 二进制内嵌 Control UI

查看全部 Release →


✨ 关键特性

🖥️ 个人桌面级:为个人电脑设计,连接文件、终端、浏览器与本地项目 — 不止于聊天窗口。

⚡️ 双击即用:约 30 秒完成安装,完整 Control UI 开箱即用 — 无需 CLI 数小时部署。

🪶 极致轻量:安装包约 30MB 级,运行时内存占用低 — 适合 7×24 长期驻留。

🔒 本地优先:会话与记忆留在本机,数据可控、可内网部署 — 生产运行无需 Node / Python。

🔧 Go 完全自研:Gateway、Agent、Channels 均为 Go 原生实现 — 单一二进制内嵌 Control UI。

🔌 Skills & MCP:内置工具 + MCP 协议 + 技能市场 — 按需扩展数字员工能力。

💬 IM 远程指挥:支持微信、企业微信、钉钉、飞书 — 随时随地下达任务。

🧠 四级记忆 + L4 进化:Knowledge Vault 本地知识库自主沉淀偏好 — 越用越懂你(说明)。

国产开源:国内团队维护,100% 开源( Apache-2.0)— 中国首个开源个人桌面级智能体。


开源智能体对比

OpenOcta 面向个人桌面:双击安装、完整客户端 UI、本土 IM 与国产模型生态。相对 OpenClaw(Node / Gateway 自托管)与 Hermes(Python / CLI 导向),OpenOcta 以 Go 单一二进制实现运行时完全自研,并内置 L4 自主进化Knowledge Vault 本地知识库

OpenOcta OpenClaw Hermes
开源协议 Apache2.0 MIT MIT
上手方式 双击安装 CLI 部署 CLI 部署
运行时 Go 自研 · 单二进制 Node.js Python
本土化 微信 / 钉钉 / 飞书 + 国产模型 海外 IM / 模型 海外 IM / 模型
记忆进化 四级记忆 + L4 Evolution 工作区 Markdown Skill 自生成
本地知识库 Knowledge Vault
安装时间 约 30 秒 通常需数小时配置 通常需数小时配置

完整对比表、Go 工程优势与选型说明docs/compare-openclaw-hermes.md


功能一览

直观感受 OpenOcta 桌面客户端的主要界面:

智能体对话界面
智能体对话 · 多轮协作、工具调用与任务执行,自然语言驱动 Agent 完成复杂工作
员工市场界面
员工市场 · 一键安装 Zabbix、Prometheus、MySQL DBA 等数字员工
技能库界面
技能库 · 766+ Skills,DevOps / 数据库 / 开发工具分类浏览与启用
知识库界面
知识库 · Obsidian 兼容笔记,同步索引供 Agent 语义检索
模型配置界面
模型 · 支持公有模型、本地模型的接入
教程中心界面
教程 · 视频 / 文档课程,Windows / Mac / Linux 快速上手与运维实战

客户端还提供 工具库、定时任务、IM 通道 等模块;更多能力可在 openocta.com 下载体验。


典型场景

电脑办公 — 用 AI 接管重复性办公任务,释放创造力。
例:「整理本周邮件要点并生成周报」

IT 运维 — 7×24 智能值守,从救火转向预防。
例:「分析这条告警日志并给出处置建议」

推广运营 — 快速产出多渠道内容素材。
例:「根据产品资料写一版小红书文案」

知识管理 — 本地知识沉淀,随时语义检索。
例:「在我的知识库里查 XX 规范并总结」

开发协作 — 读代码、改项目、跑命令、对接工具链。
例:「读这个仓库的 README 并列出待改项」

更多案例见 openocta.com/cases使用场景文档


30秒启动

  1. 下载 — 前往 GitHub Releasesopenocta.com 下载页
  2. 安装并打开 — 双击安装桌面客户端(约 30 秒)
  3. 开始对话 — 在「消息」Tab 描述任务,Agent 将连接文件、终端与工具执行

产品演示动图(待补充截图)
产品演示 · 消息对话 → 技能库 → 知识库 → 运维 Agent(待补充)


首次配置(约 2 分钟)

安装后需接入一个大模型才能对话。任选一种方式:

方式 A — 界面配置(推荐)
打开客户端「模型」Tab,或跟随首次启动的「配置引导」,填入 API Key 并选择模型。

配置引导 · 配置模型界面

方式 B — 编辑配置文件

平台 配置文件路径
Linux / macOS ~/.openocta/openocta.json
Windows %APPDATA%\openocta\openocta.json

最小示例(Moonshot 国内端点;DeepSeek / 千问 / 豆包等见 大模型配置说明):

{
  "env": {
    "vars": {
      "MOONSHOT_API_KEY": "sk-你的密钥"
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "moonshot-cn/kimi-k2.5" }
    }
  }
}

保存后重启客户端,在「消息」中试一句:

列出当前工作目录下的文件,并告诉我最大的 3 个是什么


为什么选择 OpenOcta

个人桌面级 为个人电脑设计,连接文件、终端、浏览器与本地项目,而非仅停留在聊天窗口
运行时 Go 自研 Gateway、Agent、Channels 等核心能力均为 Go 完全自研;单一二进制即可运行,生产环境无需 Node / Python
中国首个开源 国内团队维护,100% 开源( Apache-2.0);代码可审、可改、可内网部署
IM 远程指挥 支持微信、企业微信、钉钉、飞书等通道,随时随地向 Agent 下达任务
极致轻量 安装包约 30MB 级,运行时内存占用低,适合 7×24 长期驻留
Skills & MCP 内置工具 + MCP 协议 + 技能市场,可按场景扩展数字员工能力
四级记忆 + L4 进化 Knowledge Vault 知识库与 L4 Evolution 自主沉淀偏好;与会话记忆、Skills 构成分层体系(说明

OpenOcta 在架构上借鉴 OpenClaw 的 Gateway 协议与 Control UI 体验,由国内团队使用 Go 完全自研实现。


下载安装

访问 openocta.com 下载页,选择对应平台安装包:

平台 安装包
Windows OpenOcta-amd64-installer.exe
macOS (Apple Silicon) OpenOcta-arm64.dmg
macOS (Intel) OpenOcta-amd64.dmg
Linux .deb / .rpm / .tar.gz(amd64 / arm64)

安装后打开应用即可使用 Control UI。首次运行会自动初始化配置目录:

平台 默认配置目录
Linux / macOS ~/.openocta/openocta.json
Windows %APPDATA%\openocta\openocta.json

macOS 用户请从 .dmg 拖入「应用程序」安装,详见 deploy/dist-README.md

在线资源


开发者:从源码运行

面向开发者自托管 Gateway 与 Control UI(个人用户可直接使用上方安装包,无需编译)。

环境要求

  • Go 1.24+(构建后端)
  • Node ≥18(仅构建前端时需要,生产运行无需 Node
  • 环境变量 ANTHROPIC_API_KEY(使用 agent CLI 时需要)

构建与启动

make build          # 构建(推荐)
./openocta gateway run

Gateway 默认监听 http://127.0.0.1:18900;HTTP 与 WebSocket 共用同一端口,前端通过 go:embed 内嵌在二进制中,浏览器直接访问即可使用 Control UI。

开发模式(前端热更新)

./openocta gateway run    # 终端 1
make run-ui               # 终端 2 → http://localhost:5173

Agent CLI

export ANTHROPIC_API_KEY=your-key
./openocta agent -m "Hello, echo test"

文档

中文文档

文档 说明
架构概览 Gateway、Agent 运行时、MCP、Skills 分层设计
配置说明 agents、channels、gateway、cron、hooks、memory 等
通道总览 IM / 消息通道接入
MCP 配置 MCP 服务器与权限
Skills 技能系统
工具系统 内置工具与扩展
数字员工 数字员工机制
Webhooks /hooks/wake/hooks/agent
竞品对比(OpenClaw / Hermes) 完整对比表与选型说明
后端说明 Go 模块与目录
前端说明 Control UI 开发

English

上游参考


项目结构

OpenOcta/
├── src/                    # Go 后端(Gateway、Agent、Channels、Cron 等)
├── ui/                     # Control UI(Lit + Vite)
├── deploy/                 # 安装包、Docker、systemd 等
├── docs/                   # 项目文档
└── imgs/                   # Logo、截图、社群二维码等
    ├── readmePIC/          # README 功能界面截图
    └── screenshots/        # README 演示 GIF 与界面截图

常见问题

OpenOcta 是什么? OpenOcta(openocta,八爪鱼)是中国首个开源个人桌面级智能体,采用 Apache License 2.0 开源许可。双击安装即可在本机运行,支持微信/钉钉/飞书远程指挥,源码见 github.com/openocta/openocta。

OpenOcta 属于国产开源智能体吗? 是。OpenOcta 由国内团队维护,100% 开源(Apache-2.0),Go 自研运行时,面向个人桌面场景,可内网部署、数据留在本机。

有哪些好用的开源智能体?OpenOcta 适合谁? 若你需要桌面双击安装、完整 Control UI、IM 接入的个人 Agent,OpenOcta 比 CLI 部署类框架更易上手;若偏好 Node 生态与社区规模,可参考 OpenClaw。详见上文对比表。

OpenOcta 和 OpenClaw 有什么区别? OpenOcta:Go 单二进制、桌面级、Apache-2.0、内置 Control UI;OpenClaw:Node 生态、个人网关、社区 Star 更高。二者在 Gateway 协议上可兼容,场景侧重不同。

个人用的桌面级开源智能体有吗? 有。OpenOcta 专为个人电脑设计:约 30 秒安装、本地优先、支持 MCP/Skills 扩展,适合办公自动化、运维、测试等桌面场景。


参与共建

OpenOcta 讨论群二维码(待补充截图)
扫码加入 OpenOcta 讨论群,获取最新动态与问题支持


版权与许可

本仓库遵循 ** Apache-2.0** 开源协议。

Popular repositories Loading

  1. openocta openocta Public

    Open-source work buddies. Open-source personal desktop AI agent.Go runtime for office/ITops/marketing workflows.

    TypeScript 3k 335

  2. openocta_skills openocta_skills Public

    本仓库用于汇集第三方贡献的 OpenOcta 技能(Skill)资源,便于分享、版本管理与分发。

    Python 150 44