“同一个错误犯三次”“纠正过的知识点转头就忘”“项目规范要反复强调”——这是很多OpenClaw(昵称“小龙虾”)用户的共同痛点。作为开源AI代理框架,OpenClaw虽能高效执行编码、自动化等任务,但原生缺乏长期记忆能力,导致相同问题反复出现,既浪费时间又影响体验。

2026年,开发者@pskoett推出的self-improving-agent技能,彻底解决了这一难题。这款被称为“神级技能”的插件,让OpenClaw拥有了“长记性”和“自我迭代”能力——通过记录错误、学习经验、提炼规则,持续优化行为模式,越用越贴合用户的项目风格与使用习惯。本文基于参考文章的实战体验,补充2026年新手零基础全平台部署流程(阿里云+Windows11/MacOS/Linux本地)、阿里云百炼免费大模型API配置步骤,深度拆解self-improving-agent的安装、核心逻辑、实战场景及常见问题解答,所有代码命令可直接复制执行,助力用户解锁“会成长的AI代理”。阿里云上OpenClaw极速一键部署最简单,步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。




一、核心认知:self-improving-agent的核心价值与工作逻辑
(一)技能定位:给AI装一个“可迭代的记忆大脑”
self-improving-agent的核心价值在于构建“错误记录-经验学习-规则沉淀”的闭环,让OpenClaw从“单次执行工具”升级为“持续成长的协作伙伴”,解决三大核心痛点:
- 避免重复踩坑:记录工具报错、操作失误,下次遇到相同场景自动规避;
- 固化项目规范:将代码风格、工具使用习惯、协作规则永久保存,无需反复强调;
- 实现自我迭代:通过“提拔”机制将零散经验提炼为通用规则,持续优化执行效率。
| 特性 | 原生OpenClaw | OpenClaw+self-improving-agent |
|---|---|---|
| 记忆能力 | 会话内短期记忆,重启丢失 | 长期持久化记忆,跨会话复用 |
| 错误处理 | 单次提醒,重复触发 | 记录错误原因与解决方案,自动规避 |
| 项目适配性 | 通用执行,需反复调整 | 持续学习项目规范,越用越贴合 |
| 经验沉淀 | 无主动沉淀机制 | 自动记录+手动提拔,形成专属知识库 |
(二)核心工作逻辑:“记录-提炼-应用”三闭环
self-improving-agent的工作流程简单清晰,可概括为三个核心环节,全程本地文件存储,安全可控:
- 实时记录openclaw skills 教程(Record):当出现以下场景时,自动或引导用户记录关键信息至对应Markdown文件:
- 工具调用报错、命令执行失败→记录至
ERRORS.md(含报错信息、解决方案、复现次数); - 用户纠正AI操作、补充知识点→记录至
LEARNINGS.md(含正确做法、适用场景、优先级); - 用户提出功能需求、优化建议→记录至
FEATURE_REQUESTS.md(含需求描述、紧急程度、关联场景); - 发现知识过时、最佳实践更新→记录至
LEARNINGS.md。
- 经验提炼(Promote):当某条记录被验证为“非一次性、广泛适用”时,手动或自动提炼为通用规则,写入项目核心配置文件:
CLAUDE.md:存储项目事实、技术约定、知识盲区(如“包管理器仅用pnpm”);AGENTS.md:定义多Agent协作规则、工作流模式(如“API变更后需执行生成命令”);SOUL.md:明确AI行为风格、执行原则(如“编码优先,不啰嗦”);TOOLS.md:记录工具使用坑点、正确用法(如“Docker部署需映射3000端口”)。
- 自动应用(Apply):每次启动会话或执行任务前,OpenClaw会自动加载核心配置文件与记忆库,在执行过程中规避已知错误、遵循既定规则,无需用户额外提醒。
(三)部署方案选型对比(2026新手适配版)
结合self-improving-agent的记忆持久化需求,OpenClaw的双部署方案适配性如下:
| 部署方案 | 核心优势 | 适用场景 | 配置要求 | 维护成本 | 技能适配性 |
|---|---|---|---|---|---|
| 阿里云部署 | 记忆文件云端存储、多设备同步、7×24小时运行 | 团队协作、长期项目开发、多设备访问 | 最低2vCPU+2GiB内存+40GiB ESSD | 低(阿里云自带运维,数据自动备份) | 完美适配,团队成员可共享记忆库与规则 |
| 本地部署(Win11/MacOS/Linux) | 零服务器费用、数据本地存储、隐私可控 | 个人开发、短期项目、隐私敏感场景 | 设备内存≥4GiB,需安装Node.js 22.x+ | 中(需自行备份记忆文件) | 支持所有核心功能,记忆库本地访问速度更快 |
- 账号准备:注册阿里云账号 并完成实名认证(用于服务器购买与百炼API开通);
- 工具准备:远程连接工具(FinalShell,用于阿里云操作)、文本编辑器(VS Code/记事本,编辑记忆文件)、Git(技能安装必需)、Chrome浏览器;
- 核心认知:OpenClaw依赖Node.js 22.x及以上版本;self-improving-agent仅在本地读写文件,不联网、不获取敏感凭证,安全性高;记忆文件需定期备份,避免设备故障导致数据丢失。
二、2026新手零基础全平台部署流程(OpenClaw核心部署)
(一)方案一:本地全平台部署(Win11/MacOS/Linux,免费首选)
1. 前置依赖安装(Node.js+Git,全系统适配)
(1)Windows11系统(管理员模式操作)
# 安装Node.js 22.x(国内镜像加速,避免超时) iwr -useb https://npmmirror.com/mirrors/node/v22.10.0/node-v22.10.0-x64.msi -OutFile node-install.msi Start-Process .\node-install.msi -Wait # 安装Git winget install Git.Git # 配置npm国内镜像(解决技能安装超时) npm config set registry https://registry.npmmirror.com # 验证安装 node –version # 需显示v22.x.x git –version # 需显示2.40.x及以上
(2)MacOS 12+系统
# 安装Homebrew(已安装可跳过) /bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)” # 安装Node.js、Git并配置环境变量 brew install node@22 git echo ‘export PATH=”/usr/local/opt/node@22/bin:$PATH”‘ >> ~/.zshrc source ~/.zshrc # 配置npm国内镜像 npm config set registry https://registry.npmmirror.com # 验证安装 node –version && git –version
(3)Linux(Ubuntu 20.04+系统)
# 安装Node.js 22.x curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash sudo apt install -y nodejs git # 配置npm国内镜像 npm config set registry https://registry.npmmirror.com # 解决权限问题 sudo chmod -R 777 /usr/local/lib/node_modules # 验证安装 node –version && git –version
2. OpenClaw核心安装与初始化
# 全局安装OpenClaw(最新稳定版) npm install -g openclaw@latest # 创建工作目录(含技能、记忆文件夹) mkdir -p ~/OpenClaw-Workspace/{skills,.learnings} && cd ~/OpenClaw-Workspace # 初始化配置 openclaw init # 启动Gateway服务 openclaw gateway start # 验证服务(浏览器访问http://localhost:18789)
(二)方案二:阿里云部署(团队/长期项目首选)
新手零基础阿里云上部署OpenClaw喂饭级步骤流程
第一步:打开访问阿里云OpenClaw一键部署专题页面,找到并点击【一键购买并部署】。





