openclaw.plugin.json

{
  "id": "napcat",
  "name": "NapCat QQ",
  "version": "1.0.8",
  "description": "QQ chat channel plugin for OpenClaw via NapCat (OneBot 11)",
  "author": "ProperSAMA",
  "channels": ["napcat"],
  "skills": ["skill/napcat-qq"],
  "channelConfigs": {
    "napcat": {
      "label": "NapCat QQ",
      "description": "QQ chat channel via NapCat (OneBot 11)",
      "schema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "title": "NapCat HTTP URL",
            "default": "http://127.0.0.1:15150"
          },
          "agentId": {
            "type": "string",
            "title": "Fixed Agent ID",
            "description": "Optional: force all NapCat inbound sessions to use this OpenClaw agent ID",
            "default": ""
          },
          "allowUsers": {
            "type": "array",
            "items": { "type": "string" },
            "title": "Allowed User IDs",
            "description": "Only accept messages from these QQ user IDs (empty = accept all)",
            "default": []
          },
          "groupWhitelist": {
            "type": "array",
            "items": { "type": "string" },
            "title": "Group Whitelist",
            "description": "Only accept messages from these QQ group IDs when non-empty",
            "default": []
          },
          "enableGroupMessages": {
            "type": "boolean",
            "title": "Enable Group Messages",
            "description": "When enabled, process group messages (requires mention to trigger)",
            "default": false
          },
          "streaming_mode": {
            "type": "boolean",
            "title": "Streaming Mode",
            "description": "Stream replies as incremental QQ messages instead of waiting for the final combined response",
            "default": false
          },
          "enable_progress_messages": {
            "type": "boolean",
            "title": "Enable Progress Messages",
            "description": "Send assistant intermediate progress (commentary) messages to QQ as well, throttled to 1 per 3s per conversation",
            "default": false
          },
          "plainTextMode": {
            "type": "boolean",
            "title": "Plain Text Mode",
            "description": "Convert outgoing Markdown-style text to QQ-friendly plain text",
            "default": true
          },
          "groupMentionOnly": {
            "type": "boolean",
            "title": "Require Mention in Group",
            "description": "In group chats, only respond when the bot is mentioned (@)",
            "default": true
          },
          "enablePrivateTypingStatus": {
            "type": "boolean",
            "title": "Enable Private Typing Status",
            "description": "Show QQ 'typing' status in private chats while OpenClaw is processing a reply",
            "default": true
          },
          "mediaProxyEnabled": {
            "type": "boolean",
            "title": "Enable Media Proxy",
            "description": "Expose /napcat/media endpoint so NapCat can fetch media from OpenClaw host",
            "default": false
          },
          "publicBaseUrl": {
            "type": "string",
            "title": "OpenClaw Public Base URL",
            "description": "Base URL reachable by NapCat device, e.g. http://192.168.1.10:18789",
            "default": ""
          },
          "mediaProxyToken": {
            "type": "string",
            "title": "Media Proxy Token",
            "description": "Optional token required by /napcat/media endpoint",
            "default": ""
          },
          "voiceBasePath": {
            "type": "string",
            "title": "Voice Base Path",
            "description": "Base directory for relative audio files (e.g. /tmp/napcat-voice)",
            "default": ""
          },
          "groupFileFolder": {
            "type": "string",
            "title": "Group File Default Folder",
            "description": "Optional NapCat group file folder path used by /upload_group_file",
            "default": ""
          },
          "groupFileHostPrefix": {
            "type": "string",
            "title": "Group File Host Prefix",
            "description": "Host path prefix that is mounted into NapCat container (e.g. /Users/me/shared)",
            "default": ""
          },
          "groupFileContainerPrefix": {
            "type": "string",
            "title": "Group File Container Prefix",
            "description": "Container path prefix matching host prefix (e.g. /app/shared)",
            "default": ""
          },
          "groupFileStageHostDir": {
            "type": "string",
            "title": "Group File Stage Host Dir",
            "description": "Host directory (mounted into NapCat container) to stage files before upload",
            "default": ""
          },
          "groupFileStageContainerDir": {
            "type": "string",
            "title": "Group File Stage Container Dir",
            "description": "Container directory corresponding to stage host dir (e.g. /app/napcat/plugins/upload-staging)",
            "default": ""
          },
          "enableInboundLogging": {
            "type": "boolean",
            "title": "Enable Inbound Message Logging",
            "description": "Log all received QQ/group messages before allowlist filtering",
            "default": true
          },
          "inboundLogDir": {
            "type": "string",
            "title": "Inbound Log Directory",
            "description": "Directory to store per-user/per-group inbound logs",
            "default": "./logs/napcat-inbound"
          },
          "token": {
            "type": "string",
            "title": "HTTP API Token",
            "description": "Token for authenticating with NapCat HTTP server (Bearer token)",
            "default": ""
          }
        }
      }
    }
  },
  "configSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}