大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



• 长期精选记忆（MEMORY.md）：存放稳定事实（如姓名、技术偏好、常用服务地址），需手动或通过Prompt维护，内容质量高但体量小；
• 每日日志（memory/YYYY-MM-DD.md）：自动记录当日操作、临时决策、踩坑过程，新会话启动时优先读取最近1-2天日志，提供当日工作上下文；
• 会话日志（sessions/*.jsonl）：以JSONL格式记录完整对话树（用户消息、工具调用、压缩摘要），可配置是否纳入记忆索引，平衡“完整历史”与“无噪声记忆”。

• 文本检索（BM25）：借助SQLite的FTS5虚拟表，对Markdown分块文本做全文索引，适合搜索错误码、变量名等“硬token”；
• 向量检索：若安装sqlite-vec，在SQLite内建向量虚拟表，按相似度匹配语义级“相似记忆”；
• 混合排序：向量分数与BM25分数按权重混合，兼顾语义相似度与关键词精准度。

• memory_search：按自然语言查询相关记忆片段，返回结构化结果；
• memory_get：按路径和行号精确读取Markdown内容，避免长文本占用上下文；
• 预压缩记忆冲刷：会话上下文接近模型上限时，自动将重要信息写入当日日志，减少信息损失。

• 记忆无筛选：无差别保存所有操作记录，冗余信息消耗大量token；
• 跨场景受限：每个Agent拥有独立记忆文件与索引，不同Agent、不同设备间无法共享记忆；
• 管理成本高：修改或删除记忆需手动编辑Markdown文件，缺乏工程化管理接口。

• 智能提取：自动从对话中抽取结构化事实，去重合并，避免记忆冗余；
• 跨场景共享：以userId组织记忆，支持跨会话、跨Agent、跨设备共享，同一用户的多场景记忆统一管理；
• 精细化管理：提供memory_store（写入）、memory_forget（删除）等接口，支持记忆审计与精准操作；
• 可扩展性强：支持云端托管与自托管，生产环境可对接火山引擎Mem0，获得企业级监控、权限管理能力。

• 阿里云账号：注册阿里云账号并完成实名认证，用于云服务器购买与百炼API开通；
• 阿里云百炼API密钥：访问登录阿里云百炼大模型服务平台，开通服务后创建Access Key ID和Access Key Secret（保存至加密记事本）；
• Mem0账号：注册Mem0账号（支持开源自托管或云端服务），获取API Key与服务地址；
• GitHub账号（可选）：用于验证Skill与插件源码安全性。

• 云端部署：阿里云服务器（推荐Ubuntu 22.04 LTS，2vCPU+4GiB内存+40GiB ESSD）；
• 本地部署：MacOS 12+/Linux（Ubuntu 22.04+）/Windows11（64位），建议内存≥4GB、可用空间≥10GB；
• 核心依赖：Node.js≥v22.0.0、Python≥3.9、SQLite（需支持FTS5扩展）；
• 网络要求：阿里云服务器优先选择中国香港地域（免ICP备案），本地设备确保网络通畅。

• 镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
• 实例：内存必须2GiB及以上。
• 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
• 时长：根据自己的需求及预算选择。

• 端口放通：需要放通对应端口的防火墙，单击一键放通即可。
• 配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
• 配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
• 访问控制页面：单击打开网站页面可进入OpenClaw对话页面。1. 服务器选购与基础配置

1. 服务器选购：
   

• 访问阿里云轻量应用服务器控制台，选择“Ubuntu 22.04 LTS”系统镜像；
• 核心配置：2vCPU+4GiB内存+40GiB ESSD+200Mbps带宽，地域选择中国香港（免备案），付费类型选“包年包月”；
• 提交订单后，等待实例状态变为“运行中”，记录公网IP、登录账号（默认root）与密码。

1. 端口放行与环境准备：
   bash
1. SSH登录服务器（替换为你的公网IP）
ssh root@你的服务器公网IP





   
   

2. 一键放行核心端口
sudo apt install ufw -y
sudo ufw allow 22/tcp # SSH连接端口
sudo ufw allow 18789/tcp # OpenClaw核心端口
sudo ufw allow 443/tcp # API调用与插件下载端口
sudo ufw enable
sudo ufw status # 显示“ALLOW”即为成功
3. 更新系统依赖并安装核心工具
sudo apt update && sudo apt upgrade -y
sudo apt install curl git npm python3-pip sqlite3 libsqlite3-dev -y
4. 升级Node.js至22.0.0（系统自带版本过低）
sudo npm install -g n && sudo n 22.0.0
5. 配置npm国内镜像，加速安装
npm config set registry https://registry.npmmirror.com
6. 安装sqlite-vec扩展（支持向量检索）
git clone https://github.com/asg017/sqlite-vec.git
cd sqlite-vec
make loadable
sudo cp dist/vec0.so /usr/lib/sqlite3/
# 2. OpenClaw安装与初始化























































bash # 1. 一键安装OpenClaw（官方脚本，自动适配环境） npm install -g openclaw@latest # 2. 初始化配置并安装守护进程（后台稳定运行） openclaw onboard –install-daemon # 交互配置步骤（新手直接按提示操作） # 1. 接受风险提示（输入Yes） # 2. 选择AI模型提供商：暂时选择“Custom Provider”（后续配置百炼API） # 3. 选择交互渠道：推荐Telegram或飞书（按需选择） # 4. 配置网关端口：默认18789（直接回车） # 5. 初始技能选择：输入“No”（后续安装核心插件与Skill） # 3. 生成访问令牌（登录控制台需用，复制保存） openclaw token generate # 4. 查看令牌并保存 cat ~/.openclaw/openclaw.json | grep ‘“token”’ | awk -F‘“’ ‘{print \(4}' # 5. 启动服务并设置开机自启 sudo systemctl enable openclaw sudo systemctl start openclaw
3. 部署验证

• 浏览器输入 http://服务器公网IP:18789/?token=你的Token，能正常进入对话界面即为部署成功；
• 命令行验证：curl http://localhost:18789/health，返回{"status":"healthy"}即为正常。

1. 坑1：Node.js版本过低→严格执行升级命令，确保版本≥22.0.0，若升级失败，执行npm cache clean --force后重试；
2. 坑2：sqlite-vec安装失败→确保已安装libsqlite3-dev依赖，克隆仓库时网络通畅，否则影响向量检索功能；
3. 坑3：端口未放行→18789、22、443三个端口必须放行，否则无法访问控制台与下载插件；
4. 坑4：内存不足导致服务崩溃→至少选择2GiB内存，运行5个以上技能+Mem0插件推荐4GiB，可在阿里云控制台弹性升级。

• 将C:\Users\你的用户名\.openclaw添加到Windows Defender排除列表，避免被误判为病毒；
• 若出现“权限不足”报错，执行icacls %USERPROFILE%\.openclaw /grant:r 你的用户名:(F)赋予完全控制权限。

访问方式：浏览器输入 http://localhost:18789/?token=你的Token，能正常进入对话界面即为成功。
2. MacOS部署（体验**，推荐）
系统要求：MacOS 12+（M系列/Intel芯片）、8GB+内存、10GB+可用空间
# 1. 打开终端（Cmd + Space输入“Terminal”） # 2. 安装Homebrew（国内用户用镜像加速） /bin/zsh -c "\)(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)” # 3. 安装核心依赖（Node.js 22、Python 3.9、Git、SQLite） brew install node@22 python@3.9 git sqlite3 # 4. 配置Node.js环境变量（确保全局可调用） echo ’export PATH=“/usr/local/opt/node@22/bin:$PATH”‘ >> ~/.zshrc source ~/.zshrc # 5. 安装sqlite-vec扩展 git clone https://github.com/asg017/sqlite-vec.git cd sqlite-vec make loadable sudo cp dist/vec0.so /usr/local/lib/sqlite3/ # 6. 一键安装OpenClaw npm install -g openclaw@latest # 7. 初始化配置并安装守护进程 openclaw onboard –install-daemon # 交互步骤： # 1. 接受风险提示（输入Yes） # 2. 选择交互渠道：推荐iMessage（苹果生态无缝联动） # 3. 暂时跳过模型配置 # 4. 保留默认端口18789 # 8. 启动服务（后台运行） nohup openclaw gateway start > ~/.openclaw/logs/gateway.log 2>&1 & # 9. 生成访问令牌 openclaw token generate
M系列芯片避坑：若安装失败，执行arch -arm64 brew install node@22，指定ARM架构安装依赖，避免Rosetta 2转译兼容性问题。
访问方式：浏览器输入 http://localhost:18789/?token=你的Token。
3. Linux部署（Ubuntu/Debian，稳定性强）
系统要求：Ubuntu 22.04+/Debian 11+、4GB+内存、10GB+可用空间
# 1. 更新系统依赖 sudo apt update && sudo apt upgrade -y # 2. 安装核心依赖 sudo apt install curl git npm python3-pip sqlite3 libsqlite3-dev -y # 3. 升级Node.js至22.0.0 sudo npm install -g n && sudo n 22.0.0 # 4. 配置npm国内镜像 npm config set registry https://registry.npmmirror.com # 5. 安装sqlite-vec扩展 git clone https://github.com/asg017/sqlite-vec.git cd sqlite-vec make loadable sudo cp dist/vec0.so /usr/lib/sqlite3/ # 6. 一键安装OpenClaw npm install -g openclaw@latest # 7. 初始化配置并安装守护进程 openclaw onboard –install-daemon # 8. 启动服务并设置开机自启 sudo systemctl enable openclaw sudo systemctl start openclaw # 9. 生成访问令牌 openclaw token generate
访问方式：浏览器输入 http://localhost:18789/?token=你的Token。
4. 本地部署通用避坑指南

1. 坑1：权限不足→Windows11以管理员身份运行PowerShell，Mac/Linux执行命令时添加sudo；
2. 坑2：Node.js版本过低→所有系统需确保Node.js≥22.0.0，执行node –version验证，低于此版本会导致安装失败；
3. 坑3：端口18789被占用→Windows11执行netstat -ano | findstr “18789”终止占用进程；Mac/Linux执行lsof -i:18789 | xargs kill -9；
4. 坑4：sqlite-vec扩展安装失败→Windows11可直接下载预编译版本放入SQLite扩展目录，Mac/Linux确保依赖库完整；
5. 坑5：Mac M系列芯片安装失败→用arch命令指定ARM架构安装依赖，或直接下载官方预编译包手动安装。

1. 登录阿里云官网，搜索“阿里云百炼”，进入百炼大模型控制台；
2. 点击“开通服务”，阅读并同意服务协议，新用户自动领取免费额度（可在“费用管理”中查看）；
3. 进入“密钥管理”页面，点击“创建Access Key”，完成身份验证（短信/扫码）后，生成Access Key ID和Access Key Secret；
4. 复制并保存密钥（仅创建时可完整查看Access Key Secret，丢失需重新创建）；
5. 开启“消费限额”（推荐）：进入“费用管理”→“消费限额”，设置每月最大消费额度，避免超额计费。

1. 登录OpenClaw控制台，输入测试指令：帮我生成一份2026年3月工作周报模板；
2. 若返回结构化的周报模板，说明API配置成功；
3. 命令行验证：openclaw cli -c “用Markdown格式列出3个高效办公技巧”，返回结构化回复即为配置无误。

（四）API配置避坑要点

1. 坑1：密钥复制错误→逐字符核对Access Key ID和Secret，避免多余空格或换行，区分两者切勿混淆；
2. 坑2：接口地址错误→国内部署必须使用https://dashscope.aliyuncs.com/compatible-mode/v1，海外部署需替换为国际版地址；
3. 坑3：免费额度耗尽→登录百炼控制台查看额度使用情况，新用户可领取90天免费额度，足够日常轻度使用；
4. 坑4：服务未重启→配置完成后必须重启OpenClaw服务，否则配置不生效；
5. 坑5：模型选择错误→免费额度仅支持qwen3.5等基础模型，选择qwen3-max会提示额度不足，复杂任务可临时切换，简单任务用基础模型节省额度。

四、Mem0插件安装配置（升级OpenClaw长期记忆）
openclaw-mem0-plugin以插件形式集成Mem0记忆服务，安装配置简单，支持云端托管与自托管两种模式，新手推荐先使用云端模式快速体验。
（一）Mem0插件安装（全环境通用）
# 1. 安装Mem0插件（从npm仓库获取） openclaw plugins install @xray2016/openclaw-mem0-plugin # 2. 验证插件安装（显示插件版本即为成功） openclaw plugins list | grep “openclaw-mem0-plugin”
（二）Mem0云端服务配置
1. Mem0账号与API Key获取

1. 访问Mem0官方平台（或火山引擎Mem0产品页），注册并登录账号；
2. 创建项目，自定义策略（用于记忆提取规则），推荐策略Prompt：你是一个用户基础信息的提取专家，要求从一段对话中提取用户的基本信息(包括姓名、年龄、性别、地域、职业、偏好等)，并按照指定格式返回。 示例： 输入对话： AI: 你好呀～最近过得怎么样？ 用户: 还行吧，我叫王小明，最近工作有点忙。 AI: 你好，小明！ 你是做什么工作的呀？ 用户: 我在互联网公司做后端开发，今年 28 岁了。 AI: 哇，程序员呀～那肯定经常加班吧？ 用户: 哈哈，是的，尤其在北京，竞争挺激烈的。 输出： {“facts”:[“年龄:28岁”,“姓名:王小明”,“职业:程序员”,“地域:北京”,“性别:男”]}
3. 项目创建完成后，获取API Key与服务地址（host）。

2. 配置OpenClaw启用插件
编辑OpenClaw配置文件（

/.openclaw/openclaw.json），添加插件配置：
{ “plugins”: { “entries”: { “openclaw-mem0-plugin”: { “enabled”: true, “config”: { “mode”: “platform”, // 云端模式 “apiKey”: “你的Mem0 API Key”, “userId”: “自定义用户ID（如openclaw-user-001）”, // 区分不同用户，实现记忆隔离 “host”: “Mem0服务地址” // 从Mem0控制台获取 } } } } }
3. 重启服务生效
# 阿里云/Linux sudo systemctl restart openclaw openclaw gateway restart # MacOS pkill -f openclaw && nohup openclaw gateway start > ~/.openclaw/logs/gateway.log 2>&1 & # Windows11（PowerShell） stop-process -name openclaw -force start /b openclaw gateway start > %USERPROFILE%.openclaw\logs\gateway.log 2>&1
（三）Mem0插件验证与使用
1. 记忆存储验证
在OpenClaw控制台发送个人信息对话，验证记忆是否自动存储：
指令：我叫林晓，28岁，是个性格开朗的女生，热爱生活，喜欢探索新鲜事物。平时工作认真，闲暇时爱旅行、摄影、阅读，也享受和朋友分享美食、聊天。新的一年，希望能继续努力，收获更多成长和快乐！

• 若返回“Stored: 1 new memory added. [ADD]”，说明记忆存储成功；
• 登录Mem0控制台，在“长期记忆检索”中可查看提取的结构化事实（如姓名、年龄、爱好）。

• memory_search：按自然语言查询相关记忆；
• memory_list：列出当前用户所有记忆；
• memory_store：显式写入记忆（支持长期/会话级）；
• memory_get：按ID精确读取记忆；
• memory_forget：删除指定记忆。

1. 坑1：API Key配置错误→逐字符核对API Key与服务地址，避免多余空格，配置后需重启服务；
2. 坑2：记忆提取不精准→优化Mem0项目策略Prompt，明确提取字段与格式，减少模糊表述；
3. 坑3：跨Agent记忆不共享→确保不同Agent使用相同的userId，记忆会自动统一管理；
4. 坑4：云端服务访问受限→阿里云部署选择中国香港地域，本地部署确保网络能访问Mem0服务；
5. 坑5：token消耗过高→关闭原生记忆的会话日志索引，仅保留Mem0的结构化记忆，减少冗余信息。

1. 策略精细化：在Mem0中按场景创建多套提取策略（如工作偏好、个人信息、项目配置），提升记忆提取精准度；
2. 记忆分层管理：长期记忆仅存储稳定事实（如常用账号、固定偏好），临时信息依赖会话记忆或每日日志，避免长期记忆冗余；
3. 定期清理冗余：每月执行openclaw mem0 list，删除过期、错误的记忆（如旧邮箱、已变更的偏好），保持记忆库整洁。

1. 敏感信息保护：避免在对话中泄露密码、API密钥等敏感信息，Mem0会自动提取所有结构化事实，存在泄露风险；
2. 权限管控：Mem0云端服务需妥善保管API Key，避免泄露导致他人访问你的记忆；自托管模式需配置访问控制，限制IP访问；
3. 日志审计：定期查看Mem0操作日志，监控记忆写入、删除记录，排查异常操作；
4. 数据备份：云端模式定期导出Mem0记忆数据，自托管模式备份Mem0数据库，避免数据丢失。

1. 插件安装失败，提示“plugin not found”
   

• 原因：插件包名错误或npm镜像未同步；
• 解决方案：使用官方包名@xray2016/openclaw-mem0-plugin，切换npm官方镜像（npm config set registry https://registry.npmjs.org）后重试。

1. 记忆存储无响应
   

• 原因：API Key错误、服务地址不可达、策略配置不当；
• 解决方案：① 核对API Key与服务地址；② 测试网络连通性（ping Mem0服务地址）；③ 简化策略Prompt，确保提取规则清晰。

1. Agent无法调用Mem0工具
   

• 原因：插件未启用或配置错误；
• 解决方案：① 检查配置文件中enabled为true；② 重启OpenClaw网关；③ 执行openclaw plugins list确认插件已加载。

1. 跨会话记忆无法召回
   

• 原因：userId不一致或scope设置错误；
• 解决方案：① 确保不同会话使用相同的userId；② 检索时指定–scope long-term，避免仅检索会话记忆。

1. 部署选择：阿里云适合长期运行，MacOS体验**，Windows11需注意权限与防火墙配置，Linux稳定性强；
2. API配置：阿里云百炼免费额度足够新手使用，核心是正确填写密钥、配置国内接口，重启服务生效；
3. 记忆升级：Mem0插件是原生记忆的理想替代，云端模式适合快速体验，自托管/火山引擎版适合生产环境；
4. 优化关键：精细化配置Mem0提取策略，分层管理记忆，定期清理冗余，平衡记忆完整性与token消耗；
5. 安全第一：保护API Key与敏感信息，定期审计日志与备份数据，避免记忆泄露。

通过本文的流程与技巧，新手可在1-2小时内完成从部署、API配置到记忆升级的全流程，让OpenClaw从“无差别记忆”进化为“精准长期记忆”，真正成为能记住偏好、适配习惯的专属智能助手。