前言

本文檔記錄了從零開始配置 OpenClaw，并成功安裝 self-improving-agent（自我進(jìn)化引擎）技能的完整過程。包含了踩過的坑、解決方案和最佳實(shí)踐，希望能幫助其他 OpenClaw 用戶少走彎路。

第一部分：GitHub Token 配置與 Rate Limit 問題

1.1 為什么要配置 GitHub Token？

在使用 npx clawhub@latest install 安裝技能時(shí)，可能會(huì)遇到以下錯(cuò)誤：

? Rate limit exceeded
Error: Rate limit exceeded

這是因?yàn)?clawhub 工具需要從 GitHub 下載技能，而未認(rèn)證的訪客有嚴(yán)格的訪問頻率限制（60次/小時(shí)）。配置 GitHub Token 后，限制會(huì)提升到 5000次/小時(shí)。

1.2 如何正確配置 GitHub Token

生成 Token 的正確姿勢(shì)

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

2. 點(diǎn)擊 Generate new token (classic)

3. 關(guān)鍵配置：

   • Note：起個(gè)易記的名字，如 clawhub-token
   • Expiration：推薦 90 天（更安全），不要選 “No expiration”
   • Scopes：必須勾選 repo 下的所有權(quán)限（確保 public_repo 也被選中）

4. 立即復(fù)制保存！生成的令牌（以 ghp_ 開頭）關(guān)閉頁面后就看不到了。

重要安全提醒

Token 泄露后必須立即撤銷！

• 訪問：https://github.com/settings/tokens
• 找到泄露的 Token，點(diǎn)擊 Delete

Windows 環(huán)境下的 Token 設(shè)置方法

CMD（命令提示符）正確語法：

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

常見錯(cuò)誤用法：

# ? 錯(cuò)誤 - 在 CMD 中不能用空格
GITHUB_TOKEN="token" npx ...
# ? 錯(cuò)誤 - & 會(huì)導(dǎo)致并行執(zhí)行
set TOKEN=xxx & npx ...  
# ? 正確 - 使用 && 確保順序執(zhí)行
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 安裝路徑與目錄結(jié)構(gòu)

2.1 如何找到 OpenClaw 的安裝位置

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

典型輸出：

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

2.2 OpenClaw 的核心目錄結(jié)構(gòu)

C:\Users\你的用戶名\.openclaw\
├── openclaw.json          # 主配置文件（核心?。?
├── workspace\             # 工作區(qū)（AI的"靈魂"文件夾）
│   ├── SOUL.md            # AI人格設(shè)定
│   ├── USER.md            # 用戶個(gè)人信息
│   └── .learnings\        # 自我進(jìn)化引擎的記憶目錄
│       ├── ERRORS.md      # 錯(cuò)誤記錄
│       ├── LEARNINGS.md   # 學(xué)習(xí)成果記錄
│       └── FEATURE_REQUESTS.md  # 功能請(qǐng)求記錄
├── skills\                # 技能安裝目錄
│   └── self-improving-agent\   # 自我進(jìn)化技能
└── agents\                # 智能體狀態(tài)目錄

2.3 常見錯(cuò)誤：找不到.openclaw/openclaw.json

這是正?，F(xiàn)象，說明 OpenClaw 已找到配置目錄，但主配置文件尚未生成。

解決方案：

# 方法一：運(yùn)行初始化向?qū)Вㄍ扑]）
openclaw onboard
# 方法二：手動(dòng)創(chuàng)建最小配置
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 自我進(jìn)化引擎

3.1 兩種安裝方式對(duì)比

3.2 git clone 手動(dòng)安裝步驟（Windows版）

# 1. 進(jìn)入技能目錄（如果不存在則創(chuàng)建）
mkdir C:\Users\你的用戶名\.openclaw\skills\
cd C:\Users\你的用戶名\.openclaw\skills\
# 2. 克隆技能倉(cāng)庫(kù)
git clone https://github.com/pskoett/self-improving-agent.git
# 3. 驗(yàn)證安裝成功
dir self-improving-agent
# 應(yīng)該看到 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. 點(diǎn)擊 Code → Download ZIP
3. 解壓到 C:\Users\你的用戶名\.openclaw\skills\self-improving-agent\

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

