netstatus — Network + Gateway Status

Show combined network and gateway status including VPN state, public IP location, local network details, Tailscale, and system health.

When to Use

Use /netstatus or /net when you want a quick overview of:

• Current VPN connection (country, IP, provider)
• Local network interfaces and private IPs
• Tailscale / mesh network status
• Gateway health and uptime
• System status
• Whether traffic is routed through VPN or direct

Commands

Output Format

🌐 Network Status
━━━━━━━━━━━━━━━━━━━━━
🛡️ VPN: ProtonVPN 🇸🇪 (Stockholm)
    Public IP: 159.26.108.93
    Provider: AS208172 Proton AG
    Interface: utun2 (mtu 1380)

🏠 Local Network
    WiFi (en0): 192.168.1.42
    Gateway: 192.168.1.1

🔗 Tailscale
    Interface: utun3
    IPs: 100.92.54.38, fd7a:115c:a1e0::1
    Status: running

🌍 Public IP: 159.26.108.93 (same as VPN — no leak)

🖥️ Gateway: Running (14h 29m)
    Model: kimi/k2.7
    Context: 27k/131k (20%)

⏱️ System: 19h 44m uptime
    Load: 2.32 1.82 1.62

Or compact mode:

🌐 SE 159.26.108.93 | 🏠 192.168.1.42 | 🖥️ k2.7 20% | ⏱️ 19h 44m

Implementation

The skill runs these checks in sequence:

1. All Network Interfaces

# macOS: list all interfaces with their IPv4/IPv6 addresses
ifconfig | awk '/^[a-zA-Z0-9]+:/ { iface=$1 } /inet / { print iface, $2 }'

# Alternative: get specific interface IPs
ipconfig getifaddr en0  # WiFi
ipconfig getifaddr en1  # Ethernet / Thunderbolt

Interface categories to detect:

2. VPN Detection

# Check for tunnel interfaces
ifconfig | grep -E "^(utun|tun|ppp)"

# Get public IP via VPN
curl -s --connect-timeout 5 https://ipinfo.io/json

3. Tailscale Detection

# Check if tailscaled is running
pgrep -x tailscaled >/dev/null && echo "running" || echo "stopped"

# Tailscale IPs (if interface exists)
ifconfig utun3 2>/dev/null | grep inet

# Or use tailscale CLI
tailscale status --json 2>/dev/null | jq -r '.Self.TailscaleIPs[]'

4. Default Gateway

# macOS
netstat -rn | grep default | head -3

# Linux
ip route | grep default

5. IP Location

curl -s --connect-timeout 5 https://ipinfo.io/json

6. Gateway Status

Read from runtime or openclaw gateway status.

7. System Uptime

# macOS
uptime

# Linux
uptime -p

Interface Categorization Rules

1. Physical: en*, eth*, wlan* → "Local Network"
2. VPN tunnel: utun*, tun*, ppp* with public IP or non-local range → "VPN"
3. Tailscale: utun* with 100.64.0.0/10 range → "Tailscale"
4. Loopback: lo* → skip or show as "Loopback"
5. Other: awdl*, bridge* → "Other" or skip

IP Leak Detection

Compare VPN state against public IP reachability:

• If VPN interfaces exist AND public IP is reachable → traffic routed through VPN ✅
• If no VPN interfaces but public IP exists → direct connection (no VPN)

Note: The public IP will NOT match the VPN tunnel interface IP (e.g., ProtonVPN uses 10.x.x.x on the tunnel while the exit IP is public). Checking for IP equality is incorrect — instead, check if VPN is up and internet is reachable.

macOS vs Linux

Error States

Notes

• Uses ipinfo.io for geolocation (free tier, no auth needed)
• Caches result for 30 seconds to avoid rate limits
• Requires curl, jq, ifconfig (macOS) or ip (Linux)
• VPN detection uses utun on macOS, tun on Linux
• Tailscale uses 100.64.0.0/10 (CGNAT range) for mesh IPs