第二步:打开选购阿里云轻量应用服务器,配置参考如下:
- 镜像:OpenClaw(Moltbot)镜像(已经购买服务器的用户可以重置系统重新选择镜像)
- 实例:内存必须2GiB及以上。
- 地域:默认美国(弗吉尼亚),目前中国内地域(除香港)的轻量应用服务器,联网搜索功能受限。
- 时长:根据自己的需求及预算选择。



第三步:打开访问阿里云百炼大模型控制台,找到密钥管理,单击创建API-Key。

前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。

- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
- 配置OpenClaw:单击执行命令,生成访问OpenClaw的Token。
- 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。
- 访问阿里云轻量应用服务器控制台,创建实例:
- 地域选择:中国香港、新加坡(免备案,网络通畅);
- 镜像选择:Alibaba Cloud Linux 3.2104 LTS 64位;
- 实例规格:2vCPU+2GiB内存+40GiB ESSD+3Mbps带宽(个人足够,团队可选4vCPU);
- 付费类型:按需付费(测试)/ 包年包月(长期);
- 登录密码:设置强密码,妥善保存。
- 端口放行:进入实例详情页→“防火墙”→“添加规则”,放行22(远程连接)、18789(控制台)、443(API通信)端口。
2. 依赖安装与OpenClaw部署
# 远程连接服务器后执行 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash sudo apt install -y nodejs git npm config set registry https://registry.npmmirror.com npm install -g openclaw@latest # 创建工作目录 mkdir -p /data/openclaw/{skills,.learnings} && cd /data/openclaw openclaw init # 启动服务并设置开机自启 openclaw gateway start echo “openclaw gateway start” >> /etc/rc.d/rc.local chmod +x /etc/rc.d/rc.local
3. 部署验证
浏览器输入“http://服务器公网IP:18789”,能打开OpenClaw控制台即为成功。
三、self-improving-agent技能安装与配置(核心步骤)
(一)技能安装(三种方式,任选其一)
方式1:命令行一键安装(推荐,全平台通用)
# 安装clawhub工具(技能管理必备) npm install -g clawhub # 一键安装self-improving-agent技能 clawhub install self-improving-agent
方式2:Git手动安装(适合网络受限场景)
# 克隆技能源码到OpenClaw技能目录 git clone https://github.com/peterskoett/self-improving-agent.git ~/.openclaw/skills/self-improving-agent # 阿里云部署克隆路径 git clone https://github.com/peterskoett/self-improving-agent.git /data/openclaw/skills/self-improving-agent
方式3:本地文件安装(适合无网络场景)
- 下载技能压缩包(参考文章提供的获取方式);
- 解压至技能目录:# 本地部署 unzip self-improving-agent.zip -d ~/.openclaw/skills/self-improving-agent # 阿里云部署 unzip self-improving-agent.zip -d /data/openclaw/skills/self-improving-agent
(二)创建记忆文件(必需步骤)
技能需通过Markdown文件存储记忆,需手动创建核心文件,全平台通用:
# 本地部署:创建记忆文件夹与核心文件 mkdir -p ~/.openclaw/workspace/.learnings cd ~/.openclaw/workspace/.learnings # 创建错误记录文件 touch ERRORS.md # 创建经验学习文件 touch LEARNINGS.md # 创建功能需求文件 touch FEATURE_REQUESTS.md # 阿里云部署:创建记忆文件夹与核心文件 mkdir -p /data/openclaw/.learnings cd /data/openclaw/.learnings touch ERRORS.md LEARNINGS.md FEATURE_REQUESTS.md
(三)启用会话钩子(推荐,自动提醒记录)
启用后,每次启动OpenClaw会话时,技能会自动提醒用户记录经验或错误,避免遗漏:
# 启用self-improvement钩子 openclaw hooks enable self-improvement # 重启服务生效 openclaw gateway restart


