Chuyển đến nội dung chính

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.

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ếtGiá trị
Nhà cung cấpvolcengine (chung + TTS) + volcengine-plan (lập trình)
Xác thực mô hìnhVOLCANO_ENGINE_API_KEY
Xác thực TTSVOLCENGINE_TTS_API_KEY hoặc BYTEPLUS_SEED_SPEECH_API_KEY
APIMô hình tương thích OpenAI, BytePlus Seed Speech TTS

​
Bắt đầu

1

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.
2

Set a default model

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

Verify the model is available

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
Để thiết lập không tương tác (CI, scripting), truyền key trực tiếp:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

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

Nhà cung cấpĐiểm cuốiTrường hợp sử dụng
volcengineark.cn-beijing.volces.com/api/v3Mô hình chung
volcengine-planark.cn-beijing.volces.com/api/coding/v3Mô hình lập trình
Cả hai nhà cung cấp đều được cấu hình từ một API key duy nhất. Quá trình thiết lập tự động đăng ký cả hai.

​
Catalog tích hợp sẵn

Tham chiếu mô hìnhTênĐầu vàoNgữ cảnh
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8văn bản, hình ảnh256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028văn bản, hình ảnh256,000
volcengine/kimi-k2-5-260127Kimi K2.5văn bản, hình ảnh256,000
volcengine/glm-4-7-251222GLM 4.7văn bản, hình ảnh200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2văn bản, hình ảnh128,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 bytedance và doubao 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.
VOLCANO_ENGINE_API_KEY dùng cho các điểm cuối mô hình ModelArk/Doubao và không phải là API key Seed Speech. TTS cần API key Seed Speech từ BytePlus Speech Console, hoặc cặp AppID/token Speech Console cũ.
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

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.
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/* và 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.
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).
Khi chạy OpenClaw dưới dạng dịch vụ nền, các biến môi trường được đặt trong shell tương tác của bạn không tự động được kế thừa. Xem ghi chú về daemon ở trên.

​
Liên quan

Model selection

Chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.

Configuration

Tham chiếu cấu hình đầy đủ cho agent, mô hình và nhà cung cấp.

Troubleshooting

Các sự cố thường gặp và các bước gỡ lỗi.

FAQ

Các câu hỏi thường gặp về thiết lập OpenClaw.