帮你快速理解、总结文档立即下载

OpenClaw 接入 Memory 配置

最近更新时间:2026-09-01 15:06:22
我的收藏

概述

OpenClaw 是一款开源的 AI Agent 框架,使用标准的 OpenAI Chat Completions 协议与后端模型服务通信。通过将其模型接口指向 Memory 的 Proxy 服务,OpenClaw 即可获得团队记忆、技能与知识的注入能力。

前置条件

开始配置前,请确认已满足以下条件:
1. Memory Hub 已部署并可正常访问。
2. 已在 Memory Hub 的 API Key 页面获取以下两项信息:
客户端接入地址:找到 OpenClaw 对应的地址,单击复制。
User Key:以 sk-mem- 开头的密钥,用于身份认证。
3. 已安装 OpenClaw 客户端。

配置步骤

OpenClaw 的接入配置通过主目录下的 ~/.openclaw/config.yaml 文件完成,包含连接地址与密钥两项核心信息。
说明:
~ 表示当前登录用户的主目录,例如 Windows 下为 C:\\Users\\用户名,macOS / Linux 下为 /home/用户名/Users/用户名。首次使用需先创建该文件夹,例如执行 mkdir -p ~/.openclaw

步骤一:配置 config.yaml

编辑 ~/.openclaw/config.yaml,写入以下内容:
model:
# 接入地址,粘贴从 Memory Hub 复制的地址
baseURL: http://127.0.0.1:8096/openclaw/default

# User Key,粘贴从 Memory Hub 获取的密钥
apiKey: sk-mem-xxxxxxxxxxxxxxxx
上述参数的含义如下:
参数
作用
是否需要修改
baseURL
Memory 的接入地址
是,粘贴从 Memory Hub 复制的地址
apiKey
用于身份认证的 User Key
是,粘贴从 Memory Hub 获取的密钥
说明:
登录 Memory Hub,进入 API Key 页面,找到 DeepSeek Harness 对应的客户端接入地址与 User Key。

步骤二:设置文件权限

由于配置文件中包含密钥,建议限制文件访问权限:
chmod 700 ~/.openclaw
chmod 600 ~/.openclaw/config.yaml

启动并完成首次初始化

1. 启动 OpenClaw 客户端。
2. 在对话框中发送任意消息(例如 hi)。Proxy 会依次返回以下选择器(按钮形式):
是否关联团队资产(Associate team assets?):选择 Yes 注入团队上下文,选择 No 跳过。
选择团队(Team):仅存在一个团队时会自动跳过。
选择 Agent:在所选团队下选择 Agent。
选择任务(Task):首行是虚拟的 "No task" 条目。
3. 完成选择后,Agent 会进行自我介绍,并在后续每轮对话中自动注入以下上下文:会话上下文(<session_context>)、可用的技能列表(<available_skills>)与用户画像记忆(<tdai_profile_memory>)。
4. 初始化完成后,可在聊天中输入以下斜杠命令使用相关能力:
mem:help:查看记忆命令的帮助。
mem:sync:同步记忆。
mem:create-skill:创建技能。

常见问题

现象
可能原因
解决方法
启动后提示连接失败
Proxy 未启动或接入地址不正确
确认 Proxy 服务正常运行,检查 baseURL 是否与 Memory Hub 页面一致
发送消息后无选择器弹出
User Key 无效或过期
重新从 Memory Hub 复制 User Key,更新 config.yaml 中的 apiKey
配置文件修改后未生效
客户端未重新加载配置
完全退出并重新启动 OpenClaw