BGP Protocol Analysis for Openclaw

A multi-vendor diagnostic skill for analyzing BGP peering states, path selection algorithms, and route propagation across enterprise and service provider networks.

vahagn-madatyan
v0.1.1
Mar 22, 2026
0
886
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install bgp-analysis

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install bgp-analysis using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is BGP Protocol Analysis?

The BGP Protocol Analysis skill provides a protocol-reasoning-driven approach to managing Border Gateway Protocol environments. Unlike basic health checks, this skill enables deep inspection of the BGP Finite State Machine (FSM), walking the best-path algorithm to resolve asymmetric routing, and validating complex route filtering policies.

Designed for network engineers and SREs, it offers a unified diagnostic flow across Cisco IOS-XE/NX-OS, Juniper JunOS, and Arista EOS. By using these Openclaw Skills, users can move beyond surface-level metrics to interpret the technical truth of the control plane, ensuring stable convergence and accurate prefix propagation.

BGP Protocol Analysis Use Cases

  • Troubleshooting BGP peers stuck in Idle, Connect, or Active states.
  • Investigating route leaks where prefixes appear in unauthorized tables.
  • Verifying path selection outcomes after policy changes or community updates.
  • Assessing convergence speed after planned maintenance or unplanned failover events.
  • Validating route filtering and prefix-list application to prevent transit provider issues.

How BGP Protocol Analysis Works

  1. Session Inventory: Collects and compares peer states against the expected topology to identify missing or non-established neighbors.
  2. State Diagnosis: Analyzes the BGP FSM (Idle, Connect, Active, etc.) to isolate Layer 3 reachability issues or parameter mismatches.
  3. Route Table Analysis: Verifies prefix exchange counts to detect significant deviations, withdrawals, or potential leaks.
  4. Path Selection Walkthrough: Evaluates attributes like Weight, Local Preference, and AS Path length to determine why a specific route was chosen.
  5. Filtering Validation: Inspects route-maps and prefix-lists to ensure intended policies are correctly applied to inbound and outbound traffic.
  6. Convergence Assessment: Monitors for dampened paths or high update churn to ensure network stability.

BGP Protocol Analysis Setup

Ensure you have SSH access to the target routers with read-only privileges. This skill requires the ssh binary available in your environment.

To begin a diagnostic session, use the following commands based on your vendor:

# Cisco IOS-XE/NX-OS
show bgp ipv4 unicast summary

# Juniper JunOS
show bgp summary

# Arista EOS
show ip bgp summary

BGP Protocol Analysis Data Schema & Taxonomy

The skill organizes protocol data into structured reports and comparison tables:

Data Point Description Key Indicators
Peer State Current FSM status Established vs. Non-Established
Prefix Count Routes received/advertised >10% deviation triggers alerts
Path Attributes BGP decision criteria Local Pref, AS-Path, MED, etc.
Timer Values Protocol timings Hold, Keepalive, and MRAI intervals

Standardized report templates include sections for Session Status, Findings (Severity/Root Cause), and Path Analysis.

BGP Protocol Analysis Advanced Features

  • Multi-vendor syntax mapping for seamless operations across Cisco, Juniper, and Arista environments.
  • Detailed FSM error decoding to identify MD5 mismatches, TTL issues, or capability negotiation failures.
  • Convergence target benchmarking for eBGP and iBGP failover scenarios.
  • Protocol-first reasoning trees for resolving complex issues like route oscillation and memory pressure from full internet tables.
  • Support for RFC 8092 Large Communities to ensure end-to-end propagation in transit networks.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*