(四)阿里云百炼免费API配置(驱动技能运行)
self-improving-agent需依赖大模型实现错误识别、经验提炼,阿里云百炼提供7000万Token免费额度(90天有效期),足够日常使用:
- 获取百炼API-Key:
- 访问阿里云轻量应用服务器控制台,进入“密钥管理”页面;
- 点击“创建API-Key”,复制生成的密钥(仅显示一次);
- 进入“额度管理”,领取7000万Token免费额度。
- 配置OpenClaw关联API:# 进入配置目录 cd ~/.openclaw # 编辑配置文件(Win11用notepad,Mac/Linux用nano) nano config.yaml
粘贴以下配置(替换为你的API-Key):model: provider: alibaba-cloud apiKey: “你的百炼API-Key” baseUrl: “https://dashscope.aliyuncs.com/compatible-mode/v1” defaultModel: “bailian/qwen3.5-turbo” parameters: temperature: 0.7 # 平衡创造性与准确性 maxTokens: 4096 # 足够处理长文本记忆提炼 skills: autoLoad: true enabled: [“self-improving-agent”] selfImprovement: enabled: true memoryPath: “~/.openclaw/workspace/.learnings” # 记忆文件存储路径 autoRecord: true # 自动记录错误与学习经验 promoteReminder: true # 定期提醒提炼规则 security: skillScan: true - 重启服务生效:# 本地部署 openclaw gateway restart # 阿里云部署 openclaw gateway restart
四、技能实战场景(从记录到提炼,全流程演示)
以下通过3个真实开发场景,演示self-improving-agent的“记录-提炼-应用”全流程,新手可直接复刻:
(一)场景1:工具报错记录与解决方案沉淀
实战过程
- 执行错误命令:使用npm安装pnpm工作空间依赖,导致锁文件冲突:openclaw chat “执行npm install安装项目依赖”
- 技能自动记录:终端提示“锁文件冲突”报错后,self-improving-agent自动将错误信息记录至
ERRORS.md,格式如下:# ERRORS.md 错误ID:ERR-001 – 报错信息:pnpm-lock.yaml与package-lock.json冲突,无法安装依赖 – 触发命令:npm install – 解决方案:删除package-lock.json,使用pnpm install安装依赖 – 复现次数:1(Recurrence-Count: 1) – 标签:[“依赖安装”, “包管理器”, “锁文件冲突”] – 记录时间:2026-03-10 14:30:00 - 手动纠正与学习记录:用户发送纠正指令,技能记录至
LEARNINGS.md:openclaw chat “不对,这个项目用的是pnpm workspaces,不能用npm install,必须用pnpm install”LEARNINGS.md新增内容:# LEARNINGS.md 学习ID:LEARN-001 – 核心知识点:pnpm workspaces项目需使用pnpm install安装依赖,禁止使用npm install – 适用场景:所有pnpm工作空间项目 – 错误原因:npm与pnpm锁文件不兼容 – 优先级:高(Priority: High) – 记录时间:2026-03-10 14:35:00 - 经验提炼(Promote):确认该规则通用后,提炼至
CLAUDE.md:openclaw chat “将LEARN-001提炼为通用规则,写入CLAUDE.md”CLAUDE.md新增内容:# CLAUDE.md 项目技术约定 – 包管理器:所有项目统一使用pnpm,禁止使用npm install或yarn install,避免锁文件冲突; – 依赖安装命令:pnpm install(安装依赖)、pnpm add <包名>(新增依赖)。 - 自动应用:后续用户再发送“npm install”指令时,OpenClaw会自动提示“该项目需使用pnpm install,是否执行正确命令?”,避免重复报错。
(二)场景2:项目规范固化与多Agent协作规则
实战过程
- 问题触发:API接口变更后,AI未重新生成TS类型文件,导致运行时类型错误;
- 记录与纠正:用户提醒后,技能记录至
LEARNINGS.md,并提炼至AGENTS.md:openclaw chat “API变更后必须执行pnpm run generate:api && pnpm tsc –noEmit,重新生成TS client并校验类型,把这个规则写入AGENTS.md”AGENTS.md新增内容:# AGENTS.md 多Agent协作规则 – API变更后流程:编码Agent修改接口后,自动触发工具执行pnpm run generate:api(生成TS类型)和pnpm tsc –noEmit(类型校验),无错误后再提交代码; – 协作提醒:审核Agent需检查编码Agent是否执行上述命令,未执行则驳回提交。 - 应用效果:后续API变更时,编码Agent会自动执行生成与校验命令,无需用户手动提醒,类型错误发生率降至0。
(三)场景3:AI行为风格定义(SOUL.md优化)
实战过程
- 用户需求:希望AI编码时“先给代码,再做解释,不啰嗦”,且不打断YOLO模式下的编码流程;
- 直接写入SOUL.md:openclaw chat “将以下规则写入SOUL.md:1. 编码任务优先输出代码,再补充简要解释,避免冗长表述;2. 除非紧急情况,永远不打断YOLO模式下的coding agent,确保编码连贯性。”
- 应用效果:AI后续执行编码任务时,会严格遵循“代码优先”原则,且不会在YOLO模式中途插入无关提醒,符合用户使用习惯。
五、常见问题解答(FAQ,技能使用避坑关键)
(一)技能安装与配置问题
- 问题1:安装技能后,提示“找不到记忆文件夹”?
解决方案:确认已创建.learnings文件夹并新建三大核心文件(ERRORS.md/LEARNINGS.md/FEATURE_REQUESTS.md);检查配置文件中memoryPath路径是否正确,本地部署默认~/.openclaw/workspace/.learnings,阿里云部署为/data/openclaw/.learnings。 - 问题2:启用钩子后,无自动提醒记录?
解决方案:执行openclaw hooks list确认self-improvement钩子状态为“enabled”;若未启用,重新执行openclaw hooks enable self-improvement;重启OpenClaw服务后重试。 - 问题3:Git克隆技能失败?
解决方案:网络受限场景改用命令行一键安装(clawhub install self-improving-agent)或本地文件安装;国内用户可配置Git国内镜像:git config --global url."https://github.com/".insteadOf :。
- 问题1:如何手动编辑记忆文件与规则?
解决方案:直接用文本编辑器打开.learnings目录下的Markdown文件或核心配置文件(CLAUDE.md等),按现有格式新增/修改内容;编辑后无需重启服务,下次会话自动加载。 - 问题2:想删除无用的记忆或规则?
解决方案:直接删除Markdown文件中对应的条目;核心配置文件(如CLAUDE.md)中无用规则可直接删除,保存后即时生效。 - 问题3:技能是否会记录敏感信息?
解决方案:技能仅记录用户明确输入的指令、报错信息与纠正内容,不主动抓取密码、密钥等敏感信息;提炼规则前建议手动审核,避免误将敏感信息写入核心配置文件。
- 问题1:百炼API调用提示“额度不足”?
解决方案:进入百炼控制台领取免费额度;减少高频无效调用,记忆提炼等轻量任务可降低maxTokens至2048;避免重复触发相同记录操作。 - 问题2:技能生效后,OpenClaw响应变慢?
解决方案:关闭不必要的自动记录功能,执行openclaw config set selfImprovement.autoRecord false,改为手动触发记录;定期清理.learnings文件夹中重复或无效的记录,减少文件读取耗时。 - 问题3:阿里云部署后,团队成员如何共享记忆库?
解决方案:将.learnings文件夹与核心配置文件(CLAUDE.md等)同步至阿里云OSS,配置文件中添加OSS路径:
selfImprovement: memoryPath: “oss://你的OSS桶名/openclaw/.learnings” storage: oss: enabled: true accessKeyId: “你的OSS AccessKeyId” accessKeySecret: “你的OSS AccessKeySecret” endpoint: “http://oss-cn-hongkong.aliyuncs.com“
团队成员通过权限配置访问OSS,实现记忆库共享。
六、总结
self-improving-agent技能的核心价值,是给OpenClaw装上了“可成长的记忆大脑”——通过记录错误、沉淀经验、固化规则,让AI从“单次执行工具”升级为“越用越聪明的协作伙伴”,彻底解决了AI“失忆”“重复踩坑”的痛点。无论是个人开发还是团队协作,这款技能都能显著降低沟通成本、提升执行效率。
本文基于参考文章的实战体验,补充了2026年全平台部署流程、阿里云百炼API配置、三大实战场景及核心问题解答,所有代码可直接复制执行,新手无需技术背景也能快速上手。建议按以下步骤推进:
- 部署:根据需求选择本地或阿里云部署,确保OpenClaw服务正常运行;
- 安装:通过命令行一键安装技能,创建记忆文件并启用钩子;
- 实战:从日常开发场景入手,让技能自动记录错误与经验,定期提炼为通用规则;
- 优化:根据使用习惯持续完善核心配置文件,清理无用记忆,确保技能高效运行。
随着使用深入,你会发现OpenClaw对项目规范、工具链、个人习惯的理解越来越精准,相同问题的重复发生率大幅降低,真正成为“量身定制的AI代理”。建议开发者、团队尽早安装体验,让AI在持续学习中为你节省更多时间与精力。
发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/251722.html原文链接:https://javaforall.net
