หน้าแรก/การแก้ปัญหา

การแก้ปัญหา

เริ่มต้นด้วย /doctor — มันตรวจสอบเวอร์ชันรันไทม์, ข้อมูลประจำตัวผู้ให้บริการ, ความสมบูรณ์ของการตั้งค่า, สถานะปลั๊กอิน/MCP, และ Sentry telemetry

ปัญหาเริ่มต้น

"command not found: clew"

พาธติดตั้ง global npm อาจไม่อยู่ใน PATH ใช้ npx clew-code หรือ bun x clew-code เป็นทางเลือก

"Bun not found"

Clew ต้องใช้ Bun 1.3+ เป็นรันไทม์สำหรับแพ็กเกจ npm

ปัญหาผู้ให้บริการ

"No API key configured"

ตั้งค่าคีย์ API อย่างน้อยหนึ่งรายการเป็นตัวแปรสภาพแวดล้อม ดู ผู้ให้บริการ สำหรับรายการทั้งหมด

export ANTHROPIC_API_KEY=sk-ant-...
export DEEPSEEK_API_KEY=sk-...

รัน /doctor เพื่อตรวจสอบผู้ให้บริการที่ตั้งค่า

"Rate limited" หรือ "Quota exceeded"

ตั้งค่าโมเดลสำรองผ่าน CLI: --fallback-model <model> หรือใช้ /model เพื่อสลับไปยังผู้ให้บริการอื่น

ปัญหา Build

ข้อผิดพลาด TypeScript ระหว่าง build

bun run build
# ข้อผิดพลาด TypeScript อาจอยู่ในโค้ดที่ยังไม่ได้ commit หรือโมดูลภายนอก
# รันการตรวจสอบเป้าหมาย:
bun x tsc --noEmit
bun test

ปัญหาเฉพาะ Windows

  • ripgrep แถมมาที่ src/utils/vendor/ripgrep/x64-win32/rg.exe
  • TTY polyfill อาจจำเป็นสำหรับ Ink compatibility
  • PowerShell และ Bash อาจทำงานแตกต่างสำหรับการเรียกใช้เครื่องมือ

ปัญหา MCP

"MCP server connection failed"

ตรวจสอบว่าคำสั่งเซิร์ฟเวอร์มีอยู่และพาธถูกต้อง ตรวจสอบไวยากรณ์ JSON config ด้วยคำสั่ง /mcp

ปัญหาปลั๊กอิน

ปลั๊กอินไม่โหลด

ตรวจสอบรูปแบบและตำแหน่ง manifest ของปลั๊กอิน ใช้ /plugin และ /reload-plugins เพื่อรีเฟรช

การขอความช่วยเหลือ

  • การตรวจสอบในแอป: /doctor — ตรวจสอบสภาพแวดล้อมอย่างครอบคลุม
  • ภาพรวมสถานะ: /status — เวอร์ชัน, โมเดล, การเชื่อมต่อ API
  • GitHub Issues: รายงานบั๊กและขอฟีเจอร์
  • โหมด Debug: รันด้วย DEBUG=1 หรือ DEBUG=provider:anthropic