简介

ClawPort 是一个开源的、基于 Next.js 构建的 AI 智能体（Agent）管理仪表盘，专为 OpenClaw​ 框架设计。它解决了原生 OpenClaw 命令行界面（CLI）在管理复杂多智能体团队时的痛点，将分散的日志、配置和状态信息整合到一个现代化的 Web 界面中。通过 ClawPort，开发者可以直观地查看智能体组织架构、实时监控任务执行、管理定时作业（Cron Jobs）、浏览团队记忆库，并与智能体进行流式聊天交互，无需记忆复杂的 CLI 命令，实现了对 AI 团队的“一站式”可视化运维。

主要功能

• 组织地图（Org Map）：以交互式流程图（React Flow）展示智能体之间的层级关系与协作结构，直观呈现主智能体、子智能体及团队成员。

• 实时聊天与多模态交互：支持与任意智能体进行流式文本对话，并具备图像上传（视觉理解）、语音消息（转录与播放）及文件附件处理能力。

• 看板任务管理：提供类 Trello 的看板视图，支持拖拽卡片管理任务状态，并关联特定智能体上下文。

• 定时任务监控（Cron Monitor）：可视化展示所有计划任务的执行状态、历史记录、错误日志，支持按状态筛选和自动刷新。

• 成本仪表盘：聚合展示各任务及模型的 Token 消耗、费用估算、缓存命中率及异常检测，帮助进行成本控制。

• 活动控制台与实时日志：历史事件浏览器与悬浮实时日志流组件，点击日志可展开查看原始 JSON 详情。

• 记忆浏览器：直接读取 OpenClaw 的团队记忆（Team Memory）和长期记忆（LTM），支持 Markdown 渲染、搜索和下载。

• 主题系统：提供深色（Dark）、玻璃态（Glass）、彩色（Color）、浅色（Light）及跟随系统五种主题。

安装与配置

前提条件

确保已安装并运行 OpenClaw。若未安装，需先执行：

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

验证网关运行：openclaw gateway status。

安装 ClawPort

通过 npm 全局安装（注意包名为 clawport-ui，CLI 命令为 clawport）：

npm install -g clawport-ui

配置连接

运行自动配置命令，该命令会探测本地 OpenClaw 工作空间路径、网关端口及 Token，并生成 .env.local文件：

clawport setup

如何使用

1. 启动服务：执行 clawport dev启动开发服务器（默认端口 3000），或 clawport start启动生产服务。

2. 访问界面：浏览器打开 http://localhost:3000，首次进入会引导设置门户名称和主题。

3. 智能体发现：ClawPort 会自动扫描 $WORKSPACE_PATH/agents/目录下的 SOUL.md文件，无需手动配置即可加载智能体列表。

4. 交互操作：

   • 在 Chat​ 标签页选择智能体，输入指令或上传文件进行交互。

   • 在 Kanban​ 标签页创建任务卡片，分配给智能体并跟踪进度。

   • 在 Cron​ 标签页查看定时任务的执行热图与历史详情。

   • 在 Memory​ 标签页搜索智能体团队积累的知识。

应用场景实例

实例 1：研发团队自动化助手监控

场景：一个由 OpenClaw 驱动的研发团队，包含“代码审查员”、“文档生成器”和“部署工程师”三个智能体。团队每天定时拉取 Git 代码、生成变更日志并部署测试环境。

ClawPort 应用：项目经理打开 ClawPort 的 Org Map，看到三个智能体呈树状连接。在 Cron 面板发现“部署工程师”任务状态显示为“失败（红色）”，点击展开日志看到“SSH 密钥认证失败”的错误。无需登录服务器查日志，直接在界面中断任务、调整配置后重启，并通过 Chat 向“部署工程师”发送“重试部署”指令。

实例 2：内容创作团队的记忆回溯

场景：一个内容营销团队使用智能体自动抓取行业热点、撰写初稿并发布到社交媒体。一周后，需要查找关于“量子计算”的早期讨论记录。

ClawPort 应用：编辑在 ClawPort 的 Memory 浏览器中，选择“长期记忆”分类，在搜索框输入“量子计算”，系统返回了上周三智能体抓取的相关论文摘要和撰写的草稿片段。编辑直接复制 Markdown 内容进行二次加工，无需翻找聊天记录。

实例 3：多模态客服质检

场景：智能体接入了语音客服渠道，处理用户上传的产品故障图片和语音投诉。

ClawPort 应用：运维人员在 Activity 控制台看到实时日志流中有一条“Vision processing timeout”警告。他切换到 Chat 界面，直接上传一张类似的故障图片给智能体，测试其视觉识别能力是否恢复，同时利用语音播放功能检查 TTS 合成质量。

GitHub 地址

项目仓库：https://github.com/JohnRiceML/clawport-ui