ClawPort

专为您的 AI Agent 团队打造的可视化指挥中心。

网站 | 安装指南 | API 文档 | npm

---

ClawPort 是一个开源仪表板，用于管理、监控并直接与您的 OpenClaw AI Agent 进行交互。它连接到您的本地 OpenClaw 网关，为您提供组织架构图、支持视觉与语音的直接对话、看板、Cron 任务监控、成本跟踪、带有实时日志流的活动控制台以及内存浏览器——所有功能集于一体。

无需单独的 AI API Key，所有流量均通过您的 OpenClaw 网关路由。

更多截图

聊天 —— 支持流式文本、视觉、语音、文件附件	看板 —— 跨 Agent 的拖拽式任务看板
管道 (Pipelines) —— 带有健康检查的 DAG 可视化	调度 (Schedule) —— 周度热力图与作业管理
活动 (Activity) —— 带有 JSON 展开功能的历史日志浏览器	实时日志 (Live Logs) —— 实时流式传输组件
成本 (Costs) —— Token 使用量、异常情况、优化洞察	内存 (Memory) —— 带有 Markdown 渲染的团队内存浏览器

---

快速开始

1. 安装 OpenClaw

ClawPort 需要一个运行中的 OpenClaw 实例。如果您尚未安装：

# 安装 OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# 运行初始化向导（设置工作空间、网关和守护进程）
openclaw onboard --install-daemon

安装完成后，验证网关是否在运行：

openclaw gateway status

您应该能看到您的网关 URL（默认 localhost:18789）和身份验证 Token。如果您使用自定义端口，clawport setup 会自动检测。更多详情请参阅 OpenClaw 文档。

2. 安装 ClawPort

注意： npm 包名为 clawport-ui，CLI 命令为 clawport。 请勿安装无关的 clawport 包。

npm install -g clawport-ui

3. 连接并启动

# 自动检测您的 OpenClaw 配置并写入 .env.local
clawport setup

# 启动仪表板
clawport dev

打开 http://localhost:3000。初始化向导将引导您完成门户命名、选择主题以及设置操作员身份的操作。

从源码安装

git clone https://github.com/JohnRiceML/clawport-ui.git
cd clawport-ui
npm install
npm run setup
npm run dev

---

功能特性

• 组织架构图 —— 整个 Agent 团队的交互式组织图。一眼纵览层级结构、Cron 状态和关联关系。由 React Flow 驱动，支持自动布局。
• 聊天 —— 流式文本聊天、带视觉识别的图像附件、带波形播放的语音消息、文件附件、剪贴板粘贴及拖拽上传。对话记录在本地持久化。
• 看板 —— 用于跨 Agent 管理工作的任务板。支持拖拽卡片，可指定 Agent 并关联对话上下文。
• Cron 监控 —— 所有计划作业的实时状态。支持按状态过滤、按错误排序、展开查看详情。每 60 秒自动刷新。
• 成本仪表板 —— 所有 Cron 作业的 Token 使用量和成本分析。包含每日成本图表、作业明细、模型分布、异常检测、周同比趋势及缓存节省统计。
• 活动控制台 —— 历史事件日志浏览器及浮动实时流组件。点击任意日志行可展开原始 JSON。实时流组件在页面导航时保持持久化。
• 内存浏览器 —— 阅读团队记忆、长期记忆和日常日志。支持 Markdown 渲染、JSON 语法高亮、搜索及下载。包含分类最佳实践指南选项卡。
• Agent 详情 —— 每个 Agent 的完整配置文件：查看 SOUL.md、工具、层级、Cron 任务、语音 ID 及直接对话链接。
• 五种主题 —— 暗色、磨砂、彩色、亮色和系统跟随。所有主题基于 CSS 自定义属性，可立即切换。
• 自动发现 —— 自动从您的 OpenClaw 工作空间发现 Agent。无需配置文件。

---

工作原理

ClawPort 读取您的 OpenClaw 工作空间以发现 Agent，随后连接到网关以执行所有 AI 操作：

浏览器  -->  ClawPort (Next.js)  -->  OpenClaw 网关 (默认 localhost:18789)  -->  Claude
                  |                          |
                  |                     文本: /v1/chat/completions (流式 SSE)
                  |                     视觉: openclaw gateway call chat.send (CLI)
                  |                     音频: /v1/audio/transcriptions (Whisper)
                  |
             读取来源:
               $WORKSPACE_PATH/agents/    (Agent 的 SOUL.md 文件)
               $WORKSPACE_PATH/memory