บทที่ 2 — การติดตั้ง

thClaws มาในรูปแบบ binary ตัวเดียวคือ thclaws — รันในโหมด desktop GUI ได้ (ไม่ใส่ flag) หรือสลับเป็น CLI REPL (--cli) หรือ โหมดหนึ่ง turn สำหรับ script (-p "prompt") ก็ได้จาก flag เดียวกัน ดาวน์โหลด build ที่ตรงกับ OS และ CPU ของคุณได้จาก:

https://thclaws.ai/downloads

มี build ให้สำหรับ:

OS	สถาปัตยกรรม
macOS	Apple Silicon (arm64), Intel (x86_64)
Linux	x86_64, arm64
Windows	x86_64, arm64

เลือก build ให้ตรงกับ OS และสถาปัตยกรรม CPU ของเครื่อง — โหลดผิด build binary จะรันไม่ได้ (ถ้าไม่แน่ใจว่าเครื่องเป็น arm64 หรือ x86_64 ดูจาก uname -m บน macOS/Linux หรือ System Information > “System type” บน Windows)

ความต้องการของระบบ

ตัว thClaws เองมีขนาดเล็กมาก — binary ขนาดราว ๆ 20 MB หลังแตกไฟล์ และใช้ RAM ราว ๆ 250–400 MB ตอนรัน ซึ่งส่วนใหญ่เป็นของ webview ที่ระบบปฏิบัติการให้มาเอง (WKWebView บน macOS, WebView2 บน Windows, WebKit2GTK บน Linux)

	ขั้นต่ำ	ที่แนะนำ
OS	macOS 12+ · Windows 10+ · Linux ที่มี webkit2gtk-4.1 (Ubuntu 22.04+, Fedora 38+)	เวอร์ชัน stable ล่าสุด
CPU	64-bit x86_64 หรือ ARM64 ของช่วง 10 ปีมานี้	multi-core รุ่นใหม่ ๆ
RAM	ว่างอยู่ 2 GB	รวมทั้งเครื่อง 8 GB
Disk	~50 MB	SSD
Network	จำเป็นถ้าใช้ cloud provider (Anthropic / OpenAI / Gemini / OpenRouter / Z.ai / DashScope / Agentic Press); ถ้าใช้แต่ Ollama หรือ LMStudio ในเครื่อง ก็ไม่ต้องใช้เน็ต	broadband

ถ้าใช้ thClaws กับ cloud provider อย่างเดียว — โน๊ตบุ๊คซื้อมาในช่วงไม่กี่ ปีหลัง ๆ รันได้สบาย ๆ ส่วนกรณีรันโมเดลในเครื่องเอง (local) เพดานสเปก มาจาก runtime ของโมเดล (Ollama / LMStudio) ไม่ใช่ตัว thClaws — ดูตัวเลข RAM/VRAM ตามขนาดโมเดลในส่วน “ทางเลือก: Ollama สำหรับใช้งาน local ล้วน ๆ” ด้านล่าง

อยาก build จาก source? thClaws เป็น open source — clone github.com/thClaws/thClaws แล้วเลือกได้สองแบบ:

• GUI version (ตัวเดียวกับที่เราปล่อย binary ให้ดาวน์โหลด): build thclaws ที่รันได้ทั้ง GUI, --cli และ -p ต้องมี frontend bundle ก่อนเสมอ เพราะ Rust crate embed frontend/dist/index.html ตอน compile

bash $ cd frontend && pnpm install && pnpm build && cd .. $ cargo build --release --bin thclaws --features gui \ --manifest-path crates/core/Cargo.toml

• CLI-only version (ไม่มีใน release — build เองถ้าต้องการ): ไม่มี dependency ของ GUI (WebKit / WebView2) compile ไวกว่า เหมาะกับ เซิร์ฟเวอร์ headless หรือ container ที่ไม่ต้องการหน้าต่าง

