今天这篇文章，就是 PowerMem 的操作手册，不讲原理只讲步骤。从服务端部署到客户端接入，一条链路从头串到尾，每一步都有明确的命令和截图。

这个手册的目标是：你按照顺序做完（或者让你的通用 Agent 根据文章内容做完），就能拥有一套部署好的 PowerMem 服务端，以及一个已经接好记忆层的 Claude Code 或 OpenClaw 客户端。

一、Linux 服务端：安装、配置、启动
1.1 环境要求
Python >= 3.11
pip 或 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 作用
cli pmem 命令行工具
server powermem-server HTTP API 服务器
mcp MCP 协议支持
seekdb 内嵌向量数据库（零配置，无需单独部署数据库）
1.3 初始化配置

交互式生成 .env 配置文件

pmem config init

也可手动创建 .env 文件。以下是我的配置：

DATABASE_PROVIDER=oceanbase

DATABASE_PROVIDER=sqlite
SQLITE_PATH=/root/data/package/powermem/powermem.db

LLM_PROVIDER=anthropic

LLM_PROVIDER=openai

ANTHROPIC_LLM_BASE_URL=https://token-plan-cn.xiaomimimo.com/anthropic

LLM_API_KEY=tp-xxx

LLM_MODEL=mimo-v2.5-pro

LLM_API_KEY=xxx
LLM_MODEL=step-3.7-flash
OPENAI_LLM_BASE_URL=https://api.stepfun.com/step_plan/v1
EMBEDDING_PROVIDER=siliconflow
EMBEDDING_API_KEY=sk-xx
EMBEDDING_MODEL=BAAI/bge-m3

OCEANBASE_EMBEDDING_MODEL_DIMS=1024

EMBEDDING_DIMS=1024

注意事项：

SQLITE_PATH 必须是完整的数据库文件路径（如 /root/data/powermem/powermem.db），不能只是文件夹路径
使用 seekdb 时，EMBEDDING_DIMS 或 OCEANBASE_EMBEDDING_MODEL_DIMS 是必填项，维度要和嵌入模型匹配
硅基流动的嵌入模型如果不走 seekdb，可以不配 EMBEDDING_DIMS
1.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_ENABLED=true
POWERMEM_SERVER_API_KEYS=your-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。