fix(install): surface Higress gateway startup diagnostics

[RerankerGuo]

Summary

• print Higress Gateway diagnostics when the embedded installer times out waiting for /status
• include fs.inotify.max_user_instances and the gateway log tail so Envoy/V8 fatal exits are visible in the installer output
• document the sysctl checks in the English and Chinese FAQ

Fixes #888.

Verification

• bash -n install/hiclaw-install.sh
• git diff --check
• PowerShell parser not run locally because pwsh is not installed in this environment

[github-actions]

❌ Integration Tests Failed (llm-interaction / mgr=copaw / wk=hermes)

Commit: 83d2500
Workflow run: #1414

Test Results

No test output captured.

Debug Log (tail)

No debug logs available.

---

📦 Download full debug logs & test artifacts

[github-actions]

❌ Integration Tests Failed (llm-interaction / mgr=copaw / wk=copaw)

Commit: 83d2500
Workflow run: #1414

Test Results

No test output captured.

Debug Log (tail)

No debug logs available.

---

📦 Download full debug logs & test artifacts

[github-actions]

📊 CI Metrics Report

Summary

Metric	Current	Baseline	Change
LLM Calls	81	81	0 — 0%
Input Tokens	2579519	2803871	-224352 ↓ -8.0%
Output Tokens	16062	16791	-729 ↓ -4.3%
Total Tokens	2595581	2820662	-225081 ↓ -8.0%

By Role

Role	Metric	Current	Baseline	Change
🧠 Manager	LLM Calls	71	68	+3 ↑ +4.4%
	Input Tokens	2344049	2502214	-158165 ↓ -6.3%
	Output Tokens	14020	13725	+295 ↑ +2.1%
	Total Tokens	2358069	2515939	-157870 ↓ -6.3%
🔧 Workers	LLM Calls	10	13	-3 ↓ -23.1%
	Input Tokens	235470	301657	-66187 ↓ -21.9%
	Output Tokens	2042	3066	-1024 ↓ -33.4%
	Total Tokens	237512	304723	-67211 ↓ -22.1%

Per-Test Breakdown

Test	Mgr Calls	Wkr Calls	Δ Calls	Mgr In	Wkr In	Mgr Out	Wkr Out	Δ Tokens	Trend
02-create-worker	4	0	-8 ↓ -66.7%	104652	0	609	0	-253361 ↓ -70.6%	✅ improved
03-assign-task	13	6	+4 ↑ +26.7%	348942	139932	1808	901	+17927 ↑ +3.8%	⚠️ regressed
04-human-intervene	13	0	0 — 0%	324857	0	1654	0	-106487 ↓ -24.6%	— unchanged
05-heartbeat	6	0	-1 ↓ -14.3%	174108	0	984	0	-100160 ↓ -36.4%	✅ improved
06-multi-worker	35	4	+5 ↑ +14.7%	1391490	95538	8965	1141	+217000 ↑ +17.0%	⚠️ regressed

Trends

✅ 2 test(s) improved (fewer LLM calls)
⚠️ 2 test(s) regressed (more LLM calls)

---

Generated by HiClaw CI on 2026-07-08 08:23:23 UTC

---

📦 Download debug logs & test artifacts

[RerankerGuo]

@shiyiyue1102 Hi! Quick note on the SHARD_A copaw/copaw and copaw/hermes failures: I downloaded the test artifacts from run 28634278368. In the copaw/hermes case, the hiclaw-worker-bob session directory does not exist at all and Manager never invoked hiclaw create worker --name bob — Manager only created alice. In the copaw/copaw case, bob did get created and reached 14 LLM calls, but a later assertion still failed.

So the failure mode is the Manager not creating bob (a test-prompt interpretation flake), not anything in the install diagnostics this PR adds. The change itself is shell diagnostics + a sysctl note in the FAQ. Could you either re-run CI or merge if you agree the flake is unrelated? Happy to dig further if you can point me at what assertion actually failed.

[github-actions]

❌ Integration Tests Failed (llm-interaction-2 / mgr=copaw / wk=hermes)

Commit: c2c7746
Workflow run: #1511

Test Results

No test output captured.

Debug Log (tail)

No debug logs available.

---

📦 Download full debug logs & test artifacts

[RerankerGuo]

@shiyiyue1102 Hi! Re-rebased onto current main (HEAD 0b562ff) and re-ran CI. SHARD_A is now passing on this PR — but a different integration test failed:

integration-tests (llm-interaction-2, SHARD_B_TESTS, copaw, hermes) — that's tests/test-14-git-collab.sh (the 4-phase non-linear multi-worker git collaboration workflow). Took 57 minutes before failing.

This is a different failure pattern from the earlier SHARD_A copaw/hermes flake. Test 14 has its own LLM-flake surface (3 workers, 4 phases, complex branch-name / file-path / report-name invariants), and there's no equivalent deterministic-bypass like #985 yet for it. The change in this PR is shell diagnostics for Higress Gateway startup + an English/Chinese FAQ note on sysctl checks — it doesn't touch Manager agent runtime, worker git ops, or test-14 setup. Could you re-run SHARD_B copaw/hermes, or merge this PR if you agree the test 14 failure is unrelated? Happy to dig into the test-14 artifacts (run 28926397804, job 85816940745) if it would help.

Also: PR #985 (SHARD_A bob-setup deterministic fix) just turned green and was pinged this morning as priority.