feat: 初始化黄小瓜AI助手记忆仓库
- 核心配置: IDENTITY, USER, SOUL, AGENTS, TOOLS, HEARTBEAT, MEMORY - memory/: 每日总结和临时记录 - skills/: 所有已安装技能 - notes/: 语音配置笔记
This commit is contained in:
root
@@ -0,0 +1,7 @@
|
||||
{
|
||||
"version": 1,
|
||||
"registry": "https://clawhub.ai",
|
||||
"slug": "tencentcloud-lighthouse-skill",
|
||||
"installedVersion": "1.0.0",
|
||||
"installedAt": 1774109344092
|
||||
}
|
||||
183
skills/tencentcloud-lighthouse-skill/SKILL.md
Normal file
183
skills/tencentcloud-lighthouse-skill/SKILL.md
Normal file
@@ -0,0 +1,183 @@
|
||||
---
|
||||
name: tencentcloud-lighthouse-skill
|
||||
description: Manage Tencent Cloud Lighthouse (轻量应用服务器) — auto-setup mcporter + MCP, query instances, monitoring & alerting, self-diagnostics, firewall, snapshots, remote command execution (TAT). Use when user asks about Lighthouse or 轻量应用服务器. NOT for CVM or other cloud server types.
|
||||
metadata:
|
||||
{
|
||||
"openclaw":
|
||||
{
|
||||
"emoji": "☁️",
|
||||
"requires": {},
|
||||
"install":
|
||||
[
|
||||
{
|
||||
"id": "node-mcporter",
|
||||
"kind": "node",
|
||||
"package": "mcporter",
|
||||
"bins": ["mcporter"],
|
||||
"label": "Install mcporter (MCP CLI)",
|
||||
},
|
||||
],
|
||||
},
|
||||
}
|
||||
---
|
||||
|
||||
# Lighthouse 云服务器运维
|
||||
|
||||
通过 mcporter + lighthouse-mcp-server 管理腾讯云轻量应用服务器。
|
||||
|
||||
## 首次使用 — 自动设置
|
||||
|
||||
当用户首次要求管理云服务器时，按以下流程操作：
|
||||
|
||||
### 步骤 1：检查当前状态
|
||||
|
||||
```bash
|
||||
{baseDir}/scripts/setup.sh --check-only
|
||||
```
|
||||
|
||||
如果输出显示一切 OK（mcporter 已安装、config 已配置、lighthouse 已就绪），跳到「调用格式」。
|
||||
|
||||
### 步骤 2：如果未配置，引导用户提供密钥
|
||||
|
||||
告诉用户：
|
||||
> 我需要你的腾讯云 API 密钥来连接 Lighthouse 服务器。请提供：
|
||||
> 1. **SecretId** — 腾讯云 API 密钥 ID
|
||||
> 2. **SecretKey** — 腾讯云 API 密钥 Key
|
||||
>
|
||||
> 你可以在 [腾讯云控制台 > 访问管理 > API密钥管理](https://console.cloud.tencent.com/cam/capi) 获取。
|
||||
|
||||
### 步骤 3：用户提供密钥后，运行自动设置
|
||||
|
||||
```bash
|
||||
{baseDir}/scripts/setup.sh --secret-id "<用户提供的SecretId>" --secret-key "<用户提供的SecretKey>"
|
||||
```
|
||||
|
||||
脚本会自动：
|
||||
- 检查并安装 mcporter（如未安装）
|
||||
- 创建 `~/.mcporter/mcporter.json` 配置文件
|
||||
- 写入 lighthouse MCP 服务器配置和密钥
|
||||
- 验证连接
|
||||
|
||||
设置完成后即可开始使用。
|
||||
|
||||
## 调用格式
|
||||
|
||||
所有 mcporter 命令必须使用以下格式：
|
||||
|
||||
```
|
||||
mcporter call lighthouse.<tool_name> --config ~/.mcporter/mcporter.json --output json [--args '<JSON>']
|
||||
```
|
||||
|
||||
列出可用工具：
|
||||
```
|
||||
mcporter list lighthouse --config ~/.mcporter/mcporter.json --schema
|
||||
```
|
||||
|
||||
|
||||
## 工具总览
|
||||
|
||||
本 MCP Server 包含以下工具类别：
|
||||
|
||||
| 类别 | 说明 |
|
||||
|------|------|
|
||||
| 地域查询 | 获取可用地域列表（唯一不需要 Region 参数的操作） |
|
||||
| 实例管理 | 查询、启动实例，查看流量包/套餐/配额等（需要 Region） |
|
||||
| 监控与告警 | 获取多指标监控数据、设置告警策略、服务器自检（需要 Region） |
|
||||
| 防火墙 | 规则增删改查、防火墙模板管理（需要 Region） |
|
||||
| 远程命令(TAT) | 在实例上执行命令、查询任务状态（需要 Region） |
|
||||
|
||||
## 常用操作
|
||||
|
||||
> 以下所有示例省略了公共前缀 `mcporter call lighthouse.` 和 `--config ~/.mcporter/mcporter.json --output json`。
|
||||
> 完整命令格式：`mcporter call lighthouse.<tool_name> --config ~/.mcporter/mcporter.json --output json --args '<JSON>'`
|
||||
|
||||
### 获取地域列表（不需要 Region 参数）
|
||||
|
||||
```bash
|
||||
# 查询所有可用地域 — 唯一不需要 Region 参数的操作
|
||||
# 首次使用时应先调用此接口获取可用 Region 列表
|
||||
mcporter call lighthouse.describe_regions --config ~/.mcporter/mcporter.json --output json
|
||||
```
|
||||
|
||||
### 实例管理
|
||||
|
||||
```bash
|
||||
# 查询实例列表（Region 必填，可选参数: InstanceIds, Offset, Limit）
|
||||
mcporter call lighthouse.describe_instances --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","Limit":20,"Offset":0}'
|
||||
|
||||
# 查询指定实例
|
||||
mcporter call lighthouse.describe_instances --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceIds":["lhins-xxxxxxxx"]}'
|
||||
|
||||
# 启动实例
|
||||
mcporter call lighthouse.start_instances --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceIds":["lhins-xxxxxxxx"]}'
|
||||
|
||||
# 获取实例登录终端地址
|
||||
mcporter call lighthouse.describe_instance_login_url --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx"}'
|
||||
|
||||
# 查询所有应用镜像
|
||||
mcporter call lighthouse.describe_all_applications --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou"}'
|
||||
# BlueprintType 可选: APP_OS | PURE_OS | DOCKER | ALL（默认ALL）
|
||||
```
|
||||
|
||||
### 监控与告警
|
||||
|
||||
```bash
|
||||
# 获取监控数据（支持多指标同时查询，默认最近6小时）
|
||||
mcporter call lighthouse.get_monitor_data --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx","Indicators":["CPU利用率","内存利用率"]}'
|
||||
|
||||
# 获取监控数据（指定时间范围）
|
||||
mcporter call lighthouse.get_monitor_data --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx","Indicators":["公网出带宽","公网入带宽"],"StartTime":"2026-02-09 00:00:00","EndTime":"2026-02-10 00:00:00"}'
|
||||
|
||||
# 支持的监控指标（中文名称）:
|
||||
# CPU利用率 | 内存利用率 | 公网出带宽 | 公网入带宽
|
||||
# 系统盘读IO | 系统盘写IO | 公网流量包
|
||||
|
||||
# 设置告警策略
|
||||
# Alarms 中的 Frequency/Points/Size 均为字符串类型
|
||||
mcporter call lighthouse.set_alerting_strategy --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx","Indicator":"CPU利用率","Alarms":[{"Frequency":"300","Threshold":"80%","Level":"严重","Points":"3","Size":"60"}],"PolicyName":"CPU高负载告警"}'
|
||||
# Frequency(秒): "300"|"600"|"900"|"1800"|"3600"|"7200"|"10800"|"21600"|"43200"|"86400"
|
||||
# Level: "提示"|"严重"|"紧急" Points: "1"-"5" Size: "60"|"300"
|
||||
|
||||
# 服务器自检（检测网络、防火墙、存储、状态、性能）
|
||||
mcporter call lighthouse.self_test --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx"}'
|
||||
```
|
||||
|
||||
### 防火墙
|
||||
|
||||
```bash
|
||||
# 查询防火墙规则
|
||||
mcporter call lighthouse.describe_firewall_rules --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx"}'
|
||||
|
||||
# 添加防火墙规则
|
||||
mcporter call lighthouse.create_firewall_rules --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx","FirewallRules":[{"Protocol":"TCP","Port":"8080","CidrBlock":"0.0.0.0/0","Action":"ACCEPT","FirewallRuleDescription":"开放8080端口"}]}'
|
||||
|
||||
# 删除防火墙规则
|
||||
mcporter call lighthouse.delete_firewall_rules --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx","FirewallRules":[{"Protocol":"TCP","Port":"8080"}]}'
|
||||
```
|
||||
|
||||
### 远程命令执行 (TAT)
|
||||
|
||||
```bash
|
||||
# 在 Linux 实例上执行命令
|
||||
mcporter call lighthouse.execute_command --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx","Command":"uptime && df -h && free -m","SystemType":"Linux"}'
|
||||
|
||||
# 在 Windows 实例上执行命令
|
||||
mcporter call lighthouse.execute_command --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InstanceId":"lhins-xxxxxxxx","Command":"Get-Process | Sort-Object CPU -Descending | Select-Object -First 10","SystemType":"Windows"}'
|
||||
|
||||
# 查询命令执行任务详情（自动轮询直到完成）
|
||||
mcporter call lighthouse.describe_command_tasks --config ~/.mcporter/mcporter.json --output json --args '{"Region":"ap-guangzhou","InvocationTaskId":"invt-xxxxxxxx"}'
|
||||
|
||||
# 注意: Command 最大 2048 字符，超长命令建议登录实例手动执行
|
||||
```
|
||||
|
||||
## 使用规范
|
||||
|
||||
1. **每次调用必须带** `--config ~/.mcporter/mcporter.json`
|
||||
2. **始终加** `--output json` 获取结构化输出
|
||||
3. **Region 参数规则**: 除 `describe_regions` 外，所有操作都**必须**传入 `Region` 参数。如果用户未指定 Region，应先调用 `describe_regions` 获取可用地域列表，再让用户选择或根据上下文确定
|
||||
4. **首次使用流程**: 先调用 `describe_regions` 获取地域列表 → 再调用 `describe_instances` 获取实例列表 → 记住 InstanceId 和 Region 供后续使用
|
||||
5. **用实际的 InstanceId** 替换示例中的 `lhins-xxxxxxxx`（先通过 `describe_instances` 获取）
|
||||
6. **监控指标用中文**: `get_monitor_data` 的 Indicators 参数使用中文名称（CPU利用率、内存利用率等）
|
||||
7. **命令长度限制**: `execute_command` 的 Command 参数最大 2048 字符，超长建议登录实例执行
|
||||
8. **危险操作前先确认**: 防火墙修改、命令执行、实例关机/重启等，先向用户确认
|
||||
9. **错误处理**: 如果调用失败，先用 `{baseDir}/scripts/setup.sh --check-only` 诊断问题，或用 `self_test` 检测实例状态
|
||||
6
skills/tencentcloud-lighthouse-skill/_meta.json
Normal file
6
skills/tencentcloud-lighthouse-skill/_meta.json
Normal file
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"ownerId": "kn75kc19fpd7fhjt8pfak7x3j180v1jy",
|
||||
"slug": "tencentcloud-lighthouse-skill",
|
||||
"version": "1.0.0",
|
||||
"publishedAt": 1770787740068
|
||||
}
|
||||
181
skills/tencentcloud-lighthouse-skill/scripts/setup.sh
Normal file
181
skills/tencentcloud-lighthouse-skill/scripts/setup.sh
Normal file
@@ -0,0 +1,181 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
|
||||
# Lighthouse MCP Setup — installs mcporter (if needed) and writes config
|
||||
# Usage:
|
||||
# setup.sh --secret-id <ID> --secret-key <KEY> [--config-path <path>] [--check-only]
|
||||
#
|
||||
# Examples:
|
||||
# setup.sh --secret-id AKIDxxxx --secret-key yyyyyyy
|
||||
# setup.sh --check-only
|
||||
# setup.sh --secret-id AKIDxxxx --secret-key yyyyyyy --config-path /root/.mcporter/mcporter.json
|
||||
|
||||
CONFIG_PATH="${HOME}/.mcporter/mcporter.json"
|
||||
SECRET_ID=""
|
||||
SECRET_KEY=""
|
||||
CHECK_ONLY=false
|
||||
|
||||
usage() {
|
||||
cat >&2 <<'EOF'
|
||||
Usage:
|
||||
setup.sh --secret-id <TENCENTCLOUD_SECRET_ID> --secret-key <TENCENTCLOUD_SECRET_KEY> [--config-path <path>]
|
||||
setup.sh --check-only
|
||||
|
||||
Options:
|
||||
--secret-id Tencent Cloud SecretId (required unless --check-only)
|
||||
--secret-key Tencent Cloud SecretKey (required unless --check-only)
|
||||
--config-path mcporter config file path (default: ~/.mcporter/mcporter.json)
|
||||
--check-only Only check if mcporter and config are ready, don't modify anything
|
||||
-h, --help Show this help
|
||||
EOF
|
||||
exit 2
|
||||
}
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--secret-id) SECRET_ID="${2:-}"; shift 2 ;;
|
||||
--secret-key) SECRET_KEY="${2:-}"; shift 2 ;;
|
||||
--config-path) CONFIG_PATH="${2:-}"; shift 2 ;;
|
||||
--check-only) CHECK_ONLY=true; shift ;;
|
||||
-h|--help) usage ;;
|
||||
*) echo "Unknown arg: $1" >&2; usage ;;
|
||||
esac
|
||||
done
|
||||
|
||||
# --- Check mode ---
|
||||
if $CHECK_ONLY; then
|
||||
echo "=== Lighthouse MCP Status Check ==="
|
||||
|
||||
# Check mcporter
|
||||
if command -v mcporter &>/dev/null; then
|
||||
echo "[OK] mcporter installed: $(mcporter --version 2>/dev/null || echo 'unknown version')"
|
||||
else
|
||||
echo "[MISSING] mcporter not installed"
|
||||
echo " Fix: npm install -g mcporter"
|
||||
fi
|
||||
|
||||
# Check config file
|
||||
if [[ -f "$CONFIG_PATH" ]]; then
|
||||
echo "[OK] Config file exists: $CONFIG_PATH"
|
||||
# Check if lighthouse server is configured
|
||||
if grep -q '"lighthouse"' "$CONFIG_PATH" 2>/dev/null; then
|
||||
echo "[OK] lighthouse MCP server configured"
|
||||
# Check if credentials are present (not placeholder)
|
||||
if grep -q 'TENCENTCLOUD_SECRET_ID' "$CONFIG_PATH" 2>/dev/null; then
|
||||
echo "[OK] Tencent Cloud credentials found in config"
|
||||
else
|
||||
echo "[WARN] Tencent Cloud credentials may be missing"
|
||||
fi
|
||||
else
|
||||
echo "[MISSING] lighthouse MCP server not in config"
|
||||
fi
|
||||
else
|
||||
echo "[MISSING] Config file not found: $CONFIG_PATH"
|
||||
fi
|
||||
|
||||
# Try listing servers
|
||||
if command -v mcporter &>/dev/null && [[ -f "$CONFIG_PATH" ]]; then
|
||||
echo ""
|
||||
echo "=== MCP Servers ==="
|
||||
mcporter list --config "$CONFIG_PATH" 2>/dev/null || echo "[ERROR] Failed to list servers"
|
||||
fi
|
||||
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# --- Setup mode: validate inputs ---
|
||||
if [[ -z "$SECRET_ID" ]]; then
|
||||
echo "[ERROR] --secret-id is required" >&2
|
||||
exit 1
|
||||
fi
|
||||
if [[ -z "$SECRET_KEY" ]]; then
|
||||
echo "[ERROR] --secret-key is required" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo "=== Lighthouse MCP Auto Setup ==="
|
||||
|
||||
# Step 1: Check/install mcporter
|
||||
if command -v mcporter &>/dev/null; then
|
||||
echo "[OK] mcporter already installed"
|
||||
else
|
||||
echo "[INSTALL] Installing mcporter via npm..."
|
||||
npm install -g mcporter
|
||||
if command -v mcporter &>/dev/null; then
|
||||
echo "[OK] mcporter installed successfully"
|
||||
else
|
||||
echo "[ERROR] mcporter installation failed" >&2
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
# Step 2: Create config directory
|
||||
CONFIG_DIR="$(dirname "$CONFIG_PATH")"
|
||||
if [[ ! -d "$CONFIG_DIR" ]]; then
|
||||
mkdir -p "$CONFIG_DIR"
|
||||
echo "[OK] Created config directory: $CONFIG_DIR"
|
||||
fi
|
||||
|
||||
# Step 3: Write/update config with lighthouse server
|
||||
# If config exists, try to merge; otherwise create new
|
||||
if [[ -f "$CONFIG_PATH" ]]; then
|
||||
echo "[INFO] Updating existing config: $CONFIG_PATH"
|
||||
# Use a temp file for safe write
|
||||
TEMP_CONFIG="$(mktemp)"
|
||||
# Simple JSON merge using node (available since mcporter requires node)
|
||||
node -e "
|
||||
const fs = require('fs');
|
||||
let config = {};
|
||||
try { config = JSON.parse(fs.readFileSync('$CONFIG_PATH', 'utf8')); } catch {}
|
||||
if (!config.mcpServers) config.mcpServers = {};
|
||||
config.mcpServers.lighthouse = {
|
||||
command: 'npx',
|
||||
args: ['-y', 'lighthouse-mcp-server'],
|
||||
env: {
|
||||
TENCENTCLOUD_SECRET_ID: '$SECRET_ID',
|
||||
TENCENTCLOUD_SECRET_KEY: '$SECRET_KEY'
|
||||
}
|
||||
};
|
||||
fs.writeFileSync('$TEMP_CONFIG', JSON.stringify(config, null, 2));
|
||||
"
|
||||
mv "$TEMP_CONFIG" "$CONFIG_PATH"
|
||||
else
|
||||
echo "[INFO] Creating new config: $CONFIG_PATH"
|
||||
cat > "$CONFIG_PATH" <<JSONEOF
|
||||
{
|
||||
"mcpServers": {
|
||||
"lighthouse": {
|
||||
"command": "npx",
|
||||
"args": ["-y", "lighthouse-mcp-server"],
|
||||
"env": {
|
||||
"TENCENTCLOUD_SECRET_ID": "$SECRET_ID",
|
||||
"TENCENTCLOUD_SECRET_KEY": "$SECRET_KEY"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
JSONEOF
|
||||
fi
|
||||
|
||||
echo "[OK] Config written: $CONFIG_PATH"
|
||||
|
||||
# Step 4: Verify
|
||||
echo ""
|
||||
echo "=== Verification ==="
|
||||
echo "Listing MCP servers..."
|
||||
mcporter list --config "$CONFIG_PATH" 2>/dev/null || echo "[WARN] mcporter list failed (server may need first-run initialization)"
|
||||
|
||||
echo ""
|
||||
echo "Testing lighthouse connection (listing tools)..."
|
||||
if mcporter list lighthouse --config "$CONFIG_PATH" --schema 2>/dev/null; then
|
||||
echo ""
|
||||
echo "[OK] Lighthouse MCP setup complete! All tools available."
|
||||
else
|
||||
echo "[WARN] Could not list lighthouse tools yet. This is normal on first run."
|
||||
echo " The MCP server will be started on first call."
|
||||
fi
|
||||
|
||||
echo ""
|
||||
echo "=== Setup Complete ==="
|
||||
echo "Config: $CONFIG_PATH"
|
||||
echo "Server: lighthouse (via npx lighthouse-mcp-server)"
|
||||
Reference in New Issue
Block a user