Goose + JoinGonka Gateway: ผู้ให้บริการของคุณและคีย์ใน keyring

ขั้นตอนที่ 1: ติดตั้ง Goose วิธีอย่างเป็นทางการสำหรับ CLI จากเอกสารโปรเจกต์:

# macOS and Linux: the script puts the binary in ~/.local/bin
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

# macOS, Homebrew
brew install block-goose-cli

ตัวแปร CONFIGURE=false จะปิดวิซาร์ด goose configure ที่สคริปต์จะรันทันทีหลังติดตั้งตามปกติ เพราะตัวติดตั้งจะตั้งค่าผู้ให้บริการให้เอง หากไม่มีไดเรกทอรี ~/.local/bin ใน PATH สคริปต์จะแจ้งให้ทราบ สำหรับ Windows ในรีโปเดียวกันมีสคริปต์ download_cli.ps1 ส่วนแอปเดสก์ท็อปดาวน์โหลดได้จากหน้าต่างเอกสาร ทั้งแอปและ CLI อ่านการตั้งค่าเดียวกัน ดังนั้นทุกอย่างด้านล่างใช้ได้กับทั้งสอง ตรวจสอบด้วย goose --version

ขั้นตอนที่ 2: ขอคีย์ ลงทะเบียนที่ gate.joingonka.ai/register ยืนยันอีเมล แล้วสร้างคีย์ที่ขึ้นต้นด้วย jg- ในส่วน "API-คีย์" คีย์เดียวและยอดเงินเดียวใช้ได้กับทุกโมเดลในเครือข่าย

ขั้นตอนที่ 3: รันตัวติดตั้ง

npx @joingonka/setup --tool goose

ตัวติดตั้งจะถามหาคีย์ ซึ่งจะไม่ส่งผ่านอาร์กิวเมนต์บรรทัดคำสั่งเพื่อไม่ให้ค้างอยู่ในประวัติเชลล์ และจะทำสิ่งต่อไปนี้:

• สร้างไฟล์ผู้ให้บริการ custom_providers/custom_joingonka.json ที่มีที่อยู่เกตเวย์และโมเดลทั้งสามของเครือข่ายพร้อมหน้าต่างบริบทจริง สิทธิ์ 600 ชื่อ custom_joingonka และ CUSTOM_JOINGONKA_API_KEY เป็นชื่อเดียวกับที่ Goose อนุมานเองจากชื่อ "JoinGonka" ดังนั้นคีย์จากวิซาร์ดจะไปอยู่ถูกที่
• ตั้ง JoinGonka เป็นผู้ให้บริการเริ่มต้นด้วยโมเดล DeepSeek V4 Flash แต่เฉพาะเมื่อยังไม่ได้เลือกผู้ให้บริการ หรือเลือกของเราแต่โมเดลว่างเปล่าหรือหลุดจากเครือข่าย จะไม่แตะตัวเลือกของผู้อื่น แต่จะพิมพ์คำสั่งให้ลอง: goose session --provider custom_joingonka --model …
• วางคีย์ลงใน secrets.yaml เฉพาะเมื่อที่เก็บซีเคร็ตของ Goose เป็นแบบไฟล์แน่นอน มิฉะนั้นจะบอกตรง ๆ ว่ายังเหลืออีกหนึ่งขั้น รายละเอียดอยู่ในส่วนเกี่ยวกับคีย์
• สำรองไฟล์ที่แก้ไข และสุดท้ายส่งคำขอจริงไปยังเกตเวย์เพื่อตรวจสอบคีย์ ที่อยู่ และโมเดลทันที

ตัวติดตั้งค้นหาไดเรกทอรีการตั้งค่าเหมือนกับ Goose เอง: ~/.config/goose บน Linux และ macOS, %APPDATA%\Block\goose\config บน Windows, <root>/config เมื่อกำหนด GOOSE_PATH_ROOT โมเดลอื่นกำหนดได้ด้วยแฟล็ก --model พร้อมตัวย่อ deepseek, glm หรือ minimax โมเดลที่ระบุชัดเจนจะถูกบันทึกเสมอ โหมดไม่ถามจะดึงคีย์จากตัวแปรสภาพแวดล้อม:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool goose --model glm --non-interactive

ทุกอย่างที่ตัวติดตั้งทำ คุณสามารถทำด้วยตัวเองได้ Provider คือไฟล์ JSON แยกต่างหาก ~/.config/goose/custom_providers/custom_joingonka.json ชื่อไฟล์ต้องตรงกับฟิลด์ name:

