feat: merge community PRs #164 and #167

PR #164 (WeZZard): document A2A_NODE_ID setup in SKILL.md, warn when unset
PR #167 (Golden-Koi): cron keepalive best practice in README.md

Co-authored-by: WeZZard <wezzard@users.noreply.github.com>
Co-authored-by: Golden-Koi <263994476+Golden-Koi@users.noreply.github.com>

Author: 3 people

README.md

@@ -129,6 +129,17 @@ node src/ops/lifecycle.js status   # show running state
 node src/ops/lifecycle.js check    # health check + auto-restart if stagnant
 ```
 
+### Cron / external runner keepalive
+If you run a periodic keepalive/tick from a cron/agent runner, prefer a single simple command with minimal quoting.
+
+Recommended:
+
+```bash
+bash -lc 'node index.js --loop'
+```
+
+Avoid composing multiple shell segments inside the cron payload (for example `...; echo EXIT:$?`) because nested quotes can break after passing through multiple serialization/escaping layers.
+
 ## Public Release
 
 This repository is the public distribution.

SKILL.md

@@ -37,10 +37,31 @@ To run in an infinite loop (e.g., via cron or background process), use the `--lo
 node index.js --loop
 ```
 
+## Setup
+
+Before using this skill, register your node identity with the EvoMap network:
+
+1. Run the hello flow (via `evomap.js` or the EvoMap onboarding) to receive a `node_id` and claim code
+2. Visit `https://evomap.ai/claim/<claim-code>` within 24 hours to bind the node to your account
+3. Set the node identity in your environment:
+
+```bash
+export A2A_NODE_ID=node_xxxxxxxxxxxx
+```
+
+Or in your agent config (e.g., `~/.openclaw/openclaw.json`):
+
+```json
+{ "env": { "A2A_NODE_ID": "node_xxxxxxxxxxxx" } }
+```
+
+Do not hardcode the node ID in scripts. `getNodeId()` in `src/gep/a2aProtocol.js` reads `A2A_NODE_ID` automatically -- any script using the protocol layer will pick it up without extra configuration.
+
 ## Configuration
 
 | Environment Variable | Default | Description |
 |---|---|---|
+| `A2A_NODE_ID` | (required) | Your EvoMap node identity. Set this after node registration -- never hardcode it in scripts. Read automatically by `getNodeId()` in `a2aProtocol.js`. |
 | `EVOLVE_ALLOW_SELF_MODIFY` | `false` | Allow evolution to modify evolver's own source code. **NOT recommended for production.** Enabling this can cause instability -- the evolver may introduce bugs into its own prompt generation, validation, or solidify logic, leading to cascading failures that require manual intervention. Only enable for controlled experiments. |
 | `EVOLVE_LOAD_MAX` | `2.0` | Maximum 1-minute load average before evolver backs off. |
 | `EVOLVE_STRATEGY` | `balanced` | Evolution strategy: `balanced`, `innovate`, `harden`, `repair-only`, `early-stabilize`, `steady-state`, or `auto`. |

src/gep/a2aProtocol.js

@@ -83,6 +83,10 @@ function getNodeId() {
     return _cachedNodeId;
   }
 
+  console.warn('[a2aProtocol] A2A_NODE_ID is not set. Computing node ID from device fingerprint. ' +
+    'This ID may change across machines or environments. ' +
+    'Set A2A_NODE_ID after registering at https://evomap.ai to use a stable identity.');
+
   const deviceId = getDeviceId();
   const agentName = process.env.AGENT_NAME || 'default';
   const raw = deviceId + '|' + agentName + '|' + process.cwd();