关键词 (Keywords): OpenClaw, AI Agent, Google Gemini, Telegram Bot, VPS 部署, Docker 教程, 自动化办公, 宝塔面板, NAS 部署, 智能体

在人工智能从单纯的“对话机器人 (Chatbot)”向“智能体 (Agent)”进化的今天，OpenClaw（前身为 Clawdbot/Moltbot）作为一个现象级的开源项目，重新定义了我们与 AI 的交互方式。与传统的 ChatGPT 不同，OpenClaw 不仅拥有大脑（支持 Google Gemini、Claude 等模型），更拥有双手——它能够通过无头浏览器自主访问网页、截取屏幕、读取文件甚至执行代码。

本文是一份万字级的保姆级教程，旨在帮助从零基础的小白到资深开发者，在 VPS（Linux）、Windows、macOS 以及 NAS 等多种环境下部署属于自己的 OpenClaw 数字员工。我们将深入探讨 Node.js 直装与 Docker 容器化两种部署方案，并详细讲解如何申请 Google Gemini API Key 与 Telegram Bot Token。无论你是希望通过 Telegram 远程遥控服务器，还是需要一个 24 小时在线的 Web 自动化助手，本文都将为你提供最详尽的解决方案。

在开始敲击任何代码之前，我们需要准备两把核心“钥匙”：大脑（LLM API）和嘴巴（聊天界面）。

OpenClaw 支持多种模型，但 Google Gemini 目前是**选择，因为它拥有超长的上下文窗口（1M+ tokens）、极快的响应速度，且在一定限额内完全免费。

• 步骤一：环境准备 确保你的网络环境可以访问 Google 服务（建议使用美国或新加坡节点）。
• 步骤二：访问 AI Studio 打开浏览器，访问 。
• 步骤三：创建密钥
  1. 点击页面左上角的 “Get API key”。
  2. 点击 “Create API key” 按钮。
  3. 选择 “Create API key in new project”（在旧项目中创建也可以，但新项目更便于管理额度）。
• 步骤四：保存密钥 系统会生成一串以 开头的长字符串。请务必将其复制并保存在安全的地方（如密码管理器或记事本）。这是 AI 的灵魂，切勿泄露。

我们将使用 Telegram 作为指挥 OpenClaw 的遥控器。它即时性强、支持多端同步，且 API 极其稳定。

• 步骤一：寻找 BotFather 打开 Telegram App，在搜索栏输入 ，认准那个带蓝色认证对勾的账号。
• 步骤二：创建新机器人
  1. 点击底部的 或输入 。
  2. 发送指令 。
• 步骤三：命名与设置 ID
  1. BotFather 会问你：
     • 回答：给它起个好听的名字，比如 或 （支持中文）。
  2. BotFather 会接着问：
     • 回答：设置一个唯一的用户名，必须以 结尾，例如 。
• 步骤四：获取 Token 成功后，BotFather 会发给你一段长消息，其中 下方的那串红色字符（格式如 ）就是 Token。复制并保存。
• 步骤五：获取你自己的 Chat ID (安全锁) 为了防止陌生人滥用你的机器人，我们需要获取你自己的 Telegram ID。
  1. 搜索 。
  2. 点击 Start，它会回复你的 ID（一串纯数字，如 ）。记下它。

这是最推荐的部署方式。利用 VPS 的 24 小时在线特性和海外网络优势（如新加坡节点），你的 Agent 可以随时响应。

适合习惯使用 GUI 管理服务器的用户。

1. 环境配置

• 登录宝塔面板，进入 “软件商店”。
• 搜索 “Node.js 版本管理器” 并安装。
• 点击设置，选择 Stable (v20.x 或 v22.x) 版本进行安装。
• 安装完成后，点击 “命令行版本”，将刚刚安装的版本设置为 默认。

2. 安装系统依赖 (关键) OpenClaw 需要驱动无头浏览器 (Puppeteer)，Linux 默认缺少图形库。请在宝塔的 “终端” 中执行以下命令（以 Debian/Ubuntu 为例）：

Bash

3. 安装 OpenClaw 在终端中执行：

Bash

讯享网

4. 初始化配置 执行配置向导：

Bash

• LLM: 选择 。
• API Key: 填入之前申请的 。
• Platform: 选择 。
• Token: 填入 Bot Token。
• Allowed Users: 填入你的 Telegram ID（数字）。

5. 进程守护 (让它一直运行) 在宝塔终端执行：

Bash

讯享网

现在，即便你关闭网页，Jarvis 也会一直在后台运行。

Docker 是运行 AI Agent 最安全的方式，可以防止 AI 误删文件或被注入攻击。

1. 安装 Docker 如果你还没装 Docker，使用官方脚本一键安装：

Bash

2. 创建工作目录

Bash

讯享网

3. 编写 Docker Compose 文件 创建 文件：

Bash

填入以下内容（注意：由于 OpenClaw 迭代极快，我们使用 Puppeteer 官方镜像构建，确保浏览器环境正常）：

YAML

讯享网

4. 配置文件预处理 由于 Docker 启动后直接运行 ，我们需要先生成配置文件。 可以先运行一次临时的容器来生成配置：

Bash

按提示填入 Key 和 Token 后，配置文件会保存在宿主机的 目录下。

5. 启动容器

Bash

讯享网

查看日志：

Bash

