今天这篇文章就是 PowerMem 的操作手册不讲原理只讲步骤。从服务端部署到客户端接入一条链路从头串到尾每一步都有明确的命令和截图。这个手册的目标是你按照顺序做完或者让你的通用 Agent 根据文章内容做完就能拥有一套部署好的 PowerMem 服务端以及一个已经接好记忆层的 Claude Code 或 OpenClaw 客户端。立即试用 OceanBase 企业版体验国产数据库能力180 天免费试用零门槛开通一、Linux 服务端安装、配置、启动1.1 环境要求Python 3.11pip 或 uv推荐 uv更快1.2 安装# 从 PyPI 安装生产环境推荐 uv pip install powermem[cli,server,mcp,seekdb] # 或从源码安装开发环境 git clone https://github.com/oceanbase/powermem.git cd powermem uv pip install -e .[cli,server,mcp,seekdb]各 extras 说明extras作用clipmem 命令行工具serverpowermem-server HTTP API 服务器mcpMCP 协议支持seekdb内嵌向量数据库零配置无需单独部署数据库1.3 初始化配置# 交互式生成 .env 配置文件 pmem config init也可手动创建 .env 文件。以下是我的配置# DATABASE_PROVIDERoceanbase DATABASE_PROVIDERsqlite SQLITE_PATH/root/data/package/powermem/powermem.db # LLM_PROVIDERanthropic LLM_PROVIDERopenai # ANTHROPIC_LLM_BASE_URLhttps://token-plan-cn.xiaomimimo.com/anthropic # LLM_API_KEYtp-xxx # LLM_MODELmimo-v2.5-pro LLM_API_KEYxxx LLM_MODELstep-3.7-flash OPENAI_LLM_BASE_URLhttps://api.stepfun.com/step_plan/v1 EMBEDDING_PROVIDERsiliconflow EMBEDDING_API_KEYsk-xx EMBEDDING_MODELBAAI/bge-m3 # OCEANBASE_EMBEDDING_MODEL_DIMS1024 # EMBEDDING_DIMS1024注意事项SQLITE_PATH 必须是完整的数据库文件路径如 /root/data/powermem/powermem.db不能只是文件夹路径使用 seekdb 时EMBEDDING_DIMS 或 OCEANBASE_EMBEDDING_MODEL_DIMS 是必填项维度要和嵌入模型匹配硅基流动的嵌入模型如果不走 seekdb可以不配 EMBEDDING_DIMS1.4 启动服务器powermem-server --host 0.0.0.0 --port 8848参数说明参数默认值说明–host0.0.0.0监听地址–port8848监听端口–workers4工作进程数内嵌存储自动降为 1–reload关闭开发模式代码变更自动重载–log-levelINFO日志级别首次启动会比较慢60-120 秒因为需要初始化 seekdb 和下载嵌入模型。验证启动成功curl http://localhost:8848/api/v1/system/health # 返回 {status:ok} 即成功二、Dashboard 使用2.1 访问 Dashboard服务器启动后浏览器打开http://服务器IP:8848/dashboard/2.2 Dashboard 功能页面路径功能总览/dashboard/记忆总量、增长趋势、质量指标、系统健康记忆管理/dashboard/memories浏览、搜索、查看、删除记忆用户画像/dashboard/user-profile查看用户级别的聚合画像设置/dashboard/settings配置 API Key仅在服务端开启认证时需要2.3 开启认证可选在 .env 中添加POWERMEM_SERVER_AUTH_ENABLEDtrue POWERMEM_SERVER_API_KEYSyour-secret-key重启服务器后所有 API 请求需携带 X-API-Key 头。Dashboard 的 Settings 页面可配置 Key。2.4 API 文档服务器自带 Swagger 文档http://服务器IP:8848/docs三、本地 Claude Code 连接 PowerMem 服务器以下步骤在本地 Windows/Mac 操作服务器在远程 Linux。3.1 在 Dashboard 获取 API Key如果服务端开启了认证先在 Dashboard Settings 页面拿到 API Key。3.2 通过 Marketplace 安装插件在 Claude Code 中依次执行/plugin marketplace add oceanbase/powermem /plugin install memory-powermempowermem /reload-plugins如果网络不通也可以从源码安装claude --plugin-dir /path/to/powermem/apps/claude-code-plugin3.3 初始化插件/memory-powermem:init这会自动创建插件本地虚拟环境、安装 powermem 后端、启动管理服务器。3.4 Windows 用户修复 hooks 命令init 生成的 hooks.json 默认使用 shWindows 需要改为 PowerShell。hooks 文件位置C:\Users\你的用户名\.claude\plugins\cache\powermem\memory-powermem\0.1.0\hooks\hooks.json将所有 sh “${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.sh” 替换为command: powershell.exe -NoProfile -ExecutionPolicy Bypass -File \${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.ps1\完整示例{ hooks: { UserPromptSubmit: [ { hooks: [ { type: command, command: powershell.exe -NoProfile -ExecutionPolicy Bypass -File \${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.ps1\, timeout: 120 } ] } ], SessionEnd: [ { hooks: [ { type: command, command: powershell.exe -NoProfile -ExecutionPolicy Bypass -File \${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.ps1\ } ] } ], PostCompact: [ { matcher: auto|manual, hooks: [ { type: command, command: powershell.exe -NoProfile -ExecutionPolicy Bypass -File \${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.ps1\ } ] } ] } }3.5 配置连接远程服务器如果 powermem-server 不在本机比如在远程 Linux需要配置环境变量。方式一在 Claude Code 的 settings.json 中配置推荐编辑 ~/.claude/settings.json添加{ env: { POWERMEM_BASE_URL: http://服务器IP:8848, POWERMEM_API_KEY: your-secret-key } }方式二在启动 Claude Code 前设置环境变量export POWERMEM_BASE_URLhttp://服务器IP:8848 export POWERMEM_API_KEYyour-secret-key3.6 重启 Claude Code重新启动 Claude Code 即可生效。3.7 验证记忆落库时机用户发送消息时自动检索相关记忆注入到上下文中默认开启执行 /compact 时将压缩摘要保存为记忆退出会话时将完整会话记录保存为记忆验证方法结束一个会话后在 Dashboard 的 Memories 页面查看是否有新记忆写入。四、OpenClaw 安装 PowerMem 并连接落库4.1 安装插件直接跟 OpenClaw 说通过 memory-powermem 帮我安装一下 powermem 记忆引擎插件或手动执行openclaw plugins install memory-powermem4.2 配置嵌入模型阿里云百炼的 coding plan 没有嵌入模型需要手动编辑 powermem 环境文件找到插件数据目录下的 powermem.env通常在 ~/.openclaw/ 下添加/修改嵌入模型相关配置EMBEDDING_PROVIDERsiliconflow EMBEDDING_API_KEYsk-xxx EMBEDDING_MODELBAAI/bge-m3 EMBEDDING_DIMS1024根据实际使用的嵌入服务调整 provider、model 和维度。4.3 连接远程服务器可选默认 CLI 模式使用本地 pmem 存储无需额外服务器。如果需要共享团队的 PowerMem 后端在 OpenClaw 中配置 requestConfig.memory_db 指向服务器地址http://服务器IP:88484.4 验证让 OpenClaw 记住一句话帮我记住测试探针dragonfruit-zx9新开对话让 OpenClaw 回忆dragonfruit-zx9 是什么能正确召回即表示工作正常PowerMem 记忆如何自进化PowerMem 不止是一个存储桶——它是一个持续进化的记忆层。每条记忆从捕获到落库再到被检索经历一个完整的生命周期捕获Capture用户每次发消息PowerMem 自动检索相关记忆注入上下文执行 /compact 时压缩摘要自动落为记忆会话结束时完整会话记录被保存存储Store文本经过 Embedding 向量化与元数据一同落入 SQLite / OceanBase 数据库被持久化保存检索Retrieve用户提问时语义向量检索找到最相关的 Top-K 条记忆注入到上下文中增强 Agent 回答质量进化Evolve重复记忆被去重合并用户画像持续更新过期记忆淘汰、新记忆增强这个四步循环让 Agent 越用越聪明越用越懂你。常用命令速查操作命令安装uv pip install “powermem[cli,server,mcp,seekdb]”初始化配置pmem config init启动服务器powermem-server --host 0.0.0.0 --port 8848健康检查curl http://localhost:8848/api/v1/system/healthDashboardhttp://localhost:8848/dashboard/API 文档http://localhost:8848/docs立即试用 OceanBase 企业版体验国产数据库能力180 天免费试用零门槛开通