name: Bug report
description: Report defects, including regressions, crashes, and behavior bugs.
title: "[Bug]: "
labels:
  - bug
body:
  - type: markdown
    attributes:
      value: |
        Thanks for filing this report. Keep it concise, reproducible, and evidence-based.
  - type: dropdown
    id: bug_type
    attributes:
      label: Bug type
      description: Choose the category that best matches this report.
      options:
        - Regression (worked before, now fails)
        - Crash (process/app exits or hangs)
        - Behavior bug (incorrect output/state without crash)
    validations:
      required: true
  - type: textarea
    id: summary
    attributes:
      label: Summary
      description: One-sentence statement of what is broken.
      placeholder: After upgrading to <version>, <channel> behavior regressed from <prior version>.
    validations:
      required: true
  - type: textarea
    id: repro
    attributes:
      label: Steps to reproduce
      description: Provide the shortest deterministic repro path.
      placeholder: |
        1. Configure channel X.
        2. Send message Y.
        3. Run command Z.
    validations:
      required: true
  - type: textarea
    id: expected
    attributes:
      label: Expected behavior
      description: What should happen if the bug does not exist.
      placeholder: Agent posts a reply in the same thread.
    validations:
      required: true
  - type: textarea
    id: actual
    attributes:
      label: Actual behavior
      description: What happened instead, including user-visible errors.
      placeholder: No reply is posted; gateway logs "reply target not found".
    validations:
      required: true
  - type: input
    id: version
    attributes:
      label: OpenClaw version
      description: Exact version/build tested.
      placeholder: <version such as 2026.2.17>
    validations:
      required: true
  - type: input
    id: os
    attributes:
      label: Operating system
      description: OS and version where this occurs.
      placeholder: macOS 15.4 / Ubuntu 24.04 / Windows 11
    validations:
      required: true
  - type: input
    id: install_method
    attributes:
      label: Install method
      description: How OpenClaw was installed or launched.
      placeholder: npm global / pnpm dev / docker / mac app
  - type: input
    id: model
    attributes:
      label: Model
      description: Effective model under test.
      placeholder: minimax/text-01 / openrouter/anthropic/claude-opus-4.1 / anthropic/claude-sonnet-4.5
    validations:
      required: true
  - type: input
    id: provider_chain
    attributes:
      label: Provider / routing chain
      description: Effective request path through gateways, proxies, providers, or model routers.
      placeholder: openclaw -> cloudflare-ai-gateway -> minimax
    validations:
      required: true
  - type: input
    id: config_location
    attributes:
      label: Config file / key location
      description: Optional. Relevant config source or key path if this bug depends on overrides or custom provider setup. Redact secrets.
      placeholder: ~/.openclaw/openclaw.json ; models.providers.cloudflare-ai-gateway.baseUrl ; ~/.openclaw/agents/<agentId>/agent/models.json
  - type: textarea
    id: provider_setup_details
    attributes:
      label: Additional provider/model setup details
      description: Optional. Include redacted routing details, per-agent overrides, auth-profile interactions, env/config context, or anything else needed to explain the effective provider/model setup. Do not include API keys, tokens, or passwords.
      placeholder: |
        Default route is openclaw -> cloudflare-ai-gateway -> minimax.
        Previous setup was openclaw -> cloudflare-ai-gateway -> openrouter -> minimax.
        Relevant config lives in ~/.openclaw/openclaw.json under models.providers.minimax and models.providers.cloudflare-ai-gateway.
  - type: textarea
    id: logs
    attributes:
      label: Logs, screenshots, and evidence
      description: Include redacted logs/screenshots/recordings that prove the behavior.
      render: shell
  - type: textarea
    id: impact
    attributes:
      label: Impact and severity
      description: |
        Explain who is affected, how severe it is, how often it happens, and the practical consequence.
        Include:
        - Affected users/systems/channels
        - Severity (annoying, blocks workflow, data risk, etc.)
        - Frequency (always/intermittent/edge case)
        - Consequence (missed messages, failed onboarding, extra cost, etc.)
      placeholder: |
        Affected: Telegram group users on <version>
        Severity: High (blocks replies)
        Frequency: 100% repro
        Consequence: Agents cannot respond in threads
  - type: textarea
    id: additional_information
    attributes:
      label: Additional information
      description: Add any context that helps triage but does not fit above. If this is a regression, include the last known good and first known bad versions.
      placeholder: Last known good version <...>, first known bad version <...>, temporary workaround is ...