[Bug]:

[Fun-Fox]

Affected component

runtime/daemon

Severity

S0 - data loss / security risk

Current behavior

Expected behavior

can't work please help

Steps to reproduce

curl -fsSL --socks5-hostname 172.25.0.30:33521 \
  https://github.com/zeroclaw-labs/zeroclaw/releases/latest/download/zeroclaw-aarch64-unknown-linux-gnu.tar.gz \
  -o zeroclaw.tar.gz

tar xzf zeroclaw.tar.gz

mkdir -p $HOME/.cargo/bin
install -m 0755 zeroclaw "$HOME/.cargo/bin/zeroclaw"


echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

zeroclaw --version

Impact

No response

Logs / stack traces

ZeroClaw version

v0.3.2

Rust version

No response

Operating system

debian

Regression?

No, first-time setup

Pre-flight checks

• I reproduced this on the latest master branch or latest release.
• I redacted secrets, tokens, and personal data from all submitted content.

[spacelobster88]

Hi @Fun-Fox, thanks for reporting this!

After reviewing the steps you've shared, this appears to be a network/environment configuration issue rather than a bug in ZeroClaw itself. Here's what I can see:

Observations:

1. You're using --socks5-hostname with curl to route the download through a SOCKS5 proxy — ZeroClaw has no involvement at this stage, so any failure here is between curl and your proxy.
2. You're downloading v0.3.2, but the current stable release is v0.5.9. The download URL releases/latest/download/... should resolve to the latest version, so if you're seeing v0.3.2 it may indicate a caching issue.
3. The error message/screenshot doesn't show a ZeroClaw runtime error — it appears to be a download or installation step failure.

Troubleshooting steps:

First, verify the download actually worked:

# Check if the file is a valid gzip archive (not an error page HTML)
file zeroclaw.tar.gz
# Should show: gzip compressed data
# If it shows: ASCII text or HTML — the download failed silently

If the download failed via the proxy, try:

# Option 1: Use ALL_PROXY env var instead of --socks5-hostname
ALL_PROXY=socks5h://172.25.0.30:33521 curl -fsSL \
  https://github.com/zeroclaw-labs/zeroclaw/releases/latest/download/zeroclaw-aarch64-unknown-linux-gnu.tar.gz \
  -o zeroclaw.tar.gz

# Option 2: Follow redirects explicitly (GitHub releases redirect)
curl -fsSL --socks5-hostname 172.25.0.30:33521 -L \
  https://github.com/zeroclaw-labs/zeroclaw/releases/latest/download/zeroclaw-aarch64-unknown-linux-gnu.tar.gz \
  -o zeroclaw.tar.gz

Note: GitHub's /releases/latest/download/ path issues a redirect. If curl isn't following redirects, you may be saving an HTML redirect page instead of the binary. The -L flag (follow redirects) may be needed alongside --socks5-hostname.

Recommended install path:
If you have network access, the officially supported method is:

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh

Or build from source if you have Rust installed:

cargo install --git https://github.com/zeroclaw-labs/zeroclaw.git --locked

Could you share the actual error output from your terminal (text, not just a screenshot)? That would help pinpoint exactly where it's failing. If the issue turns out to be a missing -L redirect flag in the curl command, I'd suggest we update the docs/README to note this for proxy users.

Closing this as a user environment/network issue for now — please reopen if you can confirm the binary downloaded correctly and ZeroClaw itself is failing to run.

[spacelobster88]

Closing as user environment/network issue (see comment above). Please reopen if you can confirm ZeroClaw itself is failing after a successful binary download.

[theonlyhennygod]

Confirming the earlier triage — this is a network/environment issue, not a ZeroClaw bug. The user's curl command with --socks5-hostname likely fails to follow GitHub's release redirects. The -L flag and/or ALL_PROXY env var should resolve it. No code changes needed.