Volcengine (Doubao)

Nhà cung cấp Volcengine cho phép truy cập các mô hình Doubao và mô hình của 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 thông thường và lập trình. Plugin đi kèm này cũng đăng ký Volcengine Speech làm nhà cung cấp TTS.

Bắt đầu

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

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

openclaw models list --provider volcengineopenclaw models list --provider volcengine-plan

Nhà cung cấp và điểm cuối

Danh mục tích hợp sẵn

Cả hai danh mục đều là tĩnh (không có lệnh gọi khám phá /models) và hỗ trợ thống kê mức sử dụng theo luồng tương thích với OpenAI. Lược đồ công cụ của cả hai nhà cung cấp tự động loại bỏ các từ khóa minLength, maxLength, minItems, maxItems, minContains và maxContains, vì API gọi công cụ của Volcengine từ chối các từ khóa này.

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

Volcengine TTS sử dụng API HTTP BytePlus Seed Speech (voice.ap-southeast-1.bytepluses.com) và được cấu hình riêng với khóa API mô hình Doubao tương thích với OpenAI. Trong bảng điều khiển BytePlus, hãy mở Seed Speech > Settings > API Keys, sao chép khóa API, 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 tính năng này 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,        },      },    },  },}

Các trường khả dụng trong messages.tts.providers.volcengine: apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey và baseUrl. !emotion=<value> cũng hoạt động như một chỉ thị giọng nói nội tuyến khi cho phép ghi đè cài đặt giọng nói.

Đối với đích là tin nhắn thoại, OpenClaw yêu cầu định dạng gốc của nhà cung cấp là ogg_opus. Đối với tệp âm thanh đính kèm thông thường, hệ thống yêu cầu mp3. Các bí danh nhà cung cấp bytedance và doubao cũng phân giải thành nhà cung cấp giọng nói này.

Mã định danh tài nguyên mặc định là seed-tts-1.0, quyền sử dụng mà BytePlus mặc định cấp cho các khóa API Seed Speech mới tạo. Nếu dự án của bạn có quyền sử dụng TTS 2.0, hãy đặt VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.

Xác thực AppID/mã thông báo 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ác biến môi trường TTS tùy chọn khác: VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY và VOLCENGINE_TTS_BASE_URL ghi đè các trường cấu hình tương ứng trong messages.tts.providers.volcengine khi được đặt.

Cấu hình nâng cao

Liên quan