如果看到 ，说明部署成功。

适合开发者调试，或利用本地强大的 GPU/CPU 资源（虽然 Gemini 不需要本地算力）。

1. 安装 Node.js

• 访问 下载 LTS 版本并安装。
• 打开终端（CMD 或 PowerShell 或 Terminal），输入 确认安装成功。

2. 安装 OpenClaw

Bash

讯享网

3. 配置与启动

Bash

注意：本地部署时，只要你关闭终端窗口，机器人就会下线。

NAS 是运行 Agent 的绝佳载体，因为它本身就是 24 小时开机的。一键脚本请参照：NAS Docker 环境下 OpenClaw 一键自动化部署脚本以及部署教程

以群晖 (Synology) Container Manager 为例：

1. 开启 SSH：在群晖控制面板 -> 终端机和 SNMP 中开启 SSH。

2. 连接 SSH：使用终端连接群晖。

3. 获取镜像：由于没有官方镜像，我们依然使用 或基于 运行。
   • 建议：在群晖的 Docker 文件夹下新建 文件夹，上传我们在“场景二”中提到的 文件。

4. 项目构建： 在 SSH 中进入该目录：

   Bash

   讯享网

5. 配置映射：确保你的 路径正确映射到了群晖的文件系统中，方便你随时修改 。

部署完成后，如何使用它是最重要的。初始化和配置模型请参照：NAS Docker OpenClaw 初始化配置全参数调优与AI 助理进阶指南

OpenClaw 为了安全，采用了“请求-批准”机制。

1. 在 Telegram 向你的机器人发送 或 。
2. 机器人会回复：，并告诉你未授权。
3. 回到服务器终端（如果是 Docker，进入容器终端 ），执行：

   Bash

4. Telegram 机器人会立即回复：“你好！我已上线…”。

OpenClaw 的强大之处在于 Tools（工具使用）。

场景 A：全网信息聚合 (Research Agent)

• 指令：“去 hostloc 论坛看看最新的帖子列表，并截图给我。”
• 工作流：OpenClaw 接收指令 -> 调用 Puppeteer 打开 hostloc -> 截图 -> 发送图片给你。
• 优势：无需自己打开浏览器，避免广告，且可以访问你本地网络无法访问的站点（如果 VPS 在海外）。

场景 B：视觉辅助分析 (Vision Capabilities)

• 指令：发送一张包含复杂表格的图片，附言“把这个表格转成 Excel 数据发给我”。
• 工作流：OpenClaw 调用 Gemini Pro Vision 模型 -> 识别图片内容 -> 生成 CSV/Excel 格式数据 -> 回复。

场景 C：代码编写与执行 (Coding Agent)

• 指令：“写一个 Python 脚本，检查 的延迟，如果超过 200ms 就发报警邮件。直接运行它。”
• 工作流：Gemini 编写代码 -> OpenClaw 在沙箱环境中执行该代码 -> 返回执行结果。
• 注意：在 Docker 环境中执行此操作非常安全，不用担心搞坏宿主机。

场景 D：服务器运维 (Ops Agent)

• 指令：“读取 的最后 50 行，分析一下有什么错误。”
• 工作流：OpenClaw 使用文件读取工具 -> 获取日志 -> 投喂给 Gemini -> Gemini 分析并给出修复建议。

• 开源免费：相比于昂贵的 SaaS 服务，OpenClaw 代码完全透明，成本仅为 VPS 费用。
• 数据隐私：所有对话历史、密钥都保存在你自己的服务器上，只有经过你允许的 API 请求才会发送给 Google。
• 多模态：原生支持文字、图片、文件的交互，不只是简单的聊天。

现在的 Chatbot 只是“大脑”，而 OpenClaw 代表的 Agent 是“大脑 + 四肢”。

• 主动性：未来的 Agent 不再是被动等待指令，而是可以设定定时任务（例如：每天早上 8 点自动去爬取新闻并生成早报）。
• 协作性：多个 Agent 之间可以协作（Swarm Intelligence），一个负责写代码，一个负责测试，一个负责部署。

• 不要暴露 HTTP 端口：尽量通过 Telegram 进行交互，它是加密隧道。如果开启了 Web 面板，务必配置 Nginx 反向代理并通过 Cloudflare 保护。
• Allowed Users 必填：在配置文件中务必限制 为你自己的 ID，否则你的机器人可能被他人用来消耗你的 API 额度。
• Docker 隔离：正如前文所述，强烈建议使用 Docker 部署，防止 Prompt Injection 攻击导致服务器文件泄露。

Q1: 机器人不回复，Docker 日志显示 。

• A: Google Gemini 对 IP 有限制。请检查 VPS 是否启用了 Warp 或 IP 是否为支持地区（美/新/台/日）。可以在容器内执行 测试。

Q2: 截图功能报错 。

• A: 说明 Puppeteer 没装好或缺少依赖。如果是 VPS 直装，请重新运行 apt install 依赖命令。如果是 Docker，请确保使用的是包含 Chrome 的镜像。

Q3: 如何修改配置（如更换 API Key）？

• A: 配置文件通常位于 (直装) 或映射的 (Docker)。修改 JSON 文件后重启服务即可。

版权声明：本文首发于E路领航转载请注明出处。 (本文涉及的 VPS IP 及密钥均为演示数据，实际操作中请注意保护隐私)