การติดตั้ง Hermes และการกำหนดค่า OmniProxy

Hermes คือผู้ช่วยที่สามารถเก็บประวัติการสนทนาและประสบการณ์จากงานต่าง ๆ โดยนำสิ่งที่เคยทำมาจัดเป็นทักษะสำหรับใช้งานต่อในอนาคตได้ นอกจากนี้ยังเชื่อมต่อกับ Telegram, Discord, Slack, WhatsApp, Signal และเทอร์มินัลผ่าน Gateway เดียวกันได้ โดย Gateway คือจุดรับและส่งต่อข้อความแบบรวมศูนย์ คุณสามารถมอบหมายให้ตรวจสอบโค้ด บันทึกเหตุขัดข้อง หรือจัดการเอกสารของลูกค้าจากเครื่องมือแชตที่ใช้เป็นประจำ แล้วให้กลับไปทำงานต่อใน repository ได้

การเตรียมตัวก่อนติดตั้ง

เลือกวิธีติดตั้งตามระบบปฏิบัติการของคอมพิวเตอร์ก่อน macOS และ Windows สามารถใช้แพ็กเกจติดตั้งแบบมีหน้าต่างได้โดยตรง ส่วน Linux, macOS และ WSL2 สามารถใช้สคริปต์ผ่านเทอร์มินัลได้ WSL2 คือความสามารถสำหรับเรียกใช้สภาพแวดล้อม Linux ภายใน Windows สำหรับ Termux บนโทรศัพท์ Android และ Docker มีวิธีติดตั้งแยกต่างหาก คู่มือนี้จะอธิบายเฉพาะการติดตั้งบนคอมพิวเตอร์ทั่วไป

ต้องการหน้าต่าง

macOS, Windows

• macOS: เปิด DMG
• Windows: เปิดแพ็กเกจติดตั้ง
• ติดตั้งแอปลงในระบบ

ต้องการเฉพาะเทอร์มินัล

Linux, macOS, WSL2

• ใช้ install.sh คำสั่งเดียว
• บน Windows ใช้ install.ps1
• หลังติดตั้งให้ป้อน hermes

ยังไม่ควรใช้

pip, brew, AUR

• วิธีติดตั้งเหล่านี้ไม่ได้รับการสนับสนุนอย่างเป็นทางการ
• อัปเดตได้ยากแม้ติดตั้งเสร็จแล้ว
• ให้ใช้สองวิธีทางซ้ายแทน

ก่อนเริ่มต้น ให้เตรียมคอมพิวเตอร์ macOS, Windows หรือ Linux และตรวจสอบว่าสามารถเปิดเทอร์มินัลและเข้าถึง GitHub ได้ หากต้องการติดตั้งลงในไดรฟ์ภายนอก ให้เชื่อมต่อไดรฟ์ก่อนและตรวจสอบว่ามีพื้นที่เพียงพอ

ติดตั้งและเปิดใช้งานครั้งแรก

หากต้องการหน้าต่างแอป

ไปที่ ส่วนดาวน์โหลดบนเว็บไซต์ Hermes แล้วดาวน์โหลดแพ็กเกจติดตั้งที่ตรงกับระบบของคุณ แพ็กเกจติดตั้งมีสภาพแวดล้อมสำหรับการทำงานรวมอยู่แล้ว จึงไม่ต้องคอมไพล์บนคอมพิวเตอร์เมื่อเปิดใช้งานครั้งแรก

• macOS: เปิด DMG แล้วนำ Hermes.app ไปไว้ใน “Applications” DMG คือไฟล์อิมเมจสำหรับติดตั้งที่ใช้กันทั่วไปบน macOS แพ็กเกจนี้รองรับเฉพาะชิป Apple เท่านั้น และไม่รองรับ Intel Mac
• Windows: เปิดไฟล์ .appinstaller ด้วยโปรแกรมติดตั้งแอปของ Windows โปรแกรมจะติดตั้ง MSIX ที่มีลายเซ็น ซึ่งเป็นแพ็กเกจติดตั้งแอปประเภทหนึ่งของ Windows
• Linux: แพ็กเกจติดตั้งสำหรับเดสก์ท็อปมีให้เฉพาะ macOS และ Windows สำหรับ Linux ให้ใช้คำสั่งเทอร์มินัลด้านล่าง เมื่อติดตั้งเสร็จแล้วสามารถเรียกใช้ hermes desktop ได้

