---
read_when:
    - คุณต้องการใช้ Volcano Engine หรือโมเดล Doubao กับ OpenClaw
    - คุณต้องมีการตั้งค่า API key ของ Volcengine
    - คุณต้องการใช้การแปลงข้อความเป็นเสียงของ Volcengine Speech
summary: การตั้งค่า Volcano Engine (โมเดล Doubao, endpoint สำหรับเขียนโค้ด และ Seed Speech TTS)
title: Volcengine (Doubao)
x-i18n:
    generated_at: "2026-04-26T11:40:32Z"
    model: gpt-5.4
    provider: openai
    source_hash: b7948a26cc898e125d445e9ae091704f5cf442266d29e712c0dcedbe0dc0cce7
    source_path: providers/volcengine.md
    workflow: 15
---

ผู้ให้บริการ Volcengine ให้การเข้าถึงโมเดล Doubao และโมเดลของบุคคลที่สาม
ที่โฮสต์อยู่บน Volcano Engine โดยมี endpoint แยกสำหรับงานทั่วไปและงานเขียนโค้ด
Plugin แบบ bundled เดียวกันนี้ยังสามารถลงทะเบียน Volcengine Speech เป็นผู้ให้บริการ TTS
ได้ด้วย

| รายละเอียด     | ค่า                                                      |
| ---------- | ---------------------------------------------------------- |
| ผู้ให้บริการ  | `volcengine` (ทั่วไป + TTS) + `volcengine-plan` (เขียนโค้ด)  |
| Model auth | `VOLCANO_ENGINE_API_KEY`                                   |
| TTS auth   | `VOLCENGINE_TTS_API_KEY` หรือ `BYTEPLUS_SEED_SPEECH_API_KEY` |
| API        | โมเดลแบบเข้ากันได้กับ OpenAI, BytePlus Seed Speech TTS         |

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

<Steps>
  <Step title="ตั้งค่า API key">
    เรียกใช้ onboarding แบบโต้ตอบ:

    ```bash
    openclaw onboard --auth-choice volcengine-api-key
    ```

    การดำเนินการนี้จะลงทะเบียนทั้งผู้ให้บริการทั่วไป (`volcengine`) และผู้ให้บริการสำหรับงานเขียนโค้ด (`volcengine-plan`) จาก API key เดียว

  </Step>
  <Step title="ตั้งค่าโมเดลเริ่มต้น">
    ```json5
    {
      agents: {
        defaults: {
          model: { primary: "volcengine-plan/ark-code-latest" },
        },
      },
    }
    ```
  </Step>
  <Step title="ตรวจสอบว่าโมเดลพร้อมใช้งาน">
    ```bash
    openclaw models list --provider volcengine
    openclaw models list --provider volcengine-plan
    ```
  </Step>
</Steps>

<Tip>
สำหรับการตั้งค่าแบบไม่โต้ตอบ (CI, สคริปต์) ให้ส่ง key โดยตรง:

```bash
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"
```

</Tip>

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

| ผู้ให้บริการ          | Endpoint                                  | กรณีใช้งาน       |
| ----------------- | ----------------------------------------- | -------------- |
| `volcengine`      | `ark.cn-beijing.volces.com/api/v3`        | โมเดลทั่วไป |
| `volcengine-plan` | `ark.cn-beijing.volces.com/api/coding/v3` | โมเดลสำหรับเขียนโค้ด  |

<Note>
ผู้ให้บริการทั้งสองตัวถูกตั้งค่าจาก API key เดียว การตั้งค่าจะลงทะเบียนทั้งสองโดยอัตโนมัติ
</Note>

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

