วิธีติดตั้ง Hermes Agent: คู่มือตั้งค่าสำหรับผู้เริ่มต้น

Hermes Agent เป็น AI agent แบบโอเพนซอร์สจาก Nous Research ที่ทำงานผ่าน terminal ของคุณ เชื่อมต่อกับผู้ให้บริการโมเดลต่าง ๆ จดจำบริบทที่เป็นประโยชน์ข้ามเซสชัน และสามารถขยายความสามารถได้ด้วย tools, skills, messaging gateway และระบบอัตโนมัติ คู่มือนี้จะช่วยให้คุณรู้วิธีติดตั้ง Hermes คุณไม่จำเป็นต้องติดตั้ง Python หรือ Node.js ด้วยตัวเองสำหรับตัวติดตั้งมาตรฐานบน macOS หรือ Windows เพราะตัวติดตั้งอย่างเป็นทางการจะจัดการ dependency หลักให้คุณ

ก่อนติดตั้ง Hermes Agent

Hermes Agent เป็นซอฟต์แวร์ที่เน้นการใช้งานผ่าน terminal เป็นหลัก ดังนั้นคุณจะต้องติดตั้งจาก command line เลือกส่วนที่ตรงกับคอมพิวเตอร์ของคุณ:

• macOS: เปิด Terminal จาก Applications > Utilities > Terminal หรือกด Command + Space แล้วค้นหา "Terminal"

• Windows: ติดตั้ง WSL2 ก่อน เปิด terminal ของดิสโทร Linux ของคุณ แล้วทำตามคำสั่งสำหรับ Linux

คุณยังต้องมี Git ด้วย ตรวจสอบว่าติดตั้ง Git แล้วหรือยัง:

ผลลัพธ์ที่ควรได้:

หากพบข้อความ git: command not found ให้ติดตั้ง Git ก่อน:

หากคุณไม่มี Homebrew บน macOS ให้ติดตั้ง Git จาก Apple Command Line Tools โดยรันคำสั่ง:

ขั้นตอนที่ 1: ติดตั้ง Hermes Agent บน macOS หรือ Windows

ใน terminal ของคุณ คัดลอกและวางคำสั่งตัวติดตั้งอย่างเป็นทางการ:

ตัวติดตั้งจะดาวน์โหลด Hermes Agent เตรียมสภาพแวดล้อม Python ติดตั้ง dependency ที่จำเป็น และเพิ่มคำสั่ง hermes ลงใน shell path ของคุณ สำหรับการติดตั้งแบบผู้ใช้ทั่วไป ข้อมูลของ Hermes จะถูกเก็บไว้ที่ ~/.hermes/

เมื่อคำสั่งทำงานเสร็จแล้ว ให้โหลด shell ของคุณใหม่:

หากคุณใช้ Zsh ซึ่งเป็นค่าปกติบน macOS ให้รัน:

ผลลัพธ์ที่ควรได้:

ตอนนี้ให้ตรวจสอบว่าคำสั่ง Hermes Agent พร้อมใช้งานแล้ว:

ผลลัพธ์ที่ควรได้:

หมายเลขเวอร์ชันที่แน่นอนอาจเปลี่ยนแปลงไปตามการอัปเดตของ Hermes Agent

ขั้นตอนที่ 2: ตั้งค่าผู้ให้บริการโมเดลของคุณ

Hermes Agent ต้องมีผู้ให้บริการโมเดลก่อนจึงจะสามารถตอบคำถามหรือใช้เครื่องมือได้ วิธีตั้งค่าที่ง่ายที่สุดสำหรับผู้เริ่มต้นคือแบบโต้ตอบ (interactive):

ตัวช่วยตั้งค่าจะให้คุณเลือกผู้ให้บริการ เช่น Kimi/Moonshot อย่าเพิ่งตั้งค่า routing, fallback, gateway หรือ cron จนกว่าการแชทพื้นฐานจะใช้งานได้ก่อน

เลือกโมเดลเริ่มต้น kimi-k2.6 เป็นโมเดลที่ล้ำสมัยที่สุดของ Kimi ในตอนนี้

หากคุณทราบค่าที่ต้องการตั้งอยู่แล้ว คุณสามารถใช้ hermes config set ได้ ตัวอย่างเช่น:

หากคุณยังไม่มี api-key, Kimi อาจเป็นตัวเลือกที่น่าสนใจ

ขั้นตอนที่ 1: เปิดใช้งาน Kimi API ของคุณ

ก่อนใช้งาน Kimi API ร่วมกับ Hermes Agent ให้เปิดใช้งาน Kimi API Key ของคุณใน Kimi Platform เราแนะนำให้เติมเงินอย่างน้อย $20 เพื่อปลดล็อกสิทธิ์การใช้งานระดับ Tier 2 ซึ่งช่วยลด latency และรองรับการทำงานที่มีความเสถียรมากขึ้นสำหรับงานที่ซับซ้อนและมีหลายขั้นตอน