หากต้องการใช้เฉพาะเทอร์มินัล

หากใช้ Linux, macOS หรือ WSL2 ให้เรียกใช้คำสั่งต่อไปนี้ในเทอร์มินัล:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

หากใช้ PowerShell ที่มาพร้อมกับ Windows ให้เรียกใช้:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

โปรแกรมติดตั้งจะดาวน์โหลดโค้ดของ Hermes และโปรแกรมที่จำเป็นต่อการทำงาน หากการดาวน์โหลดหยุดลงกลางคัน ให้เรียกใช้คำสั่งเดิมอีกครั้ง เมื่อติดตั้งเสร็จแล้ว ให้ปิดเทอร์มินัลปัจจุบัน เปิดหน้าต่างใหม่ แล้วป้อน:

hermes

เมื่อเห็นข้อความพร้อมใช้งานของ Hermes แสดงว่าสามารถใช้คำสั่งได้แล้ว จากนั้นเรียกใช้ hermes doctor ได้ คำสั่งนี้จะตรวจสอบการติดตั้งและแจ้งว่ายังขาดสิ่งใดอยู่

ติดตั้งโปรแกรมไว้ในไดรฟ์ภายนอก

เมื่อวันที่ 9 ตุลาคม 2026 มีการติดตั้ง Hermes Agent v0.21.6 ลงในไดรฟ์ภายนอกบน Mac เครื่องหนึ่ง ตัวโปรแกรมอยู่ที่ /Volumes/AItools/tools/hermes-agent คำสั่งเริ่มต้นอยู่ที่ ~/.local/bin/hermes ส่วนการกำหนดค่าและประวัติการสนทนายังคงจัดเก็บอยู่ใน ~/.hermes

หากชื่อไดรฟ์ของคุณต่างออกไป ให้เปลี่ยนพาธหลัง --dir เป็นโฟลเดอร์ของคุณเอง ต้องเชื่อมต่อไดรฟ์นี้ไว้ตลอดเวลาที่เรียกใช้ Hermes

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

โปรแกรม

ฮาร์ดไดรฟ์แบบพกพา

• tools/hermes-agent
• วางโค้ดไว้ที่นี่

คำสั่ง

~/.local/bin/hermes

• ป้อน hermes ในเทอร์มินัล
• มีผลหลังเปิดหน้าต่างใหม่

การตั้งค่าและบทสนทนา

~/.hermes

• config.yaml อยู่ที่นี่
• ออกจากโปรแกรมก่อนถอดฮาร์ดไดรฟ์

รับค่าการเชื่อมต่อจาก OmniProxy

ในขั้นตอนนี้ Hermes จะเชื่อมต่อกับ OmniProxy ไม่ได้เชื่อมต่อกับ Grok หรือ Gemini โดยตรง ที่อยู่บริการของ Grok และ Gemini ต้องกำหนดค่าไว้ใน OmniProxy อย่านำที่อยู่เหล่านั้นไปกรอกใน Hermes โดยตรง

คอมพิวเตอร์ของคุณ

Hermes

→

เกตเวย์ภายในเครื่อง

OmniProxy

• ระบุที่อยู่ถึง /v1

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Model ID คือชื่อที่ถูกต้องแม่นยำซึ่งอินเทอร์เฟซใช้ระบุโมเดล โมเดลทั้งสองใช้ชื่อดังต่อไปนี้:

• สำหรับ Grok ให้กรอก grok-4.7 อินเทอร์เฟซของ xAI คือ https://api.x.ai/v1 และคำขอแชตจะส่งผ่าน /v1/chat/completions ดู เอกสารโมเดล Grok
• สำหรับ Gemini ให้กรอก gemini-3.8-flash อินเทอร์เฟซที่เข้ากันได้กับ OpenAI ของ Google คือ https://generativelanguage.googleapis.com/v1beta/openai/ ดู คำอธิบายการใช้งาน Gemini ที่เข้ากันได้กับ OpenAI

