Google (Gemini)

Documentation Index

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

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

• Nhà cung cấp: google
• Xác thực: GEMINI_API_KEY hoặc GOOGLE_API_KEY
• API: Google Gemini API
• Tùy chọn thời gian chạy: nhà cung cấp/mô hình agentRuntime.id: "google-gemini-cli" tái sử dụng OAuth của Gemini CLI trong khi vẫn giữ tham chiếu mô hình ở dạng chuẩn là google/*.

​

Bắt đầu

openclaw onboard --auth-choice gemini-api-key

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice gemini-api-key \
  --gemini-api-key "$GEMINI_API_KEY"

{
  agents: {
    defaults: {
      model: { primary: "google/gemini-3.1-pro-preview" },
    },
  },
}

openclaw models list --provider google

# Homebrew
brew install gemini-cli

# or npm
npm install -g @google/gemini-cli

openclaw models auth login --provider google-gemini-cli --set-default

openclaw models list --provider google

​

Khả năng

​

Tìm kiếm web

{
  plugins: {
    entries: {
      google: {
        config: {
          webSearch: {
            apiKey: "AIza...", // optional if GEMINI_API_KEY or models.providers.google.apiKey is set
            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // falls back to models.providers.google.baseUrl
            model: "gemini-2.5-flash",
          },
        },
      },
    },
  },
}

​

Tạo hình ảnh

• Cũng hỗ trợ google/gemini-3-pro-image-preview
• Tạo: tối đa 4 hình ảnh mỗi yêu cầu
• Chế độ chỉnh sửa: bật, tối đa 5 hình ảnh đầu vào
• Điều khiển hình học: size, aspectRatio và resolution

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "google/gemini-3.1-flash-image-preview",
      },
    },
  },
}

​

Tạo video

• Mô hình video mặc định: google/veo-3.1-fast-generate-preview
• Chế độ: luồng văn bản-thành-video, hình ảnh-thành-video và tham chiếu một video
• Hỗ trợ aspectRatio (16:9, 9:16) và resolution (720P, 1080P); đầu ra âm thanh hiện không được Veo hỗ trợ
• Thời lượng được hỗ trợ: 4, 6 hoặc 8 giây (các giá trị khác sẽ được làm khớp về giá trị được phép gần nhất)

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "google/veo-3.1-fast-generate-preview",
      },
    },
  },
}

​

Tạo nhạc

• Mô hình nhạc mặc định: google/lyria-3-clip-preview
• Cũng hỗ trợ google/lyria-3-pro-preview
• Điều khiển lời nhắc: lyrics và instrumental
• Định dạng đầu ra: mặc định là mp3, cộng thêm wav trên google/lyria-3-pro-preview
• Đầu vào tham chiếu: tối đa 10 hình ảnh
• Các lần chạy dựa trên phiên sẽ tách ra qua luồng tác vụ/trạng thái dùng chung, bao gồm action: "status"

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "google/lyria-3-clip-preview",
      },
    },
  },
}

​

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

• Giọng mặc định: Kore
• Xác thực: messages.tts.providers.google.apiKey, models.providers.google.apiKey, GEMINI_API_KEY hoặc GOOGLE_API_KEY
• Đầu ra: WAV cho tệp đính kèm TTS thông thường, Opus cho mục tiêu ghi chú thoại, PCM cho Talk/điện thoại
• Đầu ra ghi chú thoại: Google PCM được bọc dưới dạng WAV và chuyển mã sang Opus 48 kHz bằng ffmpeg

{
  messages: {
    tts: {
      auto: "always",
      provider: "google",
      providers: {
        google: {
          model: "gemini-3.1-flash-tts-preview",
          voiceName: "Kore",
          audioProfile: "Speak professionally with a calm tone.",
        },
      },
    },
  },
}

Here is the clean reply text.

[[tts:text]][whispers] Here is the spoken version.[[/tts:text]]

​

Giọng nói thời gian thực

{
  plugins: {
    entries: {
      "voice-call": {
        enabled: true,
        config: {
          realtime: {
            enabled: true,
            provider: "google",
            providers: {
              google: {
                model: "gemini-2.5-flash-native-audio-preview-12-2025",
                voice: "Kore",
                activityHandling: "start-of-activity-interrupts",
                turnCoverage: "only-activity",
              },
            },
          },
        },
      },
    },
  },
}

​

Cấu hình nâng cao

{
  agents: {
    defaults: {
      models: {
        "google/gemini-2.5-pro": {
          params: {
            cachedContent: "cachedContents/prebuilt-context",
          },
        },
      },
    },
  },
}

​

Liên quan