Providers
Volcengine (Doubao)
ผู้ให้บริการ Volcengine ช่วยให้เข้าถึงโมเดล Doubao และโมเดลจากบุคคลที่สามซึ่งโฮสต์บน Volcano Engine โดยมีปลายทางแยกกันสำหรับเวิร์กโหลดทั่วไปและเวิร์กโหลดการเขียนโค้ด Plugin ที่รวมมาให้เดียวกันนี้ยังลงทะเบียน Volcengine Speech เป็นผู้ให้บริการ TTS ด้วย
| รายละเอียด | ค่า |
|---|---|
| ผู้ให้บริการ | volcengine (ทั่วไป + TTS), volcengine-plan (การเขียนโค้ด) |
| การยืนยันตัวตนโมเดล | VOLCANO_ENGINE_API_KEY |
| การยืนยันตัวตน TTS | VOLCENGINE_TTS_API_KEY หรือ BYTEPLUS_SEED_SPEECH_API_KEY |
| API | โมเดลที่เข้ากันได้กับ OpenAI, BytePlus Seed Speech TTS |
เริ่มต้นใช้งาน
ตั้งค่าคีย์ API
เรียกใช้การเริ่มต้นใช้งานแบบโต้ตอบ:
openclaw onboard --auth-choice volcengine-api-keyการดำเนินการนี้จะลงทะเบียนทั้งผู้ให้บริการทั่วไป (volcengine) และผู้ให้บริการสำหรับการเขียนโค้ด (volcengine-plan) จากคีย์ API เดียว
ตั้งค่าโมเดลเริ่มต้น
{ agents: { defaults: { model: { primary: "volcengine-plan/ark-code-latest" }, }, },}ตรวจสอบว่าโมเดลพร้อมใช้งาน
openclaw models list --provider volcengineopenclaw models list --provider volcengine-planผู้ให้บริการและปลายทาง
| ผู้ให้บริการ | ปลายทาง | กรณีใช้งาน |
|---|---|---|
volcengine |
ark.cn-beijing.volces.com/api/v3 |
โมเดลทั่วไป |
volcengine-plan |
ark.cn-beijing.volces.com/api/coding/v3 |
โมเดลเขียนโค้ด |
แค็ตตาล็อกในตัว
ทั่วไป (volcengine)
| การอ้างอิงโมเดล | ชื่อ | อินพุต | บริบท |
|---|---|---|---|
volcengine/deepseek-v3-2-251201 |
DeepSeek V3.2 | ข้อความ, ภาพ | 128,000 |
volcengine/doubao-seed-1-8-251228 |
Doubao Seed 1.8 | ข้อความ, ภาพ | 256,000 |
volcengine/doubao-seed-code-preview-251028 |
doubao-seed-code-preview-251028 | ข้อความ, ภาพ | 256,000 |
volcengine/glm-4-7-251222 |
GLM 4.7 | ข้อความ, ภาพ | 200,000 |
volcengine/kimi-k2-5-260127 |
Kimi K2.5 | ข้อความ, ภาพ | 256,000 |
การเขียนโค้ด (volcengine-plan)
| การอ้างอิงโมเดล | ชื่อ | อินพุต | บริบท |
|---|---|---|---|
volcengine-plan/ark-code-latest |
Ark Coding Plan | ข้อความ | 256,000 |
volcengine-plan/doubao-seed-code |
Doubao Seed Code | ข้อความ | 256,000 |
volcengine-plan/doubao-seed-code-preview-251028 |
Doubao Seed Code Preview | ข้อความ | 256,000 |
volcengine-plan/glm-4.7 |
GLM 4.7 Coding | ข้อความ | 200,000 |
volcengine-plan/kimi-k2-thinking |
Kimi K2 Thinking | ข้อความ | 256,000 |
volcengine-plan/kimi-k2.5 |
Kimi K2.5 Coding | ข้อความ | 256,000 |
แค็ตตาล็อกทั้งสองเป็นแบบคงที่ (ไม่มีการเรียกค้นหา /models) และรองรับการบันทึกปริมาณการใช้งานแบบสตรีมที่เข้ากันได้กับ OpenAI สคีมาของเครื่องมือสำหรับผู้ให้บริการทั้งสองจะตัดคีย์เวิร์ด minLength, maxLength, minItems, maxItems, minContains และ maxContains ออกโดยอัตโนมัติ เนื่องจาก API การเรียกใช้เครื่องมือของ Volcengine ปฏิเสธคีย์เวิร์ดเหล่านี้
การแปลงข้อความเป็นเสียงพูด
Volcengine TTS ใช้ BytePlus Seed Speech HTTP API (voice.ap-southeast-1.bytepluses.com) และกำหนดค่าแยกจากคีย์ API ของโมเดล Doubao ที่เข้ากันได้กับ OpenAI ในคอนโซล BytePlus ให้เปิด Seed Speech > Settings > API Keys คัดลอกคีย์ API แล้วตั้งค่า:
export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"จากนั้นเปิดใช้งานใน openclaw.json:
{ messages: { tts: { auto: "always", provider: "volcengine", providers: { volcengine: { apiKey: "byteplus_seed_speech_api_key", voice: "en_female_anna_mars_bigtts", speedRatio: 1.0, }, }, }, },}ฟิลด์ที่ใช้ได้ภายใต้ messages.tts.providers.volcengine ได้แก่ apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey และ baseUrl นอกจากนี้ !emotion=<value> ยังใช้เป็นคำสั่งกำกับเสียงแบบอินไลน์ได้เมื่ออนุญาตให้เขียนทับการตั้งค่าเสียง
สำหรับปลายทางข้อความเสียง OpenClaw จะร้องขอ ogg_opus แบบเนทีฟของผู้ให้บริการ สำหรับไฟล์แนบเสียงทั่วไป จะร้องขอ mp3 ชื่อแทนผู้ให้บริการ bytedance และ doubao จะถูกจับคู่กับผู้ให้บริการเสียงพูดนี้เช่นกัน
รหัสทรัพยากรเริ่มต้นคือ seed-tts-1.0 ซึ่งเป็นสิทธิ์ที่ BytePlus มอบให้คีย์ Seed Speech API ที่สร้างใหม่โดยค่าเริ่มต้น หากโปรเจกต์ของคุณมีสิทธิ์ TTS 2.0 ให้ตั้งค่า VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0
การยืนยันตัวตนด้วย AppID/โทเค็นแบบเดิมยังคงรองรับสำหรับแอปพลิเคชัน Speech Console รุ่นเก่า:
export VOLCENGINE_TTS_APPID="speech_app_id"export VOLCENGINE_TTS_TOKEN="speech_access_token"export VOLCENGINE_TTS_CLUSTER="volcano_tts"ตัวแปรสภาพแวดล้อม TTS ทางเลือกอื่น ได้แก่ VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY และ VOLCENGINE_TTS_BASE_URL ซึ่งจะเขียนทับฟิลด์การกำหนดค่า messages.tts.providers.volcengine ที่ตรงกันเมื่อตั้งค่าไว้
การกำหนดค่าขั้นสูง
โมเดลเริ่มต้นหลังการเริ่มต้นใช้งาน
openclaw onboard --auth-choice volcengine-api-key จะตั้ง volcengine-plan/ark-code-latest เป็นโมเดลเริ่มต้น พร้อมกับลงทะเบียนแค็ตตาล็อกทั่วไป volcengine
พฤติกรรมสำรองของตัวเลือกโมเดล
ระหว่างการเลือกโมเดลในการเริ่มต้นใช้งานหรือกำหนดค่า ตัวเลือกการยืนยันตัวตน Volcengine จะให้ความสำคัญกับแถวทั้ง volcengine/* และ volcengine-plan/* หากโมเดลเหล่านั้นยังไม่ได้โหลด OpenClaw จะใช้แค็ตตาล็อกที่ไม่ได้กรองเป็นทางเลือกแทนการแสดงตัวเลือกที่จำกัดขอบเขตเฉพาะผู้ให้บริการซึ่งว่างเปล่า
ตัวแปรสภาพแวดล้อมสำหรับกระบวนการดีมอน
หาก Gateway ทำงานเป็นดีมอน (launchd/systemd) โปรดตรวจสอบว่าตัวแปรสภาพแวดล้อมของโมเดลและ TTS เช่น VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID และ VOLCENGINE_TTS_TOKEN พร้อมใช้งานสำหรับกระบวนการนั้น (ตัวอย่างเช่น ใน ~/.openclaw/.env หรือผ่าน env.shellEnv)
