MiMo Code + JoinGonka Gateway: Xiaomi Agent บนโมเดลเครือข่าย Gonka

ขั้นตอนที่ 1: ติดตั้ง MiMo Code วิธีทางการจาก README ของโปรเจกต์:

# macOS and Linux
curl -fsSL https://mimo.xiaomi.com/install | bash

# Windows (PowerShell)
powershell -ep Bypass -c "irm https://mimo.xiaomi.com/install.ps1 | iex"

# via npm, on any system
npm install -g @mimo-ai/cli

สคริปต์จะติดตั้งไฟล์ไบนารีไว้ใน ~/.mimocode/bin และเพิ่มไดเรกทอรีนี้เข้า PATH ผ่านโปรไฟล์เชลล์ (แฟล็ก --no-modify-path จะปิดการทำงานนี้) ตัวสคริปต์จะดาวน์โหลดบิลด์จากที่เก็บของ Xiaomi หากดาวน์โหลดไม่สำเร็จ ให้ติดตั้งผ่าน npm — เป็นรีลีสเดียวกัน ในกรณีของเราทั้งสองวิธีได้เวอร์ชัน 0.1.15 ตรวจสอบได้ด้วย mimo --version

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

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

npx @joingonka/setup --tool mimo-code

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

• เพิ่มผู้ให้บริการ joingonka ลงในคอนฟิกส่วนกลาง ~/.config/mimocode/mimocode.jsonc (หรือ mimocode.json หรือ config.json หาก MiMo Code เขียนลงที่นั่นอยู่แล้ว): อะแดปเตอร์ @ai-sdk/openai-compatible, ที่อยู่เกตเวย์พร้อม /v1 และสามโมเดลในเครือข่ายพร้อมหน้าต่างบริบท เพดานการตอบกลับ และการรองรับเครื่องมือ;
• เก็บคีย์ไว้ในที่เก็บคีย์ของ MiMo Code เอง — ~/.local/share/mimocode/auth.json ด้วยสิทธิ์ 600 ในคอนฟิกเองไม่มีคีย์ จึงเก็บไว้ในดอตไฟล์ได้อย่างสบายใจ;
• ตั้งโมเดลเริ่มต้น — ฟิลด์ model — เป็น DeepSeek V4 Flash แต่เฉพาะเมื่อยังไม่ได้เลือกโมเดล หรือโมเดลที่เลือกชี้ไปยังโมเดลที่ออกจากเครือข่ายแล้ว ตัวติดตั้งจะไม่เขียนทับตัวเลือกที่คุณทำไว้ รวมถึงในคอนฟิกส่วนกลางอื่นด้วย;
• บันทึกสำเนาของไฟล์เดิมไว้ ไม่แตะผู้ให้บริการ คีย์ และคอมเมนต์ของผู้อื่น หากไฟล์ใดแยกวิเคราะห์ไม่ได้ ก็จะไม่เขียนทับ — จะหยุดและบอกว่าต้องแก้อะไร;
• สุดท้ายจะส่งคำขอจริงไปยังเกตเวย์ และบอกตรงๆ ว่าคีย์ ที่อยู่ และโมเดลได้รับการยอมรับหรือไม่

ตัวติดตั้งรองรับไดเรกทอรีที่ไม่ได้มาตรฐานได้เอง: MIMOCODE_HOME, XDG_CONFIG_HOME, XDG_DATA_HOME และ MIMOCODE_CONFIG หากต้องการตั้งโมเดลเริ่มต้นอื่น ให้ใช้แฟล็ก --model พร้อมตัวย่อ deepseek, glm หรือ minimax; สำหรับดอตไฟล์และเซิร์ฟเวอร์มีโหมดไม่ถามคำถาม:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool mimo-code --non-interactive

หาก MiMo Code เปิดอยู่ ให้รีสตาร์ตใหม่: ผู้ให้บริการใหม่จะถูกโหลดตอนเริ่มต้น

ทุกสิ่งที่ตัวติดตั้งทำ คุณสามารถเขียนด้วยมือได้เอง มีไฟล์อยู่สองไฟล์ และแต่ละไฟล์มีหน้าที่ของตัวเอง: ไฟล์คอนฟิกอธิบายผู้ให้บริการและโมเดล ส่วน auth.json เก็บคีย์ ตัวเชื่อมทั้งสองเข้าด้วยกันคือรหัสผู้ให้บริการ — joingonka ต้องตรงกันในทั้งสองไฟล์ คอนฟิกอยู่ที่ ~/.config/mimocode/mimocode.jsonc:

