Skip to content

You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert

{{ message }}

itq5/ OpenClaw-Admin Public

• Notifications You must be signed in to change notification settings
• Fork\ 175
• Star\ 654

main

2 Branches 11 Tags

Go to Branches pageGo to Tags page

Go to file

Code

Open more actions menu

Folders and files

Repository files navigation

Claw Admin - AI 智能体管理平台

Permalink: Claw Admin - AI 智能体管理平台

现代化的 AI 智能体网关管理控制台

GitHub • 功能特性 • 技术栈 • 快速开始 • Hermes Agent 集成 • 项目结构 • 开发指南 • English

项目简介

Permalink: 项目简介

Claw Admin 是一个基于 Vue 3 构建的现代化 AI 智能体管理平台，同时支持 OpenClaw Gateway 和 Hermes Agent 两大 AI 智能体网关。通过直观的可视化操作，用户可以轻松管理 AI 智能体、会话、模型、频道、技能等核心功能，并提供完整的 Web CLI 终端体验。

版本兼容性

Permalink: 版本兼容性

核心亮点

Permalink: 核心亮点

• 🎯 双网关支持：同时支持 OpenClaw Gateway 和 Hermes Agent，一套平台管理两种智能体
• 🖥️ Web CLI 终端：基于 xterm.js 的真实 CLI 终端，支持会话持久化、断线重连、启动参数配置
• 🤖 多智能体协作：支持创建和管理多个 AI 智能体，实现复杂任务协作
• 📊 实时监控：提供系统资源、会话状态、Token 使用量等实时监控
• 🌍 国际化支持：内置中英文双语支持，无缝切换
• 🎨 现代 UI：基于 Naive UI 的响应式设计，支持亮色/暗色主题

功能特性

Permalink: 功能特性

一、OpenClaw Gateway 模块

Permalink: 一、OpenClaw Gateway 模块

仪表盘 (Dashboard)

Permalink: 仪表盘 (Dashboard)

• 运行总览与关键指标展示
• Token 使用趋势图表
• 会话活跃度统计
• 实时事件流监控
• Top 模型/渠道/工具分布

在线对话 (Chat)

Permalink: 在线对话 (Chat)

• 实时聊天交互界面
• 支持斜杠命令 (/new, /skill, /model, /status, /subagents)
• 消息筛选与搜索
• 常用语快捷回复
• Token 使用量实时统计

会话管理 (Sessions)

Permalink: 会话管理 (Sessions)

• 会话列表与详情查看
• 会话创建、重置、删除
• 多维度筛选与排序
• 消息记录导出

记忆管理 (Memory)

Permalink: 记忆管理 (Memory)

• 智能体文档管理
• 支持编辑 AGENTS、SOUL、IDENTITY、USER 等核心文档
• Markdown 编辑器
• 模板片段快速插入

任务计划 (Cron)

Permalink: 任务计划 (Cron)

• 定时任务创建与管理
• 支持 Cron 表达式、固定间隔、指定时间
• 任务执行历史查看
• 快捷模板（晨报、健康巡检等）

模型管理 (Models)

Permalink: 模型管理 (Models)

• 多模型渠道配置
• API Key 安全管理（脱敏显示）
• 模型探测功能
• 默认模型设置
• Coding 套餐快捷配置

频道管理 (Channels)

Permalink: 频道管理 (Channels)

• QQ、飞书、钉钉、企业微信渠道配置
• 渠道状态监控
• 凭证安全管理
• 一键安装与配置

技能管理 (Skills)

Permalink: 技能管理 (Skills)

• 技能插件列表
• 内置/用户技能分类
• 技能安装与更新
• Chat 可见性控制

多智能体 (Agents)

Permalink: 多智能体 (Agents)

• 智能体创建与管理
• 身份、模型、工具权限配置
• 会话统计与 Token 用量
• 工作区文件管理

智能体工坊 (Office)

Permalink: 智能体工坊 (Office)

• 多智能体协作空间
• 场景创建向导
• 任务委派与执行
• 智能体间通信
• 团队管理

虚拟公司 (MyWorld)

Permalink: 虚拟公司 (MyWorld)

• 可视化办公场景
• 角色移动与交互
• 区域互动功能
• 实时通信

远程终端 (Terminal)

Permalink: 远程终端 (Terminal)

• SSE 协议远程终端
• 多节点支持
• 全屏模式
• 自定义 Shell 和工作目录

远程桌面 (Remote Desktop)

Permalink: 远程桌面 (Remote Desktop)

• Linux/Windows 远程桌面
• 实时画面传输
• 鼠标键盘操作
• 剪贴板同步

文件浏览器 (Files)