ขั้นตอนที่ 2: สร้าง Kimi API Key ของคุณ

ไปที่ส่วน API Keys ใน Kimi Platform แล้วคลิก Create API Key อย่าลืมคัดลอก API key ของคุณและเก็บไว้อย่างปลอดภัย เพราะคีย์จะแสดงให้เห็นเพียงครั้งเดียวตอนสร้างเท่านั้น

ขั้นตอนที่ 3: ป้อน API key ของคุณ

วาง Kimi API key ของคุณและเชื่อมต่อ Hermes Agent

ขั้นตอนที่ 3: เริ่มต้น Hermes Agent

เมื่อกำหนดค่าโมเดลเรียบร้อยแล้ว ให้เริ่มต้น CLI แบบดั้งเดิม:

หรือลองใช้ terminal UI แบบใหม่:

คุณควรเห็นหน้าจอต้อนรับหรือ prompt ที่แสดงผู้ให้บริการ/โมเดลที่คุณเลือกไว้ ลองทดสอบด้วยคำของ่าย ๆ:

หากสำเร็จ จะแสดงผลลัพธ์แบบนี้:

หาก Hermes Agent เปิดขึ้นมาแต่ตอบกลับด้วยข้อผิดพลาดเกี่ยวกับโมเดลหรือการยืนยันตัวตน ให้รัน:

จากนั้นเลือกผู้ให้บริการของคุณอีกครั้งและตรวจสอบ API key หรือการล็อกอินด้วย OAuth

ขั้นตอนที่ 4: เปลี่ยน Hermes Agent ให้เป็นบอท

เช่นเดียวกับ OpenClaw, Hermes Agent สามารถทำหน้าที่เป็นบอทและเชื่อมต่อกับแอปแชทของคุณได้เช่นกัน:

หลังจากตั้งค่าแล้ว ให้ตรวจสอบสถานะของ gateway:

ให้ใช้ gateway หลังจากที่ผู้ให้บริการโมเดลของคุณทำงานได้ใน terminal แล้วเท่านั้น หาก CLI ไม่สามารถแชทพื้นฐานให้เสร็จสมบูรณ์ได้ บอทก็มักจะล้มเหลวด้วยสาเหตุเดียวกัน

ปัญหาที่พบบ่อยในการติดตั้ง Hermes Agent

hermes: command not found

สาเหตุ: terminal ของคุณยังไม่ได้โหลดการเปลี่ยนแปลง PATH ใหม่

วิธีแก้:

หรือ:

จากนั้นลอง:

git: command not found

สาเหตุ: ไม่มี Git ติดตั้งอยู่

วิธีแก้บน Ubuntu, Debian หรือ WSL2:

วิธีแก้บน macOS ด้วย Homebrew:

ยังไม่ได้ตั้งค่า API Key

สาเหตุ: ติดตั้ง Hermes Agent แล้ว แต่ยังไม่ได้ตั้งค่าคีย์ผู้ให้บริการหรือเข้าสู่ระบบ

วิธีแก้:

หรือตั้งค่าคีย์ด้วยตนเอง:

hermes doctor รายงานว่าไฟล์ตั้งค่าหายไปหรือล้าสมัย

สาเหตุ: ไฟล์ตั้งค่าของคุณอาจไม่สมบูรณ์หลังจากอัปเดต

วิธีแก้:

เชื่อมต่อกับ Endpoint ที่กำหนดเองได้ แต่ได้คำตอบที่ผิดปกติ

สาเหตุ: base URL ชื่อโมเดล หรือความยาว context ไม่ถูกต้อง

วิธีแก้: ทดสอบ endpoint ด้วยไคลเอนต์อื่นก่อน ตรวจสอบว่ารองรับมาตรฐาน OpenAI-compatible และตรวจให้แน่ใจว่าโมเดลรองรับ context อย่างน้อย 64K สำหรับการใช้งาน Hermes Agent ตามปกติ

คู่มืออ้างอิงคำสั่งด่วน

บทสรุป

วิธีที่ง่ายที่สุดในการติดตั้ง Hermes Agent คือใช้ตัวติดตั้งแบบหนึ่งบรรทัดที่เป็นทางการ รีโหลดเชลล์ของคุณ รันคำสั่ง hermes model และตรวจสอบการตั้งค่าด้วยการสนทนาจริงหนึ่งครั้งพร้อมกับ hermes doctor ให้การตั้งค่าครั้งแรกของคุณเรียบง่าย คือ หนึ่งเครื่อง หนึ่งผู้ให้บริการ หนึ่งบทสนทนาที่ใช้งานได้ เมื่อผู้ช่วย Hermes Agent พื้นฐานทำงานได้อย่างมั่นคงแล้ว คุณก็สามารถต่อยอดได้อย่างปลอดภัยด้วยการแยกด้วย Docker บอทเกตเวย์ สกิลต่าง ๆ การทำงานอัตโนมัติตามกำหนดเวลา และผู้ให้บริการโมเดลที่กำหนดเอง