{
  "$schema": "https://mimo.xiaomi.com/mimocode/config.json",
  "provider": {
    "joingonka": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "JoinGonka (Gonka)",
      "options": {
        "baseURL": "https://gate.joingonka.ai/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek V4 Flash (Gonka)",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 380000, "output": 32768 }
        },
        "zai-org/GLM-5.3-Flash": {
          "name": "GLM 5.3 Flash (Gonka)",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 390000, "output": 8192 }
        },
        "MiniMaxAI/MiniMax-M2.7": {
          "name": "MiniMax M2.7 (Gonka)",
          "tool_call": true,
          "limit": { "context": 200000, "output": 8192 }
        }
      }
    }
  },
  "model": "joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"
}

คีย์อยู่ที่ ~/.local/share/mimocode/auth.json พร้อมสิทธิ์ 600:

{
  "joingonka": { "type": "api", "key": "jg-your-key" }
}

โมเดลเริ่มต้นเขียนในรูปแบบ provider/model-id โดยแยกผู้ให้บริการที่เครื่องหมายทับตัวแรก ดังนั้น id ของโมเดลในเครือข่ายที่มีเครื่องหมายทับของตัวเองจึงเขียนตามเดิม

คีย์วางไว้ที่อื่นได้อีกไหม README ของ MiMo Code ยังมีแบบที่ใส่คีย์ลงในคอนฟิกโดยตรง — options.apiKey วิธีนี้ใช้ได้ แต่ก็ทำให้คีย์ถูก commit ไปพร้อม dotfiles ได้ง่าย และคีย์เก่าที่ลืมไว้ตรงนั้นจะทับคีย์ใหม่จาก auth.json — ตัวติดตั้งจึงลบ options.apiKey ออกจากบล็อกของตัวเอง ส่วนไฟล์ .mimocode/mimocode.jsonc ในโปรเจกต์ยิ่งไม่ควรใส่คีย์ลงไป

ไฟล์ไหนมีลำดับความสำคัญสูงสุด MiMo Code จะรวม config.json, mimocode.json และ mimocode.jsonc ระดับ global ตามลำดับนี้ โดยไฟล์ถัดไปจะทับไฟล์ก่อนหน้า ผลลัพธ์สุดท้ายดูได้จาก mimo debug config ส่วน path ของคอนฟิกและคีย์บนเครื่องของคุณดูได้จาก mimo debug paths

คุณสามารถเพิ่มผู้ให้บริการของคุณเองได้โดยไม่ต้องใช้ไฟล์ โดยใช้ตัวช่วยสร้างในตัว เมื่อเริ่มใช้งานครั้งแรกในไดเรกทอรีโปรเจกต์ MiMo Code จะถามว่าคุณเชื่อใจโฟลเดอร์นี้หรือไม่ (Yes, I trust this folder): เอเจนต์จะได้รับสิทธิ์ในการอ่าน แก้ไข และรันไฟล์ในโฟลเดอร์นั้น จากนั้นคำสั่ง /connect จะเปิดรายการ Select provider: ด้านบนคือทางเข้าสู่แพลตฟอร์ม Xiaomi MiMo, Codex และการนำเข้าจาก Claude Code ด้านล่างคือแคตตาล็อกของผู้ให้บริการ และท้ายสุดคือ + Custom provider ตัวช่วยสร้างจะถามคำถามหกข้อ:

ในการรันของเรา ตัวช่วยสร้างได้บันทึกบล็อกผู้ให้บริการด้วยโมเดลเดียวที่ไม่มีการจำกัดและสองฟิลด์ที่ตัวติดตั้งไม่มี: env พร้อมชื่อตัวแปร JOINGONKA_API_KEY ซึ่ง MiMo Code จะค้นหาคีย์ และ options.setCacheKey: true วิธีนี้ใช้งานได้กับเกตเวย์ แต่ควรกำหนดค่าให้สมบูรณ์: หากไม่มี limit คำสั่ง mimo models joingonka จะแสดงหน้าต่างขนาด 1M tokens วิธีที่ง่ายที่สุดคือหลังจากใช้ตัวช่วยสร้าง ให้รันตัวติดตั้งอีกครั้งหนึ่งครั้ง — มันจะเพิ่มแคตตาล็อกเต็มพร้อมการจำกัดลงในบล็อกเดิม