4.1 創(chuàng)建工作區(qū)記憶目錄和文件

這是最關(guān)鍵的一步，技能需要這些文件來記錄"記憶"：

# 1. 進(jìn)入工作區(qū)目錄
cd C:\Users\你的用戶名\.openclaw\workspace\
# 2. 創(chuàng)建 .learnings 目錄
mkdir .learnings
# 3. 創(chuàng)建三個(gè)核心日志文件
echo # Errors Log > .learnings\ERRORS.md
echo # Learnings Log > .learnings\LEARNINGS.md
echo # Feature Requests Log > .learnings\FEATURE_REQUESTS.md

4.2 安裝 Hooks（強(qiáng)烈推薦）

Hooks 讓技能能自動(dòng)觸發(fā)，無需手動(dòng)干預(yù)：

# 1. 復(fù)制 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 服務(wù)

openclaw gateway restart

第五部分：驗(yàn)證安裝與使用指南

5.1 驗(yàn)證安裝是否成功

方法一：命令行驗(yàn)證

# 檢查技能文件
dir C:\Users\你的用戶名\.openclaw\skills\self-improving-agent\SKILL.md
# 檢查記憶目錄
dir C:\Users\你的用戶名\.openclaw\workspace\.learnings\
# 檢查 hook 是否啟用
openclaw hooks list | findstr self-improvement

方法二：對(duì)話驗(yàn)證

在與 OpenClaw 的對(duì)話中輸入：

“我剛安裝了 self-improving-agent skill，請(qǐng)幫我確認(rèn)一下配置是否正確。如果可以，嘗試在 LEARNINGS.md 里記錄一條測(cè)試學(xué)習(xí)，內(nèi)容是’測(cè)試自我進(jìn)化功能’。”

5.2 自我進(jìn)化機(jī)制詳解

5.3 知識(shí)升級(jí)路徑

記錄的"記憶"可以手動(dòng)"提拔"到永久配置：

.learnings/LEARNINGS.md  → 普適規(guī)則 → SOUL.md
                         工作流改進(jìn) → AGENTS.md
                         工具技巧 → TOOLS.md

5.4 最佳實(shí)踐建議

1. 定期回顧：每周花幾分鐘查看 .learnings/ 下的文件，將有價(jià)值的內(nèi)容"提拔"到核心配置
2. 安全第一：安裝任何新技能前，先用 skill-vetter 掃描
3. 善用 Hook：強(qiáng)烈建議啟用 Hook，這是實(shí)現(xiàn)"自動(dòng)"進(jìn)化的關(guān)鍵
4. 輕量化原則：同類功能二選一，避免技能沖突

第六部分：常見問題排查

Q1：安裝時(shí)提示 “Rate limit exceeded”

原因：GitHub 未認(rèn)證訪問次數(shù)超限
解決：配置 GitHub Token 或改用 git clone 手動(dòng)安裝

Q2：找不到.openclaw/openclaw.json

原因：主配置文件未生成
解決：運(yùn)行 openclaw onboard 或手動(dòng)創(chuàng)建

Q3：‘git’ 不是內(nèi)部或外部命令

原因：未安裝 Git
解決：安裝 Git 或直接下載 ZIP

Q4：技能安裝后不工作

原因：缺少記憶目錄或未重啟服務(wù)
解決：創(chuàng)建 .learnings 目錄和三個(gè)日志文件，重啟 gateway

參考資料

• self-improving-agent 官方倉(cāng)庫(kù)：https://github.com/pskoett/self-improving-agent
• OpenClaw 官方文檔：https://openclaw.ai
• ClawHub 技能市場(chǎng)：https://clawhub.ai

結(jié)語

恭喜！至此，你已經(jīng)完成了 OpenClaw 的配置，并成功安裝了自我進(jìn)化引擎。你的 AI 助手從此具備了"成長(zhǎng)"的能力，會(huì)越用越懂你、越用越聰明！

到此這篇關(guān)于OpenClaw配置與自我進(jìn)化技能安裝的文章就介紹到這了,更多相關(guān)OpenClaw配置與自我進(jìn)化技能內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論