naga-config

Files (1)

• SKILL.md

SKILL.md (first lines)

# Naga 自身配置管理技能

本技能让你能够管理和配置 Naga 系统本身，包括修改系统设置、添加 MCP 工具服务、导入自定义技能。

## 1. 查看和修改系统配置

### 读取当前配置
```
GET /system/config
```
返回完整的系统配置 JSON，包含以下主要分区：
- `system` — 基础设置（ai_name, voice_enabled, stream_mode, debug, log_level）
- `api` — LLM 模型设置（api_key, base_url, model, temperature, max_tokens, max_history_rounds）
- `grag` — 知识图谱设置（enabled, auto_extract, similarity_threshold, neo4j 连接）
- `tts` — 语音合成设置（default_voice, default_speed, default_language）
- `online_search` — 搜索引擎设置（searxng_url, engines, num_results）
- `live2d` — Live2D 虚拟形象设置（enabled, model_path, animation_enabled）
- `handoff` — 工具调用循环设置（max_loop_stream, max_loop_non_stream）
- `voice_realtime` — 实时语音对话设置（enabled, provider, model, voice）
- `weather` — 天气 API 设置
- `mqtt` — MQTT 物联网设置
- `crawl4ai` — 网页爬取设置
- `computer_control` — 计算机视觉控制设置

### 修改配置
```
POST /system/config
Content-Type: application/json

{完整的配置 JSON 对象}
```

**重要**：修改配置时需要发送完整的配置对象。建议先 GET 获取当前配置，修改需要的字段后再 POST 回去。

### 常见配置操作示例

**切换 LLM 模型**：修改 `api.model`、`api.base_url`、`api.api_key`
**调整创造力**：修改 `api.temperature`（0.0=精确，1.0=创意，2.0=随机）
**修改 AI 名称**：修改 `system.ai_name`
**开关语音**：修改 `system.voice_enabled`
**开关知识图谱**：修改 `grag.enabled` 和 `grag.auto_extract`
**调整搜索结果数**：修改 `online_search.num_results`

## 2. 查看已有 MCP 工具服务

```
GET /mcp/services
```
返回所有 MCP 服务列表，包括：
- `name` — 服务名称
- `displayName` — 显示名称
- `description` — 描述
- `source` — 来源（`builtin` 内置 / `mcporter` 外部配置）
- `available` — 是否可用

## 3. 添加 MCP 工具服务

MCP 服务通过 JSON 配置添加，配置会写入 `~/.mcporter/config.json`。

```
POST /mcp/import
Content-Type: application/json

{
  "name": "服务名称",
  "config": {
    "command": "npx",
    "args": ["-y", "@mcp/server-name"],
    "type": "stdio"
  }
}
```

### MCP 配置格式

**stdio 类型**（通过 Node.js 命令启动）：
```json
{
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-xxx"],
  "type": "stdio"
}
```

**SSE/URL 类型**（通过 HTTP 连接）：
```json
{
  "url": "https://mcp-server.example.com/sse",
  "type": "sse"
}
```

### 搜索可用的 MCP 工具

当用户需要某个功能但目前没有对应的 MCP 工具时，使用内置的网络搜索工具（online_search）搜索：
- 搜索关键词：`MCP server <功能描述> npm` 或 `Model Context Protocol <功能> server`
- 常见 MCP 服务注册在 npm 的 `@modelcontextprotocol/` 组织下
- 也可以在 GitHub 搜索：`modelcontextprotocol site:github.com`
- 找到后，用 `POST /mcp/import` 添加对应的 JSON 配置

## 4. 查看技能仓库

```
GET /openclaw/market/items
```
返回所有可安装的技能列表。

### 安装技能市场中的技能
```
POST /openclaw/market/items/{item_id}/install
```

## 5. 导入自定义技能

```
POST /skills/import
Content-Type: application/json

{

From RTGS2017/NagaAgent, AGPL-3.0.

More from RTGS2017/NagaAgent