Permalink: 文件浏览器 (Files)

• 工作区文件浏览
• 文件编辑与预览
• 文件上传下载
• 目录管理

系统监控 (System)

Permalink: 系统监控 (System)

• CPU、内存、磁盘使用率
• 网络连接状态
• 实例在线状态
• 运行时间统计

系统设置 (Settings)

Permalink: 系统设置 (Settings)

• 连接配置管理
• 外观主题设置
• 环境变量配置

二、Hermes Agent 模块

Permalink: 二、Hermes Agent 模块

Hermes 仪表盘

Permalink: Hermes 仪表盘

• 系统状态总览（版本、运行时间、活跃会话）
• Token 使用量与成本分析（按日/按模型统计）
• 网关平台状态

Hermes 在线对话

Permalink: Hermes 在线对话

• 基于 OpenAI 兼容 API 的实时聊天（SSE 流式）
• 支持 17+ 斜杠命令（/new, /model, /skills, /commands, /help 等）
• 命令面板自动补全（输入 / 触发，Tab 补全，方向键选择）
• Tool Calls 可视化展示
• Markdown 渲染 + 代码高亮 + LaTeX 公式
• Token 用量实时统计

Hermes 会话管理

Permalink: Hermes 会话管理

• 会话列表（分页、搜索）
• 会话消息记录查看
• 全文搜索（FTS5）
• 会话删除

Hermes 模型管理

Permalink: Hermes 模型管理

• 模型列表（OpenAI 兼容格式）
• 当前模型切换
• 模型能力标签（vision、function_calling 等）

Hermes 频道管理

Permalink: Hermes 频道管理

• 消息平台配置（Telegram、Discord、Slack 等）
• 平台状态监控
• OAuth 认证管理

Hermes 技能管理

Permalink: Hermes 技能管理

• 技能列表（启用/禁用切换）
• 技能分类与版本信息
• 技能描述与状态

Hermes 任务计划

Permalink: Hermes 任务计划

• 定时任务 CRUD
• 任务暂停/恢复/手动触发
• Cron 表达式配置

Hermes 记忆管理

Permalink: Hermes 记忆管理

• SOUL.md 人格配置编辑
• AGENTS.md 智能体指令编辑
• Markdown 编辑器 + 模板片段

Hermes 系统管理

Permalink: Hermes 系统管理

• 配置管理（结构化表单 + 原始 YAML 编辑）
• 环境变量管理（脱敏显示、明文查看）
• 日志查看（按级别/组件/关键词过滤）
• 工具集列表

Hermes CLI 终端 🔥

Permalink: Hermes CLI 终端 🔥

• 真实 CLI 体验：通过 node-pty 启动 Hermes CLI 进程，完整的终端仿真
• 会话持久化：断开浏览器不中断 CLI 进程，支持断线重连 + 输出缓冲区回放
• 启动参数面板：可视化配置 CLI 参数（model、provider、skills、toolsets、yolo 等）
• 多会话管理：创建多个 CLI 会话，支持重连、分离、重命名、销毁
• 全功能 CLI：支持所有 CLI 专用命令（/skills、/tools、/cron、/config、/browser 等）
• 无 WebSocket：纯 SSE + HTTP POST 双通道，兼容严格网络策略
• 终端功能：全屏模式、右键粘贴、选中复制、自适应大小

技术栈

Permalink: 技术栈

前端框架

Permalink: 前端框架

UI 组件库

Permalink: UI 组件库

通信与数据

Permalink: 通信与数据

后端服务

Permalink: 后端服务

终端相关

Permalink: 终端相关

快速开始

Permalink: 快速开始

环境要求

Permalink: 环境要求

• Node.js >= 18.0.0
• npm >= 9.0.0
• Python >= 3.10（仅 Hermes CLI 终端需要）
• 必须部署在网关所在的节点上，.env填写地址时仅支持127.0.0.1或localhost

安装依赖

Permalink: 安装依赖

npm install

初始化环境变量

Permalink: 初始化环境变量

cp .env.example .env

开发模式

Permalink: 开发模式

启动前端开发服务器：

npm run dev

启动后端服务：

npm run dev:server

同时启动前后端：

npm run dev:all

访问 http://localhost:3001 进入管理界面。

生产构建

Permalink: 生产构建

npm run build

生产启动

Permalink: 生产启动

npm run start

Hermes Agent 集成

Permalink: Hermes Agent 集成

前置条件

Permalink: 前置条件

Hermes Agent 需要单独安装和配置。OpenClaw Admin 通过 HTTP API 与 Hermes Agent 通信，需要以下服务运行：

安装 Hermes Agent

