diff --git a/k8s/openclaw/AGENTS.md b/k8s/openclaw/AGENTS.md
index 4744a41..09e8bd5 100644
--- a/k8s/openclaw/AGENTS.md
+++ b/k8s/openclaw/AGENTS.md
@@ -65,3 +65,29 @@ Modular tool capabilities.
 
 ### 💡 Special Requirements
 - **`nano-banana-pro`**: Requires the `uv` tool. It is installed at `/home/node/.openclaw/bin/uv` (on the PVC) and included in the system `PATH`.
+
+## 🚨 Startup & Troubleshooting
+
+### Investigating Issues
+You can execute commands directly inside the running pod to inspect the environment or file system:
+```bash
+# Get the pod name
+kubectl get pods -n openclaw
+
+# Execute a command (e.g., check config)
+kubectl exec -it -n openclaw <pod-name> -c openclaw -- cat /home/node/.openclaw/openclaw.json
+
+# Check environment variables
+kubectl exec -it -n openclaw <pod-name> -c openclaw -- env | grep OPENCLAW
+```
+
+### Applying Configuration Changes
+Any change to `openclaw.secret.yaml` (ConfigMap or Deployment) requires a rollout restart to take effect:
+```bash
+kubectl apply -f k8s/openclaw/openclaw.secret.yaml
+kubectl rollout restart deployment openclaw -n openclaw
+```
+Always verify the rollout status:
+```bash
+kubectl rollout status deployment openclaw -n openclaw
+```
diff --git a/k8s/openclaw/openclaw.secret.yaml b/k8s/openclaw/openclaw.secret.yaml
index b15419a..6a3f525 100644
Binary files a/k8s/openclaw/openclaw.secret.yaml and b/k8s/openclaw/openclaw.secret.yaml differ