{
  "name": "custom_joingonka",
  "engine": "openai",
  "display_name": "JoinGonka",
  "description": "JoinGonka Gateway — Gonka AI inference (OpenAI-compatible)",
  "api_key_env": "CUSTOM_JOINGONKA_API_KEY",
  "base_url": "https://gate.joingonka.ai/v1/chat/completions",
  "models": [
    { "name": "deepseek-ai/DeepSeek-V4-Flash-0731", "context_limit": 380000 },
    { "name": "zai-org/GLM-5.3-Flash", "context_limit": 390000 },
    { "name": "MiniMaxAI/MiniMax-M2.7", "context_limit": 200000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

ไม่มีการตั้งค่าการจำกัดการตอบสนองแยกต่างหากสำหรับรายการโมเดลใน Goose สำหรับโมเดลเหล่านี้ Goose จะไม่ส่งขีดจำกัดไปในคำขอเลย (เราตรวจสอบจากบันทึกคำขอแล้ว) และในโหมดสตรีมมิ่ง Gateway จะจำกัดการตอบสนองตามขีดจำกัดของโมเดลเอง: 32,768 token สำหรับ DeepSeek V4 Flash, 8,192 สำหรับ GLM-5.3 Flash และ MiniMax M2.7 ไม่จำเป็นต้องตั้งค่าตัวแปร Global GOOSE_MAX_TOKENS สำหรับเรื่องนี้ เพราะมีผลกับทุก Provider ทันที

Goose อ่านไฟล์ Provider ด้วยการตรวจสอบ JSON ที่เข้มงวด: หากมีคอมเมนต์หรือคอมมาเกิน จะทำให้ Provider หายไปจากรายการ คุณสามารถสร้างด้วย Wizard (goose configure → Custom Providers) แต่ Wizard จะไม่ถามเรื่องหน้าต่างบริบท (context window) ซึ่งคุณต้องเพิ่มเองด้วยมือ

Provider และโมเดลเริ่มต้นอยู่ใน ~/.config/goose/config.yaml ซึ่ง Goose จะเขียนไว้ดังนี้:

active_provider: custom_joingonka
providers:
  custom_joingonka:
    enabled: true
    model: deepseek-ai/DeepSeek-V4-Flash-0731
    configured: true

รูปแบบเก่าที่เป็นคีย์แบบแบน GOOSE_PROVIDER และ GOOSE_MODEL ที่รูทของไฟล์ก็ยังใช้งานได้: Goose จะอ่านและแปลงเป็นรูปแบบใหม่เมื่อบันทึกการตั้งค่าครั้งแรก เช่นเดียวกับเราหลังจากใช้ goose configure ตัวติดตั้งเมื่อพบคลังข้อมูลว่างจะเขียนคีย์แบบแบน ซึ่งรุ่นใดก็เข้าใจได้ ตัวแปรสภาพแวดล้อมที่มีชื่อเดียวกันจะสำคัญกว่าไฟล์: หากตั้งค่าไว้ในเชลล์ ค่าจาก config.yaml จะไม่มีผล และตัวติดตั้งจะแจ้งเตือนเรื่องนี้

ในไฟล์ของผู้ให้บริการ Goose มีเพียงชื่อของ secret เท่านั้น — CUSTOM_JOINGONKA_API_KEY โดย Goose จะค้นหาค่าตามลำดับดังนี้: ในตัวแปรสภาพแวดล้อมที่มีชื่อนี้ จากนั้นในที่จัดเก็บ secret ของระบบ (keyring บน macOS คือ Keychain) แล้วจึงในไฟล์ secrets.yaml ที่อยู่ข้าง config โดย secret จะถูกเขียนลงไฟล์เมื่อที่จัดเก็บของ Goose เป็นแบบไฟล์ และจะถูกเก็บเป็นข้อความธรรมดาด้วยสิทธิ์ 600 ส่วนใน config.yaml นั้น Goose จะไม่ค้นหาคีย์เลย (เอกสาร)

ที่จัดเก็บจะกลายเป็นแบบไฟล์เมื่อ keyring ถูกปิด — ด้วยตัวแปร GOOSE_DISABLE_KEYRING ที่มีค่าใดก็ได้ หรือบรรทัด GOOSE_DISABLE_KEYRING: true ใน config.yaml — หรือเมื่อ keyring เข้าใช้งานไม่ได้ เช่น เซิร์ฟเวอร์ที่ไม่มีเซสชันกราฟิก คอนเทนเนอร์ หรือ CI ในกรณีหลัง Goose จะเขียนลงบันทึกว่า «Keyring unavailable. Using file storage for secrets.» และสลับไปใช้ไฟล์เอง — ซึ่งเป็นสิ่งที่เราเห็นในคอนเทนเนอร์ ตัวติดตั้งไม่สามารถเขียนลง keyring ได้ และจะไม่ปิดมันให้คุณ เพราะ Goose จะมองไม่เห็น secret ที่มีอยู่แล้วในนั้น ดังนั้นจึงมีสถานการณ์ดังนี้:

ขั้นตอนที่เหลือ รัน goose configure และตอบคำถามของ wizard — ในการทดสอบของเราคำถามมีหน้าตาดังนี้:

• What would you like to configure? → Configure Providers;
• Which model provider should we use? → JoinGonka (ของเราอยู่อันดับแรก);
• Would you like to set CUSTOM_JOINGONKA_API_KEY? (optional) → Yes จากนั้นที่ Enter value for CUSTOM_JOINGONKA_API_KEY ให้วางคีย์ — ตัวอักษรจะกลายเป็นสี่เหลี่ยม คีย์จะถูกบันทึกทันที;
• Would you like to configure advanced settings? → No;
• Select a model — Goose ได้รับรายการจาก gateway: MiniMaxAI/MiniMax-M2.7, deepseek-ai/DeepSeek-V4-Flash-0731, zai-org/GLM-5.3-Flash เคอร์เซอร์อยู่ที่บรรทัดแรก — หากต้องการคงโมเดลที่ตัวติดตั้งเลือกไว้ ให้ใช้ลูกศรเลือก DeepSeek V4 Flash หลังจากการทดสอบคำขอ wizard จะจบด้วยข้อความ «Configuration saved successfully»

ใน Goose Desktop ขั้นตอนคือ: Settings → Models → Configure providers → JoinGonka → คีย์ → Submit หากไม่อยากวางคีย์ด้วยมือ ให้ใส่คีย์ลงในตัวแปรและรัน wizard จากเชลล์เดียวกัน: Goose จะแสดง «CUSTOM_JOINGONKA_API_KEY is set via environment variable» และเสนอให้บันทึกค่า:

read -s CUSTOM_JOINGONKA_API_KEY && export CUSTOM_JOINGONKA_API_KEY
goose configure

และสำหรับการรันครั้งเดียว สามารถส่งคีย์โดยไม่บันทึกได้เลย: CUSTOM_JOINGONKA_API_KEY=jg-your-key goose session ใน PowerShell ใช้ $env:CUSTOM_JOINGONKA_API_KEY = "jg-your-key"; goose session ตัวแปรสภาพแวดล้อมมีความสำคัญกว่าค่าที่บันทึกไว้ แต่จะอยู่จนกว่าจะปิดเชลล์เท่านั้น

ก่อนอื่น มาดูกันว่า Goose มองเห็นการตั้งค่าอะไรจริง ๆ บ้าง:

goose info -v

ในบล็อก «goose Configuration» ต้องมีบรรทัด GOOSE_PROVIDER: custom_joingonka และ GOOSE_MODEL พร้อม ID ของโมเดล จากนั้นลองรันแบบครั้งเดียวโดยไม่ใช้เซสชันแบบอินเทอร์แอ็กทีฟ: วางไฟล์ที่มีบั๊กชัดเจนไว้ในไดเรกทอรีว่าง แล้วให้มันหาบั๊กนั้น

goose run --no-session -t "Read calc.py and tell me in one sentence whether it has a bug."

แฟล็ก --no-session จะไม่บันทึกการรันลงในประวัติ ในส่วนหัวจะปรากฏบรรทัดแบบ ● new session · custom_joingonka deepseek-ai/DeepSeek-V4-Flash-0731 ตามด้วยการเรียกใช้เครื่องมือ — ▸ shell พร้อมคำสั่ง cat calc.py — และคำตอบที่พบบั๊ก ส่วนโมเดลอื่นสำหรับการรันครั้งเดียวสามารถกำหนดได้ด้วย --model: zai-org/GLM-5.3-Flash หรือ MiniMaxAI/MiniMax-M2.7 ในการรันของเราเมื่อวันที่ 23 กันยายน 2026 ทั้งสามโมเดลในเครือข่ายผ่านวงจร «คำขอ → เครื่องมือ → ผลลัพธ์ → คำตอบ» ได้ทั้งหมด Goose CLI จะซ่อนกระบวนการคิดของโมเดลไว้เป็นค่าเริ่มต้น — หากต้องการแสดง สามารถใช้ตัวแปร GOOSE_CLI_SHOW_THINKING=1 เมื่อแสดงผลออกทางเทอร์มินัล ในมุมมองของเกตเวย์ คำขอจะปรากฏในแดชบอร์ด: ส่วน «การใช้งาน» แยกตาม «ตามโมเดล» และ «ตามคีย์»

หากมีอะไรผิดพลาด โดยปกติแล้วการวินิจฉัยสามารถอ่านได้จากข้อความแสดงข้อผิดพลาดโดยตรง:

เอเจนต์ใช้โทเค็นต่างจากการแชททั่วไป ในการตั้งค่ามาตรฐาน Goose จะส่งคำอธิบายเครื่องมือ 18 อย่างที่ติดตั้งมาให้แก่โมเดล และในการทดสอบของเรา การทำงานแต่ละครั้งใช้โทเค็นขาเข้าประมาณ 4,600 โทเค็นก่อนที่คุณจะถามคำถามเสียอีก งาน “อ่านไฟล์และค้นหาข้อผิดพลาด” ใช้เวลา 2-3 ขั้นตอนและ 10,000-15,000 โทเค็น ซึ่งส่วนใหญ่เป็นขาเข้า Goose จะส่งคำขอสั้นๆ อีกหนึ่งครั้งโดยอัตโนมัติเพื่อตั้งชื่อเซสชัน ส่วนขยายที่ไม่จำเป็นสามารถปิดได้ใน goose configure → Toggle Extensions — นี่เป็นวิธีที่ง่ายที่สุดในการลดโทเค็นขาเข้า

ผ่าน JoinGonka Gateway โทเค็นมีราคา $0.0069 ต่อล้านโทเค็นขาเข้า และ $0.021 ต่อล้านโทเค็นขาออก — ราคาเท่ากันสำหรับโมเดลทั้งหมดในเครือข่ายและดึงข้อมูลจากแหล่งข้อมูลสดบนหน้านี้

การประเมินในคอลัมน์ขวาอิงตามราคาในเดือนกันยายน 2026 สำหรับการเปรียบเทียบ นี่คือวิธีที่คุณสามารถชำระค่าโมเดลใน Goose:

การใช้งานที่แน่นอนและยอดคงเหลือดูได้ในแดชบอร์ด ในส่วน “การใช้งาน” และ “การเรียกเก็บเงิน” เหตุผลที่ DeepSeek V4 Flash ถูกเลือกเป็นค่าเริ่มต้น — เนื่องจากมีขีดจำกัดคำตอบสูงสุดในเครือข่าย — ได้รับการอธิบายอย่างละเอียดใน ภาพรวมโมเดล.

โหมดยืนยัน โดยค่าเริ่มต้น Goose ทำงานในโหมด auto — อิสระเต็มรูปแบบ: แก้ไขและลบไฟล์เอง รันคำสั่ง และใช้ส่วนขยายต่าง ๆ โดยไม่ถามอะไรเลย ในโปรเจกต์ของตัวเองก็สะดวกดี แต่กับโค้ดของคนอื่นควรตั้งโหมดให้เข้มขึ้น:

# inside a session
/mode smart_approve

# permanently, as a line in config.yaml
GOOSE_MODE: smart_approve

นี่เป็นคุณสมบัติของตัว Goose เอง ไม่ได้ขึ้นอยู่กับผู้ให้บริการโมเดล

การเปลี่ยนโมเดล ภายในเซสชันใช้คำสั่ง /model พร้อมรหัส เช่น /model zai-org/GLM-5.3-Flash สำหรับครั้งเดียวใช้แฟล็ก --model กับ goose run และ goose session สำหรับถาวรใช้ goose configure หรือบรรทัด model ใน config.yaml โดยผู้ให้บริการยังคงเดิม GLM-5.3 Flash ที่มีกระบวนการคิดเหมาะกับตรรกะที่ซับซ้อน แต่เพดานคำตอบอยู่ที่ 8192 โทเคน และส่วนหนึ่งหมดไปกับกระบวนการคิด — รายละเอียดอยู่ในรีวิวโมเดล

การรันแบบไม่ต้องเฝ้า goose run เหมาะกับสคริปต์และ CI: แฟล็ก -q ให้แสดงเฉพาะคำตอบของโมเดลในเอาต์พุต ส่วน --output-format json ส่งผลลัพธ์ออกมาในรูปแบบที่นำไปประมวลผลต่อได้ ตัวจำกัด --max-turns (จำนวนรอบที่เอเจนต์ทำได้โดยไม่ต้องมีคน介入) และ --max-tool-repetitions (จำนวนครั้งติดกันที่เรียกเครื่องมือเดิมด้วยอาร์กิวเมนต์เดิมได้) ช่วยป้องกันการวนซ้ำ

ความเป็นส่วนตัว สถิติการใช้งานแบบไม่ระบุตัวตนใน Goose ปิดไว้โดยค่าเริ่มต้น (GOOSE_TELEMETRY_ENABLED) เกตเวย์ไม่เก็บเนื้อหาของพรอมป์ต์และคำตอบ — ในสถิติเหลือเพียงข้อมูลสรุปการใช้งานเท่านั้น