2026.03.28 北京workshop 「让Agent 记住你」实验手册

OB_SIG小助手 · 2026 年3 月 26 日 10:50

链接导航

环境准备：2026年3月28日，北京 Workshop 活动前环境准备

项目一：2026.03.28 北京workshop 「让Agent 记住你」

项目二：2026.03.28 北京workshop 「LazyLLM X PowerMem X Skills 」

1. 实验一：powermem 初体验

前置条件 ：本机需要 Python 3.10+（python3 --version 确认）。如果还没装：macOS 用 brew install python ，Linux 用系统包管理器，Windows 从 python.org 下载安装（安装时勾选 Add to PATH ）

安装 PowerMem（Python）
建议用虚拟环境，然后安装：

mkdir -p ~/workshop/powermem

python3 -m venv ~/workshop/powermem/.venv
source ~/workshop/powermem/.venv/bin/activate

pip install powermem

装好后执行 pmem --version ，能输出版本就行。

配置 PowerMem

在目录下 ~/workshop/powermem 新建 .env ，配置 LLM 和 Embedding（数据库二选一，默认是sqlite，如果大家已经部署好了oceanbase/seekdb，用oceanbase/seekdb效果更佳）：

选择一 ：数据库用sqlite

注意：替换your_api_key_here为实际的qwen LLM 的sk(workshop 当天提供)

mkdir -p ~/workshop/powermem && cd ~/workshop/powermem
cat > .env << 'EOF'
TIMEZONE=Asia/Shanghai

DATABASE_PROVIDER=sqlite

LLM_PROVIDER=qwen
LLM_API_KEY=your_api_key_here
LLM_MODEL=qwen-plus

EMBEDDING_PROVIDER=qwen
EMBEDDING_API_KEY=your_api_key_here
EMBEDDING_MODEL=text-embedding-v4
EMBEDDING_DIMS=1536

POWERMEM_SERVER_AUTH_ENABLED=false

EOF

选择二 ：数据库用oceanbase/seekdb

注意：替换your_api_key_here为实际的qwen LLM 的sk(workshop 当天提供)，替换your_*前缀的为实际的值

mkdir -p ~/workshop/powermem && cd ~/workshop/powermem
cat > .env << 'EOF'
TIMEZONE=Asia/Shanghai

DATABASE_PROVIDER=oceanbase

OCEANBASE_HOST=your_oceanbase_host
OCEANBASE_PORT=your_oceanbase_port
OCEANBASE_USER=your_oceanbase_user
OCEANBASE_PASSWORD=your_oceanbase_password
OCEANBASE_DATABASE=test
OCEANBASE_COLLECTION=memories

LLM_PROVIDER=qwen
LLM_API_KEY=your_api_key_here
LLM_MODEL=qwen-plus

EMBEDDING_PROVIDER=qwen
EMBEDDING_API_KEY=your_api_key_here
EMBEDDING_MODEL=text-embedding-v4
EMBEDDING_DIMS=1536

POWERMEM_SERVER_AUTH_ENABLED=false

EOF

然后命令行测试：

# 注意先切换目录回工作目录
cd ~/workshop/powermem

source ~/workshop/powermem/.venv/bin/activate

# Memory: add, search, list (with filters and pagination)
pmem memory add "User prefers dark mode" --user-id user123
pmem memory add "Meeting at 3pm Friday" -u user1 -a agent1 --no-infer
pmem memory search "user preferences" --user-id user123
pmem memory search "dark mode" -l 5 -t 0.3 -j
pmem memory list --user-id user123 -l 20 -o 0 --sort-by created_at --order desc
pmem memory get <请写真实的ID> --user-id user123
pmem memory update <请写真实的ID> "Updated content" -m '{"updated": true}'
pmem memory delete <请写真实的ID> --yes
pmem memory delete-all --user-id user123 --confirm

启动server端：

powermem-server --host 0.0.0.0 --port 8000

这时候启动后，同一服务提供：

所有记忆操作的 RESTful API 端点
Dashboard ：访问 http://localhost:8000/dashboard/
交互式 API 文档，访问 http://localhost:8000/docs
与 SDK 相同的配置（通过 .env 文件）

2. 实验二：让你的openclaw 拥有长期记忆

2.1. 安装并配置openclaw

2.1.1. 安装openclaw 并初始化

npm install -g openclaw@2026.03.13

# 如果慢可以使用淘宝镜像源
npm install -g openclaw@2026.03.13 --registry=https://registry.npmmirror.com

验证是否安装成功

openclaw --version

OpenClaw 2026.3.13 (61d171a)

安装指引

openclaw onboard --install-daemon

配置说明

配置项	配置说明	配置内容
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?	是否个人使用	Yes
Onboarding mode	Onboarding的模式	选择 “QuickStart”
Model/auth provider	配置AI大模型	选择 Custom Provider（自定义提供商）。
选择Skip for now
Filter models by provider	按提供商筛选模型	选择 “All providers”
Default model	默认模型	选择 Keep current
Select channel (QuickStart)	选择聊天频道	选择 Skip for now（稍后配置渠道）
Search provider	决定智能体在用 web_search 工具时，背后用哪一家服务来搜网页。	选择 Skip for now（稍后配置）
Configure skills now? (recommended)	配置Skills	选择 “No”，后续可以配置。
Enable hooks?	配置Hooks	按空格键选中，按回车键进入下一步
How do you want to hatch your bot?	用什么方式孵化你的机器人	选择 “Hatch in TUI”。