<Tabs>
  <Tab title="ทั่วไป (volcengine)">
    | การอ้างอิงโมเดล                                    | ชื่อ                            | อินพุต       | คอนเท็กซ์ |
    | -------------------------------------------- | ------------------------------- | ----------- | ------- |
    | `volcengine/doubao-seed-1-8-251228`          | Doubao Seed 1.8                 | text, image | 256,000 |
    | `volcengine/doubao-seed-code-preview-251028` | doubao-seed-code-preview-251028 | text, image | 256,000 |
    | `volcengine/kimi-k2-5-260127`                | Kimi K2.5                       | text, image | 256,000 |
    | `volcengine/glm-4-7-251222`                  | GLM 4.7                         | text, image | 200,000 |
    | `volcengine/deepseek-v3-2-251201`            | DeepSeek V3.2                   | text, image | 128,000 |
  </Tab>
  <Tab title="สำหรับเขียนโค้ด (volcengine-plan)">
    | การอ้างอิงโมเดล                                         | ชื่อ                     | อินพุต | คอนเท็กซ์ |
    | ------------------------------------------------- | ------------------------ | ----- | ------- |
    | `volcengine-plan/ark-code-latest`                 | Ark Coding Plan          | text  | 256,000 |
    | `volcengine-plan/doubao-seed-code`                | Doubao Seed Code         | text  | 256,000 |
    | `volcengine-plan/glm-4.7`                         | GLM 4.7 Coding           | text  | 200,000 |
    | `volcengine-plan/kimi-k2-thinking`                | Kimi K2 Thinking         | text  | 256,000 |
    | `volcengine-plan/kimi-k2.5`                       | Kimi K2.5 Coding         | text  | 256,000 |
    | `volcengine-plan/doubao-seed-code-preview-251028` | Doubao Seed Code Preview | text  | 256,000 |
  </Tab>
</Tabs>

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

Volcengine TTS ใช้ BytePlus Seed Speech HTTP API และมีการตั้งค่า
แยกจาก API key ของโมเดล Doubao แบบเข้ากันได้กับ OpenAI ในคอนโซล BytePlus
ให้เปิด Seed Speech > Settings > API Keys แล้วคัดลอก API key จากนั้นตั้งค่า:

```bash
export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"
export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"
```

จากนั้นเปิดใช้งานใน `openclaw.json`:

```json5
{
  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`

<Warning>
`VOLCANO_ENGINE_API_KEY` มีไว้สำหรับ endpoint โมเดล ModelArk/Doubao และไม่ใช่
API key ของ Seed Speech TTS ต้องใช้ API key ของ Seed Speech จาก BytePlus Speech
Console หรือใช้คู่ AppID/token แบบเดิมจาก Speech Console
</Warning>

การยืนยันตัวตนแบบ AppID/token เดิมยังคงรองรับสำหรับแอปพลิเคชัน Speech Console รุ่นเก่า:

```bash
export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"
```

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

<AccordionGroup>
  <Accordion title="โมเดลเริ่มต้นหลัง onboarding">
    `openclaw onboard --auth-choice volcengine-api-key` ปัจจุบันตั้งค่า
    `volcengine-plan/ark-code-latest` เป็นโมเดลเริ่มต้น พร้อมกับลงทะเบียน
    แค็ตตาล็อก `volcengine` ทั่วไปด้วย
  </Accordion>

  <Accordion title="พฤติกรรม fallback ของตัวเลือกโมเดล">
    ระหว่าง onboarding/การกำหนดค่าการเลือกโมเดล ตัวเลือก auth ของ Volcengine จะให้ความสำคัญกับ
    แถว `volcengine/*` และ `volcengine-plan/*` ทั้งคู่ หากโมเดลเหล่านั้น
    ยังไม่ถูกโหลด OpenClaw จะ fallback ไปยังแค็ตตาล็อกที่ไม่กรอง แทนที่จะแสดง
    ตัวเลือกที่จำกัดขอบเขตเฉพาะผู้ให้บริการซึ่งว่างเปล่า
  </Accordion>

  <Accordion title="ตัวแปรสภาพแวดล้อมสำหรับโปรเซส daemon">
    หาก 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`)
  </Accordion>
</AccordionGroup>

<Warning>
เมื่อรัน OpenClaw เป็นบริการเบื้องหลัง ตัวแปรสภาพแวดล้อมที่ตั้งไว้ใน
interactive shell ของคุณจะไม่ถูกสืบทอดโดยอัตโนมัติ โปรดดูหมายเหตุเรื่อง daemon ด้านบน
</Warning>

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

<CardGroup cols={2}>
  <Card title="การเลือกโมเดล" href="/th/concepts/model-providers" icon="layers">
    การเลือกผู้ให้บริการ การอ้างอิงโมเดล และพฤติกรรม failover
  </Card>
  <Card title="การกำหนดค่า" href="/th/gateway/configuration" icon="gear">
    เอกสารอ้างอิง config แบบเต็มสำหรับ agents, models และ providers
  </Card>
  <Card title="การแก้ไขปัญหา" href="/th/help/troubleshooting" icon="wrench">
    ปัญหาที่พบบ่อยและขั้นตอนการดีบัก
  </Card>
  <Card title="คำถามที่พบบ่อย" href="/th/help/faq" icon="circle-question">
    คำถามที่พบบ่อยเกี่ยวกับการตั้งค่า OpenClaw
  </Card>
</CardGroup>