Files

Krilly c9acf0c4da Add memory-viewer from silicondawn

- Web UI for browsing and editing OpenClaw memory files
- Cloned from https://github.com/silicondawn/memory-viewer
- Built and running on port 8901
- Features: file tree, markdown rendering, search, live reload
- Full access to MEMORY.md, daily notes, skills, automations

2026-02-21 02:28:57 +00:00

3.7 KiB

Raw Blame History

中文 | English

📝 Memory Viewer for OpenClaw

一个精美的暗色主题 Web UI，用于浏览和编辑 OpenClaw AI Agent 的记忆文件。专为使用 Markdown 文件存储上下文的 OpenClaw Agent 设计。

为什么选择 Memory Viewer for OpenClaw？

OpenClaw Agent 将记忆存储在 Markdown 文件中（MEMORY.md、memory/*.md）。Memory Viewer 提供了一个专用的 Web 界面来：

浏览记忆文件的折叠树形结构
搜索所有 Agent 记忆，即时查找
编辑直接在浏览器中修改文件
监控 Agent 系统状态和内存使用情况
连接从单个 UI 连接多个 OpenClaw Agent

功能特性

📁 文件树侧栏 — 可折叠的树形结构，浏览所有 .md 文件
📖 Markdown 渲染 — 支持 GFM（GitHub 风格 Markdown），包括语法高亮、表格等
✏️ 浏览器内编辑 — 直接在页面编辑文件，Ctrl+S 保存，支持乐观锁冲突检测
🔍 全文搜索 — 即时搜索所有记忆文件（Ctrl+K）
📊 系统仪表盘 — 服务器运行时间、内存使用、负载均值、今日记忆摘要
🔄 实时刷新 — 文件在磁盘上变更时自动刷新（WebSocket + 10 秒轮询兜底）
📱 PWA 支持 — 可安装为独立应用，支持离线缓存
🔗 深度链接 — 基于 Hash 路由（#/file/路径），可收藏和分享文件 URL
📊 Mermaid 图表 — 在围栏代码块中渲染流程图和各类图表
🚗 大屏优化 — 触控友好的 UI，适配车载屏幕（Tesla）和大型显示器
🌙 暗色/亮色主题 — 一键切换，适合常驻仪表盘
📱 响应式设计 — 移动端支持侧滑菜单
🌐 多 Bot 连接 — 在单个 UI 中连接多个 OpenClaw Agent 工作区

快速开始

# 克隆仓库
git clone https://github.com/silicondawn/memory-viewer.git
cd memory-viewer

# 安装依赖
npm install

# 启动开发服务器（同时启动 API 和 Vite）
npm run dev

然后在浏览器中打开 http://localhost:5173。

OpenClaw 集成

Memory Viewer 与 OpenClaw Agent 无缝集成。连接到你的 OpenClaw Agent：

确保你的 OpenClaw Agent 正在运行且可访问
在 Memory Viewer 中，点击右上角的网络图标
添加你的 Agent 工作区路径（例如 /home/user/clawd）
开始浏览和编辑你的 Agent 记忆文件

部署

Memory Viewer 可以作为独立服务部署：

# 构建生产版本
npm run build

# 启动生产服务器
npm start

服务器默认运行在 8901 端口。你可以通过 Cloudflare Tunnel、Nginx 或任何反向代理暴露它。

3.7 KiB Raw Blame History Unescape Escape