Hermes Agent คือเอเจนต์ AI แบบโอเพนซอร์สจาก Nous Research ที่ทำงานผ่านเทอร์มินัล เชื่อมต่อกับผู้ให้บริการโมเดลต่าง ๆ จดจำบริบทที่เป็นประโยชน์ข้ามเซสชัน และขยายความสามารถได้ด้วยเครื่องมือ สกิล เกตเวย์รับส่งข้อความ และระบบอัตโนมัติ คู่มือนี้จะช่วยให้คุณทราบวิธีติดตั้ง Hermes สำหรับตัวติดตั้งมาตรฐานบน macOS หรือ Windows คุณไม่จำเป็นต้องติดตั้ง Python หรือ Node.js ด้วยตนเอง เพราะตัวติดตั้งอย่างเป็นทางการจะจัดการส่วนพึ่งพาหลักให้
ก่อนติดตั้ง Hermes Agent
Hermes Agent เป็นซอฟต์แวร์ที่เน้นการใช้งานผ่านเทอร์มินัล ดังนั้นคุณจะติดตั้งผ่านบรรทัดคำสั่ง เลือกหัวข้อที่ตรงกับคอมพิวเตอร์ของคุณ:
macOS: เปิด Terminal จาก Applications > Utilities > Terminal หรือกด Command + Space แล้วค้นหา "Terminal"
Windows: ติดตั้ง WSL2 ก่อน เปิดเทอร์มินัลของลินุกซ์ดิสทริบิวชัน แล้วทำตามคำสั่งสำหรับ Linux
คุณต้องมี Git ด้วย ตรวจสอบว่าได้ติดตั้ง Git แล้วหรือไม่:
ผลลัพธ์ที่คาดว่าจะได้รับ:
หากเห็น git: command not found ให้ติดตั้ง Git ก่อน:
หากยังไม่มี Homebrew บน macOS ให้ติดตั้ง Git จาก Apple Command Line Tools โดยเรียกใช้:
ขั้นตอนที่ 1: ติดตั้ง Hermes Agent บน macOS หรือ Windows
ในเทอร์มินัล ให้คัดลอกและวางคำสั่งติดตั้งอย่างเป็นทางการ:
ตัวติดตั้งจะดาวน์โหลด Hermes Agent เตรียมสภาพแวดล้อม Python ติดตั้งส่วนพึ่งพาที่จำเป็น และเพิ่มคำสั่ง hermes ลงในพาธของเชลล์ สำหรับการติดตั้งแบบผู้ใช้ทั่วไป ข้อมูล Hermes จะจัดเก็บไว้ใน ~/.hermes/
เมื่อคำสั่งทำงานเสร็จ ให้โหลดเชลล์ใหม่:
หากคุณใช้ Zsh ซึ่งพบได้ทั่วไปบน macOS ให้เรียกใช้:
ผลลัพธ์ที่คาดว่าจะได้รับ:
ตอนนี้ให้ยืนยันว่าคำสั่ง Hermes Agent พร้อมใช้งาน:
ผลลัพธ์ที่คาดหวัง:
หมายเลขเวอร์ชันที่แน่นอนอาจเปลี่ยนแปลงได้เมื่อมีการอัปเดต Hermes Agent
ขั้นตอนที่ 2: กำหนดค่าผู้ให้บริการโมเดล
Hermes Agent ต้องมีผู้ให้บริการโมเดลก่อนจึงจะตอบคำถามหรือใช้เครื่องมือได้ การตั้งค่าสำหรับผู้เริ่มต้นที่ง่ายที่สุดคือแบบอินเทอร์แอกทีฟ:
วิซาร์ดจะให้คุณเลือกผู้ให้บริการ เช่น Kimi/Moonshot อย่าเพิ่งกำหนดค่า routing, fallback, gateway หรือ cron จนกว่าจะใช้งานแชตพื้นฐานได้
เลือกโมเดลเริ่มต้น Kimi K3 คือโมเดลเรือธงรุ่นล่าสุดของ Kimi; หากคุณต้องการใช้เขียนโค้ดเป็นหลัก kimi-k2.7-code เป็นตัวเลือกที่ดีกว่า
หากคุณทราบค่าที่ต้องการตั้งค่าอยู่แล้ว คุณสามารถใช้ hermes config set ได้ ตัวอย่างเช่น:
หากคุณไม่มีคีย์ API Kimi อาจเป็นตัวเลือกที่น่าสนใจ
ขั้นตอนที่ 1: เปิดใช้งาน Kimi API ของคุณ
ก่อนใช้ Kimi API กับ Hermes Agent ให้เปิดใช้งาน Kimi API Key ของคุณใน Kimi Platform เราแนะนำให้เติมเงิน $20 ขึ้นไปเพื่อปลดล็อกสิทธิ์การเข้าถึงระดับ Tier 2 ซึ่งช่วยลดเวลาแฝงและรองรับประสิทธิภาพที่เสถียรกว่าสำหรับงานที่ซับซ้อนและมีหลายขั้นตอน
ขั้นตอนที่ 2: สร้าง Kimi API Key ของคุณ
ไปที่ส่วน API Keys ใน Kimi Platform แล้วคลิก Create API Key อย่าลืมคัดลอกคีย์ API ของคุณและเก็บไว้ในที่ปลอดภัย เนื่องจากคีย์จะแสดงเพียงครั้งเดียวเมื่อสร้าง
ขั้นตอนที่ 3: ป้อนคีย์ API ของคุณ
วางคีย์ Kimi API ของคุณแล้วเชื่อมต่อ Hermes Agent
ขั้นตอนที่ 3: เริ่มใช้งาน Hermes Agent
เมื่อตั้งค่าโมเดลแล้ว ให้เริ่ม CLI แบบดั้งเดิม:
หรือลองใช้ UI สำหรับเทอร์มินัลแบบใหม่:
คุณควรเห็นหน้าจอต้อนรับหรือ prompt ที่แสดงผู้ให้บริการ/โมเดลที่เลือกไว้ ทดสอบด้วยคำขอแบบง่าย:
หากสำเร็จจะมีลักษณะดังนี้:
หาก Hermes Agent เปิดขึ้นแต่ตอบกลับด้วยข้อผิดพลาดเกี่ยวกับโมเดลหรือการยืนยันตัวตน ให้รัน:
จากนั้นเลือกผู้ให้บริการของคุณอีกครั้ง และตรวจสอบคีย์ API หรือการเข้าสู่ระบบ OAuth
ขั้นตอนที่ 4: เปลี่ยน Hermes Agent ให้เป็นบอต
เช่นเดียวกับ OpenClaw, Hermes Agent สามารถทำงานเป็นบอตและเชื่อมต่อกับแอปแชตของคุณได้:
หลังตั้งค่าเสร็จ ให้ตรวจสอบสถานะ gateway:
ใช้ gateway หลังจากผู้ให้บริการโมเดลของคุณทำงานในเทอร์มินัลแล้วเท่านั้น หาก CLI ไม่สามารถทำแชตพื้นฐานได้ บอตก็มักจะล้มเหลวด้วยสาเหตุเดียวกัน
ปัญหาที่พบบ่อยในการติดตั้ง Hermes Agent
hermes: ไม่พบคำสั่ง
สาเหตุ: เทอร์มินัลของคุณยังไม่ได้โหลดการเปลี่ยนแปลง PATH ใหม่
วิธีแก้ไข:
หรือ:
จากนั้นลอง:
git: ไม่พบคำสั่ง
สาเหตุ: ไม่มี Git ติดตั้งอยู่
วิธีแก้ไขบน Ubuntu, Debian หรือ WSL2:
วิธีแก้ไขบน macOS ด้วย Homebrew:
ยังไม่ได้ตั้งค่า API Key
สาเหตุ: ติดตั้ง Hermes Agent แล้ว แต่ยังไม่ได้กำหนดคีย์ผู้ให้บริการหรือการเข้าสู่ระบบ
วิธีแก้ไข:
หรือตั้งค่าคีย์ด้วยตนเอง:
hermes doctor รายงานว่าการกำหนดค่าขาดหายหรือล้าสมัย
สาเหตุ: ไฟล์การกำหนดค่าของคุณอาจไม่สมบูรณ์หลังการอัปเดต
วิธีแก้ไข:
เชื่อมต่อ Custom Endpoint ได้ แต่ตอบกลับไม่ถูกต้อง
สาเหตุ: base URL, ชื่อโมเดล หรือความยาวบริบทไม่ถูกต้อง
วิธีแก้ไข: ทดสอบ endpoint ในไคลเอนต์อื่นก่อน ยืนยันว่ารองรับ OpenAI และตรวจสอบให้แน่ใจว่าโมเดลรองรับบริบทอย่างน้อย 64K สำหรับเวิร์กโฟลว์ Hermes Agent ทั่วไป
ข้อมูลอ้างอิงคำสั่งฉบับย่อ
สรุป
วิธีที่ง่ายที่สุดในการติดตั้ง Hermes Agent คือใช้ตัวติดตั้งแบบบรรทัดเดียวอย่างเป็นทางการ โหลดเชลล์ใหม่ เรียกใช้ hermes model และตรวจสอบการตั้งค่าด้วยการแชตจริงหนึ่งครั้งพร้อม hermes doctor ตั้งค่าเริ่มต้นให้เรียบง่าย: หนึ่งเครื่อง หนึ่งผู้ให้บริการ และหนึ่งการสนทนาที่ใช้งานได้ เมื่อผู้ช่วย Hermes Agent พื้นฐานทำงานได้เสถียรแล้ว คุณจึงค่อยต่อยอดได้อย่างปลอดภัยด้วยการแยกสภาพแวดล้อมด้วย Docker, gateway bot, skill, ระบบอัตโนมัติตามกำหนดเวลา และผู้ให้บริการโมเดลแบบกำหนดเอง
คำถามที่พบบ่อย
~/.hermes/ และขยายความสามารถได้ด้วยสกิล หน่วยความจำ งานตามกำหนดเวลา และเกตเวย์รับส่งข้อความiex (irm https://hermes-agent.nousresearch.com/install.ps1) ใน PowerShell หรือใช้แพ็กเกจเดสก์ท็อป MSIX ก็ได้ ส่วน WSL2 ยังคงเป็นทางเลือกเสริมhermes model เลือกผู้ให้บริการหนึ่งราย เช่น Kimi จากนั้นเริ่ม hermes ทดสอบแชตปกติหนึ่งครั้ง เรียกใช้ hermes doctor และยืนยันว่า hermes --continue สามารถกลับไปยังเซสชันของคุณได้ หลังจากนั้นจึงเพิ่มการแยกสภาพแวดล้อมด้วย Docker สกิล เซิร์ฟเวอร์ MCP เสียง cron หรือเกตเวย์รับส่งข้อความตามต้องการ