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

作者：Jason

日期：2026年3月12日

📝 前言

本文档记录了从零开始配置 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 也被选中）
立即复制保存 ！生成的令牌（以 ghp_ 开头）关闭页面后就看不到了。

⚠️ 重要安全提醒

Token 泄露后必须立即撤销！

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

Windows 环境下的 Token 设置方法

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

bash 复制代码

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

常见错误用法：

bash 复制代码

# ❌ 错误 - 在 CMD 中不能用空格
GITHUB_TOKEN="token" npx ...

# ❌ 错误 - & 会导致并行执行
set TOKEN=xxx & npx ...  

# ✅ 正确 - 使用 && 确保顺序执行
set TOKEN=xxx && npx ...

PowerShell 语法：

powershell 复制代码

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

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

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

bash 复制代码

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

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

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

bash 复制代码

# 查看 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 已找到配置目录，但主配置文件尚未生成。

解决方案：

bash 复制代码

# 方法一：运行初始化向导（推荐）
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版）

bash 复制代码

# 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 创建工作区记忆目录和文件

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

bash 复制代码

# 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 让技能能自动触发，无需手动干预：

bash 复制代码

# 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 服务

bash 复制代码

openclaw gateway restart

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

✅ 5.1 验证安装是否成功

方法一：命令行验证

bash 复制代码

# 检查技能文件
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.md

💡 5.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 配置与自我进化技能安装全攻略