今天这篇文章就是 PowerMem 的操作手册不讲原理只讲步骤。从服务端部署到客户端接入一条链路从头串到尾每一步都有明确的命令和截图。这个手册的目标是你按照顺序做完或者让你的通用 Agent 根据文章内容做完就能拥有一套部署好的 PowerMem 服务端以及一个已经接好记忆层的 Claude Code 或 OpenClaw 客户端。一、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.gitcd powermemuv pip install -e “.[cli,server,mcp,seekdb]”各 extras 说明extras 作用cli pmem 命令行工具server powermem-server HTTP API 服务器mcp MCP 协议支持seekdb 内嵌向量数据库零配置无需单独部署数据库1.3 初始化配置交互式生成 .env 配置文件pmem config init也可手动创建 .env 文件。以下是我的配置DATABASE_PROVIDERoceanbaseDATABASE_PROVIDERsqliteSQLITE_PATH/root/data/package/powermem/powermem.dbLLM_PROVIDERanthropicLLM_PROVIDERopenaiANTHROPIC_LLM_BASE_URLhttps://token-plan-cn.xiaomimimo.com/anthropicLLM_API_KEYtp-xxxLLM_MODELmimo-v2.5-proLLM_API_KEYxxxLLM_MODELstep-3.7-flashOPENAI_LLM_BASE_URLhttps://api.stepfun.com/step_plan/v1EMBEDDING_PROVIDERsiliconflowEMBEDDING_API_KEYsk-xxEMBEDDING_MODELBAAI/bge-m3OCEANBASE_EMBEDDING_MODEL_DIMS1024EMBEDDING_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参数说明参数 默认值 说明–host 0.0.0.0 监听地址–port 8848 监听端口–workers 4 工作进程数内嵌存储自动降为 1–reload 关闭 开发模式代码变更自动重载–log-level INFO 日志级别首次启动会比较慢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_ENABLEDtruePOWERMEM_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。