1. 项目定位与用途
ClawPort 是一个开源的 AI agent 指挥中心仪表板,用于统一管理、监控和交互 OpenClaw AI agents。它连接到本地 OpenClaw 网关,提供组织架构图、直接 agent 聊天(支持视觉和语音)、看板、cron 监控、成本跟踪、活动控制台(实时日志流)和内存浏览器等功能。所有请求通过 OpenClaw 网关路由,无需单独 AI API 密钥。项目以 npm 包 clawport-ui 发布,提供全局 CLI 命令 clawport,基于 Next.js 16 构建。
2. 解决的问题
ClawPort 解决 AI agent 团队管理中的碎片化问题。传统上,监控 agent 状态、分配任务、查看日志、分析成本和直接交互需要多个独立工具,导致上下文切换频繁、运维复杂。ClawPort 将这些功能整合在一个可视化界面中,提供统一的组织视图、通信渠道和监控面板,降低管理开销,使团队能更专注于 AI 工作流本身。
3. 适用场景
主要适用场景包括:AI 开发团队集中管理和监控多个自主 agents;通过可视化界面与 agents 进行文本、图像和语音交互;跟踪和分析 AI 任务执行成本与 token 使用情况;使用看板方法跨 agents 分配和跟踪任务进度;实时查看 cron 作业状态和流式日志进行调试;浏览和搜索团队共享内存。适合需要高效协调多个 AI 代理完成复杂任务的团队。
4. 安装方式
安装需分两步:首先安装 OpenClaw 网关,运行 curl -fsSL https://openclaw.ai/install.sh | bash 安装,然后执行 openclaw onboard --install-daemon 启动网关并验证状态;其次全局安装 ClawPort:npm install -g clawport-ui(注意包名为 clawport-ui,CLI 命令为 clawport)。也可从源码安装:克隆仓库后运行 npm install、npm run setup 和 npm run dev。Node.js 版本要求 >=22。
5. 使用方式
配置连接:运行 clawport setup 自动检测 OpenClaw 配置并生成 .env.local。启动:clawport dev 启动开发服务器,访问 http://localhost:3000。首次启动会引导用户完成门户命名、主题选择和操作员身份设置。日常使用包括:在 Org Map 页面查看 agent 团队层级;在 Chat 页面与特定 agent 流式对话并发送多媒体;在 Kanban 页面拖放任务卡片;在 Cron 页面监控定时任务;在 Costs 页面分析用量与费用;在 Activity 和 Memory 页面查看日志与内存。
6. 实现特点
ClawPort 采用 Next.js 16 App Router 架构,页面组件标记为 'use client',API 路由在服务端运行。模块化 API 设计按功能拆分端点,如 agents、chat、costs、crons、kanban 等。后端支持 OpenClaw 网关和 OpenAI 双后端,通过环境变量 OPENCLAW_GATEWAY_TOKEN 认证。UI 层使用 Tailwind CSS、Radix UI 和 shadcn 组件库,结合 lucide-react 图标库。