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

  发布时间:2026-04-01 11:18:58   作者:逍遥子_   我要评论
OpenClaw是一款开源的AI智能体网关工具,它允许用户在本地部署AI助手,并通过网关将聊天应用连接到AI智能体,从而实现功能的本地化部署,这篇文章主要介绍了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 的正确姿势

  1. 登录 GitHubSettingsDeveloper settingsPersonal access tokensTokens (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

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

  1. 访问:https://github.com/pskoett/self-improving-agent
  2. 点击 CodeDownload ZIP
  3. 解压到 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.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

参考资料

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

结语

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

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

相关文章

  • OpenClaw模型配置与切换的过程和遇到的问题解决方案

    OpenClaw是一款开源的AI智能体网关工具,它允许用户在本地部署AI助手,并通过网关将聊天应用连接到AI智能体,从而实现功能的本地化部署,这篇文章主要介绍了OpenClaw模型配置与
    2026-03-23
  • OpenClaw配置全流程

    本文给大家介绍OpenClaw配置全流程,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2026-03-18
  • OpenClaw环境变量配置的完整指南

    文章讲述了作者在配置环境变量时遇到的问题,以及如何通过在shell配置文件和systemd服务配置中双重设置环境变量来解决这个问题,作者还分享了常见的错误及解决方法,并提出了
    2026-03-17
  • openclaw配置飞书的完整教程

    本文详细介绍如何将OpenClaw AI 智能体网关与飞书(Feishu)集成,实现企业内部的 AI 助手功能,涵盖飞书应用创建、权限配置、OpenClaw 连接和高级功能设置,本文给大家介绍
    2026-03-17
  • 本地部署OpenClaw安装配置使用教程

    本文给大家分享本地部署OpenClaw安装配置使用教程,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2026-03-09
  • OpenClaw 本地安装与配置十分钟完成(附常用命令速查)

    OpenClaw 是一个开源的个人 AI 助手,支持系统操作、文件读写、代码执行等,它可以通过配置文件进行各种设置,这篇文章给大家介绍OpenClaw 快速入门:10 分钟完成本地安装与配
    2026-03-06

最新评论