用途:管理 Naga 系统本身的配置,包括修改系统设置、添加 MCP 工具服务、导入自定义技能与查看技能仓库。
主要能力与用法:
- 配置管理。GET /system/config 读取完整配置 JSON,覆盖 system、api、grag、tts、online_search、live2d、handoff、voice_realtime、weather、mqtt、crawl4ai、computer_control 等分区;POST /system/config 发送完整配置对象进行修改,建议先 GET 再改动所需字段后回传。常见操作包括切换 LLM 模型(api.model、api.base_url、api.api_key)、调整 api.temperature、修改 system.ai_name、开关 system.voice_enabled、开关 grag 知识图谱、调整 online_search.num_results。
- MCP 工具服务。GET /mcp/services 查看已有服务(name、displayName、description、source、available);POST /mcp/import 添加服务,配置写入 ~/.mcporter/config.json,支持 stdio 类型(command 为 npx、args、type 为 stdio)与 SSE/URL 类型(url、type 为 sse)。缺少所需工具时可用内置 online_search 搜索 MCP server。
- 技能管理。GET /openclaw/market/items 查看可安装技能,POST /openclaw/market/items/{item_id}/install 安装;POST /skills/import 导入自定义技能,内容以 Markdown 写入 skills/{name}/SKILL.md,下次对话自动加载。
- 系统提示词。GET /system/prompt 获取,POST /system/prompt 以 content 字段设置。
适用场景:用户要求修改设置、添加工具或技能、切换模型、调整搜索或语音行为时使用。
限制与注意:修改配置后立即生效,无需重启;添加 MCP 服务后需在服务列表中确认可用状态;网络搜索、网址访问与文件访问使用内置 clawdbot 工具,无需额外 MCP;敏感信息如 API 密钥应适当掩码。技能导入的具体字段校验与错误处理细节暂未提供。