Skip to content

Correct Wi-Fi spec and local-model performance in hardware docs - #273

Open
yalexx wants to merge 1 commit into
mainfrom
fix/docs-spec-accuracy
Open

Correct Wi-Fi spec and local-model performance in hardware docs#273
yalexx wants to merge 1 commit into
mainfrom
fix/docs-spec-accuracy

Conversation

@yalexx

@yalexx yalexx commented Jul 27, 2026

Copy link
Copy Markdown
Collaborator

Two inaccurate specs on the hardware pages

Wi-Fi

The pages said Wi-Fi 6. The Jetson Orin Nano Super dev kit we ship (945-13766-0005-000) bundles a Realtek RTL8822CE: 802.11 a/b/g/n/ac, dual-band 2Γ—2, up to 867 Mbps, Bluetooth 5.0.

Sources β€” distributor listings for that exact part number specify an "802.11ac/abgn wireless network interface controller" in the kit contents:

So it is Wi-Fi 5, not Wi-Fi 6.

Local model performance

The table published ~3.5 tok/s for Llama 3.1 8B. Multiply tok/s by Q4 weight size for every row and it lands at ~15–17 GB/s of effective memory bandwidth β€” against the board's 102 GB/s. That is CPU-class, so the table was measured without CUDA offload.

A shipped ClawBox does not run that way:

  • config/clawbox-performance.service sets MAXN + jetson_clocks at boot
  • scripts/optimize-ollama.sh sets OLLAMA_KV_CACHE_TYPE=q8_0, OLLAMA_FLASH_ATTENTION=1

Replaced with our own production measurement (Ollama, warm runs, eval_rate, tegrastats over 176 samples, GR3D 99%): 1B ~45 Β· 2B ~26 Β· 3B ~23 Β· 3.8B ~22 tok/s, ~11.4 W average, 61.8 Β°C peak, no throttling. 7–8B is now listed honestly at ~10 tok/s and a tight fit in 8 GB.

For reference, NVIDIA's ~19 tok/s for Llama 3.1 8B on this board is MLC/INT4 β€” a runtime we do not ship.

Consistency

The same numbers are now on clawbox.com (#345, #346) and in the support knowledge base, so all three surfaces agree.

Still open

The 7–8B row is extrapolated from the measured bandwidth, not directly measured β€” worth one benchmark run on a live box to confirm, along with a 25 W vs MAXN comparison.

πŸ€– Generated with Claude Code

The hardware pages carried two inaccurate specs.

Connectivity said "Wi-Fi 6". The Jetson Orin Nano Super dev kit we ship
(945-13766-0005-000) bundles a Realtek RTL8822CE β€” 802.11 a/b/g/n/ac,
dual-band 2x2, up to 867 Mbps, Bluetooth 5.0. Distributor listings for that
exact part number specify an "802.11ac/abgn wireless network interface
controller". So it is Wi-Fi 5, not Wi-Fi 6.

Local model performance published ~3.5 tok/s for Llama 3.1 8B. Every row of
that table works out to ~15-17 GB/s of effective memory bandwidth against the
board's 102 GB/s, which is CPU-class β€” it was measured without CUDA offload.
A shipped ClawBox sets MAXN + jetson_clocks at boot and runs Ollama with
q8_0 KV cache and flash attention, i.e. the GPU path.

Replaced with our own production measurement (2026-07-22 benchmark post):
1B ~45, 2B ~26, 3B ~23, 3.8B ~22 tok/s at ~11.4 W average, no throttling.
7-8B is listed honestly at ~10 tok/s and a tight fit in 8 GB.

Same numbers now used on clawbox.com and in the support knowledge base.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@yalexx
yalexx requested a review from a team as a code owner July 27, 2026 13:30
@coderabbitai

coderabbitai Bot commented Jul 27, 2026

Copy link
Copy Markdown

Warning

Review limit reached

You’ve reached a temporary PR review limit under our Fair Usage Limits Policy.

Your recent review volume is higher than typical usage, so adaptive limits are currently applied.

Next review available in: 55 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
βš™οΈ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: fdf8f15f-d854-48b3-8f5c-2ac2846f7ca1

πŸ“₯ Commits

Reviewing files that changed from the base of the PR and between 280ed5e and a9a49ac.

πŸ“’ Files selected for processing (2)
  • docs-site/hardware/clawbox-connect.mdx
  • docs-site/hardware/requirements.mdx
✨ Finishing Touches
πŸ§ͺ Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/docs-spec-accuracy

Comment @coderabbitai help to get the list of available commands.

@github-actions

Copy link
Copy Markdown

πŸ¦€ ClawReview

Your friendly reef crab, here with the lay of the land.

Corrects two factual errors in the hardware docs: the bundled wireless adapter (RTL8822CE) is Wi-Fi 5/802.11ac, not Wi-Fi 6, and the local-model benchmark table is replaced with production-measured figures (Ollama, MAXN mode, 176 tegrastats samples) that better reflect what a shipped ClawBox actually achieves. Power draw figures are also updated to match the measured ~11 W typical / 19 W peak rather than the previous estimates.

At a glance

  • πŸ“– Docs Β· touches docs-site hardware pages (clawbox-connect.mdx, requirements.mdx)
  • Base branch: main Β· +26 source / +0 tests across 2 files
  • βœ… base main matches the beta-first convention (docs/meta-only change)
  • 🟑 title doesn't follow type: description (feat/fix/chore/docs/…)

Good to know

  • ℹ️ Pure docs-only change β€” no source code, config, or runtime paths touched. Safe to merge without any device-side concerns.
  • 🟑 The 7–8B row (~10 tok/s) is bandwidth-extrapolated, not directly measured on hardware β€” the PR body flags this as still open.
  • ℹ️ Numbers are now kept in sync across three surfaces (docs-site, clawbox.com, support KB) β€” worth keeping that alignment in mind for future spec changes.

β€” ClawReview πŸ¦€, your resident reef crab. Just orientation β€” CodeRabbit does the line-by-line, humans do the merge. Conventions: docs.

@github-actions github-actions Bot added the area: docs Auto-triage area label Jul 27, 2026
@github-actions

github-actions Bot commented Jul 27, 2026

Copy link
Copy Markdown

CI Summary

βœ… Tests

  • Result: passed
  • View run
  • Coverage: statements 69.77%, branches 59.68%, functions 65.16%, lines 71.79%

βœ… E2E

βœ… E2E Install

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: docs Auto-triage area

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant