AnalyticDB：通過 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-intl.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