数字员工控制台 Web

数字员工控制台是面向运维和管理员的 Web 应用，技术栈为 React + Ant Design + Express + SQLite。管理动作运行时已经合并进本包，服务端通过 managementClient 在进程内执行 OpenClaw 管理能力，不再依赖独立管理进程或 MQTT 转发客户端。

能力

• 管理员登录、改密、用户和数字员工平台用户目录管理
• 数字员工模板管理
• 全局 Skill 管理
• LLM Provider / Model 管理
• 数字员工创建、编辑、启停、删除、授权、Token 限额和工作区下载
• 业务系统管理、连通性测试、调用日志和统计
• 面向 CUI 与 aios-apps-invoke-cli serve 的内部/外部 API；invoke CLI client 不直接访问这些 API
• 本地 SQLite 缓存目录、状态、日志、统计和 Token 用量
• 启动同步、定时同步和手动同步共用同一套同步计划

列表、状态和统计统一从 SQLite 读取。远端目录通过 catalog.snapshot 同步刷新，Token 用量通过 agent.usage.list 刷新；版本信息启动时通过 version.list 拉取并缓存到 component_versions。

目录结构

server/src/
  api/            HTTP 路由和中间件
  background/     后台同步与启动协调
  config/         环境变量加载
  db/             SQLite 初始化和表结构
  infra/          S3 / provider 适配
  management/     进程内 management action client
  services/       业务服务
  utils/          通用工具

server/management-src/
  capabilities/   OpenClaw 管理动作实现

src/
  app/            前端入口和 API 客户端
  components/     布局组件
  pages/          页面模块
  utils/          格式化工具

启动

npm install
npm run start

前端开发：

npm run dev

构建：

npm run build

测试：

npm test
npm run test:fast
npm run test:full

test:fast 和 test:full 默认假定真实服务运行在 http://127.0.0.1:3030，并能访问 AIOS 容器派生的内置 MQTT / MinIO 环境。

默认账号

• 用户名：aios
• 初始密码：123456

首次使用默认密码登录后，系统会要求管理员修改密码。

工作区下载

浏览器请求 GET /api/agents/:slug/workspace.zip 后，服务端通过进程内 management action runtime 执行 agent.workspace.export，把 zip 写入 AIOS_S3_ADMIN_OUTBOX_BUCKET，再从 S3 读取该对象并以附件形式返回浏览器。

同步计划

启动后后台流程为：

1. 等待 service.ping 可用。
2. 执行 version.list 并写入 component_versions。
3. 执行 catalog.snapshot。
4. 如果目录快照同步成功，60 秒后执行第一次 agent.usage.list。
5. 每次 catalog.snapshot 完成后 120 秒再次执行。
6. 每次 agent.usage.list 完成后 120 秒再次执行。

设置页“同步数据”按钮会先执行 catalog.snapshot，再执行 agent.usage.list。同步过程显示蒙层，完成后用 toast 提示结果。

对外 API

面向 invoke CLI service：

• GET /api/external/cookie?sessionId=...&provider=...
• POST /api/external/invoke/logging

面向 CUI：

• GET /api/external/agents?userName=zhangsan
• GET /api/external/session?userName=zhangsan&agentId=finance-agent
• GET /api/external/context?sessionId=...

内部 API：

• GET /api/internal/app-invoke/system?provider=...&applicationName=...
• GET /api/internal/app-invoke/base-url?applicationName=...
• POST /api/internal/app-invoke/logs
• GET /api/internal/cui/agents

localhost 请求会跳过鉴权；非本地请求需要配置好的 Bearer Token 或管理端登录 Token。

AIOS Docker 容器中 aios-apps-invoke-cli serve 以 aios-svc 身份常驻运行，通过这些 API 解析业务系统配置、外部 cookie 和调用日志。OpenClaw/agent 侧只执行 CLI client，并通过本地 socket 把请求交给 service。