diff --git a/docs/clawd-md.md b/docs/clawd-md.md
new file mode 100644
index 000000000..b29b938c0
--- /dev/null
+++ b/docs/clawd-md.md
@@ -0,0 +1,13 @@
+---
+summary: "Redirect: /clawd.md → /clawd"
+permalink: /clawd.md
+---
+
+<!-- {% raw %} -->
+<script>
+  window.location.replace("{{ \"/clawd\" | relative_url }}");
+</script>
+
+If you’re not redirected automatically, go to
+<a href="{{ \"/clawd\" | relative_url }}">/clawd</a>.
+<!-- {% endraw %} -->
diff --git a/docs/index.md b/docs/index.md
index 086a6b91b..b0f7ba2a3 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -20,7 +20,7 @@ read_when:
 <p align="center">
   <a href="https://github.com/steipete/clawdis">GitHub</a> ·
   <a href="https://www.npmjs.com/package/clawdis">npm</a> ·
-  <a href="./clawd.md">Clawd setup</a>
+  <a href="./clawd">Clawd setup</a>
 </p>
 
 CLAWDIS bridges WhatsApp (via WhatsApp Web / Baileys) and Telegram (Bot API / grammY) to coding agents like [Pi](https://github.com/badlogic/pi-mono).