Web 管理台

OpenClaw Web管理台提供了一个直观的图形化界面，用于监控和管理整个AI智能体平台。通过管理台，您可以实时查看Agent运行状态、浏览日志、编辑配置、管理插件，并与平台API进行集成。本章将详细介绍管理台的各项功能和使用方法。

仪表板概览

仪表板是管理台的首页，提供了平台运行状态的全局视图。当您登录管理台后，首先看到的就是这个信息密集的概览页面。

仪表板包含以下核心模块：

• 系统状态卡片：显示平台整体健康状态、运行时间、活跃Agent数量、API请求速率等关键指标
• Agent活动图：以时间轴形式展示各Agent的活动状态，包括正在执行的任务、等待中的请求和已完成的历史
• 资源使用仪表：CPU、内存、GPU利用率的实时图表，支持按时间范围筛选
• 错误率趋势：过去24小时的错误率变化曲线，帮助快速定位异常时段
• 最近告警：显示最近触发的告警事件，按严重程度排序

Agent监控

Agent监控页面提供了每个智能体的详细运行信息。您可以在此查看所有Agent的列表，并深入查看单个Agent的运行细节。

Agent监控的核心功能包括：

• Agent列表视图：以表格形式展示所有Agent，包括名称、状态、最后活跃时间、累计执行次数、成功率等
• Agent详情页：展示单个Agent的完整信息，包括配置参数、工具列表、记忆状态、执行历史和性能指标
• 实时对话追踪：对于对话型Agent，可以实时查看当前正在进行的对话轮次、上下文内容和工具调用记录
• 执行历史回放：可以回放Agent过去的执行过程，逐步查看决策链路和工具调用顺序

# 通过API获取Agent监控数据
GET /api/v1/monitor/agents
Response:
{
  "agents": [
    {
      "id": "research-bot-001",
      "name": "研究助手",
      "status": "running",
      "uptime": "2h 35m",
      "tasks_completed": 47,
      "success_rate": 0.96,
      "avg_latency_ms": 1230,
      "active_sessions": 3,
      "memory_usage": {
        "short_term": 45,
        "long_term_entries": 1280
      }
    }
  ],
  "total": 5,
  "running": 3,
  "idle": 2
}

日志查看器

日志查看器是管理台中最强大的调试工具之一。它提供了结构化的日志浏览体验，支持实时流式查看和历史日志搜索。

日志查看器支持以下功能：

• 实时日志流：通过WebSocket连接实时接收日志事件，无需手动刷新
• 高级过滤：按日志级别、模块、Agent、时间范围、关键字等多维度过滤
• 上下文关联：点击任意日志条目，可以查看该请求的完整调用链路，包括Agent决策过程和工具调用详情
• 日志导出：支持将过滤后的日志导出为JSON、CSV或纯文本格式
• 日志标注：可以为重要日志条目添加标注和备注，方便团队协作排查问题

# 日志API查询示例
GET /api/v1/logs?level=ERROR&agent=research-bot&since=1h&limit=100

Response:
{
  "logs": [
    {
      "timestamp": "2024-03-15T10:23:45.123Z",
      "level": "ERROR",
      "module": "openclaw.agent.executor",
      "agent_id": "research-bot-001",
      "trace_id": "abc123def456",
      "message": "Tool execution failed: web_search",
      "context": {
        "tool": "web_search",
        "error": "Rate limit exceeded",
        "retry_count": 3
      }
    }
  ],
  "total": 15,
  "has_more": true
}

配置编辑器

配置编辑器允许您直接在浏览器中修改OpenClaw的配置。它提供了语法高亮、自动补全和实时验证功能，让配置管理变得更加安全和高效。

配置编辑器的主要特性：

• 语法高亮和自动补全：基于JSON Schema的智能提示，自动补全配置键名和可选值
• 实时验证：在编辑过程中实时检查配置语法和语义错误，避免提交无效配置
• 差异对比：保存前可以查看当前配置与已发布配置的差异，清晰了解每次变更
• 版本历史：保存配置的所有历史版本，支持一键回滚到任意历史版本
• 权限控制：基于角色的访问控制，确保只有授权用户可以修改关键配置

API端点集成

Web管理台的所有功能都通过RESTful API实现，您可以直接调用这些API来构建自定义的管理工具或集成到现有的运维系统中。

以下是管理台提供的核心API端点：

# 认证
POST /api/v1/auth/login
{
  "username": "admin",
  "password": "your-password"
}
# 返回 JWT token，后续请求需携带 Authorization: Bearer <token>

# 系统状态
GET /api/v1/dashboard/status
GET /api/v1/dashboard/metrics?period=24h

# Agent管理
GET    /api/v1/agents
GET    /api/v1/agents/{agent_id}
POST   /api/v1/agents
PUT    /api/v1/agents/{agent_id}
DELETE /api/v1/agents/{agent_id}
POST   /api/v1/agents/{agent_id}/start
POST   /api/v1/agents/{agent_id}/stop

# 日志查询
GET /api/v1/logs?level=ERROR&agent={agent_id}&since=1h

# 配置管理
GET /api/v1/config
PUT /api/v1/config
GET /api/v1/config/history
POST /api/v1/config/rollback

# 插件管理
GET    /api/v1/plugins
POST   /api/v1/plugins/install
DELETE /api/v1/plugins/{plugin_id}

Web管理台默认监听 http://localhost:8080/dashboard。您可以通过配置文件修改监听地址和端口，也可以配置反向代理（如Nginx）来启用HTTPS和访问控制。