การเลือกโมเดล. การเลือกแบบถาวรคือฟิลด์ model ในคอนฟิก ในอินเทอร์เฟซคุณสามารถเปลี่ยนโมเดลได้ด้วยคำสั่ง /models และสำหรับการรันครั้งเดียวให้ใช้แฟล็ก -m คำสั่ง mimo models joingonka จะแสดงให้เห็นว่า MiMo Code มองเห็นโมเดลใดบ้างจากผู้ให้บริการและทำงานกับหน้าต่างขนาดใด รวมถึงเกณฑ์ที่เอเจนต์จะเริ่มบีบอัดประวัติ:

joingonka/deepseek-ai/DeepSeek-V4-Flash-0731 — window 380K, compacts at 342K
joingonka/MiniMaxAI/MiniMax-M2.7 — window 200K, compacts at 180K
joingonka/zai-org/GLM-5.3-Flash — window 390K, compacts at 351K

ราคาของโมเดลทั้งหมดในเครือข่ายเท่ากัน ดังนั้นการเลือกจึงขึ้นอยู่กับพฤติกรรม นี่คือผลลัพธ์ในการรัน mimo run ของเราในงานเดียว — อ่านไฟล์และค้นหาข้อผิดพลาด:

เหตุผลที่ DeepSeek V4 Flash ถูกเลือกเป็นค่าเริ่มต้น ได้รับการอธิบายไว้ใน ภาพรวมโมเดล

ก่อนอื่น ตรวจสอบว่า MiMo Code มองเห็นผู้ให้บริการและคีย์:

mimo models joingonka
mimo providers list

คำสั่งแรกจะแสดงรายชื่อสามโมเดลของเครือข่ายพร้อมขนาดหน้าต่างบริบท ตามตัวอย่างด้านบน ส่วนคำสั่งที่สองจะแสดงเส้นทางไปยังที่เก็บคีย์และบรรทัด joingonka api จากนั้นลองรันหนึ่งครั้ง วางไฟล์ calc.py ที่มีบั๊กชัดเจนไว้ในไดเรกทอรีโปรเจกต์ — เช่น โปรแกรมคำนวณพื้นที่สี่เหลี่ยมที่เอาด้านมาบวกกันแทนที่จะคูณกัน — แล้วขอให้มันหาบั๊ก:

mimo run "Read the file calc.py in the current project directory and tell me in one sentence whether it has a bug."

ผลลัพธ์จะแสดงเอเจนต์และโมเดล (> build · deepseek-ai/DeepSeek-V4-Flash-0731) การเรียกใช้เครื่องมือ (→ Read calc.py) และคำตอบที่ตรงประเด็น — พร้อมชี้ตำแหน่งนิพจน์ที่ผิด ตัวเลือก --format json จะเปลี่ยนผลลัพธ์ให้เป็นสตรีมเหตุการณ์ที่แต่ละขั้นตอนมีตัวนับโทเค็น ส่วน -m joingonka/<model-id> ใช้รันกับโมเดลอื่น ในรอบทดสอบของเรา ทั้งสามโมเดลของเครือข่ายผ่านลูป «ส่งคำขอ → เรียกเครื่องมือ → ได้ผลลัพธ์ → ตอบ» ครบทุกขั้นตอน

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

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

เครื่องมือเอเจนต์ใช้โทเค็นต่างจากการแชทปกติ: MiMo Code จะเพิ่ม System Prompt, คำอธิบายเครื่องมือ และบริบทการทำงานของเอเจนต์เข้าไปในทุกประโยคของคุณ และงานหนึ่งงานต้องใช้หลายขั้นตอน ในการทดสอบของเรา ทุกคำขอไปยังโมเดลต้องใช้โทเค็นขาเข้า 22-25k โทเค็น และงาน "อ่านไฟล์และค้นหาข้อผิดพลาด" ที่มีสองขั้นตอนใช้ไปประมาณ 45-50k โทเค็น ซึ่งเกือบทั้งหมดเป็นขาเข้า ดังนั้นราคาต่อโทเค็นจึงเป็นสิ่งสำคัญที่นี่

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

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

การประเมินราคาสำหรับโมเดลเกตเวย์ใน MiMo Code จะเป็นศูนย์ เนื่องจากไม่มีฟิลด์ cost ในบันทึก และในเหตุการณ์ --format json จะแสดงค่า "cost": 0 การบริโภคจริงและยอดเงินคงเหลือจะอยู่ในแดชบอร์ด ในส่วน "การใช้งาน" และ "การเรียกเก็บเงิน"

