OpenClaw配置与自我进化技能安装全攻略

OpenClaw 配置与自我进化技能安装全攻略

📝 前言

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

第一部分：GitHub Token 配置与 Rate Limit 问题

🔑 1.1 为什么要配置 GitHub Token？

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

1 ✗ Rate limit exceeded

2 Error: Rate limit exceeded

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

🚀 1.2 如何正确配置 GitHub Token

生成 Token 的正确姿势

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 泄露后必须立即撤销！

l访问：https://github.com/settings/tokens

l找到泄露的 Token，点击 Delete

Windows 环境下的 Token 设置方法

CMD（命令提示符）正确语法：

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

常见错误用法：

1 # ❌ 错误 - 在 CMD 中不能用空格

2 GITHUB_TOKEN="token" npx ...

3 

4 # ❌ 错误 - & 会导致并行执行

5 set TOKEN=xxx & npx ...

6 

7 # ✅ 正确 - 使用 && 确保顺序执行

8 set TOKEN=xxx && npx ...

PowerShell 语法：

1 $env:GITHUB_TOKEN="你的令牌"; npx clawhub@latest install self-improving-agent

🔧 1.3 备选方案：如果 GH_TOKEN 不生效

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

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

第二部分：OpenClaw 安装路径与目录结构

🔍 2.1 如何找到 OpenClaw 的安装位置

1 # 查看 openclaw 命令所在位置

2 where openclaw

典型输出：

1 C:\Users\你的用户名\AppData\Roaming\npm\openclaw

2 C:\Users\你的用户名\AppData\Roaming\npm\openclaw.cmd

📁 2.2 OpenClaw 的核心目录结构

1 C:\Users\你的用户名\.openclaw\

2 ├── openclaw.json# 主配置文件（核心！）

3 ├── workspace\# 工作区（AI的"灵魂"文件夹）

4 │├── SOUL.md# AI人格设定

5 │├── USER.md# 用户个人信息

6 │└── .learnings\# 自我进化引擎的记忆目录

7 │├── ERRORS.md# 错误记录

8 │├── LEARNINGS.md# 学习成果记录

9 │└── FEATURE_REQUESTS.md# 功能请求记录

10 ├── skills\# 技能安装目录

11 │└── self-improving-agent\# 自我进化技能

12 └── agents\# 智能体状态目录

❗ 2.3 常见错误：找不到 .openclaw/openclaw.json

这是正常现象，说明 OpenClaw 已找到配置目录，但主配置文件尚未生成。

解决方案：

1 # 方法一：运行初始化向导（推荐）

2 openclaw onboard

3 

4 # 方法二：手动创建最小配置

5 cd C:\Users\你的用户名\.openclaw

6 echo { > openclaw.json

7 echo"gateway": { >> openclaw.json

8 echo"mode": "local", >> openclaw.json

9 echo"port": 18789, >> openclaw.json

10 echo"bind": "127.0.0.1" >> openclaw.json

11 echo}, >> openclaw.json

12 echo"agent": { >> openclaw.json

13 echo"workspace": "C:/Users/你的用户名/.openclaw/workspace" >> openclaw.json

14 echo} >> openclaw.json

15 echo } >> openclaw.json

第三部分：安装 self-improving-agent 自我进化引擎

🎯 3.1 两种安装方式对比

📥 3.2 git clone 手动安装步骤（Windows版）

1 # 1. 进入技能目录（如果不存在则创建）

2 mkdir C:\Users\你的用户名\.openclaw\skills\

3 cd C:\Users\你的用户名\.openclaw\skills\

4 

5 # 2. 克隆技能仓库

6 git clone https://github.com/pskoett/self-improving-agent.git

7 

8 # 3. 验证安装成功

9 dir self-improving-agent

10 # 应该看到 SKILL.md, README.md 等文件

🔧 3.3 如果没有安装 Git

方案 A：安装 Git

l下载地址：https://git-scm.com/download/win

l安装后重新打开命令行

方案 B：直接下载 ZIP

1.访问：https://github.com/pskoett/self-improving-agent

2.点击 Code → Download ZIP

3.解压到 C:\Users\你的用户名\.openclaw\skills\self-improving-agent\

第四部分：激活 self-improving-agent 技能

⚙️ 4.1 创建工作区记忆目录和文件

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

1 # 1. 进入工作区目录

2 cd C:\Users\你的用户名\.openclaw\workspace\

3 

4 # 2. 创建 .learnings 目录

5 mkdir .learnings

6 

7 # 3. 创建三个核心日志文件

8 echo # Errors Log > .learnings\ERRORS.md

9 echo # Learnings Log > .learnings\LEARNINGS.md

10 echo # Feature Requests Log > .learnings\FEATURE_REQUESTS.md

🔌 4.2 安装 Hooks（强烈推荐）

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

1 # 1. 复制 hooks 到全局目录

2 xcopy /E C:\Users\你的用户名\.openclaw\skills\self-improving-agent\hooks\openclaw C:\Users\你的用户名\.openclaw\hooks\self-improvement\

3 

4 # 2. 启用 hook

5 openclaw hooks enable self-improvement

🔄 4.3 重启 Gateway 服务

1 openclaw gateway restart

第五部分：验证安装与使用指南

✅ 5.1 验证安装是否成功

方法一：命令行验证

1 # 检查技能文件

2 dir C:\Users\你的用户名\.openclaw\skills\self-improving-agent\SKILL.md

3 

4 # 检查记忆目录

5 dir C:\Users\你的用户名\.openclaw\workspace\.learnings\

6 

7 # 检查 hook 是否启用

8 openclaw hooks list | findstr self-improvement

方法二：对话验证

在与 OpenClaw 的对话中输入：

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

🧠 5.2 自我进化机制详解

📈 5.3 知识升级路径

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

1 .learnings/LEARNINGS.md→ 普适规则 → SOUL.md

2 工作流改进→ AGENTS.md

3 工具技巧→ TOOLS.md

💡 5.4 最佳实践建议

1.定期回顾：每周花几分钟查看 .learnings/ 下的文件，将有价值的内容"提拔"到核心配置

2.安全第一：安装任何新技能前，先用 skill-vetter 扫描

3.善用 Hook：强烈建议启用 Hook，这是实现"自动"进化的关键

4.轻量化原则：同类功能二选一，避免技能冲突

第六部分：常见问题排查

❓ Q1：安装时提示 "Rate limit exceeded"

原因：GitHub 未认证访问次数超限

解决：配置 GitHub Token 或改用 git clone 手动安装

❓ Q2：找不到 .openclaw/openclaw.json

原因：主配置文件未生成

解决：运行 openclaw onboard 或手动创建

❓ Q3：'git' 不是内部或外部命令

原因：未安装 Git

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

❓ Q4：技能安装后不工作

原因：缺少记忆目录或未重启服务

解决：创建 .learnings 目录和三个日志文件，重启 gateway

📚 参考资料

lself-improving-agent 官方仓库：https://github.com/pskoett/self-improving-agent

lOpenClaw 官方文档：https://openclaw.ai

lClawHub 技能市场：https://clawhub.ai

🎉 结语

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

如果在配置过程中遇到其他问题，欢迎继续探索和交流！

本文档基于真实问题解决过程整理，持续更新中...