Skip to main content

🖥️ YingClaw Installation

👤 Who it's for: Anyone who needs to install the YingClaw desktop client
⏱️ Read time: ~5 minutes
💡 In one line: Pick the steps for your system and you'll be up and running in minutes.

The YingClaw desktop client supports Windows / macOS / Linux. Download the installer for your platform, then follow the steps below to install and launch it.

Windows Startup Guide​

After the download finishes, double-click the application to open it.

macOS Installation & Startup Guide​

Step 1: Run FirstLaunch.command for the first time​

In Finder, enter the YingClaw folder and double-click to run FirstLaunch.command. macOS will show a system warning: "FirstLaunch.command was not opened; Apple cannot verify it does not contain malware that could harm your Mac or leak your privacy."

First launch warning

Step 2: Click the "?" help button​

In the warning box, click the "?" help button in the top-right corner.

Click help button

Step 3: Read the Mac User Guide​

The system automatically jumps to the "Protect your Mac from malware" section in the Mac User Guide, which explains how to allow apps from unidentified developers.

Mac User Guide

Step 4: Back in the warning dialog, choose "Open Anyway"​

Back in the warning dialog, besides "Done" and "Move to Trash", there is now an "Open Anyway" button. Click "Open Anyway".

Select Open Anyway

Step 5: System Settings → Privacy & Security​

If it still won't open, go to System Settings → Privacy & Security. In the "Security" area you can see the blocked message; click the "Open Anyway" button on the right.

Privacy & Security

Step 6: Authorize with Touch ID​

The system shows the "Privacy & Security" authorization box; complete authorization with Touch ID or your user password.

Touch ID authorization

Step 7: Run the script again​

After authorization, double-click FirstLaunch.command to run it again. The warning will still appear, but it can now be allowed to run normally.

Run the script again

macOS FAQ​

Q1: Why do I need to run FirstLaunch.command?

This script initializes the client runtime environment and must be run once during the first installation.

Q2: It still won't open after running FirstLaunch.command — what to do?

Go to System Settings → Privacy & Security, find the corresponding block prompt and click "Open Anyway", then complete authorization with Touch ID or your password, and finally double-click the script again.

Q3: Do I need to allow it every time I open the client?

No. After the first approval, the system remembers the authorization status for this app, and you can open it directly afterwards.

Q4: YingClaw.app also says it cannot be opened — what to do?

Follow the same approval method as for FirstLaunch.command: click "Open Anyway" in System Settings → Privacy & Security.

Linux Installation & Startup Guide​

  1. Unpack the archive:

    tar -xzf YingClaw.tar.gz

  2. Enter the directory and run the install script:

    cd YingClaw && chmod +x install.sh && ./install.sh

  3. After installation, search for YingClaw in the app menu to launch it, or type it directly in the terminal:

    YingClaw