MolyMemos OpenClaw Plugin

OpenClaw 插件，通过 WebSocket 连接到服务器，接收推送的内容并写入 memory 文件夹。

安装

npm install
npm run build

配置

在 OpenClaw 配置文件中添加插件配置：

{
  plugins: {
    entries: {
      "molymemos": {
        enabled: true,
        config: {
          serverUrl: "ws://localhost:8080",  // 必填，WebSocket 服务器地址
          apiKey: "your-api-key",            // 可选，认证密钥
          reconnectInterval: 5000            // 可选，重连间隔(ms)，默认 5000
        }
      }
    }
  }
}

配置项

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | serverUrl | string | 是 | WebSocket 服务器地址 | | apiKey | string | 否 | API 认证密钥 | | reconnectInterval | number | 否 | 重连间隔(ms)，默认 5000 |

工作原理

1. 插件启动时建立 WebSocket 连接到配置的服务器
2. 监听服务器推送的消息
3. 收到消息后将内容 append 到 {workspaceDir}/memory/molymemos/{filepath}
4. 连接断开后自动重连

服务器消息格式

服务器推送的消息需要符合以下 JSON 格式：

{
  "type": "memo",
  "content": "要追加的内容",
  "filepath": "notes/daily.md"
}

接口

Gateway RPC 方法

molymemos.append

手动追加内容到文件。

参数：

{
  "content": "要追加的内容",
  "filepath": "相对路径，如 notes/2024/01/15.md"
}

molymemos.status

获取插件状态。

响应：

{
  "serverUrl": "ws://localhost:8080",
  "connected": true,
  "workspaceDir": "~/.openclaw/workspace",
  "molyMemosDir": "~/.openclaw/workspace/memory/molymemos"
}

HTTP 路由

POST /molymemos/append

手动追加内容到文件。

curl -X POST http://localhost:port/molymemos/append \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello World", "filepath": "test.md"}'

GET /molymemos/status

获取插件状态。

Agent 工具

append_memo

Agent 可调用的工具，用于追加内容到记忆文件夹。

参数：

• content: 要追加的内容
• filepath: 相对文件路径

文件结构

内容会被追加到 {workspaceDir}/memory/molymemos/{filepath} 路径下。

例如，如果 workspaceDir 是 ~/.openclaw/workspace，filepath 是 notes/daily.md， 那么内容会追加到 ~/.openclaw/workspace/memory/molymemos/notes/daily.md。