bash $ cargo build --release --bin thclaws-cli \ --manifest-path crates/core/Cargo.toml

ต้องใช้ Rust 1.85+ (ทั้งสองแบบ) และ Node.js 20+ กับ pnpm 9+ สำหรับ GUI build สำหรับผู้ใช้ส่วนใหญ่เราแนะนำให้ใช้เส้นทางการติดตั้งด้วย download ด้านล่างมากกว่า

ติดตั้ง

macOS

1. ดาวน์โหลด thclaws-<version>-<arch>-apple-darwin.tar.gz ที่ตรงกับเครื่อง
2. แตกไฟล์แล้วย้าย binary ไปยัง PATH ของคุณ:

bash $ tar -xzf ~/Downloads/thclaws-*-apple-darwin.tar.gz $ mkdir -p ~/.local/bin $ mv thclaws ~/.local/bin/ $ chmod +x ~/.local/bin/thclaws

3. ถ้า ~/.local/bin ยังไม่อยู่ใน PATH ให้เพิ่มบรรทัดนี้ใน ~/.zshrc (หรือ ~/.bashrc) แล้วเปิด terminal ใหม่:

bash export PATH="$HOME/.local/bin:$PATH"

4. เมื่อเปิดใช้งานครั้งแรก Gatekeeper ของ macOS อาจบล็อก binary ที่ ไม่ได้ sign (“cannot be opened because the developer cannot be verified”) ให้ล้าง flag quarantine ครั้งเดียวจบ:

bash $ xattr -d com.apple.quarantine ~/.local/bin/thclaws

Linux

1. ดาวน์โหลด thclaws-<version>-<arch>-unknown-linux-gnu.tar.gz
2. แตกไฟล์แล้วติดตั้ง:

bash $ tar -xzf ~/Downloads/thclaws-*-linux-gnu.tar.gz $ mkdir -p ~/.local/bin $ install -m 755 thclaws ~/.local/bin/

3. ตรวจให้แน่ใจว่า ~/.local/bin อยู่ใน PATH (distro ส่วนใหญ่ตั้งไว้ ให้แล้วผ่าน ~/.profile ถ้ายังไม่มี ให้เพิ่มบรรทัด export PATH=... จากหัวข้อ macOS)

Windows

1. ดาวน์โหลด thclaws-<version>-<arch>-pc-windows-msvc.zip
2. แตกไฟล์ไปที่ %LOCALAPPDATA%\Programs\thclaws (สร้าง folder ถ้า ยังไม่มี)
3. เพิ่ม folder นั้นเข้าไปใน PATH ของผู้ใช้: - Start → “Edit environment variables for your account” - Path → Edit → New → %LOCALAPPDATA%\Programs\thclaws - OK → เปิดหน้าต่าง PowerShell / terminal ใหม่

ทางเลือก: Ollama สำหรับใช้งาน local ล้วน ๆ

ถ้าต้องการรันกับโมเดล local ทั้งหมดโดยไม่ใช้ API key ของ cloud ให้ ติดตั้ง Ollama ควบคู่กับ thClaws:

# macOS
brew install ollama

# Linux (script installer)
curl -fsSL https://ollama.com/install.sh | sh

# Windows
# Download the installer from ollama.com/download

เริ่ม daemon ของ Ollama (ollama serve หรือเปิดผ่าน desktop app) แล้ว pull โมเดลที่ใหญ่พอสำหรับงาน agent โมเดลเล็ก ๆ (Llama 3.2, Phi-3 ฯลฯ) มักพลาดเรื่องรูปแบบการเรียก tool และ reasoning หลายขั้น แนะนำ ให้ใช้ Gemma 4 26B ขึ้นไป:

$ ollama pull gemma4:26b         # recommended minimum
$ ollama pull gemma4:31b         # better if your hardware can host it

งบประมาณฮาร์ดแวร์คร่าว ๆ:

