rtgs2017/naga-config

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 命令启动）：

{
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-xxx"],
  "type": "stdio"
}

SSE/URL 类型（通过 HTTP 连接）：

{
  "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

{
  "name": "技能名称",
  "content": "技能描述和指令内容（Markdown 格式）"
}

技能文件会被创建为 skills/{name}/SKILL.md，包含 YAML frontmatter 元数据和 Markdown 内容。技能会在下次对话时自动加载到系统提示词中。

自定义技能内容建议格式

# 技能标题

简要描述这个技能做什么。

## 触发条件
描述何时应使用此技能。

## 执行步骤
1. 第一步
2. 第二步

## 输出格式
描述期望的输出格式。

6. 查看和修改系统提示词

获取当前系统提示词

GET /system/prompt

设置系统提示词

POST /system/prompt
Content-Type: application/json

{
  "content": "新的系统提示词内容"
}

注意事项

• 网络搜索、网址访问和文件访问功能使用 Naga 内置的 clawdbot 工具，不需要额外的 MCP 服务
• 修改配置后会立即生效，无需重启
• 添加 MCP 服务后，需要在服务列表中确认其状态为可用
• 敏感信息（如 API 密钥）在回复用户时应适当掩码处理