diff --git a/docker/docker-compose.local.yml b/docker/docker-compose.local.yml
index 2caabd652..e93d9814d 100644
--- a/docker/docker-compose.local.yml
+++ b/docker/docker-compose.local.yml
@@ -1,4 +1,27 @@
 services:
+  # ─────────────────────────────────────────────
+  # PicoClaw Agent (one-shot query)
+  #   docker compose -f docker/docker-compose.yml run --rm picoclaw-agent -m "Hello"
+  # ─────────────────────────────────────────────
+  picoclaw-agent:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile
+    userns_mode: "keep-id"
+    container_name: picoclaw-agent
+    security_opt:
+      - label=disable
+    profiles:
+      - agent
+    # Uncomment to access host network; leave commented unless needed.
+    #extra_hosts:
+    # - "host.docker.internal:host-gateway"
+    volumes:
+      - ./data:/home/picoclaw/.picoclaw:Z
+    entrypoint: ["picoclaw", "agent"]
+    stdin_open: true
+    tty: true
+
   # ─────────────────────────────────────────────
   # PicoClaw Gateway (Long-running Bot)
   #   docker compose -f docker/docker-compose.yml up picoclaw-gateway