通过 Skill 插件实现OpenClaw日志分析

步骤一：克隆仓库并准备环境

git clone https://github.com/aliyun/alibabacloud-adb-mysql-mcp-server
cd alibabacloud-adb-mysql-mcp-server/skill/alibabacloud-adb-openclaw-insight

步骤二：安装项目依赖

• 方式一：使用 uv（推荐）

  # 安装 uv 包管理器
  curl -LsSf https://astral.sh/uv/install.sh | sh
  
  # 安装项目依赖
  uv pip install -r requirements.txt

• 方式二：使用 pip

  pip install -r requirements.txt
  # 如果找不到 "pip"，请尝试：
  pip3 install -r requirements.txt

步骤三：配置 Skill 连接信息

这是安装过程中唯一需要手动干预的步骤。请在继续之前，收集并确认以下配置信息。

• AnalyticDB for MySQL 连接信息

  配置项	说明	示例
  adb.host	AnalyticDB for MySQL集群的连接地址。	am-xxxxxxxx.ads.aliyuncs.com
  adb.port	数据库端口号。	3306
  adb.database	目标数据库名称。	openclaw_adb
  adb.username	数据库用户名。	your_user
  adb.password	数据库密码。	your_password

• LLM 大模型配置

  说明

  如果用户只需要 L1 运营效率分析，可跳过此部分。

  配置项	说明	示例
  llm.endpoint	大模型 API 的服务地址。	https://dashscope.aliyuncs.com/compatible-mode/v1
  llm.apiKey	API Key。	sk-xxxxxxxxxx
  llm.model	模型名称。	qwen-plus
  llm.apiType	API 协议类型 (openai 或 anthropic)。	openai

• （可选）分析模块开关

  配置项	说明	默认值
  analysis.enableL1	启用 L1 分析。	true
  analysis.enableL2	启用 L2 分析 (需要 LLM)。	true
  analysis.enableL3	启用 L3 分析 (需要 LLM)。	true
  analysis.analysisWindowDays	分析时间窗口（天）	7

步骤四：写入配置文件

根据用户提供的信息，从模板生成 config.json：

cp config.example.json config.json

然后将用户提供的值写入 config.json 对应字段。最终文件结构如下：

{
  "adb": {
    "host": "<用户提供的 host>",
    "port": 3306,
    "database": "<用户提供的 database>",
    "username": "<用户提供的 username>",
    "password": "<用户提供的 password>",
    "sessionTable": "openclaw_sessions",
    "logsTable": "openclaw_logs",
    "connectionPoolSize": 5
  },
  "collection": {
    "intervalMinutes": 5,
    "batchSize": 100,
    "retentionDays": 7,
    "enableLogCollection": true,
    "enableTokenCollection": true
  },
  "filters": {
    "minLevel": "info",

    "includeSubsystems": [ ],

    "excludeSubsystems": ["verbose", "trace"]
  },
  "llm": {
    "endpoint": "<用户提供的 endpoint，如未提供则留空>",
    "apiKey": "<用户提供的 apiKey，如未提供则留空>",
    "model": "<用户提供的 model>",
    "apiType": "<用户提供的 apiType>",
    "maxConcurrency": 5,
    "temperature": 0.1,
    "maxTokens": 128000
  },
  "analysis": {
    "enableL1": true,
    "enableL2": <用户是否启用 L2>,
    "enableL3": <用户是否启用 L3>,
    "analysisWindowDays": 7,
    "maxSessionsForLlm": 500
  }
}

步骤五：初始化数据库

此命令将在AnalyticDB for MySQL版集群中创建或更新所需的表结构。

python -m scripts.init_db
# 如果找不到 "python"，请尝试：
python3 -m scripts.init_db