kbarbel640-del Meshtastic Skill
Complete Meshtastic LoRa mesh network control through Mesh Master API integration.
Overview
This skill provides comprehensive mesh network control by communicating with Mesh Master (running on Raspberry Pi or other device). Mesh Master handles the actual Meshtastic device connection; this skill provides the natural language interface.
Architecture
Clawdbot (this skill)
↓ HTTP API calls
Mesh Master (RPi, Flask app)
↓ Python meshtastic library
Meshtastic Device (LoRa radio)
Connection Methods
1. Local Network (Recommended)
MESH_MASTER_URL=http://192.168.1.100:5000
- Fast, direct communication
- No VPN overhead
- Requires both on same WiFi
2. Tailscale VPN (Remote)
MESH_MASTER_URL=http://100.64.x.x:5000
- Secure, works remotely
- Uses Tailscale private network
- Slightly higher latency
3. USB Serial (Direct)
MESHTASTIC_PORT=/dev/ttyUSB0
- Direct connection to Meshtastic device
- Runs Meshtastic CLI locally
- No Mesh Master required
Commands & Capabilities
Messaging
Send Message to Node
"send a message to bob: hello there"
"msg @snmo thanks for the update"
"/snmo how's the weather?"
Sends via Mesh Master relay system with ACK tracking.
Send to Channel/Group
"broadcast: emergency shelter needed"
"send to camping group: dinner at 7pm"
"ch 1 everyone gather at base"
Sends to entire channel, respects quiet hours.
Network Status
View All Nodes
"show me all nodes"
"who's on the mesh?"
"list network nodes"
Returns formatted table with signal strength, battery, location.
Node Details
"show info for node WH3R"
"what's the signal to brian?"
"node details for !ba4bf9d0"
Returns signal, battery, telemetry, position, last seen.
Network Metrics
"mesh health"
"network status"
"how many nodes online?"
Returns hop count, air utilization, message throughput.
Channel Management
List Channels
"show channels"
"what channels are active?"
"list all channels"
Switch Channel
"use channel camping"
"switch to ch 2"
"primary channel"
Create Channel
"add channel hiking"
"new channel for rescue-ops"
"create channel with name scout-ops"
Configure Channel
"set channel 1 name to hiking"
"configure camping channel encryption random"
"change modem preset to long-slow"
Delete Channel
"remove channel 2"
"delete camping channel"
Radio Settings
View Settings
"show radio config"
"what's the lora settings?"
"get device settings"
Change Settings
"set lora region to US"
"change device role to repeater"
"set power mode to always on"
"configure wifi ssid mywifi password mypass"
Export/Import Config
"export configuration"
"save config to file"
"load configuration from backup.yaml"
Telemetry & Requests
Request Telemetry
"get telemetry from bob"
"request position from WH3R"
"battery status for all nodes"
Traceroute
"traceroute to !ba4bf9d0"
"how do i reach node camping?"
Position & Location
Set Position
"set my location to 40.7128 -74.0060"
"location 39.7392 -104.9903 1234m"
"my coordinates 25.2 -16.8"
View Positions
"show all locations"
"where's bob?"
"node positions map"
Ham Radio
Enable Ham Mode
"enable ham mode with callsign KI1345"
"set ham radio KI1345"
Enables unencrypted operation for licensed operators.
Disable Ham Mode
"disable ham mode"
"back to normal encryption"
Device Management
Rename Device
"rename myself to Snail"
"set owner John Smith"
"short name JS"
Get Info
"show device info"
"radio status"
"firmware version"
Reboot Device
"reboot radio"
"restart meshtastic"
Advanced
QR Code
"show channel qr"
"generate qr for all channels"
"qr code"
Canned Messages
"set canned messages: hello | busy | brb"
"get canned messages"
Ringtone
"set ringtone <rtttl-string>"
"get ringtone"
Configure MQTT
"enable mqtt server.com:1883"
"set mqtt username user password pass"
Configuration
Environment Variables
# Mesh Master location
export MESH_MASTER_URL="http://192.168.1.100:5000"
# or
export MESH_MASTER_URL="http://100.64.x.x:5000" # Tailscale
# Direct Meshtastic connection (optional)
export MESHTASTIC_PORT="/dev/ttyUSB0"
# Timeouts
export MESH_TIMEOUT=10 # seconds
# Debug logging
export MESH_DEBUG=true
Local Development
For testing without Mesh Master:
# Mock mode (simulates responses)
export MESH_MOCK=true
Performance
- Message send: 0.5-2s (depends on mesh)
- Node list: 1-3s
- Configuration: 1-5s (device reboot)
- Telemetry request: 2-10s (varies with distance)
Error Handling
The skill handles:
- Mesh Master connection failures → Clear error message + retry option
- Invalid node IDs → Searches for partial match or suggests valid nodes
- Network timeout → Waits with "mesh is slow" message
- Malformed input → Clarifies what you meant with examples
References
- cli-commands.md - Complete Meshtastic CLI command reference
- mesh-master-api.md - Mesh Master API endpoints and examples
- networking.md - Tailscale setup & network troubleshooting
- examples.md - Real-world usage scenarios
Troubleshooting
"Can't reach Mesh Master"
- Check MESH_MASTER_URL is correct
- Verify Mesh Master is running on RPi
- Check network/WiFi/Tailscale connectivity
- Firewall port 5000 access
"Node not found"
- Verify node is on mesh (use
/nodescommand) - Try using node's short name instead of ID
- May need to wait for node to join network
"Message failed to send"
- Check destination node is reachable
- Verify channel encryption matches
- Try broadcasting instead (reaches more nodes)
- Check quiet hours setting
"Settings change didn't apply"
- Device may need reboot
- Some settings require channel reconfiguration
- Check device firmware compatibility
GitHub & Deployment
This skill is published to GitHub with full security review:
- ✅
.gitignoreprevents credential leakage - ✅ No hardcoded API keys
- ✅ All sensitive values from environment
- ✅ Configuration templates provided
To integrate with Mesh Master:
- Clone skill into
~/Mesh-Master/mesh_master/skills/meshtastic/ - Add to Mesh Master's command registry
- Restart Mesh Master
- Commands available in dashboard & Telegram bot
Security
- API calls use environment-based credentials only
- No logs contain actual message content
- Respects user privacy & mesh encryption
- Compatible with Mesh Master's security model