Logo

菜单

sycnnj
发布于 2026-02-02 / 1,130 阅读
1
0

OpenClaw(原 Clawdbot)全能 AI 助理部署教程：从零打造你的私人数字员工

#AI Agent#OpenClaw#Gemini#docker#AI#vps

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

摘要 (Abstract)

在人工智能从单纯的“对话机器人 (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 自动化助手，本文都将为你提供最详尽的解决方案。

第一部分：前期准备 —— 获取通往 AI 世界的钥匙

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

1. 申请 Google Gemini API Key (你的 AI 大脑)

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

  • 步骤一：环境准备 确保你的网络环境可以访问 Google 服务（建议使用美国或新加坡节点）。

  • 步骤二：访问 AI Studio 打开浏览器，访问 Google AI Studio (aistudio.google.com)。

  • 步骤三：创建密钥

    1. 点击页面左上角的 "Get API key"。

    2. 点击 "Create API key" 按钮。

    3. 选择 "Create API key in new project"（在旧项目中创建也可以，但新项目更便于管理额度）。

  • 步骤四：保存密钥 系统会生成一串以 AIza 开头的长字符串。请务必将其复制并保存在安全的地方（如密码管理器或记事本）。这是 AI 的灵魂，切勿泄露。

2. 申请 Telegram Bot Token (你的交互终端)

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

  • 步骤一：寻找 BotFather 打开 Telegram App，在搜索栏输入 @BotFather，认准那个带蓝色认证对勾的账号。

  • 步骤二：创建新机器人

    1. 点击底部的 Start 或输入 /start。

    2. 发送指令 /newbot。

  • 步骤三：命名与设置 ID

    1. BotFather 会问你："Alright, a new bot. How are we going to call it?"

      • 回答：给它起个好听的名字，比如 Jarvis AI 或 我的超级助理（支持中文）。

    2. BotFather 会接着问："Good. Now let's choose a username for your bot."

      • 回答：设置一个唯一的用户名，必须以 bot 结尾，例如 my_private_agent_2026_bot。

  • 步骤四：获取 Token 成功后，BotFather 会发给你一段长消息，其中 Use this token to access the HTTP API: 下方的那串红色字符（格式如 123456:ABC-DEF...）就是 Token。复制并保存。

  • 步骤五：获取你自己的 Chat ID (安全锁) 为了防止陌生人滥用你的机器人，我们需要获取你自己的 Telegram ID。

    1. 搜索 @userinfobot。

    2. 点击 Start，它会回复你的 ID（一串纯数字，如 987654321）。记下它。

第二部分：部署方案 A —— VPS 环境 (Linux)

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

场景一：宝塔面板 (BT Panel) 可视化部署

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

1. 环境配置

  • 登录宝塔面板，进入 “软件商店”。

  • 搜索 "Node.js 版本管理器" 并安装。

  • 点击设置，选择 Stable (v20.x 或 v22.x) 版本进行安装。

  • 安装完成后，点击 “命令行版本”，将刚刚安装的版本设置为 默认。

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

Bash

# 更新软件源
sudo apt-get update

# 一键安装 Chrome 所需依赖库
sudo apt-get install -y ca-certificates fonts-liberation libappindicator3-1 libasound2 libatk-bridge2.0-0 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgbm1 libgcc1 libglib2.0-0 libgtk-3-0 libnspr4 libnss3 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 lsb-release wget xdg-utils

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

Bash

npm install -g openclaw

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

Bash

openclaw onboard

  • LLM: 选择 Google Gemini。

  • API Key: 填入之前申请的 AIza...。

  • Platform: 选择 Telegram。

  • Token: 填入 Bot Token。

  • Allowed Users: 填入你的 Telegram ID（数字）。

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

Bash

# 安装 PM2
npm install -g pm2

# 启动并命名为 Jarvis
pm2 start openclaw --name "Jarvis" -- start

# 保存当前进程列表，开机自启
pm2 save
pm2 startup

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

场景二：Docker 容器化部署 (高安全性推荐)

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

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

Bash

curl -fsSL https://get.docker.com | bash
systemctl enable docker
systemctl start docker

2. 创建工作目录

Bash

mkdir -p /opt/openclaw/config
cd /opt/openclaw

3. 编写 Docker Compose 文件 创建 docker-compose.yml 文件：

Bash

nano docker-compose.yml

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

YAML

version: '3.8'

services:
  openclaw:
    # 使用包含 Chrome 依赖的基础镜像
    image: ghcr.io/puppeteer/puppeteer:21.5.0
    container_name: openclaw_agent
    init: true
    user: root # 必须使用 root 权限安装 npm 包
    environment:
      - NODE_ENV=production
      # 如果你的 VPS 在国内，需要配置 HTTP_PROXY
      # - HTTP_PROXY=http://172.17.0.1:7890
      # - HTTPS_PROXY=http://172.17.0.1:7890
    volumes:
      # 映射配置文件，防止重启丢失配置
      - ./config:/home/pptruser/.openclaw
    # 容器启动时自动更新并启动 OpenClaw
    command: >
      sh -c "npm install -g openclaw && openclaw start"
    restart: unless-stopped
    network_mode: host # 使用 host 模式避免网络复杂性，或者使用 bridge

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

Bash

# 交互式生成配置
docker run -it --rm -v $(pwd)/config:/root/.openclaw node:20-slim sh -c "npm install -g openclaw && openclaw onboard"

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

5. 启动容器

Bash

docker-compose up -d

查看日志：

Bash

docker logs -f openclaw_agent

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

第三部分：部署方案 B —— 本地与家用环境

场景三：Windows / macOS 本地部署

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

1. 安装 Node.js

  • 访问 nodejs.org 下载 LTS 版本并安装。

  • 打开终端（CMD 或 PowerShell 或 Terminal），输入 node -v 确认安装成功。

2. 安装 OpenClaw

Bash

npm install -g openclaw

3. 配置与启动

Bash

openclaw onboard
# 跟随向导完成配置
openclaw start

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

场景四：NAS 部署 (Synology/QNAP)

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

以群晖 (Synology) Container Manager 为例：

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

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

  3. 获取镜像：由于没有官方镜像，我们依然使用 docker build 或基于 ghcr.io/puppeteer/puppeteer 运行。

    • 建议：在群晖的 Docker 文件夹下新建 openclaw 文件夹，上传我们在“场景二”中提到的 docker-compose.yml 文件。

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

    Bash

    cd /volume1/docker/openclaw
sudo docker-compose up -d

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

第四部分：使用指南与核心功能

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

1. 配对 (Pairing) —— 第一次握手

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

  1. 在 Telegram 向你的机器人发送 /start 或 Hello。

  2. 机器人会回复：Pairing code: ABCDEF，并告诉你未授权。

  3. 回到服务器终端（如果是 Docker，进入容器终端 docker exec -it openclaw_agent sh），执行：

    Bash

    openclaw pairing approve telegram ABCDEF

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

2. 核心使用场景 (应用案例)

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

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

  • 指令：“去 hostloc 论坛看看最新的帖子列表，并截图给我。”

  • 工作流：OpenClaw 接收指令 -> 调用 Puppeteer 打开 hostloc -> 截图 -> 发送图片给你。

  • 优势：无需自己打开浏览器，避免广告，且可以访问你本地网络无法访问的站点（如果 VPS 在海外）。

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

  • 指令：发送一张包含复杂表格的图片，附言“把这个表格转成 Excel 数据发给我”。

  • 工作流：OpenClaw 调用 Gemini Pro Vision 模型 -> 识别图片内容 -> 生成 CSV/Excel 格式数据 -> 回复。

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

  • 指令：“写一个 Python 脚本，检查 google.com 的延迟，如果超过 200ms 就发报警邮件。直接运行它。”

  • 工作流：Gemini 编写代码 -> OpenClaw 在沙箱环境中执行该代码 -> 返回执行结果。

  • 注意：在 Docker 环境中执行此操作非常安全，不用担心搞坏宿主机。

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

  • 指令：“读取 /var/log/nginx/error.log 的最后 50 行，分析一下有什么错误。”

  • 工作流：OpenClaw 使用文件读取工具 -> 获取日志 -> 投喂给 Gemini -> Gemini 分析并给出修复建议。

第五部分：优势、趋势与安全性

1. 为什么选择 OpenClaw？

  • 开源免费：相比于昂贵的 SaaS 服务，OpenClaw 代码完全透明，成本仅为 VPS 费用。

  • 数据隐私：所有对话历史、密钥都保存在你自己的服务器上，只有经过你允许的 API 请求才会发送给 Google。

  • 多模态：原生支持文字、图片、文件的交互，不只是简单的聊天。

2. AI Agent 的未来趋势

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

  • 主动性：未来的 Agent 不再是被动等待指令，而是可以设定定时任务（例如：每天早上 8 点自动去爬取新闻并生成早报）。

  • 协作性：多个 Agent 之间可以协作（Swarm Intelligence），一个负责写代码，一个负责测试，一个负责部署。

3. 安全隐私特别提示

  • 不要暴露 HTTP 端口：尽量通过 Telegram 进行交互，它是加密隧道。如果开启了 Web 面板，务必配置 Nginx 反向代理并通过 Cloudflare 保护。

  • Allowed Users 必填：在配置文件中务必限制 allowed_users 为你自己的 ID，否则你的机器人可能被他人用来消耗你的 API 额度。

  • Docker 隔离：正如前文所述，强烈建议使用 Docker 部署，防止 Prompt Injection 攻击导致服务器文件泄露。

附录：常见问题排查 (Troubleshooting)

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

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

Q2: 截图功能报错 Browser not found。

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

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

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

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

加了Umami代码导致微信/TG分...
OpenClaw：当AI伸出“利爪...

评论