OpenClaw安装配置记录

/ 1164 字 / 约 3 分钟阅读

最近折腾了一下 OpenClaw，这是一个非常强大的本地 AI 代理系统。它不像普通的聊天机器人那样只能陪聊，而是可以真正操作文件、执行命令、帮我干活。

这篇文章记录一下在 Ubuntu 本地环境下安装 OpenClaw，并配置 Google Gemini 模型和 Telegram 机器人的全过程。

1. 前置准备：Google Cloud 结算

在使用 google-gemini-cli 之前，有一个容易被忽视的关键点：你必须确保你的 Google Cloud 账号已经开启了结算账户 (Billing Account)。

虽然 Gemini 对个人开发者提供了非常充足的免费配额（普通用户日常使用几乎不可能超额扣费），但 Google 要求项目必须绑定结算卡才能激活 API 访问权限。

  1. 前往 Google Cloud Console。
  2. 确保创建了一个项目，并在“结算 (Billing)”板块绑定了有效的支付方式。

2. 一键安装与自动引导

准备好后，在 Ubuntu 终端运行官方一键安装脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

脚本执行完毕后，会自动进入交互式的配置向导 (Wizard)。跟着屏幕上的提示一步步操作即可。

3. 交互式配置中的关键点

配置向导会以问答的形式引导你完成所有设置。流程非常直观，但有两点需要特别注意：

注意点 1：模型选择 (Model Selection)

  • 当向导询问模型提供商时，选择 google-gemini-cli。
  • 系统会弹出认证链接（OAuth），点击链接登录 Google 账号授权即可。
  • 认证成功后，推荐选择 Gemini 3 Pro Preview 版本。这个版本智商很高，但如果是预览版，偶尔可能会有响应波动。如果后续发现变慢，随时可以再次运行配置命令切换回稳定版。

注意点 2：Telegram 配置 (Channel Setup)

这是让 AI 能在手机上随时响应你的关键。你需要提前准备好机器人的 Token：

  1. 准备 Bot Token：

    • 在 Telegram 搜索 @BotFather，发送 /newbot 创建一个新机器人。
    • BotFather 会给你一串 HTTP API Token，这就是配置向导里要填的 Token。

  2. 安全配对 (Pairing/Allowlist)：

    • 为了防止陌生人蹭用你的额度，强烈建议在配置向导中直接填入你的 Telegram User ID 到白名单（Allowlist）。
    • User ID 获取方式：私聊 Telegram 上的 @userinfobot 查看。

4. 启动服务

配置完成后，启动 OpenClaw 网关：

openclaw gateway start

查看状态：

openclaw gateway status

5. 开始使用

现在，打开 Telegram，给你的机器人发一句 “Hello” 吧！它已经连接上了你的本地环境，并且由强大的 Gemini 3 模型驱动，随时准备听候差遣。