Providers
GitHub Copilot
GitHub Copilot คือผู้ช่วยเขียนโค้ดด้วย AI ของ GitHub ซึ่งให้สิทธิ์เข้าถึงโมเดล Copilot สำหรับบัญชีและแผน GitHub ของคุณ OpenClaw สามารถใช้ Copilot เป็นผู้ให้บริการโมเดล หรือรันไทม์ของเอเจนต์ได้สามวิธี
สามวิธีในการใช้ Copilot ใน OpenClaw
ผู้ให้บริการในตัว (github-copilot)
ใช้ขั้นตอนการเข้าสู่ระบบผ่านอุปกรณ์แบบเนทีฟเพื่อรับโทเค็น GitHub จากนั้นแลกเป็น โทเค็น Copilot API เมื่อ OpenClaw ทำงาน วิธีนี้เป็นเส้นทางค่าเริ่มต้นและง่ายที่สุด เนื่องจากไม่ต้องใช้ VS Code
เรียกใช้คำสั่งเข้าสู่ระบบ
openclaw models auth login-github-copilotระบบจะแจ้งให้คุณไปยัง URL และป้อนรหัสแบบใช้ครั้งเดียว เปิด เทอร์มินัลค้างไว้จนกว่ากระบวนการจะเสร็จสมบูรณ์
ตั้งค่าโมเดลเริ่มต้น
openclaw models set github-copilot/claude-opus-4.7หรือกำหนดในการตั้งค่า:
{ agents: { defaults: { model: { primary: "github-copilot/claude-opus-4.7" } }, },}Plugin ชุดควบคุม Copilot SDK (copilot)
ติดตั้ง Plugin ภายนอก @openclaw/copilot เมื่อต้องการให้
Copilot CLI และ SDK ของ GitHub จัดการลูปเอเจนต์ระดับล่างสำหรับโมเดล
github-copilot/* ที่เลือก
openclaw plugins install @openclaw/copilotจากนั้นเลือกให้โมเดลหรือผู้ให้บริการใช้รันไทม์ดังกล่าว:
{ agents: { defaults: { model: "github-copilot/gpt-5.5", models: { "github-copilot/gpt-5.5": { agentRuntime: { id: "copilot" }, }, }, }, },}เลือกวิธีนี้เมื่อต้องการเซสชัน Copilot CLI แบบเนทีฟ สถานะเธรดที่จัดการโดย SDK
และ Compaction ที่ Copilot จัดการสำหรับรอบการทำงานของเอเจนต์เหล่านั้น หากไม่ได้
เลือกใช้ agentRuntime อย่างชัดเจน โมเดล github-copilot/* จะยังคงใช้
ผู้ให้บริการในตัว ดูสัญญารันไทม์ฉบับเต็มได้ที่ ชุดควบคุม Copilot SDK
Plugin Copilot Proxy (copilot-proxy)
ใช้ส่วนขยาย Copilot Proxy ของ VS Code เป็นบริดจ์ภายในเครื่อง OpenClaw จะสื่อสารกับ
ปลายทาง /v1 ของพร็อกซี (ค่าเริ่มต้นคือ http://localhost:3000/v1) และใช้
รายการโมเดลที่คุณกำหนดค่า
Plugin copilot-proxy มาพร้อมกับ OpenClaw และเปิดใช้งานเป็นค่าเริ่มต้น
กำหนด URL ฐานและรหัสโมเดลด้วย:
openclaw models auth login --provider copilot-proxy --set-defaultGitHub Enterprise (ถิ่นที่อยู่ของข้อมูล)
หากองค์กรของคุณใช้ผู้เช่า GitHub Enterprise แบบกำหนดถิ่นที่อยู่ของข้อมูล (โฮสต์
*.ghe.com เช่น your-org.ghe.com) Copilot จะอยู่บนปลายทางภายในผู้เช่า
แทน github.com สาธารณะ OpenClaw เปิดเผยตัวเลือกนี้เป็น
ตัวเลือกการยืนยันตัวตนโดยตรง คุณจึงไม่ต้องแก้ไข URL ด้วยตนเอง
เลือกตัวเลือกการยืนยันตัวตน Enterprise
ในขั้นตอนเริ่มต้นใช้งานหรือ openclaw models auth ให้เลือก
GitHub Copilot (Enterprise / data residency) ระบบจะแจ้งให้คุณป้อน
โดเมน Enterprise (เช่น your-org.ghe.com) จากนั้นกระบวนการเข้าสู่ระบบ
ผ่านอุปกรณ์จะทำงานกับผู้เช่านั้น
ป้อนเฉพาะรากของผู้เช่า (your-org.ghe.com) ระบบไม่ยอมรับโฮสต์บริการที่อนุมานมา
เช่น api.your-org.ghe.com หรือ copilot-api.your-org.ghe.com
OpenClaw จะอนุมานปลายทางเหล่านั้นจากรากของผู้เช่าโดยอัตโนมัติ
openclaw models auth login --provider github-copilot --method device-enterpriseบันทึกโดเมนไว้ในการตั้งค่า
โฮสต์ที่เลือกจะถูกจัดเก็บไว้ภายใต้พารามิเตอร์ของผู้ให้บริการ เพื่อให้การรีเฟรชโทเค็น และการเติมข้อความในภายหลังมุ่งไปยังผู้เช่านั้นโดยอัตโนมัติ:
{ models: { providers: { "github-copilot": { params: { githubDomain: "your-org.ghe.com" } }, }, },}กระบวนการผ่านอุปกรณ์ การแลกโทเค็น และการเติมข้อความจะชี้ไปยัง
https://your-org.ghe.com/login/device/code,
https://api.your-org.ghe.com/copilot_internal/v2/token และ
https://copilot-api.your-org.ghe.com ตามลำดับ โทเค็นแบบกำหนดถิ่นที่อยู่ของข้อมูลจะมี
ตราประทับผู้เช่าและไม่มีคำใบ้พร็อกซี ดังนั้น URL ฐานสำหรับการเติมข้อความจะย้อนกลับไปใช้
โฮสต์ Copilot ของผู้เช่าแทนปลายทางสาธารณะ
แฟล็กเสริม
| คำสั่ง | แฟล็ก | คำอธิบาย |
|---|---|---|
openclaw models auth login-github-copilot |
--yes |
เขียนทับโปรไฟล์การยืนยันตัวตนที่มีอยู่โดยไม่แสดงข้อความถามยืนยัน |
openclaw models auth login --provider github-copilot --method device |
--set-default |
ใช้โมเดลเริ่มต้นที่ผู้ให้บริการแนะนำด้วย |
# ข้ามการยืนยันการเข้าสู่ระบบใหม่openclaw models auth login-github-copilot --yes # เข้าสู่ระบบและตั้งค่าโมเดลเริ่มต้นในขั้นตอนเดียวopenclaw models auth login --provider github-copilot --method device --set-defaultการเริ่มต้นใช้งานแบบไม่โต้ตอบ
กระบวนการเข้าสู่ระบบผ่านอุปกรณ์ต้องใช้ TTY แบบโต้ตอบ สำหรับการตั้งค่าแบบไม่มีส่วนติดต่อ
ให้นำเข้าโทเค็นการเข้าถึง GitHub OAuth ที่มีอยู่ด้วย openclaw onboard --non-interactive:
openclaw onboard --non-interactive --accept-risk \ --auth-choice github-copilot \ --github-copilot-token "$COPILOT_GITHUB_TOKEN" \ --skip-channels --skip-healthคุณสามารถละ --auth-choice ได้เช่นกัน การส่ง --github-copilot-token จะอนุมาน
ตัวเลือกการยืนยันตัวตนของผู้ให้บริการ GitHub Copilot หากละแฟล็กนี้ ขั้นตอนเริ่มต้นใช้งานจะ
ย้อนกลับไปใช้ COPILOT_GITHUB_TOKEN, GH_TOKEN และ GITHUB_TOKEN ตามลำดับ ใช้
--secret-input-mode ref โดยตั้งค่า COPILOT_GITHUB_TOKEN เพื่อจัดเก็บ tokenRef
ที่อ้างอิงตัวแปรสภาพแวดล้อมแทนข้อความธรรมดาใน auth-profiles.json
ต้องใช้ TTY แบบโต้ตอบ
กระบวนการเข้าสู่ระบบผ่านอุปกรณ์ต้องใช้ TTY แบบโต้ตอบ ให้เรียกใช้โดยตรงใน เทอร์มินัล ไม่ใช่ในสคริปต์แบบไม่โต้ตอบหรือไปป์ไลน์ CI
ความพร้อมใช้งานของโมเดลขึ้นอยู่กับแผนของคุณ
ความพร้อมใช้งานของโมเดล Copilot ขึ้นอยู่กับแผน GitHub ของคุณ หากโมเดล
ถูกปฏิเสธ ให้ลองใช้รหัสอื่น (เช่น github-copilot/gpt-5.5) ดู
โมเดลที่รองรับในแต่ละแผน Copilot
ของ GitHub สำหรับรายการโมเดลปัจจุบัน
รีเฟรชแค็ตตาล็อกแบบสดจาก Copilot API
เมื่อเส้นทางการยืนยันตัวตนผ่านอุปกรณ์ (หรือตัวแปรสภาพแวดล้อม) แก้ไขโทเค็น GitHub ได้แล้ว
OpenClaw จะรีเฟรชแค็ตตาล็อกโมเดลตามต้องการจาก ${baseUrl}/models
(ปลายทางเดียวกับที่ VS Code Copilot ใช้) เพื่อให้รันไทม์ติดตาม
สิทธิ์ของแต่ละบัญชีและขนาดหน้าต่างบริบทที่ถูกต้องโดยไม่ต้องปรับเปลี่ยน
แมนิเฟสต์ โมเดล Copilot ที่เผยแพร่ใหม่จะปรากฏโดยไม่ต้องอัปเกรด OpenClaw
และหน้าต่างบริบทจะแสดงขีดจำกัดจริงของแต่ละโมเดล
(เช่น 400k สำหรับชุด gpt-5.x และ 1M สำหรับตัวแปรภายใน
claude-opus-*-1m)
แค็ตตาล็อกแบบคงที่ที่รวมมาให้จะยังคงเป็นทางเลือกสำรองที่มองเห็นได้ เมื่อปิดใช้การค้นหา
ผู้ใช้ไม่มีโปรไฟล์การยืนยันตัวตน GitHub การแลกโทเค็นล้มเหลว
หรือการเรียก HTTPS ไปยัง /models เกิดข้อผิดพลาด หากต้องการยกเลิกการใช้ฟังก์ชันนี้
และพึ่งพาแค็ตตาล็อกแมนิเฟสต์แบบคงที่ทั้งหมด (กรณีออฟไลน์/แยกขาดจากเครือข่าย):
{ plugins: { entries: { "github-copilot": { config: { discovery: { enabled: false } }, }, }, },}การเลือกการขนส่ง
รหัสโมเดล Claude จะใช้การขนส่ง Anthropic Messages โดยอัตโนมัติ โมเดล Gemini ใช้การขนส่ง OpenAI Chat Completions ส่วนโมเดล GPT และชุด o จะยังคงใช้การขนส่ง OpenAI Responses OpenClaw เลือก การขนส่งที่ถูกต้องตามการอ้างอิงโมเดล
ความเข้ากันได้ของคำขอ
OpenClaw ส่งส่วนหัวคำขอแบบ Copilot IDE ผ่านการขนส่งของ Copilot
(เวอร์ชันตัวแก้ไข/Plugin ของ VS Code และรหัสการผสานรวม vscode-chat)
ทำเครื่องหมายรอบการติดตามผลลัพธ์ของเครื่องมือว่าเริ่มต้นโดยเอเจนต์ และตั้งค่าส่วนหัว
ด้านภาพของ Copilot เมื่อรอบการทำงานมีข้อมูลเข้าประเภทรูปภาพ
ลำดับการแก้ไขตัวแปรสภาพแวดล้อม
OpenClaw แก้ไขข้อมูลยืนยันตัวตน Copilot จากตัวแปรสภาพแวดล้อมตาม ลำดับความสำคัญต่อไปนี้:
| ลำดับความสำคัญ | ตัวแปร | หมายเหตุ |
|---|---|---|
| 1 | COPILOT_GITHUB_TOKEN |
ความสำคัญสูงสุด ใช้เฉพาะกับ Copilot |
| 2 | GH_TOKEN |
โทเค็น GitHub CLI (ทางเลือกสำรอง) |
| 3 | GITHUB_TOKEN |
โทเค็น GitHub มาตรฐาน (ความสำคัญต่ำที่สุด) |
เมื่อตั้งค่าหลายตัวแปร OpenClaw จะใช้ตัวแปรที่มีความสำคัญสูงสุด
กระบวนการเข้าสู่ระบบผ่านอุปกรณ์ (openclaw models auth login-github-copilot) จะจัดเก็บ
โทเค็นไว้ในที่จัดเก็บโปรไฟล์การยืนยันตัวตน และมีลำดับความสำคัญเหนือกว่าตัวแปรสภาพแวดล้อม
ทั้งหมด
การจัดเก็บโทเค็น
การเข้าสู่ระบบจะจัดเก็บโทเค็น GitHub ไว้ในที่จัดเก็บโปรไฟล์การยืนยันตัวตน (รหัสโปรไฟล์
github-copilot:github) และแลกเป็นโทเค็น Copilot API อายุสั้น
เมื่อ OpenClaw ทำงาน คุณไม่จำเป็นต้องจัดการโทเค็นด้วยตนเอง
เอ็มเบดดิงสำหรับการค้นหาหน่วยความจำ
GitHub Copilot สามารถทำหน้าที่เป็นผู้ให้บริการเอ็มเบดดิงสำหรับ การค้นหาหน่วยความจำ ได้เช่นกัน หากคุณสมัครใช้ Copilot และ เข้าสู่ระบบแล้ว OpenClaw สามารถใช้บริการนี้สำหรับเอ็มเบดดิงได้โดยไม่ต้องมีคีย์ API แยกต่างหาก
การตั้งค่า
ตั้งค่า memorySearch.provider เป็น GitHub Copilot อย่างชัดเจนเพื่อใช้เอ็มเบดดิงของ GitHub Copilot หากมี
โทเค็น GitHub อยู่ OpenClaw จะค้นหาโมเดลเอ็มเบดดิงที่พร้อมใช้งานจาก
Copilot API และเลือกโมเดลที่ดีที่สุดโดยอัตโนมัติ
{ agents: { defaults: { memorySearch: { provider: "github-copilot", // ไม่บังคับ: เขียนทับโมเดลที่ค้นพบโดยอัตโนมัติ model: "text-embedding-3-small", }, }, },}วิธีการทำงาน
- OpenClaw แก้ไขโทเค็น GitHub ของคุณ (จากตัวแปรสภาพแวดล้อมหรือโปรไฟล์การยืนยันตัวตน)
- แลกโทเค็นดังกล่าวเป็นโทเค็น Copilot API อายุสั้น
- สอบถามปลายทาง
/modelsของ Copilot เพื่อค้นหาโมเดลเอ็มเบดดิงที่พร้อมใช้งาน - เลือกโมเดลที่ดีที่สุด (ลำดับความต้องการ:
text-embedding-3-small,text-embedding-3-large,text-embedding-ada-002) - ส่งคำขอเอ็มเบดดิงไปยังปลายทาง
/embeddingsของ Copilot
ความพร้อมใช้งานของโมเดลขึ้นอยู่กับแผน GitHub ของคุณ หากไม่มีโมเดลเอ็มเบดดิง ที่พร้อมใช้งาน OpenClaw จะข้าม Copilot และลองใช้ผู้ให้บริการรายถัดไป