在 60 秒内完成 OpenClaw 2.0 与 Gemini 的配置

@_philschmid
英语2026年8月31日
104K
160
19
16
210

TL;DR

一份关于在本地部署 OpenClaw 2.0 的简明技术指南。内容涵盖安装流程、Gemini 3.7 Flash 集成,以及如何启用网络搜索溯源和多渠道聊天等功能。

五个命令安装 OpenClaw 2.0(v2026.8.1),连接 Gemini 3.7 Flash,这是我们最快的(+300 token/秒)用于编码和 Agent 的模型,并在一分钟内开始使用 Google 搜索接地进行聊天。

Philipp Schmid - inline image

什么是 OpenClaw 2.0?

OpenClaw 是一个真正能做事的个人 AI 助手。它运行在你的设备上,在你的聊天中,遵循你的规则。

  • 随处聊天: 从浏览器控制界面、Telegram、Discord、WhatsApp 或 Slack 聊天。
  • 集成工具: 浏览器自动化、终端执行、文件系统访问和网络搜索接地。
  • 记忆功能: 跨会话保持记忆,因此它了解你的偏好、项目和联系人。

OpenClaw 2.0v2026.8.1)是迄今为止最大的更新:更简单的安装、重建的浏览器应用可直接进入对话,以及你可以通过与你的 Claw 对话完成的设置。完整说明:v2026.8.1

前提条件

  • Node.js: Node 26(推荐)或 Node 22.22.3+ / 24.15+node --version)。
  • Gemini API 密钥:Google AI Studio 获取免费密钥。

1. 安装 OpenClaw 2.0

通过 npm 全局安装 OpenClaw:

bash
1npm install -g openclaw@2026.8.1

验证安装:

bash
1openclaw --version# 输出:OpenClaw 2026.8.1 (ea80657)

2. 配置 Gemini 身份验证

在当前 shell 中导出你的 Gemini API 密钥:

bash
1export GEMINI_API_KEY="your-gemini-api-key-here"

将其持久化到 OpenClaw 的本地配置文件存储中:

bash
1openclaw onboard --non-interactive --accept-risk --skip-health \
2 --mode local \
3 --auth-choice gemini-api-key \
4 --gemini-api-key "$GEMINI_API_KEY"

(注意:你可以安全地忽略任何关于配置 Brave API 密钥的入门提示——Gemini 内置的 Google 搜索接地会被自动使用。)

3. 将 Gemini 3.7 Flash 设为默认模型

Gemini 3.7 Flash 设置为默认的 Agent 模型:

bash
1openclaw models set google/gemini-3.7-flash

(注意:如果 OpenClaw 显示警告,提示该模型不在本地目录中,可以安全忽略。该模型会在下一步中动态解析并针对 Google AI Studio 进行验证。)

验证模型发现和身份验证状态:

bash
1openclaw models list --provider google

4. 通过 CLI 测试推理

在你的终端中运行一个独立的 Agent 轮次:

bash
1openclaw agent --local --agent main --message "你好!你运行的是什么模型?"

输出:

text
1我运行的是 google/gemini-3.7-flash。
2我是你在 OpenClaw 中的新助手!你想叫我什么?
Philipp Schmid - inline image

5. 启动网关并打开控制界面

将网关设置为本地模式并启动:

bash
1openclaw config set gateway.mode localopenclaw gateway run

(要作为持久后台守护进程运行,请使用:`openclaw gateway install && openclaw gateway start`。要停止它:`openclaw gateway stop --force`)。

在浏览器中打开控制界面:

bash
1openclaw dashboard

浏览器将打开到 http://127.0.0.1:18789/,并使用你的本地会话令牌进行身份验证:

Philipp Schmid - inline image

后续步骤

GEMINI_API_KEY 存在时,Google 搜索接地默认启用。无需额外配置或搜索密钥。

  • 直接通过 CLI 测试:\openclaw capability web search --query "最新的 Gemini 模型"\
  • 在聊天会话中,Gemini 会在需要最新上下文时自动运行带有引用的网络搜索。

参见:OpenClaw 中的 Google 搜索接地

Philipp Schmid - inline image

利用其他 Gemini 功能

  • 图像生成 使用 openclaw models set-image google/gemini-3.1-flash-image 设置 Google 的图像模型。
  • 视频生成 使用 google/veo-3.1-fast-generate-preview 生成 4–8 秒的视频。
  • 音乐生成 通过 google/lyria-3-clip-preview 进行提示驱动的音乐生成。
  • 文本转语音 Gemini 批量 TTS,支持自然语言风格提示(gemini-3.1-flash-tts-preview)。
  • 实时语音 通过 Gemini Live API(gemini-3.1-flash-live-preview)实现低延迟双向语音流。

完整的 Google 文档

连接聊天频道

使用简单的 CLI 命令将你的 Gemini 助手连接到你最喜欢的消息应用:

  • 浏览所有频道:\openclaw channels list --all\
  • 交互式设置:\openclaw channels add\
  • Telegram:\openclaw channels add --channel telegram --token "<BOT_TOKEN>"\
  • WhatsApp(二维码):\openclaw channels login --channel whatsapp\
  • Discord:\openclaw channels add --channel discord --token "<BOT_TOKEN>"\
  • 验证频道状态:\openclaw channels status --probe\

完整的聊天频道文档

二次创作

使用 YouMind 创作爆款文章

收集素材、拆解爆点、生成视觉资产、撰写内容,并在一个 AI 工作空间里完成分发。

了解 YouMind
写给创作者

把你的 Markdown 变成干净的 𝕏 文章

图片上传、表格、代码块,往 𝕏 上手动重排太痛苦。YouMind 把整篇 Markdown 一键转成干净、可直接发布的 𝕏 文章草稿。

试试 Markdown 转 𝕏

更多可拆解样本

近期爆款文章

探索更多爆款文章