配置结束后，出现“ Wake up, my friend!” 。然后输入/exit命令退出。

2.1.2. 配置

直接修改配置文件~/.openclaw/openclaw.json ，找到对应的模块，没有的话直接加一个就行

模型相关的配置

  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "your_api_key_here",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen-plus",
            "name": "qwen-plus",
            "api": "openai-completions",
            "reasoning": false,
            "input": [
              "text",
              "image"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 1000000,
            "maxTokens": 65536
          }
        ]
      }
    }
  },

agent相关的配置

  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus"
      },
      "models": {
        "bailian/qwen3.5-plus": {}
      },
      "workspace": "/root/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },

2.2. 安装memory-powermem记忆插件

2.2.1. 一键安装(方式一)

当然你如果你想省事，你可以直接扔一个 Skill 链接，让小“龙虾”帮你搞定安装，此时你只需要喝着咖啡，稍等片刻即可：

参考这个链接: https://clawhub.ai/teingi/install-powermem-memory-minimal，帮我安装一下memory-powermem插件，并做一下记忆的测试

2.2.2. 手动安装(方式二)

注意：手动安装是需要先安装好powermem服务，参考上一章节的【实验一】，openclaw 接入powermem的时候，支持powermem的两种模式接入：http模式、cli(命令行模式)``

安装插件 memory-powermem

openclaw plugins install memory-powermem

安装后用 openclaw plugins list 确认 memory-powermem 存在。

修改配置

插件安装后自带一份配置（cli模式，连接 localhost:8000 ），如果你的 PowerMem 服务就跑在本机默认端口，这一步可以跳过 。

只有以下情况需要手动编辑 ~/.openclaw/openclaw.json ：

PowerMem 服务不在 localhost:8000 （改 baseUrl ）
想用 CLI 模式替代 HTTP 模式（改 mode ）
需要调整 autoRecall / autoCapture 等行为

配置生效优先级：~/.openclaw/openclaw.json > 插件内置默认值。

HTTP 模式示例：（先验证：curl -s http://localhost:8000/api/v1/system/health ）

{
  "plugins": {
    "slots": { "memory": "memory-powermem" },
    "entries": {
      "memory-powermem": {
        "enabled": true,
        "config": {
          "mode": "http",
          "baseUrl": "http://localhost:8000",
          "autoCapture": true,
          "autoRecall": true,
          "inferOnAdd": true
        }
      }
    }
  }
}

CLI 模式示例（不启 HTTP 服务，本机直接调用 pmem ）：

{
  "plugins": {
    "slots": { "memory": "memory-powermem" },
    "entries": {
      "memory-powermem": {
        "enabled": true,
        "config": {
          "mode": "http",
          "envFile": "用户目录(请记得替换为绝对路径)/.openclaw/powermem/.env",
          "pmemPath": "用户目录(请记得替换为绝对路径)/.openclaw/powermem/.venv/bin/pmem",
          "autoCapture": true,
          "autoRecall": true,
          "inferOnAdd": true
        }
      }
    }
  }
}

重启gateway 并验证新的记忆插件生效

重启 OpenClaw gateway，执行：

openclaw gateway restart

检测 memory-powermem 记忆插件健康情况

openclaw ltm health

无报错即表示插件已连通。可以再试一下写入和检索：

openclaw ltm add "一条测试记忆"
openclaw ltm search "测试"

如果检索能返回刚写入的内容，说明完整链路（PowerMem → 插件 → OpenClaw）已经通了。

2.2.3. 遇到问题？

openclaw ltm health 连不上 ：确认 PowerMem 服务在运行，curl http://localhost:8000/api/v1/system/health 能返回 JSON
插件不在列表里 ：openclaw plugins list 检查，确认执行过 openclaw plugins install memory-powermem
记忆写入了但检索不到 ：检查 .env 里 Embedding 配置是否正确（API Key、模型名）
更多排查 ：openclaw plugins doctor 可以诊断插件加载和配置问题

3. 小帖士

3.1. “卸载虾”

3.1.1. 最佳方案：官方一键卸载

如果你的 openclaw 命令还在，务必先用官方命令 ：

openclaw uninstall --all --yes --non-interactive

这条命令会依次：

停止 Gateway 服务
删除状态目录（~/.openclaw ）
卸载 npm 全局包

重要提醒 ：很多人犯的错误是先跑 npm uninstall -g openclaw ，这会导致 openclaw 命令消失，之后就无法运行官方的卸载命令了。正确的顺序是：先 openclaw uninstall ，再处理 npm 包 。

3.1.2. openclaw-uninstaller 的第三方工具

GitHub 上有一个叫 openclaw-uninstaller 的第三方工具（MIT 许可证，支持 Python 3.7+），它提供了一个非常贴心的功能——先存档，再告别 ：

pip install openclaw-uninstaller
openclaw-uninstall  # 或简写 ocu

它会在卸载前自动创建快照备份（支持 tar.gz 格式），重装后可以完全恢复配置和身份。如果你不确定将来是否还会回来，这是最稳妥的选择。

小贴士 ：备份内容包括 ~/.openclaw 主配置目录和 ~/.config/openclaw 配置缓存，但会自动排除日志和缓存文件以节省空间。

Tiki · 2026 年3 月 26 日 23:40

学习

杨门 · 2026 年3 月 26 日 23:59

学习了