หากต้องการเปลี่ยนไปใช้ Gemini ใน Hermes เพียงเปลี่ยนชื่อโมเดลเป็น gemini-3.8-flash โดยยังคงกรอกที่อยู่อินเทอร์เฟซของ OmniProxy เช่นเดิม

คัดลอกที่อยู่อินเทอร์เฟซและคีย์จาก OmniProxy แล้วกรอก Model ID ที่ตรงกัน:

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Base URL คือที่อยู่อินเทอร์เฟซที่ Hermes ใช้ส่งคำขอ ในที่นี้ต้องลงท้ายด้วย /v1 ส่วน API Key คือคีย์ที่ OmniProxy ออกให้ Hermes ให้แทนที่ด้วยข้อมูลของคุณเองและอย่านำไปเผยแพร่ในหน้าสาธารณะ

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

กรอกการกำหนดค่าเครื่องมือ

ออกจากการสนทนาที่กำลังดำเนินอยู่ก่อน แล้วเรียกใช้คำสั่งต่อไปนี้ในเทอร์มินัล:

hermes model

เลือก Custom endpoint (self-hosted / VLLM / etc.) Custom endpoint คืออินเทอร์เฟซแบบกำหนดเอง ซึ่งหมายถึงการให้ Hermes เชื่อมต่อกับที่อยู่บริการที่คุณระบุ แทนการใช้แหล่งที่มาที่กำหนดไว้ล่วงหน้า

ตัวช่วยตั้งค่าจะถามที่อยู่อินเทอร์เฟซ คีย์ และชื่อโมเดลตามลำดับ ให้กรอกข้อมูลสามรายการจากส่วนก่อนหน้า หากต้องการใช้ Gemini ให้กรอกชื่อโมเดลเป็น gemini-3.8-flash

คุณยังสามารถแก้ไข ~/.hermes/config.yaml ได้โดยตรง YAML คือรูปแบบข้อความที่ใช้การเยื้องเพื่อแสดงความสัมพันธ์ของการกำหนดค่า ตัวอย่างสำหรับ Grok มีดังนี้:

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

หากใช้ Gemini ให้เปลี่ยน default เป็น gemini-3.8-flash โดยคงอีกสามรายการไว้เหมือนเดิม:

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

หลังจากบันทึกแล้ว ให้เรียกใช้ hermes ใหม่แล้วเริ่มสนทนา ในเซสชันที่เปิดอยู่แล้ว /model สามารถสลับได้เฉพาะระหว่างแหล่งที่มาที่บันทึกไว้เท่านั้น และไม่สามารถใช้เพิ่มการกำหนดค่านี้ได้

ตรวจสอบด้วยงานจริง

1

hermes doctor

• ผ่านการตรวจสอบการติดตั้ง

2

ส่งข้อความสั้นหนึ่งข้อความ

• เห็นคำตอบจาก Hermes

3

เปิดบันทึกการเรียกใช้

• ตรวจสอบชื่อโมเดล

1. เรียกใช้ hermes doctor เพื่อตรวจสอบว่าการติดตั้งสมบูรณ์หรือไม่
2. เรียกใช้ hermes แล้วให้มันอธิบายด้วยหนึ่งประโยคว่าสามารถทำอะไรได้บ้าง คุณควรเห็นข้อความตอบกลับ
3. เปิดบันทึกการเรียกใช้ของ OmniProxy ยืนยันว่าคำขอนี้มาจาก Hermes และตรวจสอบว่าชื่อโมเดลเป็น grok-4.7 หรือ gemini-3.8-flash

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

หากต้องการแชตผ่านเบราว์เซอร์ ให้เรียกใช้คำสั่งต่อไปนี้บนเครื่อง:

hermes dashboard --no-open --host 127.0.0.1 --port 9119

จากนั้นเปิด http://127.0.0.1:9119 ที่อยู่นี้ใช้ได้เฉพาะบนคอมพิวเตอร์เครื่องปัจจุบันเท่านั้น

ข้อผิดพลาดที่พบบ่อย

