{"id":"66e82cbc-600d-4e20-adad-51e222b65d1d","entityType":"agent","slug":"clawhub-alan-stratcraftsai-clawnexus","name":"Clawnexus","canonicalUrl":"https://www.xpersona.co/agent/clawhub-alan-stratcraftsai-clawnexus","canonicalPath":"/agent/clawhub-alan-stratcraftsai-clawnexus","generatedAt":"2026-10-11T11:25:51.746Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T09:01:52.223Z","emptyReason":null},"description":"Discover, name, and manage OpenClaw instances on your LAN. Scan for AI agents, check status, set aliases, resolve .claw names, and get connection URLs via th... Skill: Clawnexus Owner: alan-stratcraftsai Summary: Discover, name, and manage OpenClaw instances on your LAN. Scan for AI agents, check status, set aliases, resolve .claw names, and get connection URLs via th... Tags: latest:0.4.1 Version history: v0.4.1 | 2026-04-30T06:32:23.297Z | auto - Removed all source code, configuration, and test files from the repository. - Project now only includes documentation; no functi","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s177srkkxmx7m7nds44r8acpfd8551fd:clawnexus","sourceUrl":"https://clawhub.ai/alan-stratcraftsai/clawnexus","homepage":"https://clawhub.ai/alan-stratcraftsai/skills/clawnexus","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/alan-stratcraftsai/clawnexus","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/alan-stratcraftsai/skills/clawnexus","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Discover, name, and manage OpenClaw instances on your LAN. Scan for AI agents, check status, set aliases, resolve .claw names, and get connection URLs via th..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T09:01:52.223Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T09:01:52.223Z","emptyReason":null},"stars":null,"forks":null,"downloads":1106,"packageName":null,"latestVersion":"0.4.1","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T09:01:52.108Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T09:01:52.223Z","lastCrawledAt":"2026-10-11T09:01:52.108Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T09:01:52.108Z","lastVerifiedAt":null,"highlights":[{"version":"0.4.1","createdAt":"2026-04-30T06:32:23.297Z","changelog":"- Removed all source code, configuration, and test files from the repository. - Project now only includes documentation; no functional code or scripts remain.","fileCount":3,"zipByteSize":3095},{"version":"0.4.0","createdAt":"2026-03-15T00:14:17.057Z","changelog":"Sync SKILL.md with curl-based commands for OpenClaw agent compatibility; add troubleshooting and workflow sections","fileCount":11,"zipByteSize":8002},{"version":"0.2.7","createdAt":"2026-03-06T03:23:43.655Z","changelog":"Fix metadata key to clawdbot, compress description, add overview and troubleshooting sections, expand keywords","fileCount":2,"zipByteSize":1820},{"version":"1.0.0","createdAt":"2026-03-05T12:17:01.091Z","changelog":"Initial release: discover and manage OpenClaw instances across your LAN","fileCount":2,"zipByteSize":1681}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s177srkkxmx7m7nds44r8acpfd8551fd:clawnexus","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T11:25:51.745Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T09:01:52.223Z","emptyReason":null},"readme":"Skill: Clawnexus\n\nOwner: alan-stratcraftsai\n\nSummary: Discover, name, and manage OpenClaw instances on your LAN. Scan for AI agents, check status, set aliases, resolve .claw names, and get connection URLs via th...\n\nTags: latest:0.4.1\n\nVersion history:\n\nv0.4.1 | 2026-04-30T06:32:23.297Z | auto\n\n- Removed all source code, configuration, and test files from the repository.\n- Project now only includes documentation; no functional code or scripts remain.\n\nv0.4.0 | 2026-03-15T00:14:17.057Z | user\n\nSync SKILL.md with curl-based commands for OpenClaw agent compatibility; add troubleshooting and workflow sections\n\nv0.2.7 | 2026-03-06T03:23:43.655Z | user\n\nFix metadata key to clawdbot, compress description, add overview and troubleshooting sections, expand keywords\n\nv1.0.0 | 2026-03-05T12:17:01.091Z | user\n\nInitial release: discover and manage OpenClaw instances across your LAN\n\nArchive index:\n\nArchive v0.4.1: 3 files, 3095 bytes\n\nFiles: skill-card.md (2168b), SKILL.md (3550b), _meta.json (128b)\n\nFile v0.4.1:SKILL.md\n\n---\nname: clawnexus\ndescription: \"Discover, name, and manage OpenClaw instances on your LAN. Scan for AI agents, check status, set aliases, resolve .claw names, and get connection URLs via the ClawNexus daemon.\"\nversion: 0.4.0\nmetadata: {\"clawdbot\": {\"emoji\": \"🦞\", \"homepage\": \"https://github.com/SilverstreamsAI/ClawNexus\", \"requires\": {\"env\": [], \"bins\": [\"curl\"]}}}\n---\n\n# ClawNexus\n\n## Overview\n\nClawNexus is a naming and discovery layer for OpenClaw. It runs a local daemon that automatically discovers OpenClaw instances on your network and assigns them readable names, so you can refer to instances by alias (e.g., \"home\") instead of IP addresses.\n\nWorks across networks too — instances can register `.claw` names (like `home.alan.id.claw`) and connect via encrypted relay from anywhere.\n\n## Prerequisites\n\n```bash\n# Install and start the daemon\nnpm install -g clawnexus\nclawnexus start\n```\n\n## When NOT to Use\n\n- Daemon not running → tell the user to run `clawnexus start` first\n- User only has one OpenClaw instance and doesn't need discovery\n- Cross-internet connections without a `.claw` name (use local LAN only)\n\n## Commands\n\n### List all known instances\n\n```bash\ncurl -s http://localhost:17890/instances | jq '.instances[] | {name: (.alias // .auto_name), status, address}'\n```\n\n### Check a specific instance (by alias, auto_name, or address:port)\n\n```bash\ncurl -s http://localhost:17890/instances/home\ncurl -s http://localhost:17890/instances/olivia\ncurl -s http://localhost:17890/instances/192.168.1.10:18789\n```\n\n### Scan the local network for OpenClaw instances\n\n```bash\ncurl -s -X POST http://localhost:17890/scan\n```\n\n### Set a friendly alias for an instance\n\n```bash\ncurl -s -X PUT http://localhost:17890/instances/olivia/alias \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"alias\": \"home\"}'\n```\n\n### Get the WebSocket URL to connect to an instance\n\n```bash\n# Get address and port, then build URL\ncurl -s http://localhost:17890/instances/home | jq '\"ws://\\(.address):\\(.gateway_port)\"'\n```\n\n### Check daemon health\n\n```bash\ncurl -s http://localhost:17890/health\n```\n\n### Resolve a .claw name (Registry, requires internet + v0.2+)\n\n```bash\ncurl -s http://localhost:17890/resolve/myagent.id.claw\n```\n\n## Workflow: \"Is home online?\"\n\n1. Check instances: `curl -s http://localhost:17890/instances`\n2. Look for alias \"home\" in the response\n3. If `status: \"online\"` → confirm to user\n4. If not found → suggest scanning: `curl -X POST http://localhost:17890/scan`\n\n## Workflow: \"Connect me to raspi\"\n\n1. Resolve: `curl -s http://localhost:17890/instances/raspi`\n2. Build URL: `ws://<address>:<gateway_port>`\n3. Report URL to user for use with OpenClaw's gateway connect\n\n## Troubleshooting\n\n- **\"Connection refused\" on localhost:17890** → The ClawNexus daemon is not running. Tell the user to run `clawnexus start`.\n- **No instances found** → The daemon may have just started. Run `curl -s -X POST http://localhost:17890/scan` to trigger a network scan, then retry listing.\n- **Instance shows `status: \"offline\"`** → The OpenClaw gateway on that machine may be stopped. The instance was previously discovered but is not currently reachable.\n\n## Notes\n\n- Instance identifiers accept: `alias`, `auto_name`, `display_name`, `agent_id`, IP address, or `address:port`\n- `auto_name` is derived from the hostname (e.g., hostname \"Olivia\" → auto_name \"olivia\")\n- `is_self: true` instances are the local machine (address `127.0.0.1`); useful for health checks\n- The daemon persists registry to `~/.clawnexus/registry.json`\n\nFile v0.4.1:_meta.json\n\n{\n  \"ownerId\": \"kn7bcm971bxt402hf9g7z95bwd82a4a6\",\n  \"slug\": \"clawnexus\",\n  \"version\": \"0.4.1\",\n  \"publishedAt\": 1777530743297\n}\n\nFile v0.4.1:skill-card.md\n\n## Description:\n\nDiscover, name, and manage OpenClaw instances on your LAN. Scan for AI agents, check status, set aliases, resolve .claw names, and get connection URLs via the ClawNexus daemon.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[alan-stratcraftsai](https://clawhub.ai/user/alan-stratcraftsai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and operators use this skill to discover OpenClaw instances, check availability, assign aliases, resolve .claw names, and produce connection URLs through a local ClawNexus daemon.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Installing and running an unpinned global daemon can execute publisher-controlled code with user-level access.\n\nMitigation: Install only a pinned, reviewed ClawNexus package from a trusted publisher and avoid sudo or administrator privileges.\n\nRisk: LAN scanning can probe systems or networks where discovery is not authorized.\n\nMitigation: Run scans only on networks where the user has permission to discover OpenClaw instances.\n\nRisk: The daemon persists discovered instance metadata in ~/.clawnexus/registry.json.\n\nMitigation: Treat the registry as local network metadata and clear it when the stored instance data is no longer needed.\n\n## Reference(s):\n\n- [ClawNexus project homepage](https://github.com/SilverstreamsAI/ClawNexus)\n- [ClawHub skill page](https://clawhub.ai/alan-stratcraftsai/skills/clawnexus)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with inline shell commands and local API examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include localhost API calls, instance status summaries, alias instructions, and WebSocket connection URLs.]\n\n## Skill Version(s):\n\n0.4.1 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v0.4.0: 11 files, 8002 bytes\n\nFiles: dist/index.d.ts (276b), dist/index.js (3533b), package.json (1276b), README.md (2132b), scripts/check.sh (334b), SKILL.md (3550b), src/index.ts (3370b), test/index.test.ts (5571b), tsconfig.json (142b), vitest.config.ts (130b), _meta.json (128b)\n\nFile v0.4.0:SKILL.md\n\n---\nname: clawnexus\ndescription: \"Discover, name, and manage OpenClaw instances on your LAN. Scan for AI agents, check status, set aliases, resolve .claw names, and get connection URLs via the ClawNexus daemon.\"\nversion: 0.4.0\nmetadata: {\"clawdbot\": {\"emoji\": \"🦞\", \"homepage\": \"https://github.com/SilverstreamsAI/ClawNexus\", \"requires\": {\"env\": [], \"bins\": [\"curl\"]}}}\n---\n\n# ClawNexus\n\n## Overview\n\nClawNexus is a naming and discovery layer for OpenClaw. It runs a local daemon that automatically discovers OpenClaw instances on your network and assigns them readable names, so you can refer to instances by alias (e.g., \"home\") instead of IP addresses.\n\nWorks across networks too — instances can register `.claw` names (like `home.alan.id.claw`) and connect via encrypted relay from anywhere.\n\n## Prerequisites\n\n```bash\n# Install and start the daemon\nnpm install -g clawnexus\nclawnexus start\n```\n\n## When NOT to Use\n\n- Daemon not running → tell the user to run `clawnexus start` first\n- User only has one OpenClaw instance and doesn't need discovery\n- Cross-internet connections without a `.claw` name (use local LAN only)\n\n## Commands\n\n### List all known instances\n\n```bash\ncurl -s http://localhost:17890/instances | jq '.instances[] | {name: (.alias // .auto_name), status, address}'\n```\n\n### Check a specific instance (by alias, auto_name, or address:port)\n\n```bash\ncurl -s http://localhost:17890/instances/home\ncurl -s http://localhost:17890/instances/olivia\ncurl -s http://localhost:17890/instances/192.168.1.10:18789\n```\n\n### Scan the local network for OpenClaw instances\n\n```bash\ncurl -s -X POST http://localhost:17890/scan\n```\n\n### Set a friendly alias for an instance\n\n```bash\ncurl -s -X PUT http://localhost:17890/instances/olivia/alias \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"alias\": \"home\"}'\n```\n\n### Get the WebSocket URL to connect to an instance\n\n```bash\n# Get address and port, then build URL\ncurl -s http://localhost:17890/instances/home | jq '\"ws://\\(.address):\\(.gateway_port)\"'\n```\n\n### Check daemon health\n\n```bash\ncurl -s http://localhost:17890/health\n```\n\n### Resolve a .claw name (Registry, requires internet + v0.2+)\n\n```bash\ncurl -s http://localhost:17890/resolve/myagent.id.claw\n```\n\n## Workflow: \"Is home online?\"\n\n1. Check instances: `curl -s http://localhost:17890/instances`\n2. Look for alias \"home\" in the response\n3. If `status: \"online\"` → confirm to user\n4. If not found → suggest scanning: `curl -X POST http://localhost:17890/scan`\n\n## Workflow: \"Connect me to raspi\"\n\n1. Resolve: `curl -s http://localhost:17890/instances/raspi`\n2. Build URL: `ws://<address>:<gateway_port>`\n3. Report URL to user for use with OpenClaw's gateway connect\n\n## Troubleshooting\n\n- **\"Connection refused\" on localhost:17890** → The ClawNexus daemon is not running. Tell the user to run `clawnexus start`.\n- **No instances found** → The daemon may have just started. Run `curl -s -X POST http://localhost:17890/scan` to trigger a network scan, then retry listing.\n- **Instance shows `status: \"offline\"`** → The OpenClaw gateway on that machine may be stopped. The instance was previously discovered but is not currently reachable.\n\n## Notes\n\n- Instance identifiers accept: `alias`, `auto_name`, `display_name`, `agent_id`, IP address, or `address:port`\n- `auto_name` is derived from the hostname (e.g., hostname \"Olivia\" → auto_name \"olivia\")\n- `is_self: true` instances are the local machine (address `127.0.0.1`); useful for health checks\n- The daemon persists registry to `~/.clawnexus/registry.json`\n\nFile v0.4.0:README.md\n\n# clawnexus-skill\n\nClawNexus Skill for OpenClaw — query and manage AI instances from within an OpenClaw conversation.\n\n## Installation\n\n```bash\nnpm install clawnexus-skill\n```\n\n## Prerequisites\n\nThe `clawnexus` daemon must be running:\n\n```bash\nnpm install -g clawnexus\nclawnexus start\n```\n\n## Requirements\n\nRequires `clawnexus >= 0.2.0`.\n\n## Actions\n\n| Action | Description | Parameters |\n|--------|-------------|------------|\n| `list` | List all known instances | — |\n| `info` | Get details for a specific instance | `name` |\n| `scan` | Scan the local network for instances | — |\n| `alias` | Set a friendly alias for an instance | `id`, `alias` |\n| `connect` | Get WebSocket URL for an instance | `name` |\n| `health` | Check daemon status | — |\n| `resolve` | Resolve a `.claw` name to an instance (Registry, v0.2+) | `name` |\n\n> `id` and `name` parameters accept any identifier in the resolve chain: alias, auto\\_name, display\\_name, agent\\_id, IP address, or `address:port`.\n\n## Usage\n\n```typescript\nimport { handleSkillRequest } from \"clawnexus-skill\";\n\n// List all instances\nconst result = await handleSkillRequest({ action: \"list\" });\n// { success: true, data: { count: 2, instances: [...] } }\n\n// Get instance info\nconst info = await handleSkillRequest({\n  action: \"info\",\n  params: { name: \"home\" },\n});\n\n// Scan the network\nconst scan = await handleSkillRequest({ action: \"scan\" });\n\n// Set an alias (id accepts alias, auto_name, address, or address:port)\nconst alias = await handleSkillRequest({\n  action: \"alias\",\n  params: { id: \"olivia\", alias: \"home\" },\n});\n\n// Get connection URL\nconst conn = await handleSkillRequest({\n  action: \"connect\",\n  params: { name: \"home\" },\n});\n// { success: true, data: { url: \"ws://192.168.1.10:18789\" } }\n\n// Resolve a .claw name (requires Registry, clawnexus >= 0.2.0)\nconst resolved = await handleSkillRequest({\n  action: \"resolve\",\n  params: { name: \"myagent.id.claw\" },\n});\n```\n\n## Configuration\n\n| Environment Variable | Description | Default |\n|---------------------|-------------|---------|\n| `CLAWNEXUS_API` | Daemon API URL | `http://localhost:17890` |\n\n## License\n\nMIT\n\nFile v0.4.0:_meta.json\n\n{\n  \"ownerId\": \"kn7bcm971bxt402hf9g7z95bwd82a4a6\",\n  \"slug\": \"clawnexus\",\n  \"version\": \"0.4.0\",\n  \"publishedAt\": 1773533657057\n}\n\nFile v0.4.0:package.json\n\n{\n  \"name\": \"clawnexus-skill\",\n  \"version\": \"0.4.0\",\n  \"description\": \"ClawNexus Skill for OpenClaw — discover, name, and manage AI instances on your local network\",\n  \"license\": \"MIT\",\n  \"author\": \"alan-silverstreams <alan@silverstream.tech>\",\n  \"homepage\": \"https://github.com/SilverstreamsAI/ClawNexus\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/SilverstreamsAI/ClawNexus.git\",\n    \"directory\": \"packages/skill\"\n  },\n  \"bugs\": \"https://github.com/SilverstreamsAI/ClawNexus/issues\",\n  \"keywords\": [\n    \"openclaw\",\n    \"ai\",\n    \"agent\",\n    \"skill\",\n    \"clawnexus\",\n    \"instance\",\n    \"management\",\n    \"discovery\",\n    \"network\",\n    \"lan\",\n    \"multi-instance\",\n    \"mdns\",\n    \"registry\",\n    \"naming\",\n    \"identity\"\n  ],\n  \"main\": \"dist/index.js\",\n  \"types\": \"dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"default\": \"./dist/index.js\"\n    }\n  },\n  \"files\": [\n    \"dist\",\n    \"SKILL.md\",\n    \"README.md\"\n  ],\n  \"scripts\": {\n    \"build\": \"tsc -p tsconfig.json\",\n    \"dev\": \"tsc -p tsconfig.json --watch\",\n    \"test\": \"vitest run\",\n    \"prepublishOnly\": \"pnpm build\"\n  },\n  \"engines\": {\n    \"node\": \">=22\"\n  },\n  \"devDependencies\": {\n    \"typescript\": \"^5.7.0\",\n    \"@types/node\": \"^22.0.0\"\n  }\n}\n\nFile v0.4.0:tsconfig.json\n\n{\n  \"extends\": \"../../tsconfig.base.json\",\n  \"compilerOptions\": {\n    \"rootDir\": \"src\",\n    \"outDir\": \"dist\"\n  },\n  \"include\": [\"src/**/*\"]\n}\n\nArchive v0.2.7: 2 files, 1820 bytes\n\nFiles: SKILL.md (3408b), _meta.json (128b)\n\nFile v0.2.7:SKILL.md\n\n---\nname: clawnexus\ndescription: \"Discover, name, and manage OpenClaw instances on your LAN. Scan for AI agents, check status, set aliases, resolve .claw names, and get connection URLs via the ClawNexus daemon.\"\nversion: 0.2.7\nmetadata: {\"clawdbot\": {\"emoji\": \"🦞\", \"homepage\": \"https://github.com/SilverstreamsAI/ClawNexus\", \"requires\": {\"env\": [], \"bins\": [\"curl\"]}}}\n---\n\n# ClawNexus\n\n## Overview\n\nClawNexus is a naming and discovery layer for OpenClaw. It runs a local daemon that automatically discovers OpenClaw instances on your network and assigns them readable names, so you can refer to instances by alias (e.g., \"home\") instead of IP addresses.\n\n## Prerequisites\n\n```bash\n# Install and start the daemon\nnpm install -g clawnexus\nclawnexus start\n```\n\n## When NOT to Use\n\n- Daemon not running → tell the user to run `clawnexus start` first\n- User only has one OpenClaw instance and doesn't need discovery\n- Cross-internet connections without a `.claw` name (use local LAN only)\n\n## Commands\n\n### List all known instances\n\n```bash\ncurl -s http://localhost:17890/instances | jq '.instances[] | {name: (.alias // .auto_name), status, address}'\n```\n\n### Check a specific instance (by alias, auto_name, or address:port)\n\n```bash\ncurl -s http://localhost:17890/instances/home\ncurl -s http://localhost:17890/instances/olivia\ncurl -s http://localhost:17890/instances/192.168.1.10:18789\n```\n\n### Scan the local network for OpenClaw instances\n\n```bash\ncurl -s -X POST http://localhost:17890/scan\n```\n\n### Set a friendly alias for an instance\n\n```bash\ncurl -s -X PUT http://localhost:17890/instances/olivia/alias \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"alias\": \"home\"}'\n```\n\n### Get the WebSocket URL to connect to an instance\n\n```bash\n# Get address and port, then build URL\ncurl -s http://localhost:17890/instances/home | jq '\"ws://\\(.address):\\(.gateway_port)\"'\n```\n\n### Check daemon health\n\n```bash\ncurl -s http://localhost:17890/health\n```\n\n### Resolve a .claw name (Registry, requires internet + v0.2+)\n\n```bash\ncurl -s http://localhost:17890/resolve/myagent.id.claw\n```\n\n## Workflow: \"Is home online?\"\n\n1. Check instances: `curl -s http://localhost:17890/instances`\n2. Look for alias \"home\" in the response\n3. If `status: \"online\"` → confirm to user\n4. If not found → suggest scanning: `curl -X POST http://localhost:17890/scan`\n\n## Workflow: \"Connect me to raspi\"\n\n1. Resolve: `curl -s http://localhost:17890/instances/raspi`\n2. Build URL: `ws://<address>:<gateway_port>`\n3. Report URL to user for use with OpenClaw's gateway connect\n\n## Troubleshooting\n\n- **\"Connection refused\" on localhost:17890** → The ClawNexus daemon is not running. Tell the user to run `clawnexus start`.\n- **No instances found** → The daemon may have just started. Run `curl -s -X POST http://localhost:17890/scan` to trigger a network scan, then retry listing.\n- **Instance shows `status: \"offline\"`** → The OpenClaw gateway on that machine may be stopped. The instance was previously discovered but is not currently reachable.\n\n## Notes\n\n- Instance identifiers accept: `alias`, `auto_name`, `display_name`, `agent_id`, IP address, or `address:port`\n- `auto_name` is derived from the hostname (e.g., hostname \"Olivia\" → auto_name \"olivia\")\n- `is_self: true` instances are the local machine (address `127.0.0.1`); useful for health checks\n- The daemon persists registry to `~/.clawnexus/registry.json`\n\nFile v0.2.7:_meta.json\n\n{\n  \"ownerId\": \"kn7bcm971bxt402hf9g7z95bwd82a4a6\",\n  \"slug\": \"clawnexus\",\n  \"version\": \"0.2.7\",\n  \"publishedAt\": 1772767423655\n}\n\nArchive v1.0.0: 2 files, 1681 bytes\n\nFiles: SKILL.md (3193b), _meta.json (128b)\n\nFile v1.0.0:SKILL.md\n\n---\r\nname: clawnexus\r\ndescription: \"Discover, name, and manage OpenClaw instances on your local network using the ClawNexus daemon. Use when: (1) user asks about other AI instances or agents on their network, (2) checking if a specific instance is online, (3) connecting to another OpenClaw instance by name, (4) scanning the LAN for OpenClaw gateways, (5) setting friendly names (aliases) for instances. NOT for: managing the OpenClaw instance the agent is currently running on, cross-internet connections without Registry setup, or tasks that don't involve multi-instance discovery.\"\r\nmetadata: { \"openclaw\": { \"emoji\": \"🦞\" } }\r\n---\r\n\r\n# ClawNexus\r\n\r\nDiscover and manage OpenClaw instances on your local network. The ClawNexus daemon (`clawnexus`) runs at `http://localhost:17890` and maintains a registry of discovered instances.\r\n\r\n## Prerequisites\r\n\r\n```bash\r\n# Install and start the daemon\r\nnpm install -g clawnexus\r\nclawnexus start\r\n```\r\n\r\n## When NOT to Use\r\n\r\n- Daemon not running → tell the user to run `clawnexus start` first\r\n- User only has one OpenClaw instance and doesn't need discovery\r\n- Cross-internet connections without a `.claw` name (use local LAN only)\r\n\r\n## Commands\r\n\r\n### List all known instances\r\n\r\n```bash\r\ncurl -s http://localhost:17890/instances | jq '.instances[] | {name: (.alias // .auto_name), status, address}'\r\n```\r\n\r\n### Check a specific instance (by alias, auto_name, or address:port)\r\n\r\n```bash\r\ncurl -s http://localhost:17890/instances/home\r\ncurl -s http://localhost:17890/instances/olivia\r\ncurl -s http://localhost:17890/instances/192.168.1.10:18789\r\n```\r\n\r\n### Scan the local network for OpenClaw instances\r\n\r\n```bash\r\ncurl -s -X POST http://localhost:17890/scan\r\n```\r\n\r\n### Set a friendly alias for an instance\r\n\r\n```bash\r\ncurl -s -X PUT http://localhost:17890/instances/olivia/alias \\\r\n  -H \"Content-Type: application/json\" \\\r\n  -d '{\"alias\": \"home\"}'\r\n```\r\n\r\n### Get the WebSocket URL to connect to an instance\r\n\r\n```bash\r\n# Get address and port, then build URL\r\ncurl -s http://localhost:17890/instances/home | jq '\"ws://\\(.address):\\(.gateway_port)\"'\r\n```\r\n\r\n### Check daemon health\r\n\r\n```bash\r\ncurl -s http://localhost:17890/health\r\n```\r\n\r\n### Resolve a .claw name (Registry, requires internet + v0.2+)\r\n\r\n```bash\r\ncurl -s http://localhost:17890/resolve/myagent.id.claw\r\n```\r\n\r\n## Workflow: \"Is home online?\"\r\n\r\n1. Check instances: `curl -s http://localhost:17890/instances`\r\n2. Look for alias \"home\" in the response\r\n3. If `status: \"online\"` → confirm to user\r\n4. If not found → suggest scanning: `curl -X POST http://localhost:17890/scan`\r\n\r\n## Workflow: \"Connect me to raspi\"\r\n\r\n1. Resolve: `curl -s http://localhost:17890/instances/raspi`\r\n2. Build URL: `ws://<address>:<gateway_port>`\r\n3. Report URL to user for use with OpenClaw's gateway connect\r\n\r\n## Notes\r\n\r\n- Instance identifiers accept: `alias`, `auto_name`, `display_name`, `agent_id`, IP address, or `address:port`\r\n- `auto_name` is derived from the hostname (e.g., hostname \"Olivia\" → auto_name \"olivia\")\r\n- `is_self: true` instances are the local machine (address `127.0.0.1`); useful for health checks\r\n- The daemon persists registry to `~/.clawnexus/registry.json`\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7bcm971bxt402hf9g7z95bwd82a4a6\",\n  \"slug\": \"clawnexus\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1772713021091\n}","readmeExcerpt":"Skill: Clawnexus Owner: alan-stratcraftsai Summary: Discover, name, and manage OpenClaw instances on your LAN. Scan for AI agents, check status, set aliases, resolve .claw names, and get connection URLs via th... Tags: latest:0.4.1 Version history: v0.4.1 | 2026-04-30T06:32:23.297Z | auto - Removed all source code, configuration, and test files from the repository. - Project now only includes documentation; no functi","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Install and start the daemon\nnpm install -g clawnexus\nclawnexus start"},{"language":"bash","snippet":"curl -s http://localhost:17890/instances | jq '.instances[] | {name: (.alias // .auto_name), status, address}'"},{"language":"bash","snippet":"curl -s http://localhost:17890/instances | jq '.instances[] | {name: (.alias // .auto_name), status, address}'"},{"language":"bash","snippet":"curl -s http://localhost:17890/instances/home"},{"language":"bash","snippet":"curl -s http://localhost:17890/instances/olivia"},{"language":"bash","snippet":"curl -s http://localhost:17890/instances/192.168.1.10:18789"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: clawnexus\ndescription: \"Discover, name, and manage OpenClaw instances on your LAN. Scan for AI agents, check status, set aliases, resolve .claw names, and get connection URLs via the ClawNexus daemon.\"\nversion: 0.4.0\nmetadata: {\"clawdbot\": {\"emoji\": \"🦞\", \"homepage\": \"https://github.com/SilverstreamsAI/ClawNexus\", \"requires\": {\"env\": [], \"bins\": [\"curl\"]}}}\n---\n\n# ClawNexus\n\n## Overview\n\nClawNexus is a naming and discovery layer for OpenClaw. It runs a local daemon that automatically discovers OpenClaw instances on your network and assigns them readable names, so you can refer to instances by alias (e.g., \"home\") instead of IP addresses.\n\nWorks across networks too — instances can register `.claw` names (like `home.alan.id.claw`) and connect via encrypted relay from anywhere.\n\n## Prerequisites\n\n```bash\n# Install and start the daemon\nnpm install -g clawnexus\nclawnexus start\n```\n\n## When NOT to Use\n\n- Daemon not running → tell the user to run `clawnexus start` first\n- User only has one OpenClaw instance and doesn't need discovery\n- Cross-internet connections without a `.claw` name (use local LAN only)\n\n## Commands\n\n### List all known instances\n\n```bash\ncurl -s http://localhost:17890/instances | jq '.instances[] | {name: (.alias // .auto_name), status, address}'\n```\n\n### Check a specific instance (by alias, auto_name, or address:port)\n\n```bash\ncurl -s http://localhost:17890/instances/home\ncurl -s http://localhost:17890/instances/olivia\ncurl -s http://localhost:17890/instances/192.168.1.10:18789\n```\n\n### Scan the local network for OpenClaw instances\n\n```bash\ncurl -s -X POST http://localhost:17890/scan\n```\n\n### Set a friendly alias for an instance\n\n```bash\ncurl -s -X PUT http://localhost:17890/instances/olivia/alias \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"alias\": \"home\"}'\n```\n\n### Get the WebSocket URL to connect to an instance\n\n```bash\n# Get address and port, then build URL\ncurl -s http://localhost:17890/instances/home | jq '\"ws://\\(.address):\\(.gateway_port)\"'\n```\n\n### Check daemon health\n\n```bash\ncurl -s http://localhost:17890/health\n```\n\n### Resolve a .claw name (Registry, requires internet + v0.2+)\n\n```bash\ncurl -s http://localhost:17890/resolve/myagent.id.claw\n```\n\n## Workflow: \"Is home online?\"\n\n1. Check instances: `curl -s http://localhost:17890/instances`\n2. Look for alias \"home\" in the response\n3. If `status: \"online\"` → confirm to user\n4. If not found → suggest scanning: `curl -X POST http://localhost:17890/scan`\n\n## Workflow: \"Connect me to raspi\"\n\n1. Resolve: `curl -s http://localhost:17890/instances/raspi`\n2. Build URL: `ws://<address>:<gateway_port>`\n3. Report URL to user for use with OpenClaw's gateway connect\n\n## Troubleshooting\n\n- **\"Connection refused\" on localhost:17890** → The ClawNexus daemon is not running. Tell the user to run `clawnexus start`.\n- **No instances found** → The daemon may have just started. Run `curl -s -X POST http://localhost:17890/scan` to trigger a network scan, then retry listing.\n- **Inst"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7bcm971bxt402hf9g7z95bwd82a4a6\",\n  \"slug\": \"clawnexus\",\n  \"version\": \"0.4.1\",\n  \"publishedAt\": 1777530743297\n}"},{"path":"skill-card.md","content":"## Description:\n\nDiscover, name, and manage OpenClaw instances on your LAN. Scan for AI agents, check status, set aliases, resolve .claw names, and get connection URLs via the ClawNexus daemon.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[alan-stratcraftsai](https://clawhub.ai/user/alan-stratcraftsai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and operators use this skill to discover OpenClaw instances, check availability, assign aliases, resolve .claw names, and produce connection URLs through a local ClawNexus daemon.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Installing and running an unpinned global daemon can execute publisher-controlled code with user-level access.\n\nMitigation: Install only a pinned, reviewed ClawNexus package from a trusted publisher and avoid sudo or administrator privileges.\n\nRisk: LAN scanning can probe systems or networks where discovery is not authorized.\n\nMitigation: Run scans only on networks where the user has permission to discover OpenClaw instances.\n\nRisk: The daemon persists discovered instance metadata in ~/.clawnexus/registry.json.\n\nMitigation: Treat the registry as local network metadata and clear it when the stored instance data is no longer needed.\n\n## Reference(s):\n\n- [ClawNexus project homepage](https://github.com/SilverstreamsAI/ClawNexus)\n- [ClawHub skill page](https://clawhub.ai/alan-stratcraftsai/skills/clawnexus)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with inline shell commands and local API examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include localhost API calls, instance status summaries, alias instructions, and WebSocket connection URLs.]\n\n## Skill Version(s):\n\n0.4.1 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Discover, name, and manage OpenClaw instances on your LAN. Scan for AI agents, check status, set aliases, resolve .claw names, and get connection URLs via th... Skill: Clawnexus Owner: alan-stratcraftsai Summary: Discover, name, and manage OpenClaw instances on your LAN. Scan for AI agents, check status, set aliases, resolve .claw names, and get connection URLs via th... Tags: latest:0.4.1 Version history: v0.4.1 | 2026-04-30T06:32:23.297Z | auto - Removed all source code, configuration, and test files from the repository. - Project now only includes documentation; no functi","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1010,"uniquenessScore":50,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T09:01:52.223Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T09:01:52.223Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T11:25:51.746Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}