Home/stef-openclaw-skills
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: clarify nordvpn mac setup flow

Browse Source
This commit is contained in:
Stefano Fiorini
2026-03-11 23:53:15 -05:00
parent d1b4d58c5d
commit 78be4fc600
3 changed files with 23 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
docs/nordvpn-client.md
View File

@@ -39,6 +39,14 @@ node skills/nordvpn-client/scripts/nordvpn-client.js disconnect
- `NordVPN.app` may stay installed but is only the manual fallback - `NordVPN.app` may stay installed but is only the manual fallback
- the app login is not reused by the automated WireGuard backend - the app login is not reused by the automated WireGuard backend
Quick start:
1. `node skills/nordvpn-client/scripts/nordvpn-client.js install`
2. set `NORDVPN_TOKEN` or `NORDVPN_TOKEN_FILE`
3. `node skills/nordvpn-client/scripts/nordvpn-client.js login`
4. `node skills/nordvpn-client/scripts/nordvpn-client.js connect --country "Italy"` or `--city "Milan"`
5. `node skills/nordvpn-client/scripts/nordvpn-client.js verify`
### Linux ### Linux
- install path follows NordVPN's official installer script - install path follows NordVPN's official installer script

11
skills/nordvpn-client/SKILL.md
View File

@@ -40,6 +40,7 @@ node scripts/nordvpn-client.js disconnect
- macOS: - macOS:
- preferred backend is NordLynx/WireGuard using `wireguard-go` and `wireguard-tools` - preferred backend is NordLynx/WireGuard using `wireguard-go` and `wireguard-tools`
- `install` bootstraps those tools with Homebrew - `install` bootstraps those tools with Homebrew
- equivalent Homebrew command: `brew install wireguard-go wireguard-tools`
- `login` validates `NORDVPN_TOKEN` / `NORDVPN_TOKEN_FILE` for the WireGuard backend - `login` validates `NORDVPN_TOKEN` / `NORDVPN_TOKEN_FILE` for the WireGuard backend
- `NordVPN.app` can remain installed, but it is only the manual fallback - `NordVPN.app` can remain installed, but it is only the manual fallback
@@ -73,6 +74,16 @@ Optional credential file env vars:
Use this skill first, then run the follow-up task under the active VPN session. Use this skill first, then run the follow-up task under the active VPN session.
Use `verify` when you want an explicit post-connect location check without changing VPN state. Use `verify` when you want an explicit post-connect location check without changing VPN state.
## macOS Quick Start
For an automated macOS flow:
1. `node scripts/nordvpn-client.js install`
2. set `NORDVPN_TOKEN` or `NORDVPN_TOKEN_FILE`
3. `node scripts/nordvpn-client.js login`
4. `node scripts/nordvpn-client.js connect --country "Italy"` or `--city "Milan"`
5. `node scripts/nordvpn-client.js verify`
## Known Boundaries ## Known Boundaries
- Linux country/city connect remains whatever the official `nordvpn` CLI supports. - Linux country/city connect remains whatever the official `nordvpn` CLI supports.

8
skills/nordvpn-client/scripts/nordvpn-client.js
View File

@@ -369,7 +369,7 @@ function buildStateSummary(installProbe, ipInfo) {
recommendedAction = installProbe.tokenAvailable recommendedAction = installProbe.tokenAvailable
? installProbe.wireguard.sudoReady ? installProbe.wireguard.sudoReady
? "Use token-based WireGuard automation on macOS." ? "Use token-based WireGuard automation on macOS."
: "WireGuard tooling and token are available, but connect/disconnect require non-interactive sudo for wg-quick." : "WireGuard tooling and token are available, but connect/disconnect require non-interactive sudo for wg-quick. Authorize sudo for wg-quick, then rerun login/connect."
: "Set NORDVPN_TOKEN or NORDVPN_TOKEN_FILE for automated macOS NordLynx/WireGuard connects."; : "Set NORDVPN_TOKEN or NORDVPN_TOKEN_FILE for automated macOS NordLynx/WireGuard connects.";
} else if (installProbe.platform === "darwin" && installProbe.appInstalled) { } else if (installProbe.platform === "darwin" && installProbe.appInstalled) {
controlMode = "app-manual"; controlMode = "app-manual";
@@ -377,14 +377,14 @@ function buildStateSummary(installProbe, ipInfo) {
loginMode = "app-manual"; loginMode = "app-manual";
connectMode = "app-manual"; connectMode = "app-manual";
recommendedAction = installProbe.tokenAvailable recommendedAction = installProbe.tokenAvailable
? "NordVPN.app is installed, but automated macOS connects also require wireguard-go and wireguard-tools. Run install to bootstrap them." ? "NordVPN.app is installed, but automated macOS connects also require wireguard-go and wireguard-tools. Run 'node scripts/nordvpn-client.js install' to install them with Homebrew."
: "NordVPN.app is installed. Without a PATH-visible CLI or a NordVPN token plus WireGuard tools, login/connect fall back to the app."; : "NordVPN.app is installed. For automated macOS connects, run 'node scripts/nordvpn-client.js install' to install wireguard-go and wireguard-tools with Homebrew, then set NORDVPN_TOKEN or NORDVPN_TOKEN_FILE and run login.";
} else if (installProbe.platform === "darwin" && installProbe.brewPath) { } else if (installProbe.platform === "darwin" && installProbe.brewPath) {
controlMode = "wireguard-bootstrap"; controlMode = "wireguard-bootstrap";
automaticControl = false; automaticControl = false;
loginMode = "wireguard-token"; loginMode = "wireguard-token";
connectMode = "wireguard"; connectMode = "wireguard";
recommendedAction = "Run install to bootstrap wireguard-go and wireguard-tools for automated macOS NordLynx connects."; recommendedAction = "Run 'node scripts/nordvpn-client.js install' to install wireguard-go and wireguard-tools with Homebrew for automated macOS NordLynx connects.";
} }
return { return {