OpenClaw配置与自我进化技能安装的完整过程

目录

• 前言
• 第一部分：GitHub Token 配置与 Rate Limit 问题
• 1.1 为什么要配置 GitHub Token？
• 1.2 如何正确配置 GitHub Token
• 生成 Token 的正确姿势
• 重要安全提醒
• Windows 环境下的 Token 设置方法
• 1.3 备选方案：如果GH_TOKEN不生效
• 第二部分：OpenClaw 安装路径与目录结构
• 2.1 如何找到 OpenClaw 的安装位置
• 2.2 OpenClaw 的核心目录结构
• 2.3 常见错误：找不到.openclaw/openclaw.json
• 第三部分：安装 self-improving-agent 自我进化引擎
• 3.1 两种安装方式对比
• 3.2 git clone 手动安装步骤（Windows版）
• 3.3 如果没有安装 Git
• 第四部分：激活 self-improving-agent 技能
• 4.1 创建工作区记忆目录和文件
• 4.2 安装 Hooks（强烈推荐）
• 4.3 重启 Gateway 服务
• 第五部分：验证安装与使用指南
• 5.1 验证安装是否成功
• 5.2 自我进化机制详解
• 5.3 知识升级路径
• 5.4 最佳实践建议
• 第六部分：常见问题排查
• Q1：安装时提示 “Rate limit exceeded”
• Q2：找不到.openclaw/openclaw.json
• Q3：‘git’ 不是内部或外部命令
• Q4：技能安装后不工作
• 参考资料
• 结语

本文档记录了从零开始配置 OpenClaw，并成功安装 self-improving-agent（自我进化引擎）技能的完整过程。包含了踩过的坑、解决方案和最佳实践，希望能帮助其他 OpenClaw 用户少走弯路。

在使用 npx clawhub@latest install 安装技能时，可能会遇到以下错误：

✗ Rate limit exceeded
Error: Rate limit exceeded

这是因为 clawhub 工具需要从 GitHub 下载技能，而未认证的访客有严格的访问频率限制（60次/小时）。配置 GitHub Token 后，限制会提升到 5000次/小时。

1. 登录 GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)

2. 点击 Generate new token (classic)

3. 关键配置：

   • Note：起个易记的名字，如 clawhub-token
   • Expiration：推荐 90 天（更安全），不要选 “No expiration”
   • Scopes：必须勾选 repo 下的所有权限（确保 public_repo 也被选中）

4. 立即复制保存！生成的令牌（以 ghp_ 开头）关闭页面后就看不到了。

Token 泄露后必须立即撤销！

• 访问：https://github.com/settings/tokens
• 找到泄露的 Token，点击 Delete

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

有些工具读取的是 GH_TOKEN 而不是 GITHUB_TOKEN：

set GH_TOKEN=你的令牌 && npx clawhub@latest install self-improving-agent

# 查看 openclaw 命令所在位置
where openclaw

典型输出：

C:Users你的用户名AppDataRoamingnpmopenclaw
C:Users你的用户名AppDataRoamingnpmopenclaw.cmd

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                # 智能体状态目录

这是正常现象，说明 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

安装方式	优点	缺点	适用场景
clawhub 安装	自动处理依赖，简单	需要 GitHub Token，易遇 rate limit	网络顺畅，已配置 Token
git clone 手动安装	不受 rate limit 限制，可控	需手动配置路径	推荐！ 尤其适合新手

# 1. 进入技能目录（如果不存在则创建）
mkdir C:Users你的用户名.openclawskills
cd C:Users你的用户名.openclawskills
# 2. 克隆技能仓库
git clone https://github.com/pskoett/self-improving-agent.git
# 3. 验证安装成功
dir self-improving-agent
# 应该看到 SKILL.md, README.md 等文件

方案 A：安装 Git

• 下载地址：https://git-scm.com/download/win
• 安装后重新打开命令行

方案 B：直接下载 ZIP

1. 访问：https://github.com/pskoett/self-improving-agent
2. 点击 Code → Download ZIP
3. 解压到 C:Users你的用户名.openclawskillsself-improving-agent

这是最关键的一步，技能需要这些文件来记录"记忆"：

# 1. 进入工作区目录
cd C:Users你的用户名.openclawworkspace
# 2. 创建 .learnings 目录
mkdir .learnings
# 3. 创建三个核心日志文件
echo # Errors Log > .learningsERRORS.md
echo # Learnings Log > .learningsLEARNINGS.md
echo # Feature Requests Log > .learningsFEATURE_REQUESTS.md

Hooks 让技能能自动触发，无需手动干预：

# 1. 复制 hooks 到全局目录
xcopy /E C:Users你的用户名.openclawskillsself-improving-agenthooksopenclaw C:Users你的用户名.openclawhooksself-improvement
# 2. 启用 hook
openclaw hooks enable self-improvement

openclaw gateway restart

方法一：命令行验证

# 检查技能文件
dir C:Users你的用户名.openclawskillsself-improving-agentSKILL.md
# 检查记忆目录
dir C:Users你的用户名.openclawworkspace.learnings
# 检查 hook 是否启用
openclaw hooks list | findstr self-improvement

方法二：对话验证

在与 OpenClaw 的对话中输入：

“我刚安装了 self-improving-agent skill，请帮我确认一下配置是否正确。如果可以，尝试在 LEARNINGS.md 里记录一条测试学习，内容是’测试自我进化功能’。”

日志文件	记录内容	触发时机
ERRORS.md	命令执行失败、API调用异常	运行出错时自动记录
LEARNINGS.md	用户纠正、最佳实践、知识缺口	用户纠正或AI自省时
FEATURE_REQUESTS.md	用户请求但当前不支持的功能	能力不足时记录

记录的"记忆"可以手动"提拔"到永久配置：

.learnings/LEARNINGS.md  → 普适规则 → SOUL.md
                         工作流改进 → AGENTS.md
                         工具技巧 → TOOLS.md

1. 定期回顾：每周花几分钟查看 .learnings/ 下的文件，将有价值的内容"提拔"到核心配置
2. 安全第一：安装任何新技能前，先用 skill-vetter 扫描
3. 善用 Hook：强烈建议启用 Hook，这是实现"自动"进化的关键
4. 轻量化原则：同类功能二选一，避免技能冲突

原因：GitHub 未认证访问次数超限
解决：配置 GitHub Token 或改用 git clone 手动安装

原因：主配置文件未生成
解决：运行 openclaw onboard 或手动创建

原因：未安装 Git
解决：安装 Git 或直接下载 ZIP

原因：缺少记忆目录或未重启服务
解决：创建 .learnings 目录和三个日志文件，重启 gateway

• self-improving-agent 官方仓库：https://github.com/pskoett/self-improving-agent
• OpenClaw 官方文档：https://openclaw.ai
• ClawHub 技能市场：https://clawhub.ai

恭喜！至此，你已经完成了 OpenClaw 的配置，并成功安装了自我进化引擎。你的 AI 助手从此具备了"成长"的能力，会越用越懂你、越用越聪明！

到此这篇关于OpenClaw配置与自我进化技能安装的文章就介绍到这了,更多相关OpenClaw配置与自我进化技能内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！