Skip to content

README.md

Latest commit

 

History

History
161 lines (114 loc) · 2.93 KB

README.md

File metadata and controls

161 lines (114 loc) · 2.93 KB

OpenClaw 集成指南

集成方式

方案 A: 修改 OpenClaw 源码（推荐用于原型验证）

步骤 1: 安装插件

cd /home/admin/openclaw/workspace/skill-evolution-plugin
npm install -g

步骤 2: 修改 SkillExecutor.js

找到文件：

/opt/jvs-claw/base/lib/node_modules/openclaw/src/executor/SkillExecutor.js

在文件顶部添加：

const { evolutionPlugin, executeToolWithMonitoring } = require('skill-evolution-plugin');

修改工具执行函数：

// 原函数
async _executeTool(toolName, params) {
  // ... 原有逻辑
}

// 修改后
async _executeTool(toolName, params) {
  return executeToolWithMonitoring(
    this.currentSkillName,
    toolName,
    params,
    this._originalExecuteTool.bind(this)
  );
}

步骤 3: 重启 OpenClaw Gateway

openclaw gateway restart

方案 B: 环境变量注入（无需修改源码）

创建启动脚本：

#!/bin/bash
# ~/.openclaw/scripts/with-evolution.sh

export OPENCLAW_PRE_HOOK="node -e \"require('skill-evolution-plugin').hooks.pre()\""
export OPENCLAW_POST_HOOK="node -e \"require('skill-evolution-plugin').hooks.post()\""

exec openclaw "$@"

方案 C: OpenClaw 插件系统（需要 OpenClaw 支持）

如果 OpenClaw 有插件系统，在配置中启用：

# ~/.openclaw/config.yaml
plugins:
  skill-evolution:
    enabled: true
    logPath: ~/.openclaw/skills
    threshold: 3
    autoReport: weekly

验证集成

1. 检查日志文件

使用 Skill 后，检查是否生成日志：

ls -la ~/.openclaw/skills/<skill-name>/.evolution/

应该看到：

execution-log.jsonl
patches/
manifest.json

2. 查看执行记录

cat ~/.openclaw/skills/<skill-name>/.evolution/execution-log.jsonl | jq .

3. 生成报告

skill-evolution report <skill-name>

常见问题

Q: 插件未生效？

A: 检查以下几点：

  1. 插件是否正确安装：npm list -g skill-evolution-plugin
  2. OpenClaw 是否重启
  3. 日志文件是否生成

Q: 如何禁用插件？

A: 三种方式：

  1. 设置环境变量：export SKILL_EVOLUTION_ENABLED=false
  2. 修改配置：enabled: false
  3. 卸载插件：npm uninstall -g skill-evolution-plugin

Q: 日志文件太大？

A: 定期清理旧日志：

# 保留最近 100 条
tail -n 100 execution-log.jsonl > temp.jsonl && mv temp.jsonl execution-log.jsonl

性能影响

  • 内存开销: ~5MB（存储执行记录）
  • CPU 开销: <1%（异步记录，不阻塞执行）
  • 磁盘开销: ~1KB/次执行（JSONL 格式）

隐私和安全

  • 所有数据本地存储（~/.openclaw/skills/...）
  • 不上传任何数据到外部
  • 日志不包含敏感信息（仅记录工具调用）

下一步

  1. 选择一种集成方案
  2. 在测试环境中验证
  3. 收集使用反馈
  4. 优化性能和准确率