From 8bfc304009b7853f775b9e88c62175619baf5034 Mon Sep 17 00:00:00 2001
From: root <root@0bfc167e-openclaw-assistant.local.hass.io>
Date: Tue, 24 Feb 2026 00:08:28 +0200
Subject: [PATCH] chore(github): add issue templates for bug reports and
 feature requests

---
 .github/ISSUE_TEMPLATE/bug_report.yml      | 100 +++++++++++++++++++++
 .github/ISSUE_TEMPLATE/config.yml          |   8 ++
 .github/ISSUE_TEMPLATE/feature_request.yml |  58 ++++++++++++
 3 files changed, 166 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml
 create mode 100644 .github/ISSUE_TEMPLATE/config.yml
 create mode 100644 .github/ISSUE_TEMPLATE/feature_request.yml

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
new file mode 100644
index 0000000..d47ea1e
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,100 @@
+name: Bug report
+description: Report a reproducible problem with the OpenClaw Home Assistant add-on.
+title: "bug: "
+labels:
+  - bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting this. Please include concrete, reproducible details.
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Pre-flight checks
+      options:
+        - label: I updated to the latest add-on version and restarted it.
+          required: true
+        - label: I checked the docs/troubleshooting section first.
+          required: true
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: What happened?
+      description: Short description of the bug.
+      placeholder: Describe the broken behavior.
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: What did you expect to happen?
+      placeholder: Describe expected behavior.
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Provide exact steps and values.
+      placeholder: |
+        1) Go to ...
+        2) Set ...
+        3) Restart add-on
+        4) Observe ...
+    validations:
+      required: true
+
+  - type: input
+    id: addon_version
+    attributes:
+      label: Add-on version
+      placeholder: e.g. 0.5.52
+    validations:
+      required: true
+
+  - type: input
+    id: openclaw_version
+    attributes:
+      label: OpenClaw version (if known)
+      placeholder: e.g. 2026.2.22-2
+
+  - type: dropdown
+    id: access_mode
+    attributes:
+      label: Access mode
+      options:
+        - custom
+        - local_only
+        - lan_https
+        - lan_reverse_proxy
+        - tailnet_https
+        - unknown
+    validations:
+      required: true
+
+  - type: textarea
+    id: config
+    attributes:
+      label: Relevant add-on configuration (redacted)
+      description: Remove secrets/tokens/passwords.
+      render: yaml
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Add-on logs
+      description: Paste the relevant log section.
+      render: text
+    validations:
+      required: true
+
+  - type: textarea
+    id: extra
+    attributes:
+      label: Additional context
+      description: Network/proxy/tailscale setup, screenshots, etc.
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..f699ecb
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: OpenClaw docs
+    url: https://docs.openclaw.ai
+    about: Check troubleshooting and configuration guides first.
+  - name: OpenClaw Community Discord
+    url: https://discord.com/invite/clawd
+    about: Ask questions and share setup details with the community.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
new file mode 100644
index 0000000..6775382
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,58 @@
+name: Feature request
+description: Suggest an improvement for the OpenClaw Home Assistant add-on.
+title: "feat: "
+labels:
+  - enhancement
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the idea. Concrete use-cases help us prioritize.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem are you trying to solve?
+      placeholder: As a user, I struggle with...
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      placeholder: Describe what should be added or changed.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      placeholder: Workarounds you've tried, and why they are not enough.
+
+  - type: textarea
+    id: user_flow
+    attributes:
+      label: Suggested UX / configuration flow
+      placeholder: |
+        1) User opens ...
+        2) User sets ...
+        3) Add-on does ...
+
+  - type: textarea
+    id: impact
+    attributes:
+      label: Impact
+      description: Who benefits and how often this would be used.
+      placeholder: This helps users who...
+
+  - type: checkboxes
+    id: scope
+    attributes:
+      label: Scope
+      options:
+        - label: This is specific to the Home Assistant add-on (not upstream OpenClaw core).
+          required: false
+        - label: I can help test this on my setup.
+          required: false