Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

ผู้ให้บริการ Volcengine ให้การเข้าถึงโมเดล Doubao และโมเดลของบุคคลที่สาม ที่โฮสต์อยู่บน Volcano Engine โดยมี endpoint แยกสำหรับงานทั่วไปและงานเขียนโค้ด Plugin แบบ bundled เดียวกันนี้ยังสามารถลงทะเบียน Volcengine Speech เป็นผู้ให้บริการ TTS ได้ด้วย
รายละเอียดค่า
ผู้ให้บริการvolcengine (ทั่วไป + TTS) + volcengine-plan (เขียนโค้ด)
Model authVOLCANO_ENGINE_API_KEY
TTS authVOLCENGINE_TTS_API_KEY หรือ BYTEPLUS_SEED_SPEECH_API_KEY
APIโมเดลแบบเข้ากันได้กับ OpenAI, BytePlus Seed Speech TTS

​
เริ่มต้นใช้งาน

1

ตั้งค่า API key

เรียกใช้ onboarding แบบโต้ตอบ:
openclaw onboard --auth-choice volcengine-api-key
การดำเนินการนี้จะลงทะเบียนทั้งผู้ให้บริการทั่วไป (volcengine) และผู้ให้บริการสำหรับงานเขียนโค้ด (volcengine-plan) จาก API key เดียว
2

ตั้งค่าโมเดลเริ่มต้น

{
  agents: {
    defaults: {
      model: { primary: "volcengine-plan/ark-code-latest" },
    },
  },
}
3

ตรวจสอบว่าโมเดลพร้อมใช้งาน

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
สำหรับการตั้งค่าแบบไม่โต้ตอบ (CI, สคริปต์) ให้ส่ง key โดยตรง:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

​
ผู้ให้บริการและ endpoint

ผู้ให้บริการEndpointกรณีใช้งาน
volcengineark.cn-beijing.volces.com/api/v3โมเดลทั่วไป
volcengine-planark.cn-beijing.volces.com/api/coding/v3โมเดลสำหรับเขียนโค้ด
ผู้ให้บริการทั้งสองตัวถูกตั้งค่าจาก API key เดียว การตั้งค่าจะลงทะเบียนทั้งสองโดยอัตโนมัติ

​
แค็ตตาล็อกในตัว

การอ้างอิงโมเดลชื่ออินพุตคอนเท็กซ์
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8text, image256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028text, image256,000
volcengine/kimi-k2-5-260127Kimi K2.5text, image256,000
volcengine/glm-4-7-251222GLM 4.7text, image200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2text, image128,000

​
การแปลงข้อความเป็นเสียง

Volcengine TTS ใช้ BytePlus Seed Speech HTTP API และมีการตั้งค่า แยกจาก API key ของโมเดล Doubao แบบเข้ากันได้กับ OpenAI ในคอนโซล BytePlus ให้เปิด Seed Speech > Settings > API Keys แล้วคัดลอก API key จากนั้นตั้งค่า: 
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,
        },
      },
    },
  },
}
สำหรับปลายทางแบบ voice-note นั้น OpenClaw จะขอ ogg_opus แบบเนทีฟของผู้ให้บริการจาก Volcengine สำหรับไฟล์แนบเสียงปกติ จะขอ mp3 แทน Provider alias bytedance และ doubao ก็ถูกแยกความละเอียดไปยังผู้ให้บริการเสียงเดียวกันเช่นกัน resource id เริ่มต้นคือ seed-tts-1.0 เพราะนี่คือสิ่งที่ BytePlus มอบให้ กับ API key ของ Seed Speech ที่สร้างใหม่ในโปรเจกต์เริ่มต้น หากโปรเจกต์ของคุณ มีสิทธิ์ใช้งาน TTS 2.0 ให้ตั้งค่า VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0
VOLCANO_ENGINE_API_KEY มีไว้สำหรับ endpoint โมเดล ModelArk/Doubao และไม่ใช่ API key ของ Seed Speech TTS ต้องใช้ API key ของ Seed Speech จาก BytePlus Speech Console หรือใช้คู่ AppID/token แบบเดิมจาก Speech Console
การยืนยันตัวตนแบบ AppID/token เดิมยังคงรองรับสำหรับแอปพลิเคชัน Speech Console รุ่นเก่า: 
export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"

​
การตั้งค่าขั้นสูง

openclaw onboard --auth-choice volcengine-api-key ปัจจุบันตั้งค่า volcengine-plan/ark-code-latest เป็นโมเดลเริ่มต้น พร้อมกับลงทะเบียน แค็ตตาล็อก volcengine ทั่วไปด้วย
ระหว่าง onboarding/การกำหนดค่าการเลือกโมเดล ตัวเลือก auth ของ Volcengine จะให้ความสำคัญกับ แถว volcengine/* และ volcengine-plan/* ทั้งคู่ หากโมเดลเหล่านั้น ยังไม่ถูกโหลด OpenClaw จะ fallback ไปยังแค็ตตาล็อกที่ไม่กรอง แทนที่จะแสดง ตัวเลือกที่จำกัดขอบเขตเฉพาะผู้ให้บริการซึ่งว่างเปล่า
หาก Gateway ทำงานเป็น daemon (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)
เมื่อรัน OpenClaw เป็นบริการเบื้องหลัง ตัวแปรสภาพแวดล้อมที่ตั้งไว้ใน interactive shell ของคุณจะไม่ถูกสืบทอดโดยอัตโนมัติ โปรดดูหมายเหตุเรื่อง daemon ด้านบน

​
ที่เกี่ยวข้อง

การเลือกโมเดล

การเลือกผู้ให้บริการ การอ้างอิงโมเดล และพฤติกรรม failover

การกำหนดค่า

เอกสารอ้างอิง config แบบเต็มสำหรับ agents, models และ providers

การแก้ไขปัญหา

ปัญหาที่พบบ่อยและขั้นตอนการดีบัก

คำถามที่พบบ่อย

คำถามที่พบบ่อยเกี่ยวกับการตั้งค่า OpenClaw