Docs

Requirements

• Windows 10 or 11 only.
• Python 3.10+ for source runs (run.bat prefers py -3.10).
• PyQt6, torch, ultralytics, onnxruntime, bettercam, mss, numpy, opencv-python, pywin32.
• NVIDIA GPU strongly recommended for TensorRT .engine. Optional: wmi, pyserial, onnxruntime-gpu, CUDA Toolkit + TensorRT (ClawRT).
• Your YOLO detect model as .onnx or a .engine built for this GPU.

YOLO, ONNX, and engines

Detection is YOLO object detection on a center crop. That is the AI step. Live inference loads only a TensorRT .engine or an ONNX .onnx. A .pt file is for export only.

.engine is TensorRT: fastest, NVIDIA GPU, built for this card and TensorRT version. Needs ClawRT (CUDA + TensorRT). Prefer this if both files exist.

.onnx is the portable YOLO export. Import in Setup. Works without TensorRT. Subscribers start here. No models ship in the installer.

Each game pack has its own model path. Either format works on any game. Example packs: Marvel Rivals uses a .engine. COD / Warzone uses a .onnx. Default has no model until you import one. Switch games and import again if that game is empty.

Development install

1. Install Python 3.10+ with Add to PATH.
2. From the repo root run requirements.bat.
3. Optional TensorRT: tools\tensorrt_setup\start.bat. RTX 50: start_50_series.bat.
4. Launch with run.bat or py -3.10 main.py. Use run_as_admin.bat if capture fails.

Subscriber installer

1. Install ClawAim-Setup.exe.
2. Wizard: paste your key, import .onnx, system check, aim key.
3. Switch game under Profiles. Import ONNX again if that game has no model.
4. Control: Start Aimbot when blockers are gone.

Config lives in %LOCALAPPDATA%\ClawAim\. Models live in %LOCALAPPDATA%\ClawAim\models\<game>\. No models in the installer. One key, one PC.

How to use

1. Setup: paste key, then Activate.
2. Choose ONNX, or set .engine on Model.
3. System status OK. Pick aim key (often mouse-right, 0x02).
4. Control: Start Aimbot. In game, hold the aim key.
5. Alt+1 through Alt+9 switches character profiles.

Troubleshooting

Window will not start

py -3.10 main.py in a terminal. Confirm PyQt6.

Capture black

run_as_admin.bat. MSS vs BetterCam. Avoid exclusive fullscreen.

Cannot start

Import ONNX for this game. Activate license.

Engine will not load

Rebuild .engine on this PC from ONNX.

Boxes, no move

Aim key, mouse method, COM/protocol, admin.