Permalink: 安装 Hermes Agent

# 官方一键安装脚本
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 运行交互式配置向导
hermes setup

配置 Hermes Agent

Permalink: 配置 Hermes Agent

1. 设置 AI 模型 Provider

Permalink: 1. 设置 AI 模型 Provider

Hermes Agent 支持多种 AI 供应商。选择一种进行配置：

方式一：通过配置向导（推荐）

hermes setup model

方式二：通过环境变量

编辑 ~/.hermes/.env 文件：

# OpenRouter（默认）
OPENROUTER_API_KEY=sk-or-v1-xxxxx

# 或使用 Anthropic
ANTHROPIC_API_KEY=sk-ant-xxxxx

# 或使用 OpenAI
OPENAI_API_KEY=sk-xxxxx

# 或使用自定义 Provider（如本地部署的模型）
CUSTOM_API_KEY=your-api-key
CUSTOM_BASE_URL=http://your-server:port/v1

2. 设置模型

Permalink: 2. 设置模型

# 交互式选择
hermes model

# 或通过配置文件设置
# 编辑 ~/.hermes/config.yaml
# model: anthropic/claude-sonnet-4

3. 设置API

Permalink: 3. 设置API

vim  ./.hermes/.env
API_SERVER_ENABLED=true
GATEWAY_ALLOW_ALL_USERS=true
API_SERVER_KEY=1212

4. 启动 Hermes Gateway

Permalink: 4. 启动 Hermes Gateway

# 安装
hermes gateway install

# 前台运行（调试用）
hermes gateway run -v

# 后台运行（生产用）
hermes gateway start

# 查看状态
hermes gateway status

# Web UI API服务启动
hermes dashboard

5. 验证连接

Permalink: 5. 验证连接

# 检查 API Server
curl http://localhost:8642/v1/health

# 检查 Web UI
curl http://localhost:9119/api/status

在 OpenClaw Admin 中连接 Hermes

Permalink: 在 OpenClaw Admin 中连接 Hermes

1. 登录 OpenClaw Admin
2. 进入 设置 页面
3. 在 Hermes Agent 区域配置：

• Web UI 地址：http://localhost:9119（默认）
  • API Server 地址：http://localhost:8642（默认）
  • API Key：如果配置了 API_SERVER_KEY 则填写

4. 点击 测试连接 验证
5. 保存配置后，侧边栏将显示 Hermes 模块入口

环境变量

Permalink: 环境变量

在 .env 文件中配置 Hermes 相关参数：

# === Hermes Agent 配置 ===
HERMES_WEB_URL=http://localhost:9119    # Hermes Web UI 地址
HERMES_API_URL=http://localhost:8642    # Hermes API Server 地址
HERMES_API_KEY=1212                     # Hermes API 密钥（可选）
HERMES_CLI_PATH=/path/to/hermes         # Hermes CLI 路径（可选，默认自动检测）

CLI 终端使用

Permalink: CLI 终端使用

Hermes CLI 终端支持以下启动参数：

在 Web 界面中，展开 启动配置 面板即可可视化配置这些参数。

项目结构

Permalink: 项目结构

