討論 – 人工智能研究

连接 Trilium 与 OpenClaw/Clawdbot，打造主权个人的私有 AI 助手

2026 年 1 月 26 日上午 12:31 #32875

什么是 OpenClaw（原 Clawdbot）

OpenClaw（原名 Clawdbot，曾短暂更名为 Moltbot）是一个开源的个人 AI 助手平台。它由 PSPDFKit 创始人 Peter Steinberger 于 2025 年底开发发布。项目的核心理念是”本地优先”——你的数据、对话历史和记忆都保存在你自己的设备上，而不是云端。

📌 名称变更历史：2025年11月发布时名为 Clawdbot → 2026年1月27日因 Anthropic 商标争议改名为 Moltbot → 2026年1月29日再次更名为 OpenClaw

项目发布后迅速走红，短短两个月内 GitHub Star 数超过 10万，成为 GitHub 历史上增长最快的开源项目之一。AI 研究者 Andrej Karpathy 公开称赞该项目，投资人 Chamath Palihapitiya 分享了 Moltbot 帮他在几分钟内节省了 15% 汽车保险费的经历。

与传统的 AI 聊天工具不同，OpenClaw 具备以下独特优势：

特性	OpenClaw	ChatGPT/Claude 等
🏠 部署方式	Gateway 运行在你的设备上，数据完全由你掌控	云端托管
🔗 多平台接入	WhatsApp、Telegram、Slack、Discord、Signal、iMessage、Google Chat、Microsoft Teams、Matrix、Zalo 等 10+ 渠道	需访问专用网站/App
🧠 持久记忆	真正的长期记忆，能够记住你的偏好、决策和重要信息	会话重置后丢失
🛠️ 工具扩展	支持文件操作、代码执行、网页浏览、Shell 命令等	对话能力受限
💰 成本	使用现有 API 订阅	额外付费
🔧 可定制性	完全可扩展	封闭系统

架构概览

OpenClaw 的核心是 Gateway（openclaw gateway），一个长期运行的 Node.js 进程，负责管理所有渠道连接并提供 WebSocket 控制平面（默认端口 18789）。