โมเดล	RAM / VRAM ที่ต้องการ
gemma4:26b	~20 GB
gemma4:31b	~24 GB

Apple Silicon ที่มี unified memory 32 GB รันขนาด 31B ได้สบาย ๆ ส่วน เครื่อง Mac ที่มี RAM 16 GB ควรอยู่ที่ 26B ถ้าใช้ GPU แยก ตัวเลข ด้านบนหมายถึง VRAM ไม่ใช่ RAM ของระบบ

สั่ง thClaws ให้สลับไปใช้โมเดลนั้นด้วย /model ollama/gemma4:26b (หรือ โมเดลที่คุณ pull มา) โดยไม่ต้องใช้ API key บทที่ 6 อธิบายตัวเลือกของ Ollama อย่างละเอียด รวมถึง prefix oa/* ที่ compatible กับ Anthropic ซึ่งมักให้ผลลัพธ์ tool call ที่สะอาดกว่าเมื่อใช้กับโมเดล local ตัวเดียวกัน

ตรวจสอบการติดตั้ง

$ thclaws --version                   # print version
$ thclaws --cli                       # interactive REPL
$ thclaws -p "say hi in one word"     # headless one-shot (--print also works)

ทั้งสามคำสั่งควรพิมพ์ผลหรือรันได้โดยไม่ error ถ้า -p / --print ถามหา key แสดงว่ายังไม่ได้ตั้งค่า — ไปที่บทที่ 6

อัปเดต

ดาวน์โหลด archive เวอร์ชันใหม่จาก https://thclaws.ai/downloads แล้วทำตามขั้นตอนการติดตั้งของ platform ของคุณซ้ำอีกครั้ง config เดิม (API key, session, plugin ฯลฯ) ที่อยู่ใต้ ~/.config/thclaws/ (หรือ %APPDATA%\thclaws\ บน Windows) จะยังคงอยู่ — เปลี่ยนแค่ตัว binary เท่านั้น

ถอนการติดตั้ง

# macOS / Linux
$ rm ~/.local/bin/thclaws

# Windows (PowerShell)
PS> Remove-Item "$env:LOCALAPPDATA\Programs\thclaws" -Recurse

Configuration และ state ที่บันทึกไว้จะอยู่ใต้ ~/.config/thclaws/ (หรือ %APPDATA%\thclaws\ บน Windows) ถ้าต้องการ uninstall ให้สะอาด ก็ลบพวกนี้ด้วย:

$ rm -rf ~/.config/thclaws

การแก้ปัญหา

อาการ	วิธีแก้
thclaws: command not found หลังติดตั้ง	~/.local/bin ไม่ได้อยู่ใน PATH — เพิ่ม export PATH="$HOME/.local/bin:$PATH" เข้าไปใน rc ของ shell
macOS แจ้งว่า “cannot be opened because the developer cannot be verified”	ทำครั้งเดียว: xattr -d com.apple.quarantine ~/.local/bin/thclaws
Linux: error while loading shared libraries: libssl.so.3	ติดตั้ง OpenSSL 3 (sudo apt install libssl3 / sudo dnf install openssl)
Windows: PowerShell ไม่รู้จัก thclaws	folder ไม่อยู่ใน PATH — เช็ค env var PATH อีกครั้งแล้วเปิด terminal ใหม่
หน้าต่าง GUI ไม่เปิด	ลอง thclaws --cli ก่อน — ถ้ารันได้ แสดงว่า webview ของ GUI ขาด dep ของระบบ (WebKit บน Linux / WebView2 บน Windows)

ต่อไป

บทที่ 3 อธิบายว่า thClaws กำหนดขอบเขตตัวเองให้อยู่ภายใน directory ของ โปรเจกต์อย่างไร พร้อมโหมดการรันทั้งสามแบบ (GUI, CLI REPL, one-shot -p / --print) ส่วนบทที่ 6 คือที่ที่คุณจะตั้งค่า provider และ API key