openclaw-admin/
├── src/
│   ├── api/                        # API 层
│   │   ├── hermes/                 # Hermes API 客户端
│   │   │   └── client.ts           # HermesApiClient 类
│   │   ├── types/                  # TypeScript 类型定义
│   │   ├── connect.ts              # 连接管理
│   │   ├── rpc-client.ts           # RPC 客户端
│   │   └── websocket.ts            # WebSocket 封装
│   │
│   ├── assets/                     # 静态资源
│   │   └── styles/
│   │       └── main.css            # 全局样式
│   │
│   ├── components/                 # 组件
│   │   ├── common/                 # 通用组件
│   │   ├── layout/                 # 布局组件
│   │   └── office/                 # 办公场景组件
│   │
│   ├── composables/                # 组合式函数
│   │   ├── useEventStream.ts       # 事件流
│   │   ├── useResizable.ts         # 尺寸调整
│   │   └── useTheme.ts             # 主题管理
│   │
│   ├── i18n/                       # 国际化
│   │   ├── messages/
│   │   │   ├── zh-CN.ts            # 中文
│   │   │   └── en-US.ts            # 英文
│   │   └── index.ts
│   │
│   ├── layouts/                    # 布局
│   │   └── DefaultLayout.vue
│   │
│   ├── router/                     # 路由
│   │   ├── index.ts
│   │   └── routes.ts
│   │
│   ├── stores/                     # Pinia 状态管理
│   │   ├── hermes/                 # Hermes 状态管理
│   │   │   ├── connection.ts       # 连接管理
│   │   │   ├── config.ts           # 配置管理
│   │   │   ├── chat.ts             # 聊天
│   │   │   ├── session.ts          # 会话管理
│   │   │   ├── model.ts            # 模型管理
│   │   │   ├── channel.ts          # 频道管理
│   │   │   ├── skill.ts            # 技能管理
│   │   │   ├── cron.ts             # 定时任务
│   │   │   └── memory.ts           # 记忆管理
│   │   ├── hermes-cli.ts           # Hermes CLI 终端
│   │   ├── agent.ts                # 智能体
│   │   ├── auth.ts                 # 认证
│   │   ├── channel.ts              # 频道
│   │   ├── chat.ts                 # 聊天
│   │   ├── config.ts               # 配置
│   │   ├── cron.ts                 # 定时任务
│   │   ├── memory.ts               # 记忆
│   │   ├── model.ts                # 模型
│   │   ├── session.ts              # 会话
│   │   ├── skill.ts                # 技能
│   │   ├── terminal.ts             # 终端
│   │   ├── theme.ts                # 主题
│   │   └── websocket.ts            # WebSocket
│   │
│   ├── utils/                      # 工具函数
│   │   ├── channel-config.ts
│   │   ├── format.ts
│   │   ├── markdown.ts
│   │   └── secret-mask.ts
│   │
│   ├── views/                      # 页面视图
│   │   ├── hermes/                 # Hermes 模块页面
│   │   │   ├── HermesDashboard.vue # 仪表盘
│   │   │   ├── HermesChatPage.vue  # 在线对话
│   │   │   ├── HermesSessionsPage.vue  # 会话管理
│   │   │   ├── HermesModelsPage.vue    # 模型管理
│   │   │   ├── HermesChannelsPage.vue  # 频道管理
│   │   │   ├── HermesSkillsPage.vue    # 技能管理
│   │   │   ├── HermesCronPage.vue      # 任务计划
│   │   │   ├── HermesMemoryPage.vue    # 记忆管理
│   │   │   ├── HermesSystemPage.vue    # 系统管理
│   │   │   └── HermesCliPage.vue       # CLI 终端
│   │   ├── agents/                 # 多智能体
│   │   ├── channels/               # 频道管理
│   │   ├── chat/                   # 在线对话
│   │   ├── cron/                   # 任务计划
│   │   ├── memory/                 # 记忆管理
│   │   ├── models/                 # 模型管理
│   │   ├── sessions/               # 会话管理
│   │   ├── skills/                 # 技能管理
│   │   ├── system/                 # 系统监控
│   │   ├── terminal/               # 远程终端
│   │   ├── remote-desktop/         # 远程桌面
│   │   ├── files/                  # 文件浏览
│   │   ├── office/                 # 智能体工坊
│   │   ├── myworld/                # 虚拟公司
│   │   ├── monitor/                # 运维中心
│   │   ├── settings/               # 系统设置
│   │   ├── Dashboard.vue           # 仪表盘
│   │   └── Login.vue               # 登录页
│   │
│   ├── App.vue                     # 根组件
│   ├── main.ts                     # 入口文件
│   └── env.d.ts                    # 环境类型声明
│
├── server/                         # 后端服务
│   ├── index.js                    # 服务入口（含 Hermes CLI 代理）
│   ├── hermes-proxy.js             # Hermes API 代理
│   ├── gateway.js                  # Gateway 连接
│   └── database.js                 # 数据库操作
│
├── public/                         # 公共静态资源
├── dist/                           # 构建输出
├── data/                           # 数据存储
│
├── vite.config.ts                  # Vite 配置
├── tsconfig.json                   # TypeScript 配置
├── package.json                    # 项目配置
├── .env.example                    # 环境变量示例
└── .env                            # 本地环境变量（由 .env.example 复制）

开发指南

Permalink: 开发指南

代码风格

Permalink: 代码风格

• 使用 Vue 3 Composition API + <script setup lang="ts">
• 遵循 2 空格缩进、单引号、尾随逗号、无分号
• 使用 @/ 别名导入 src 路径

命名约定

Permalink: 命名约定

构建验证

Permalink: 构建验证

提交前请确保：

npm run build

构建通过，无类型错误。

环境变量

Permalink: 环境变量

先复制示例文件，再按本地环境填写：

cp .env.example .env

然后在 .env 文件中配置：

# === 应用配置 ===
VITE_APP_TITLE=OpenClaw Admin
PORT=3000
DEV_PORT=3001

# === 认证配置 ===
AUTH_USERNAME=admin
AUTH_PASSWORD=admin