สิทธิ์การเข้าถึง (Permissions) ในอินเทอร์เฟซของ MiMo Code จะขอการยืนยันสำหรับการดำเนินการที่มีความเสี่ยง แต่ใน mimo run ไม่มีใครให้ถาม ดังนั้นมันจะปฏิเสธคำขอเข้าถึงนอกโปรเจกต์ด้วยตัวเอง สำหรับสภาพแวดล้อมชั่วคราวที่เชื่อถือได้จะมีแฟล็ก --dangerously-skip-permissions (หรือตัวแปรสภาพแวดล้อม MIMOCODE_DANGEROUSLY_SKIP_PERMISSIONS=1): ซึ่งจะอนุญาตทุกอย่างที่กฎไม่ห้ามไว้ แต่จะใช้ได้เฉพาะในคอนเทนเนอร์หรือ Sandbox เท่านั้น ในอินเทอร์เฟซจะมีโหมดที่คล้ายกันซึ่งเปิดใช้งานตลอดเซสชันด้วยคำสั่ง /skip-permissions

เอเจนต์ (Agents) โดยค่าเริ่มต้น build จะทำงานด้วยชุดเครื่องมือเต็มรูปแบบ plan จะมีหน้าที่เพียงอ่านและวิเคราะห์ ส่วน compose จะจัดการกระบวนการตั้งแต่สเปคไปจนถึงโค้ดที่ผ่านการทดสอบแล้ว คุณสามารถสลับใช้งานได้ด้วยปุ่ม Tab

บริบทที่ยาว (Long Context) ที่ขีดจำกัดของหน้าต่าง MiMo Code จะทำการรวบรวมบริบทใหม่จากจุดตรวจสอบ (checkpoint) ล่าสุด, หน่วยความจำของโปรเจกต์ และข้อความใหม่ โดยจะคำนวณเกณฑ์จาก limit.context คุณสามารถบีบอัดข้อมูลก่อนกำหนดได้ด้วยคำสั่ง /context-limit แยกตามแต่ละโมเดล

สิ่งที่ผูกกับบัญชี Xiaomi การป้อนข้อมูลด้วยเสียง (/voice) จะใช้โมเดลของแพลตฟอร์ม MiMo ในการแปลงเสียงเป็นข้อความและจะใช้งานได้หลังจากเข้าสู่ระบบแล้ว สำหรับโค้ด คำสั่ง และเอเจนต์ย่อยจะทำงานผ่านผู้ให้บริการที่เชื่อมต่อไว้ ซึ่งในการทดสอบของเราสามารถใช้งานได้โดยไม่ต้องเข้าสู่ระบบใดๆ

รูปภาพ โมเดลในเครือข่ายเป็นโมเดลข้อความ: ใน /modalities ให้เหลือไว้เพียงข้อความเท่านั้น ส่วนสำหรับภาพหน้าจอ ให้ตั้งค่าผู้ให้บริการรายที่สองที่ใช้โมเดลที่มีความสามารถด้านการมองเห็น (Vision)

MiMo Code และ OpenCode เป็นญาติกันแต่มีการตั้งค่าที่ต่างกัน ทั้งสองมีไดเรกทอรีและไฟล์เป็นของตัวเอง ดังนั้นการตั้งค่าของตัวหนึ่งจะไม่ถูกส่งต่อไปยังอีกตัว:

เวอร์ชัน โปรเจกต์มีการอัปเดตบ่อยครั้ง เพื่อให้ทำซ้ำได้ (reproducibility) โปรดล็อกเวอร์ชันไว้: npm install -g @mimo-ai/[email protected] หรือ curl -fsSL https://mimo.xiaomi.com/install | bash -s — --version 0.1.15

นอกจากนี้ยังมีเอเจนต์จากห้องปฏิบัติการโดยตรงสำหรับตระกูลโมเดลที่เครือข่ายให้บริการ: MiniMax Code ทำงานบนโมเดล MiniMax M2.7 ของผู้จำหน่ายเอง DeepSeek และ Z.ai (ผู้สร้าง GLM) ก็มีเอเจนต์ของตัวเองเช่นกัน ทั้งหมดสามารถเชื่อมต่อเข้ากับเกตเวย์เดียวด้วยคีย์เดียว