OpenClaw配置与自我进化技能安装的完整过程
逍遥子_
前言
本文档记录了从零开始配置 OpenClaw,并成功安装 self-improving-agent(自我进化引擎)技能的完整过程。包含了踩过的坑、解决方案和最佳实践,希望能帮助其他 OpenClaw 用户少走弯路。
第一部分:GitHub Token 配置与 Rate Limit 问题
1.1 为什么要配置 GitHub Token?
在使用 npx clawhub@latest install 安装技能时,可能会遇到以下错误:
✗ Rate limit exceeded Error: Rate limit exceeded
这是因为 clawhub 工具需要从 GitHub 下载技能,而未认证的访客有严格的访问频率限制(60次/小时)。配置 GitHub Token 后,限制会提升到 5000次/小时。
1.2 如何正确配置 GitHub Token
生成 Token 的正确姿势
登录 GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
点击 Generate new token (classic)
关键配置:
- Note:起个易记的名字,如
clawhub-token - Expiration:推荐 90 天(更安全),不要选 “No expiration”
- Scopes:必须勾选 repo 下的所有权限(确保
public_repo也被选中)
- Note:起个易记的名字,如
立即复制保存!生成的令牌(以
ghp_开头)关闭页面后就看不到了。
重要安全提醒
Token 泄露后必须立即撤销!
- 访问:https://github.com/settings/tokens
- 找到泄露的 Token,点击 Delete
Windows 环境下的 Token 设置方法
CMD(命令提示符)正确语法:
set GITHUB_TOKEN=你的令牌 && npx clawhub@latest install self-improving-agent
常见错误用法:
# ❌ 错误 - 在 CMD 中不能用空格 GITHUB_TOKEN="token" npx ... # ❌ 错误 - & 会导致并行执行 set TOKEN=xxx & npx ... # ✅ 正确 - 使用 && 确保顺序执行 set TOKEN=xxx && npx ...
PowerShell 语法:
$env:GITHUB_TOKEN="你的令牌"; npx clawhub@latest install self-improving-agent
1.3 备选方案:如果GH_TOKEN不生效
有些工具读取的是 GH_TOKEN 而不是 GITHUB_TOKEN:
set GH_TOKEN=你的令牌 && npx clawhub@latest install self-improving-agent
第二部分:OpenClaw 安装路径与目录结构
2.1 如何找到 OpenClaw 的安装位置
# 查看 openclaw 命令所在位置 where openclaw
典型输出:
C:\Users\你的用户名\AppData\Roaming\npm\openclaw C:\Users\你的用户名\AppData\Roaming\npm\openclaw.cmd
2.2 OpenClaw 的核心目录结构
C:\Users\你的用户名\.openclaw\ ├── openclaw.json # 主配置文件(核心!) ├── workspace\ # 工作区(AI的"灵魂"文件夹) │ ├── SOUL.md # AI人格设定 │ ├── USER.md # 用户个人信息 │ └── .learnings\ # 自我进化引擎的记忆目录 │ ├── ERRORS.md # 错误记录 │ ├── LEARNINGS.md # 学习成果记录 │ └── FEATURE_REQUESTS.md # 功能请求记录 ├── skills\ # 技能安装目录 │ └── self-improving-agent\ # 自我进化技能 └── agents\ # 智能体状态目录
2.3 常见错误:找不到.openclaw/openclaw.json
这是正常现象,说明 OpenClaw 已找到配置目录,但主配置文件尚未生成。
解决方案:
# 方法一:运行初始化向导(推荐)
openclaw onboard
# 方法二:手动创建最小配置
cd C:\Users\你的用户名\.openclaw
echo { > openclaw.json
echo "gateway": { >> openclaw.json
echo "mode": "local", >> openclaw.json
echo "port": 18789, >> openclaw.json
echo "bind": "127.0.0.1" >> openclaw.json
echo }, >> openclaw.json
echo "agent": { >> openclaw.json
echo "workspace": "C:/Users/你的用户名/.openclaw/workspace" >> openclaw.json
echo } >> openclaw.json
echo } >> openclaw.json第三部分:安装 self-improving-agent 自我进化引擎
3.1 两种安装方式对比
| 安装方式 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| clawhub 安装 | 自动处理依赖,简单 | 需要 GitHub Token,易遇 rate limit | 网络顺畅,已配置 Token |
| git clone 手动安装 | 不受 rate limit 限制,可控 | 需手动配置路径 | 推荐! 尤其适合新手 |
3.2 git clone 手动安装步骤(Windows版)
# 1. 进入技能目录(如果不存在则创建) mkdir C:\Users\你的用户名\.openclaw\skills\ cd C:\Users\你的用户名\.openclaw\skills\ # 2. 克隆技能仓库 git clone https://github.com/pskoett/self-improving-agent.git # 3. 验证安装成功 dir self-improving-agent # 应该看到 SKILL.md, README.md 等文件
3.3 如果没有安装 Git
方案 A:安装 Git
- 下载地址:https://git-scm.com/download/win
- 安装后重新打开命令行
方案 B:直接下载 ZIP
- 访问:https://github.com/pskoett/self-improving-agent
- 点击 Code → Download ZIP
- 解压到
C:\Users\你的用户名\.openclaw\skills\self-improving-agent\
第四部分:激活 self-improving-agent 技能
4.1 创建工作区记忆目录和文件
这是最关键的一步,技能需要这些文件来记录"记忆":
# 1. 进入工作区目录 cd C:\Users\你的用户名\.openclaw\workspace\ # 2. 创建 .learnings 目录 mkdir .learnings # 3. 创建三个核心日志文件 echo # Errors Log > .learnings\ERRORS.md echo # Learnings Log > .learnings\LEARNINGS.md echo # Feature Requests Log > .learnings\FEATURE_REQUESTS.md
4.2 安装 Hooks(强烈推荐)
Hooks 让技能能自动触发,无需手动干预:
# 1. 复制 hooks 到全局目录 xcopy /E C:\Users\你的用户名\.openclaw\skills\self-improving-agent\hooks\openclaw C:\Users\你的用户名\.openclaw\hooks\self-improvement\ # 2. 启用 hook openclaw hooks enable self-improvement
4.3 重启 Gateway 服务
openclaw gateway restart
第五部分:验证安装与使用指南
5.1 验证安装是否成功
方法一:命令行验证
# 检查技能文件 dir C:\Users\你的用户名\.openclaw\skills\self-improving-agent\SKILL.md # 检查记忆目录 dir C:\Users\你的用户名\.openclaw\workspace\.learnings\ # 检查 hook 是否启用 openclaw hooks list | findstr self-improvement
方法二:对话验证
在与 OpenClaw 的对话中输入:
“我刚安装了 self-improving-agent skill,请帮我确认一下配置是否正确。如果可以,尝试在 LEARNINGS.md 里记录一条测试学习,内容是’测试自我进化功能’。”
5.2 自我进化机制详解
| 日志文件 | 记录内容 | 触发时机 |
|---|---|---|
| ERRORS.md | 命令执行失败、API调用异常 | 运行出错时自动记录 |
| LEARNINGS.md | 用户纠正、最佳实践、知识缺口 | 用户纠正或AI自省时 |
| FEATURE_REQUESTS.md | 用户请求但当前不支持的功能 | 能力不足时记录 |
5.3 知识升级路径
记录的"记忆"可以手动"提拔"到永久配置:
.learnings/LEARNINGS.md → 普适规则 → SOUL.md
工作流改进 → AGENTS.md
工具技巧 → TOOLS.md5.4 最佳实践建议
- 定期回顾:每周花几分钟查看
.learnings/下的文件,将有价值的内容"提拔"到核心配置 - 安全第一:安装任何新技能前,先用
skill-vetter扫描 - 善用 Hook:强烈建议启用 Hook,这是实现"自动"进化的关键
- 轻量化原则:同类功能二选一,避免技能冲突
第六部分:常见问题排查
Q1:安装时提示 “Rate limit exceeded”
原因:GitHub 未认证访问次数超限
解决:配置 GitHub Token 或改用 git clone 手动安装
Q2:找不到.openclaw/openclaw.json
原因:主配置文件未生成
解决:运行 openclaw onboard 或手动创建
Q3:‘git’ 不是内部或外部命令
原因:未安装 Git
解决:安装 Git 或直接下载 ZIP
Q4:技能安装后不工作
原因:缺少记忆目录或未重启服务
解决:创建 .learnings 目录和三个日志文件,重启 gateway
参考资料
- self-improving-agent 官方仓库:https://github.com/pskoett/self-improving-agent
- OpenClaw 官方文档:https://openclaw.ai
- ClawHub 技能市场:https://clawhub.ai
结语
恭喜!至此,你已经完成了 OpenClaw 的配置,并成功安装了自我进化引擎。你的 AI 助手从此具备了"成长"的能力,会越用越懂你、越用越聪明!
到此这篇关于OpenClaw配置与自我进化技能安装的文章就介绍到这了,更多相关OpenClaw配置与自我进化技能内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!