# === OpenClaw Gateway 配置 ===
OPENCLAW_WS_URL=ws://localhost:18789
OPENCLAW_AUTH_TOKEN=1212
OPENCLAW_AUTH_PASSWORD=        # Gateway 密码，与 Token 二选一即可

# === Hermes Agent 配置 ===
HERMES_WEB_URL=http://localhost:9119
HERMES_API_URL=http://localhost:8642
HERMES_API_KEY=1212
HERMES_CLI_PATH=               # Hermes CLI 路径（可选，默认自动检测）

# === 其他 ===
LOG_LEVEL=INFO
MEDIA_DIR=

启动环境

## 正式环境
npm run start
## 开发环境
npm run dev:all

API 参考

Permalink: API 参考

OpenClaw WebSocket RPC 方法

Permalink: OpenClaw WebSocket RPC 方法

项目通过 WebSocket 与 OpenClaw Gateway 通信，支持以下 RPC 方法：

配置管理

Permalink: 配置管理

• config.get - 获取配置
• config.patch - 更新配置
• config.set - 设置配置
• config.apply - 应用配置

会话管理

Permalink: 会话管理

• sessions.list - 列出会话
• sessions.get - 获取会话详情
• sessions.reset - 重置会话
• sessions.delete - 删除会话
• sessions.spawn - 创建会话
• sessions.history - 获取历史记录
• sessions.usage - 获取用量统计

频道管理

Permalink: 频道管理

• channels.status - 获取频道状态
• channel.auth - 频道认证
• channel.pair - 频道配对

智能体管理

Permalink: 智能体管理

• agents.list - 列出智能体
• agents.create - 创建智能体
• agents.update - 更新智能体
• agents.delete - 删除智能体
• agents.files.list - 列出文件
• agents.files.get - 获取文件
• agents.files.set - 设置文件

模型管理

Permalink: 模型管理

• models.list - 列出模型

定时任务

Permalink: 定时任务

• cron.list - 列出任务
• cron.add - 添加任务
• cron.update - 更新任务
• cron.delete - 删除任务
• cron.run - 执行任务

系统监控

Permalink: 系统监控

• health - 健康检查
• status - 状态查询
• system-presence - 实例状态
• logs.tail - 日志查看

Hermes REST API 代理

Permalink: Hermes REST API 代理

后端通过 hermes-proxy.js 代理到 Hermes Agent 的两个服务：

Hermes CLI 终端 API

Permalink: Hermes CLI 终端 API

安全说明

Permalink: 安全说明

• ⚠️ 禁止提交 真实 Gateway Token、API Key 或其他敏感信息
• 凭证字段采用掩码显示，不回显明文
• API Key 仅在输入新值时提交，未输入则保持原值
• Hermes CLI 会话有 2 小时孤儿超时自动回收

许可证

Permalink: 许可证

MIT License

贡献指南

Permalink: 贡献指南

欢迎提交 Issue 和 Pull Request！

GitHub 仓库: https://github.com/itq5/OpenClaw-Admin

1. Fork 本仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'feat: add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 创建 Pull Request

联系方式

Permalink: 联系方式

作者邮箱

Permalink: 作者邮箱

📧 root@itq5.com

微信交流群

Permalink: 微信交流群

欢迎加入微信交流群，获取最新动态和技术支持：

Made with ❤️ by Claw Admin Team

About

Claw-Admin 是一个基于 Vue 3 构建的现代化 AI 智能体管理平台，同时支持 OpenClaw Gateway 和 Hermes Agent 两大 AI 智能体网关提供完整的 Web 管理界面。通过直观的可视化操作，用户可以轻松管理 AI 智能体、会话、模型、频道、技能等核心功能。

claw.227727.xyz

Topics

[ui](/content/topics/ui "Topic: ui"/index.html) [web](/content/topics/web "Topic: web"/index.html) [dashboard](/content/topics/dashboard "Topic: dashboard"/index.html) [hermes](/content/topics/hermes "Topic: hermes"/index.html) [openclaw](/content/topics/openclaw "Topic: openclaw"/index.html) [hermes-agent](/content/topics/hermes-agent "Topic: hermes-agent"/index.html)

Resources

Readme

License

MIT license

Contributing

Contributing

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

654\ stars

Watchers

6\ watching

Forks

175\ forks

Report repository

Releases\ 11

v1.0.2 添加TTS语音合成功能及界面优化\ Latest\ \ 4 days agoApr 26, 2026

+ 10 releases

Packages\ 0

No packages published

Contributors\ 5

-

-

- -

Languages

• Vue65.5%
• TypeScript27.8%
• JavaScript6.5%
• Other0.2%

You can’t perform that action at this time.