From ad4f4388f41fd11aa6ef13f180628f396e783a10 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sun, 18 Jan 2026 08:15:12 +0000
Subject: [PATCH] docs: explain per-agent exec node binding

---
 docs/cli/config.md | 8 ++++++++
 docs/tools/exec.md | 7 +++++++
 2 files changed, 15 insertions(+)

diff --git a/docs/cli/config.md b/docs/cli/config.md
index 4e9045ba8..d285f6da7 100644
--- a/docs/cli/config.md
+++ b/docs/cli/config.md
@@ -15,6 +15,7 @@ the configure wizard (same as `clawdbot configure`).
 clawdbot config get browser.executablePath
 clawdbot config set browser.executablePath "/usr/bin/google-chrome"
 clawdbot config set agents.defaults.heartbeat.every "2h"
+clawdbot config set agents.list[0].tools.exec.node "node-id-or-name"
 clawdbot config unset tools.web.search.apiKey
 ```
 
@@ -27,6 +28,13 @@ clawdbot config get agents.defaults.workspace
 clawdbot config get agents.list[0].id
 ```
 
+Use the agent list index to target a specific agent:
+
+```bash
+clawdbot config get agents.list
+clawdbot config set agents.list[1].tools.exec.node "node-id-or-name"
+```
+
 ## Values
 
 Values are parsed as JSON5 when possible; otherwise they are treated as strings.
diff --git a/docs/tools/exec.md b/docs/tools/exec.md
index ee07945a7..72cafe869 100644
--- a/docs/tools/exec.md
+++ b/docs/tools/exec.md
@@ -41,6 +41,13 @@ Notes:
 - `tools.exec.ask` (default: `on-miss`)
 - `tools.exec.node` (default: unset)
 
+Per-agent node binding (use the agent list index in config):
+
+```bash
+clawdbot config get agents.list
+clawdbot config set agents.list[0].tools.exec.node "node-id-or-name"
+```
+
 ## Session overrides (`/exec`)
 
 Use `/exec` to set **per-session** defaults for `host`, `security`, `ask`, and `node`.