概述
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 ~/.openclawchmod 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 |