Tailscale for Openclaw

A dual-mode management tool that integrates the Tailscale CLI and API for complete control over your private mesh network.

jmagar
v1.0.0
Jan 24, 2026
6
6.9k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install tailscale

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 tailscale 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 Tailscale?

The Tailscale skill for Openclaw Skills offers a robust interface for interacting with your tailnet, combining local machine operations with global administrative control. It enables developers and homelab enthusiasts to monitor device health, manage connectivity, and automate network security tasks directly through their AI agent. By incorporating this skill into Openclaw Skills, users gain the ability to orchestrate secure communication across diverse environments without manual CLI hunting.

Tailscale Use Cases

  • Checking the real-time online status and connectivity diagnostics of all devices in a tailnet.
  • Moving files securely between personal devices using Taildrop without external cloud storage.
  • Routing traffic through specific exit nodes to manage privacy or access geo-restricted resources.
  • Automating the creation of ephemeral auth keys for temporary cloud instances or CI/CD runners.
  • Monitoring and managing Tailscale Funnel to expose local development services to the public internet.

How Tailscale Works

  1. The skill identifies whether a requested action is local (CLI-based) or global (API-based).
  2. For local operations, it executes system-level commands to interact with the Tailscale daemon on the host machine.
  3. For tailnet-wide operations, it authenticates via the provided API key to fetch or modify data across the entire organization.
  4. Results from these operations are parsed and presented as actionable data within the Openclaw Skills environment.
  5. The skill handles complex JSON outputs from Tailscale to provide clear summaries of network health and device details.

Tailscale Setup

To enable full functionality for this skill in Openclaw Skills, first ensure the Tailscale CLI is installed and authenticated. For API-based management, create a configuration file at ~/.clawdbot/credentials/tailscale/config.json with the following structure:

{
  "apiKey": "tskey-api-your-key-here",
  "tailnet": "-"
}

You can generate your API key in the Tailscale Admin Console under Settings > Keys.

Tailscale Data Schema & Taxonomy

The skill manages data across several domains, utilizing both CLI outputs and API responses. The primary data structures include:

Component Description Key Fields
Device Status Real-time state of nodes HostName, TailscaleIP, OnlineStatus, LastSeen
Network Diagnostics Local connection health NATType, DERP, UDPStatus
Auth Keys Provisioning tokens KeyID, Reusable, Ephemeral, Expiration
Serve/Funnel Service exposure config LocalPort, PublicURL, Protocol

Tailscale Advanced Features

  • Multi-node diagnostic pings to distinguish between direct and relayed (DERP) connections.
  • Public service exposure via Tailscale Funnel for rapid prototyping and external testing.
  • Programmatic ACL (Access Control List) validation to ensure network security policies are sound before deployment.
  • Management of MagicDNS and custom nameservers for simplified internal service discovery.
  • Granular device tagging and route management via the Openclaw Skills API integration.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*