Clawnexus
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
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
0.4.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 0.4.1release · observed Apr 30, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s177srkkxmx7m7nds44r8acpfd8551fd:clawnexus- 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: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/snapshot"
Documentation
CLAWHUB
21,616 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
---
name: clawnexus
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 the ClawNexus daemon."
version: 0.4.0
metadata: {"clawdbot": {"emoji": "🦞", "homepage": "https://github.com/SilverstreamsAI/ClawNexus", "requires": {"env": [], "bins": ["curl"]}}}
---
# ClawNexus
## Overview
ClawNexus 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.
Works across networks too — instances can register `.claw` names (like `home.alan.id.claw`) and connect via encrypted relay from anywhere.
## Prerequisites
```bash
# Install and start the daemon
npm install -g clawnexus
clawnexus start
```
## When NOT to Use
- Daemon not running → tell the user to run `clawnexus start` first
- User only has one OpenClaw instance and doesn't need discovery
- Cross-internet connections without a `.claw` name (use local LAN only)
## Commands
### List all known instances
```bash
curl -s http://localhost:17890/instances | jq '.instances[] | {name: (.alias // .auto_name), status, address}'
```
### Check a specific instance (by alias, auto_name, or address:port)
```bash
curl -s http://localhost:17890/instances/home
curl -s http://localhost:17890/instances/olivia
curl -s http://localhost:17890/instances/192.168.1.10:18789
```
### Scan the local network for OpenClaw instances
```bash
curl -s -X POST http://localhost:17890/scan
```
### Set a friendly alias for an instance
```bash
curl -s -X PUT http://localhost:17890/instances/olivia/alias \
-H "Content-Type: application/json" \
-d '{"alias": "home"}'
```
### Get the WebSocket URL to connect to an instance
```bash
# Get address and port, then build URL
curl -s http://localhost:17890/instances/home | jq '"ws://\(.address):\(.gateway_port)"'
```
### Check daemon health
```bash
curl -s http://localhost:17890/health
```
### Resolve a .claw name (Registry, requires internet + v0.2+)
```bash
curl -s http://localhost:17890/resolve/myagent.id.claw
```
## Workflow: "Is home online?"
1. Check instances: `curl -s http://localhost:17890/instances`
2. Look for alias "home" in the response
3. If `status: "online"` → confirm to user
4. If not found → suggest scanning: `curl -X POST http://localhost:17890/scan`
## Workflow: "Connect me to raspi"
1. Resolve: `curl -s http://localhost:17890/instances/raspi`
2. Build URL: `ws://<address>:<gateway_port>`
3. Report URL to user for use with OpenClaw's gateway connect
## Troubleshooting
- **"Connection refused" on localhost:17890** → The ClawNexus daemon is not running. Tell the user to run `clawnexus start`.
- **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.
- **Inst_meta.json
{
"ownerId": "kn7bcm971bxt402hf9g7z95bwd82a4a6",
"slug": "clawnexus",
"version": "0.4.1",
"publishedAt": 1777530743297
}skill-card.md
## 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 the ClawNexus daemon. This skill is ready for commercial/non-commercial use. ## Publisher: [alan-stratcraftsai](https://clawhub.ai/user/alan-stratcraftsai) ### License/Terms of Use: MIT-0 ## Use Case: Developers 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. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Installing and running an unpinned global daemon can execute publisher-controlled code with user-level access. Mitigation: Install only a pinned, reviewed ClawNexus package from a trusted publisher and avoid sudo or administrator privileges. Risk: LAN scanning can probe systems or networks where discovery is not authorized. Mitigation: Run scans only on networks where the user has permission to discover OpenClaw instances. Risk: The daemon persists discovered instance metadata in ~/.clawnexus/registry.json. Mitigation: Treat the registry as local network metadata and clear it when the stored instance data is no longer needed. ## Reference(s): - [ClawNexus project homepage](https://github.com/SilverstreamsAI/ClawNexus) - [ClawHub skill page](https://clawhub.ai/alan-stratcraftsai/skills/clawnexus) ## Skill Output: **Output Type(s):** [text, markdown, shell commands, configuration, guidance] **Output Format:** [Markdown guidance with inline shell commands and local API examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [May include localhost API calls, instance status summaries, alias instructions, and WebSocket connection URLs.] ## Skill Version(s): 0.4.1 (source: server release evidence) ## Ethical Considerations: Users 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.
AionUi
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!
activepieces
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
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/alan-stratcraftsai/skills/clawnexus",
"sourceUrl": "https://clawhub.ai/alan-stratcraftsai/skills/clawnexus",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T09:01:52.223Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T09:01:52.223Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/alan-stratcraftsai/clawnexus",
"sourceUrl": "https://clawhub.ai/alan-stratcraftsai/clawnexus",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T09:01:52.223Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.4.1",
"href": "https://clawhub.ai/alan-stratcraftsai/clawnexus",
"sourceUrl": "https://clawhub.ai/alan-stratcraftsai/clawnexus",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-30T06:32:23.297Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-alan-stratcraftsai-clawnexus/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.4.1",
"description": "- Removed all source code, configuration, and test files from the repository. - Project now only includes documentation; no functional code or scripts remain.",
"href": "https://clawhub.ai/alan-stratcraftsai/clawnexus",
"sourceUrl": "https://clawhub.ai/alan-stratcraftsai/clawnexus",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-30T06:32:23.297Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
