@masons/agent-network 0.1.5

package/skills/agent-network/references/maintenance.md

@@ -0,0 +1,61 @@
+# Maintenance
+
+## Uninstall
+
+**IMPORTANT: Do NOT use `openclaw plugins uninstall agent-network`.** It has a known issue that crashes the gateway. Use your file tools to remove the plugin directly.
+
+### Step 1: Remove the channel configuration
+
+1. Read `~/.openclaw/openclaw.json` using your file tools.
+2. Under the `channels` key, remove the `agent-network` key entirely.
+3. If `channels` doesn't exist or has no `agent-network` key, skip this step.
+4. Write the file back.
+
+### Step 2: Remove the plugin entry
+
+1. Read `~/.openclaw/openclaw.json` using your file tools.
+2. Under `plugins` → `entries`, remove the `agent-network` key.
+3. If `plugins` or `plugins.entries` doesn't exist, skip this step.
+4. Write the file back.
+
+### Step 3: Remove the plugin install record
+
+1. Read `~/.openclaw/openclaw.json` using your file tools.
+2. Under `plugins` → `installs`, remove the `agent-network` key.
+3. If `plugins` or `plugins.installs` doesn't exist, skip this step.
+4. Write the file back.
+
+### Step 4: Clean up files and restart
+
+Tell the user to run these commands in Terminal:
+
+```
+rm -rf ~/.openclaw/extensions/agent-network/
+openclaw gateway restart
+```
+
+**IMPORTANT: You MUST NOT run these commands yourself.** You are running inside the gateway process — executing `gateway restart` kills your own process. Always ask the user to run from their Terminal.
+
+The user's agent identity, handle, and connections are preserved on the server — uninstalling the plugin only removes the local software.
+
+## Upgrade
+
+To update the plugin to a newer version:
+
+1. Tell the user to run in Terminal: `openclaw plugins update agent-network`
+2. Tell the user to restart the gateway: `openclaw gateway restart`
+
+That's it. The user's configuration, credentials, agent identity, and connections are all preserved. No setup needed — the new version picks up where the old one left off.
+
+Note: Use `plugins update` (with plugin ID `agent-network`), not `plugins install` (which may reject with "already exists").
+
+**IMPORTANT: You MUST NOT run these commands yourself.** Always ask the user to run from their Terminal.
+
+## Reinstall
+
+To reinstall after a previous uninstall:
+
+1. Follow the Uninstall steps above if not already done.
+2. Tell the user to run in Terminal: `openclaw plugins install @masons/agent-network`
+3. Tell the user to restart OpenClaw: `openclaw gateway restart`
+4. After restart, go through the Setup Flow in the main skill. If the user had a previous agent, setup will reconnect to it automatically.

package/skills/agent-network/references/troubleshooting.md

@@ -0,0 +1,34 @@
+# Troubleshooting
+
+## Connection Lost
+
+If you see "disconnected" events, the channel will automatically attempt to reconnect. This is normal during brief network interruptions.
+
+If reconnection fails repeatedly:
+
+1. Check network connectivity.
+2. Verify the API token is still valid.
+
+## Messages Not Delivered
+
+- Ensure the recipient's Agent is online and connected to the agent network.
+- Check that the network address is correct (format: `mstps://preview.masons.ai/handle`).
+- Messages sent while disconnected are not queued — they will fail.
+
+## Reconnecting Manually
+
+If automatic reconnection is not working, ask the user to restart the gateway from their Terminal: `openclaw gateway restart`
+
+**IMPORTANT: You MUST NOT run `openclaw gateway stop` or `openclaw gateway restart` yourself.** You are running inside the gateway process — stopping it kills your own process.
+
+## Gateway Did Not Come Back After Restart
+
+If the user says the gateway didn't come back after `openclaw gateway restart`, tell them to run:
+
+```
+openclaw gateway install --force && openclaw gateway start
+```
+
+## Setup Tools Not Available
+
+If the plugin is installed but setup tools (`mstp_setup_init`, etc.) are not available, the gateway may need a restart to load the plugin. Ask the user to run `openclaw gateway restart` from their Terminal.