Providers

Volcengine (Doubao)

Nhà cung cấp Volcengine cho phép truy cập các mô hình Doubao và mô hình bên thứ ba được lưu trữ trên Volcano Engine, với các điểm cuối riêng cho khối lượng công việc chung và lập trình. Cùng một Plugin tích hợp cũng có thể đăng ký Volcengine Speech làm nhà cung cấp TTS.

Chi tiết Giá trị
Nhà cung cấp volcengine (chung + TTS) + volcengine-plan (lập trình)
Xác thực mô hình VOLCANO_ENGINE_API_KEY
Xác thực TTS VOLCENGINE_TTS_API_KEY hoặc BYTEPLUS_SEED_SPEECH_API_KEY
API Mô hình tương thích OpenAI, BytePlus Seed Speech TTS

Bắt đầu

  • Set the API key

    Chạy onboarding tương tác:

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

    Lệnh này đăng ký cả nhà cung cấp chung (volcengine) và lập trình (volcengine-plan) từ một API key duy nhất.

  • Set a default model

    {
      agents: {
        defaults: {
          model: { primary: "volcengine-plan/ark-code-latest" },
        },
      },
    }
    
  • Verify the model is available

    openclaw models list --provider volcengine
    openclaw models list --provider volcengine-plan
    
  • Nhà cung cấp và điểm cuối

    Nhà cung cấp Điểm cuối Trường hợp sử dụng
    volcengine ark.cn-beijing.volces.com/api/v3 Mô hình chung
    volcengine-plan ark.cn-beijing.volces.com/api/coding/v3 Mô hình lập trình

    Catalog tích hợp sẵn

    General (volcengine)

    Tham chiếu mô hình Tên Đầu vào Ngữ cảnh
    volcengine/doubao-seed-1-8-251228 Doubao Seed 1.8 văn bản, hình ảnh 256,000
    volcengine/doubao-seed-code-preview-251028 doubao-seed-code-preview-251028 văn bản, hình ảnh 256,000
    volcengine/kimi-k2-5-260127 Kimi K2.5 văn bản, hình ảnh 256,000
    volcengine/glm-4-7-251222 GLM 4.7 văn bản, hình ảnh 200,000
    volcengine/deepseek-v3-2-251201 DeepSeek V3.2 văn bản, hình ảnh 128,000

    Coding (volcengine-plan)

    Tham chiếu mô hình Tên Đầu vào Ngữ cảnh
    volcengine-plan/ark-code-latest Ark Coding Plan văn bản 256,000
    volcengine-plan/doubao-seed-code Doubao Seed Code văn bản 256,000
    volcengine-plan/glm-4.7 GLM 4.7 Coding văn bản 200,000
    volcengine-plan/kimi-k2-thinking Kimi K2 Thinking văn bản 256,000
    volcengine-plan/kimi-k2.5 Kimi K2.5 Coding văn bản 256,000
    volcengine-plan/doubao-seed-code-preview-251028 Doubao Seed Code Preview văn bản 256,000

    Chuyển văn bản thành giọng nói

    Volcengine TTS sử dụng BytePlus Seed Speech HTTP API và được cấu hình riêng với API key của API mô hình Doubao tương thích OpenAI. Trong console BytePlus, mở Seed Speech > Settings > API Keys và sao chép API key, rồi thiết lập:

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

    Sau đó bật trong 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,
            },
          },
        },
      },
    }
    

    Đối với mục tiêu ghi chú thoại, OpenClaw yêu cầu Volcengine dùng định dạng gốc của nhà cung cấp ogg_opus. Đối với tệp đính kèm âm thanh thông thường, OpenClaw yêu cầu mp3. Các bí danh nhà cung cấp bytedancedoubao cũng phân giải về cùng một nhà cung cấp giọng nói.

    ID tài nguyên mặc định là seed-tts-1.0 vì đây là quyền mà BytePlus cấp cho các API key Seed Speech mới tạo trong dự án mặc định. Nếu dự án của bạn có quyền TTS 2.0, hãy đặt VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.

    Xác thực AppID/token cũ vẫn được hỗ trợ cho các ứng dụng Speech Console cũ hơn:

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

    Cấu hình nâng cao

    Default model after onboarding

    openclaw onboard --auth-choice volcengine-api-key hiện đặt volcengine-plan/ark-code-latest làm mô hình mặc định đồng thời cũng đăng ký catalog chung volcengine.

    Model picker fallback behavior

    Trong quá trình onboarding/cấu hình lựa chọn mô hình, lựa chọn xác thực Volcengine ưu tiên cả các hàng volcengine/*volcengine-plan/*. Nếu các mô hình đó chưa được tải, OpenClaw sẽ quay về catalog không lọc thay vì hiển thị một bộ chọn trống được giới hạn theo nhà cung cấp.

    Environment variables for daemon processes

    Nếu Gateway chạy dưới dạng daemon (launchd/systemd), hãy đảm bảo các biến môi trường cho mô hình và TTS như VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID, và VOLCENGINE_TTS_TOKEN có sẵn cho tiến trình đó (ví dụ, trong ~/.openclaw/.env hoặc qua env.shellEnv).

    Liên quan