# openocta
**Repository Path**: jprice/openocta
## Basic Information
- **Project Name**: openocta
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-14
- **Last Updated**: 2026-03-14
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
OpenOcta 八爪鱼 —— 开源企业级智能体，专为运维而生
> English version: see `README.en.md`.
> 英文说明请查看 `README.en.md`。
OpenOcta 基于 [OpenClaw](https://github.com/openocta/openocta) 的 Gateway 协议和 Control UI，重写为 **单一 Go 二进制后端 + 内嵌前端**，面向无桌面服务器环境下的运维、可观测与自动化场景。
---
## 项目简介
- **定位**：在企业内部充当「可观测 & 运维智能中枢」，统一接入监控、日志、配置、CMDB、工单等数据源，通过 Agent 帮助排障、分析与决策。
- **形态**：一个包含 Gateway、Agent、Channels、Cron、前端静态资源的单一二进制，可通过 CLI、HTTP/WebSocket、Webhook 等方式对接外部系统。
- **协议兼容**：兼容 OpenClaw Gateway WebSocket 协议与官方 Control UI 行为，便于从原有 OpenClaw 迁移或并存。
---
## 交流与反馈
- **讨论与使用经验分享**：欢迎加入八爪鱼讨论群，交流部署实践、运维场景与最佳实践。
- **问题反馈与需求建议**：可以在群内提问或反馈使用问题，也欢迎在 Git 仓库中提交 Issue / PR。
扫码加入 OpenOcta 讨论群，获取最新动态与问题支持
---
## 快速开始
### 环境要求
- **Go 1.24+**（用于构建后端）
- **Node ≥18**（仅构建时用于编译前端，生产环境无需 Node）
- 环境变量 **`ANTHROPIC_API_KEY`**（使用 `agent` 命令时需要）
### 构建与启动 Gateway
```bash
# 构建（推荐使用 Makefile）
make build
# 或使用脚本
./build.sh build # 支持: ui | embed | go | build | clean | snapshot | release | docker
# 启动 Gateway
make run
# 或
./openocta gateway run
```
Gateway 默认监听 `http://127.0.0.1:18900`，HTTP 与 WebSocket 共用同一端口，**前端已通过 go:embed 内嵌在二进制中**，直接通过浏览器访问即可使用 Control UI。
### 开发模式（前端热更新）
```bash
# 终端 1：运行 Gateway（需要先构建一次）
./openocta gateway run
# 终端 2：运行前端 Dev Server（端口 5173）
make run-ui
```
浏览器访问 `http://localhost:5173` 即可调试前端。
### 使用 Agent CLI
```bash
export ANTHROPIC_API_KEY=your-key
./openocta agent -m "Hello, echo test"
```
### 配置文件
首次运行且配置文件不存在时，会自动从嵌入的 `openocta.json.example` 初始化并写入配置目录：
| 平台 | 默认配置目录 |
|---------------|------------------------------------|
| Linux / macOS | `~/.openocta/openocta.json` |
| Windows | `%APPDATA%\openocta\openocta.json` |
---
## 文档与参考
### 文档语言映射
- **中文文档**
- 根文档：`README.md`（本文件）
- 后端：`src/README.md`
- 前端：`ui/README.md`
- **English Docs**
- Root: `README.en.md`
### 主要文档
- **后端总览**：`src/README.md`
模块说明、迁移状态与后端相关文档索引。
- **前端说明**：`ui/README.md`
Control UI 功能介绍、开发脚本与目录结构。
- **配置与能力**（位于 `src/docs/`）：
- `configuration.md` — 配置总览：agents、channels、gateway、cron、hooks、memory 等。
- `mcp-configuration.md` — MCP 服务器声明与权限、超时配置。
- `trace-and-observability.md` — Trace、token 使用采集与链路记录。
- `webhooks.md` — `/hooks/wake`、`/hooks/agent`、`/hooks/alert` 的请求/响应结构与适用场景。
- `architecture.md` — 基于 agentsdk-go 的分层设计与扩展点。
- `skills.md`、`tools.md`、`tools-builtin.md`、`tools-openocta.md` — 技能与工具系统的整体说明。
上游参考：
- [OpenClaw 官方仓库](https://github.com/openocta/openocta)
- [docs.openclaw.ai](https://docs.openclaw.ai)（包含 Gateway 协议、配置等官方文档）
---
## 项目结构
```text
OpenOcta/
├── src/ # Go 后端（Gateway、Agent、Channels、Cron 等）
│ ├── cmd/openocta/ # CLI 入口与子命令
│ ├── embed/ # 嵌入资源（前端、config-schema、openocta.json.example）
│ │ └── frontend/ # 前端构建产物（由 build 生成）
│ ├── pkg/ # 核心模块
│ └── README.md # 后端详细说明
├── ui/ # Control UI 前端（Lit + Vite，WebSocket 控制面）
│ └── README.md # 前端详细说明
├── deploy/ # 部署相关（Dockerfile、systemd 服务）
└── docs/ # 文档与迁移计划
```
- **后端**：Go 1.24+，提供 Gateway HTTP + WebSocket、Agent、Channels、Cron、Config 等能力。
- **前端**：Control UI 通过 **go:embed** 嵌入单一二进制，生产环境无需单独部署前端。
- **单一二进制**：构建后的 `openocta` 已包含前端与配置模板，可直接分发运行。
---
## 版权声明
本仓库遵循 **GPLv3** 开源限制。
你可以基于 OpenOcta 的源代码进行二次开发，但是需要遵守以下规定：
- 不能替换和修改 OpenOcta 的 Logo 和版权信息；
- 二次开发后的衍生作品必须遵守 GPLv3 的开源义务。
如需商业授权，请联系：**chengyun@databuff.com**。