_conf_schema.json

{
  "gateway_url": {
    "description": "External gateway URL",
    "type": "string",
    "hint": "HTTP endpoint that receives AstrBot message events and returns a reply JSON.",
    "obvious_hint": true,
    "default": ""
  },
  "secret_header_name": {
    "description": "Secret header name",
    "type": "string",
    "hint": "Optional header name used for gateway authentication.",
    "default": "X-External-Gateway-Secret"
  },
  "secret": {
    "description": "Gateway secret",
    "type": "string",
    "hint": "Optional gateway secret. Store it in AstrBot config; do not commit it.",
    "obvious_hint": true,
    "default": ""
  },
  "timeout_seconds": {
    "description": "HTTP timeout seconds",
    "type": "int",
    "default": 30
  },
  "listen_all": {
    "description": "Forward ordinary messages",
    "type": "bool",
    "hint": "When disabled, only /gateway commands are forwarded.",
    "default": false
  },
  "require_wake": {
    "description": "Only forward wake/mention messages in passive mode",
    "type": "bool",
    "default": true
  },
  "stop_event_on_reply": {
    "description": "Stop later handlers when gateway returns a reply",
    "type": "bool",
    "default": true
  },
  "allowed_platforms": {
    "description": "Allowed platform adapter names",
    "type": "list",
    "hint": "Empty means all platforms. Examples: telegram, aiocqhttp, discord.",
    "default": []
  },
  "allowed_sessions": {
    "description": "Allowed unified message origins",
    "type": "list",
    "hint": "Empty means all sessions. Use this to restrict noisy groups.",
    "default": []
  },
  "extra_headers_json": {
    "description": "Extra HTTP headers JSON",
    "type": "text",
    "hint": "Optional JSON object merged into request headers.",
    "editor_mode": true,
    "editor_language": "json",
    "default": "{}"
  }
}