• เมื่อป้อน hermes แล้วแจ้งว่าไม่พบคำสั่ง: ให้ปิดเทอร์มินัลก่อน แล้วเปิดหน้าต่างใหม่ หากยังไม่พบ ให้ตรวจสอบว่า ~/.local/bin อยู่ใน PATH แล้ว PATH คือรายการตำแหน่งไดเรกทอรีที่ระบบใช้ค้นหาคำสั่ง สำหรับ Windows ให้ตรวจสอบว่าไดเรกทอรีเริ่มต้นที่โปรแกรมติดตั้งเพิ่มไว้อยู่ใน PATH
• การดาวน์โหลดระหว่างติดตั้งหยุดกลางคัน: เรียกใช้คำสั่งติดตั้งเดิมอีกครั้ง ส่วนที่ดาวน์โหลดไว้แล้วจะถูกนำมาใช้ต่อ
• Hermes ไม่ตอบกลับหรือแจ้งว่าเชื่อมต่อไม่ได้: ตรวจสอบว่า OmniProxy กำลังทำงานอยู่ และ Base URL ลงท้ายด้วย /v1 หรือไม่ หาก Hermes ทำงานอยู่ใน Docker แต่ OmniProxy อยู่บนเครื่องโฮสต์ อย่าใช้ 127.0.0.1 ซึ่งเข้าถึงได้เฉพาะภายในคอนเทนเนอร์
• แจ้งว่าคีย์ไม่ถูกต้อง: อัปเดตคีย์ของ OmniProxy แล้วแก้ไข api_key ใน config.yaml คีย์ของ xAI หรือ Google เป็นการตั้งค่าผู้ให้บริการของ OmniProxy อย่านำมากรอกในช่องนี้ของ Hermes
• แจ้งว่าไม่มีโมเดลนี้: เปิดรายการโมเดลปัจจุบันของ OmniProxy แล้วคัดลอก grok-4.7 หรือ gemini-3.8-flash ให้ตรงตามรูปแบบที่แสดงในรายการทุกประการ
• มีการตอบกลับ แต่ไม่สามารถทำงานอย่างการอ่านไฟล์หรือเรียกใช้คำสั่งได้: เปลี่ยนไปใช้โมเดลอื่นใน OmniProxy ที่มีความสามารถเหล่านี้ แล้วเปิด Hermes ใหม่อีกครั้ง
• เมื่อติดตั้งโปรแกรมไว้ในไดรฟ์ภายนอก ถอดไดรฟ์แล้ว hermes doctor รายงานข้อผิดพลาดด้านพื้นที่จัดเก็บ: ให้เชื่อมต่อไดรฟ์นั้นอีกครั้งก่อน อย่าให้ Hermes เขียนการกำหนดค่าชุดใหม่ขณะที่ไม่ได้เชื่อมต่อไดรฟ์

เอกสารอ้างอิงอย่างเป็นทางการ

ดูขั้นตอนการติดตั้งได้จาก เอกสารการติดตั้ง Hermes และ การรองรับแพลตฟอร์ม ดูการกำหนดค่า Custom endpoint ได้จาก เอกสาร Hermes Provider ส่วน Model ID ดูได้จาก เอกสารโมเดล Grok และ คำอธิบายการใช้งาน Gemini ที่เข้ากันได้กับ OpenAI

การติดตั้งบน macOS ได้รับการทดสอบครบทุกขั้นตอนเมื่อวันที่ 2026-10-09 โดยใช้ Hermes Agent v0.21.6 ส่วน grok-4.7 และ gemini-3.8-flash เป็น Model ID มาตรฐานในเอกสารของ xAI และ Google ณ วันดังกล่าว เมื่อกรอกข้อมูลจริง ให้ยึดชื่อตามที่แสดงใน OmniProxy เป็นหลัก

แทนที่ตัววางตำแหน่งทั้งหมดด้วยค่าจากการกำหนดค่า OmniProxy ของคุณ ห้ามเผยแพร่คีย์จริง

ผลลัพธ์ที่บันทึกหรือ HTTP 200 เพียงอย่างเดียวไม่พิสูจน์ความเข้ากันได้เต็มรูปแบบของเอเจนต์ ตรวจสอบแหล่งที่มาและโมเดลในบันทึกการเรียกใช้ของ OmniProxy

แหล่งทางการ · Hermes ↗