┌─────────────────────────────────────────────────────────────┐
│                    消息渠道                                  │
│  WhatsApp · Telegram · Discord · Slack · iMessage · ...     │
├─────────────────────────────────────────────────────────────┤
│                        ↓                                    │
├─────────────────────────────────────────────────────────────┤
│  OpenClaw Gateway (ws://127.0.0.1:18789)                    │
│  ├── 会话管理 (Sessions)                                    │
│  ├── 记忆系统 (Memory)                                      │
│  ├── 工具执行 (Tools)                                       │
│  ├── Skills 扩展                                            │
│  └── Control UI (浏览器控制台)                               │
├─────────────────────────────────────────────────────────────┤
│                        ↓                                    │
├─────────────────────────────────────────────────────────────┤
│  Pi 编码代理 (Coding Agent)                                  │
│  ├── 代码生成与执行                                          │
│  ├── 文件操作                                               │
│  └── 系统命令                                               │
└─────────────────────────────────────────────────────────────┘

Pi：OpenClaw 的核心代理

OpenClaw 底层使用的是一个名为 Pi 的轻量级编码代理（由 Mario Zechner 编写）。Pi 的设计理念是：LLM 非常擅长编写和运行代码，所以让代理自我扩展——如果你想让代理做它还不会的事情，不需要下载扩展或技能，只需让代理自己编写代码来扩展自己。

⚠️ 注意：从最新版本开始，旧版的 Claude/Codex/Gemini/Opencode 路径已被移除，Pi 是唯一的编码代理路径。运行时要求：Node ≥ 22。

OpenClaw 的记忆系统

OpenClaw 最强大的特性之一就是它的记忆系统，通过两个机制实现：JSONL 会话记录 和 Markdown 记忆文件。

1. 会话记录（Session Transcripts）

属性	说明
存储格式	JSONL 文件
生命周期	当前对话会话
用途	保存对话上下文，让 AI 理解你在聊什么
清除方式	发送 `/new` 或 `/reset` 命令

会话记录就像人的短期记忆，只在当前对话中有效。当你开始新话题或需要”刷新” AI 的状态时，可以重置会话。

重置命令支持：

/new 或 /reset：开始新会话
/new <model>：开始新会话并切换模型（支持模型别名或 provider/model 格式）
单独发送 /new 或 /reset 时，OpenClaw 会运行一个简短的问候来确认重置

会话重置策略配置：

idleMinutes：空闲超时自动重置
resetByType：按会话类型（dm、group、thread）设置不同策略
resetByChannel：按渠道设置重置策略

2. 长期记忆（MEMORY.md）

属性	说明
存储位置	`~/clawd/MEMORY.md`
生命周期	永久保存，直到手动删除
用途	存储重要的决策、偏好、持久性事实
写入方式	代理使用标准的 `write` 文件工具自行写入

长期记忆是 OpenClaw 的”人生经验”。例如：

你的编程风格偏好
项目的技术架构决策
重要的业务规则

💡 设计理念：没有特殊的记忆写入 API。代理只是简单地写入文件。如果有人说”记住这个”，代理会把它写下来（不会只保存在内存中）。

3. 日志记忆（Daily Memory）

属性	说明
存储位置	`~/clawd/memory/YYYY-MM-DD.md`
生命周期	按日期归档
用途	记录每日的工作笔记、临时上下文
生成方式	新会话开始时，hook 会抓取上一次对话并写入摘要

日志记忆就像工作日志，帮助你回顾”那天发生了什么”。

4. 语义搜索（向量索引）

OpenClaw 可以在 MEMORY.md 和 memory/*.md（以及你选择加入的任何额外目录/文件）上构建一个小型向量索引，以便语义查询可以找到相关笔记，即使措辞不同。

搜索机制：

混合搜索：结合向量搜索和关键词匹配
向量搜索：使用 SQLite
关键词搜索：使用 FTS5（SQLite 扩展）
嵌入提供者：可配置

索引刷新机制：

文件监视器监控 MEMORY.md、memory/ 和 memorySearch.extraPaths
变更后 1.5 秒去抖动后标记索引为脏
同步在会话开始、搜索时或定时触发

重建索引触发条件：

嵌入提供者/模型变更
端点指纹变更
分块参数变更

安装与配置

系统要求

资源	最低配置	推荐配置
RAM	512MB-1GB	2GB
CPU	1 核	–
磁盘	~500MB	更多（日志、媒体）
Node.js	≥ 22	最新 LTS

Raspberry Pi 4 即可运行 Gateway！

安装方式

推荐：全局 npm/pnpm 安装

# npm
npm install -g openclaw@latest

# 或 pnpm
pnpm add -g openclaw@latest

然后进行初始化和安装服务

openclaw onboard --install-daemon

OpenClaw 支持 macOS、Windows 和 Linux，一键安装脚本会自动安装 Node.js 和所有依赖。还有一个伴侣应用（Beta）提供菜单栏访问。

启动 Gateway

openclaw gateway

启动后访问控制台：http://127.0.0.1:18789/

Tailnet 访问配置：

openclaw gateway --bind tailnet --token <your-token>

非 loopback 绑定必须提供 token。

Skills 系统

OpenClaw 通过 Skills 扩展功能，让它能够与外部服务交互、自动化工作流程并执行专门任务。

内置能力

OpenClaw 出厂自带 50+ Skills，包括：

📁 文件管理
🌐 网页浏览自动化
🏠 智能家居控制
📱 社交媒体管理
⌨️ Shell 命令执行
📊 数据提取

ClawHub：Skills 市场

ClawHub（https://clawhub.com）是 OpenClaw 的公共 Skills 注册表，你可以：

发现新 Skills
安装和更新 Skills
备份你的 Skills 配置

⚠️ 安全警告

请将第三方 Skills 视为不受信任的代码，启用前务必阅读其源码！

近期安全审计发现 341 个恶意 ClawHub Skills，滥用 OpenClaw 在 macOS 和 Windows 上传播 Atomic Stealer 并窃取凭证。ClawHub 的开放性质和缺乏严格审核流程使其成为攻击者的目标。

常用命令

命令	功能
`openclaw gateway`	启动 Gateway
`openclaw status`	显示存储路径和最近会话
`openclaw sessions --json`	导出所有会话条目
`openclaw sessions --active <minutes>`	筛选活跃会话
`/new`	重置会话
`/new <model>`	重置会话并切换模型
`/reset`	重置会话（同 /new）
`/status`	查看代理状态、上下文使用量、配置开关等

TriliumAI Agent 插件：将 Trilium 知识库与 OpenClaw 连接

TriliumAI Agent 是一个 WordPress 插件，它将 Trilium Notes 知识库与 AI 助手（包括 OpenClaw）连接起来，让你可以：

🔍 搜索和浏览 Trilium 笔记
📤 选择笔记并导出到 AI 工作目录
💉 注入笔记内容到 OpenClaw 的记忆系统

插件架构

┌─────────────────────────────────────────────────────────────┐
│                    WordPress 后台                           │
├─────────────────────────────────────────────────────────────┤
│  TriliumAI Agent 插件                                       │
│  ├── Trilium 工作区（搜索/浏览笔记）                         │
│  ├── OpenCode 会话管理（本地 Agent）                         │
│  └── OpenClaw 集成（WebSocket 通信）                         │
├─────────────────────────────────────────────────────────────┤
│                        ↓ WebSocket                          │
├─────────────────────────────────────────────────────────────┤
│  OpenClaw Gateway (ws://127.0.0.1:18789)                    │
│  ├── 会话管理                                               │
│  ├── 记忆系统                                               │
│  └── 工具执行                                               │
└─────────────────────────────────────────────────────────────┘

如何使用：将 Trilium 笔记注入 OpenClaw 记忆

步骤 1：选择 OpenClaw Provider

在聊天界面的模型选择器中，选择 OpenClaw：

模型选择：[OpenClaw ▼]

选择后，界面会显示：

Trilium 笔记工作区
记忆模式选择器
记忆管理按钮

步骤 2：搜索并选择笔记

在工作区中搜索你需要的笔记：

🔍 [输入关键词搜索笔记...]  [搜索]

点击笔记项即可选中，支持多选。

步骤 3：选择记忆模式

根据你的需求选择合适的记忆模式：

模式	图标	用途	效果
临时记忆	💬	当前对话中使用	笔记内容注入聊天输入框，作为上下文发送
长期记忆	🧠	永久保存	笔记追加到 `MEMORY.md`
日志记忆	📅	按日期归档	笔记追加到 `memory/今日日期.md`

步骤 4：执行导出

点击导出按钮，笔记内容会被转换为 Markdown 格式并发送到 OpenClaw。

临时记忆模式示例：

---
📚 以下是来自 Trilium 知识库的参考资料：

## 项目技术架构
> 来源: Trilium 笔记 ID abc123

（笔记内容...）

---

请基于以上资料回答我的问题：

长期/日志记忆模式示例：

请将以下内容追加到 MEMORY.md 文件末尾，作为长期记忆保存。

## Trilium 笔记导入 - 2026-02-03T10:00:00

### 项目技术架构
> 来源: Trilium 笔记 ID `abc123`

（笔记内容...）

记忆管理功能

插件提供了便捷的记忆管理功能：

┌─────────────────────────────────────────────────────┐
│ 🧹 记忆管理                              [📊 状态]  │
├─────────────────────────────────────────────────────┤
│ [🔄 重置会话] [🧠 清空长期记忆] [📅 清空日志记忆]    │
└─────────────────────────────────────────────────────┘

按钮	功能	实现方式
🔄 重置会话	清除当前对话上下文，开始新会话	发送 `/new` 命令
🧠 清空长期记忆	清空 `MEMORY.md` 内容	让 Agent 执行 write 工具
📅 清空日志记忆	删除 `memory/*.md` 文件	让 Agent 执行 bash 命令
📊 状态	查看当前记忆文件状态	让 Agent 报告文件信息

WebSocket 通信协议

插件通过 WebSocket 与 OpenClaw Gateway 通信：

// 请求格式
{
  "type": "req",
  "id": "1",
  "method": "chat.send",
  "params": {
    "sessionKey": "main",
    "message": "你好",
    "idempotencyKey": "wp-1706234567890-abc123"
  }
}

// 响应格式
{
  "type": "res",
  "id": "1",
  "ok": true,
  "payload": {
    "runId": "run-xyz",
    "status": "started"
  }
}

支持的 Gateway 方法

方法	用途
`connect`	握手认证
`chat.send`	发送消息
`chat.history`	获取对话历史
`sessions.list`	获取会话列表

使用场景示例

场景 1：项目知识问答

你有一个复杂的项目，技术文档都保存在 Trilium 中：

搜索相关笔记（如”API 接口文档”、”数据库设计”）
选择 💬 临时记忆 模式
导出笔记
在输入框追加问题：”根据以上文档，这个 API 应该怎么调用？”

场景 2：建立项目记忆库

你希望 OpenClaw 永久记住项目的核心信息：

选择项目的关键笔记（架构决策、编码规范等）
选择 🧠 长期记忆 模式
导出笔记
之后每次与 OpenClaw 对话，它都会记住这些信息

场景 3：每日工作记录

你习惯用 Trilium 记录每日工作：

选择今日的工作笔记
选择 📅 日志记忆 模式
导出笔记
这些内容会保存到 memory/2026-02-03.md，方便日后回顾

常见问题

Q: 为什么选择 OpenClaw 而不是直接调用 API？

A: OpenClaw 提供了完整的 Agent 运行时，包括：

✅ 工具执行沙箱（或完全系统访问权限）
✅ 持久化记忆（含语义搜索）
✅ 多渠道接入（10+ 平台）
✅ 安全的本地部署
✅ Skills 扩展生态

直接调用 API 只能获得基础的对话能力，无法享受这些高级特性。

Q: 记忆会占用多少存储空间？

A: 记忆以纯文本 Markdown 存储，非常节省空间：

一年的日志记忆（每天 1KB）约 365KB
MEMORY.md 通常在几十 KB 以内

Q: 如何备份记忆？

A: 直接复制以下文件/目录即可：

长期记忆：~/clawd/MEMORY.md
日志记忆：~/clawd/memory/

Q: OpenClaw 安全吗？

A: 主要安全考虑：

⚠️ 高级别系统访问权限
⚠️ 可能的配置错误
⚠️ 执行任意代码的能力
⚠️ 第三方 Skills 可能包含恶意代码

建议：

在了解的环境中部署
谨慎授予系统访问权限
启用 Skills 前审查源码
定期更新到最新版本

总结

OpenClaw（原 Clawdbot）+ TriliumAI Agent 的组合，让你可以：

✅ 在本地运行强大的 AI 助手 ✅ 将知识库与 AI 连接 ✅ 建立持久化的 AI 记忆（含语义搜索） ✅ 方便地管理和清理记忆 ✅ 通过 Skills 扩展无限可能

这是一个真正”懂你”的 AI 助手——它不仅能回答问题，还能记住你告诉它的一切，并且能真正执行任务。

抱歉，回覆主題必需先登入。