Kylin Relay Skill

What This Skill Does

Lets QClaw remotely control any Kylin/Feiteng ARM64 Linux computer.

From a new Windows machine, one command deploys everything. From then on, instant reconnect.

`

QClaw (Windows) TCP:12345 (JSON) Kylin ARM64

relay_client.py ──── exec/status ────────→ qt-relay (GUI)

←── stdout/stderr/exit ──── QProcess → bash

`

Quick Reference For The Agent

Already deployed - just connect and use:

`

python scripts/relay_client.py status

python scripts/relay_client.py exec ""

`

First time on a new Kylin - one deploy command:

`

python scripts/relay_client.py deploy --ssh-user --ssh-pass

`

Credentials are saved to ~/.qclaw/kylin-relay.json automatically.

After first deploy, just use status and exec without credentials.

Multi-machine:

`

python scripts/relay_client.py 192.168.1.7 status

python scripts/relay_client.py 192.168.1.7 exec "df -h"

python scripts/relay_client.py 192.168.1.100 status

python scripts/relay_client.py 192.168.1.100 exec "uname -a"

`

Setup On A New Windows Machine

1. Copy the entire kylin-relay directory to ~/.qclaw/skills/
2. Download the ARM64 binary (one-time):
• Windows (PowerShell):

```powershell

$url = "https://raw.githubusercontent.com/XinLongWang2001/kylin-relay/main/assets/qt-relay-arm64"

$dir = "$env:USERPROFILE\.qclaw\skills\kylin-relay\assets"

New-Item -ItemType Directory -Path $dir -Force | Out-Null

Invoke-WebRequest -Uri $url -OutFile "$dir\qt-relay-arm64"

```

• Linux/macOS:

```bash

curl -fsSL https://raw.githubusercontent.com/XinLongWang2001/kylin-relay/main/assets/qt-relay-arm64 \

-o ~/.qclaw/skills/kylin-relay/assets/qt-relay-arm64

```

1. That's it. The skill is self-contained.
• ARM64 binary downloads to assets/
• SSH helpers in scripts/ (cross-platform)

First Deployment To A New Kylin

Step by step what happens:

`

User: "部署麒麟 192.168.1.100"

Agent calls:

python scripts/relay_client.py 192.168.1.100 deploy --ssh-user root --ssh-pass MyPass123

The deploy command:

[1/4] SSH to Kylin, verify connectivity and architecture

[2/4] SCP the pre-compiled ARM64 binary (~/qt-relay-project/qt-relay)

[3/4] Check Qt5 libraries (auto-install if missing)

[4/4] Start service: nohup DISPLAY=:0 ./qt-relay --bind 0.0.0.0 &

→ Save credentials to ~/.qclaw/kylin-relay.json

`

Time: ~5 seconds (binary transfer). No compilation needed.

Daily Usage

`

User: "连麒麟看看状态"

Agent: python scripts/relay_client.py 192.168.1.7 status

→ [OK] Kylin Relay online / system / user / hostname

User: "麒麟上看看磁盘"

Agent: python scripts/relay_client.py 192.168.1.7 exec "df -h"

User: "麒麟安装nginx"

Agent: python scripts/relay_client.py 192.168.1.7 exec "sudo apt install nginx -y"

`

Config File

~/.qclaw/kylin-relay.json:

`json

{

"targets": {

"192.168.1.7": {

"host": "192.168.1.7",

"ssh_user": "d2000",

"ssh_pass": "qilin@123",

"port": 12345,

"token": "qclaw-relay"

},

"192.168.1.100": {

"host": "192.168.1.100",

"ssh_user": "root",

"ssh_pass": "MyPass",

"port": 12345,

"token": "qclaw-relay"

}

},

"default": "192.168.1.7"

}

`

Agent should write to this file when deploying or when user provides new credentials.

Files In This Skill

| Path | Size | Purpose |

|------|------|---------|

| scripts/relay_client.py | 15KB | Main client: status, exec, deploy |

| scripts/config.template.json | 0.2KB | Config template |

| scripts/config.template.json | 0.2KB | Config template |

| scripts/pw_helper.py | 0.6KB | SSH password helper (Linux/macOS) |

| scripts/ssh_askpass.cmd | 0.03KB | SSH password helper (Windows) |

| SKILL.md | this file | Skill description |

Requirements

QClaw side (Windows):

• Python 3
• SSH client (built into Windows 10+)
• No other dependencies

Kylin side:

• SSH server (openssh-server)
• Qt5 libraries: libqt5widgets5, libqt5network5, libqt5gui5

(deploy step [3/4] auto-installs these via apt if missing)

• X11 display (:0) for the GUI (service runs headless if no display)

Protocol

TCP connection to port 12345, JSON messages separated by newline:

`

Client → {"type":"auth","token":"qclaw-relay"}

Server ← {"type":"auth_ok"}

Client → {"type":"exec","id":"abc123","command":"uname -a","timeout":30}

Server ← {"id":"abc123","type":"stdout","data":"Linux ...\n"}

Server ← {"id":"abc123","type":"exit","code":0}

`

Troubleshooting

• "Not connected": qt-relay may have stopped. SSH in and restart: ~/qt-relay-project/qt-relay --bind 0.0.0.0 &
• "Auth failed": Token mismatch. Check config or restart with --token qclaw-relay
• Deploy fails: Check SSH connectivity first. Qt5 libs auto-install, but may need manual pt install if offline.
• Missing display: If DISPLAY=:0 fails, service still starts but GUI won't show. Commands still work.
• Need to change password: Edit ~/.qclaw/kylin-relay.json directly, or re-run deploy with new credentials.