openclaw

关注公众号 jb51net

关闭
AI > openclaw >

零基础入门OpenClaw 完整安装配置实战指南(完全流程)

A洛

OpenClaw 是什么？简单说，就是一个可以让 AI 住进你的 Telegram、管理你的电脑或服务器、帮你写代码的开源框架。

OpenClaw 是一个开源的 AI 助手框架,支持在 Telegram、电脑或服务器上运行,并且可以扩展技能,本文详细介绍了从环境准备到多 Bot 配置的整个安装过程,包括技能扩展和浏览器自动化等功能,适合喜欢折腾的开发者和需要 AI 助手但不想使用商业产品的用户。

听起来很酷？确实很酷。但安装配置的过程，也确实有点折腾。

今天我就把整个安装过程记录下来，从环境准备到多 Bot 配置，从技能扩展到自动化工作流，一步步带你走完全流程。

一、环境准备：你需要什么？

1.1 系统要求

我的环境：

由于不敢在生产机器上直接折腾，我找了一台闲置电脑，装了 Windows + Ubuntu 24.04 双系统。平时用 Windows，需要跑 OpenClaw 时就切换到 Ubuntu。

1.2 软件依赖

1.3 必备资源

二、安装 OpenClaw

2.1 安装主程序

在终端中执行：

npm install -g openclaw@latest

如果你使用 pnpm：

pnpm add -g openclaw@latest

安装完成后验证：

openclaw --version

应该看到版本号，比如 2026.1.29。

![截图：openclaw 版本信息]

2.2 安装 AICodewith 插件（可选）

如果你使用 AICodewith 服务（国内中转，支持 GPT、Claude、Gemini），需要安装插件：

在终端中执行：

openclaw plugins install openclaw-aicodewith-auth

然后启用插件：

openclaw plugins enable openclaw-aicodewith-auth

如果 gateway 正在运行，需要重启一下：

openclaw gateway stop
openclaw gateway run

2.3 配置 API

如果使用 AICodewith：

运行认证命令：

openclaw models auth login --provider aicodewith-claude --set-default

按提示输入你的 AICodewith API Key（注册地址：https://aicodewith.com/zh/login?tab=register&invitation=EK1S5F）

查看可用模型：

openclaw models list | grep aicodewith

如果使用其他服务商：

可以在初始化配置时选择 OpenAI、Anthropic、Google 等。

2.4 执行初始化配置（第一次安装必须）

启动配置流程：

openclaw onboard --install-daemon

按照向导提示操作：

配置完成后，系统会自动启动 Gateway。

验证运行状态：

openclaw status

![截图：openclaw status 输出]

三、配置 Telegram Bot

OpenClaw 必须配置一个对话渠道才能使用。目前推荐使用 Telegram，因为：

OpenClaw 支持多个 Telegram Bot 同时运行，每个 Bot 可以有不同的用途。

3.1 创建第一个 Bot

步骤 1：获取 Telegram Bot Token

  1. 在 Telegram 中搜索 @BotFather（官方 Bot 创建工具）
  2. 发送命令：/newbot
  3. 按提示设置 bot 名称和用户名
  4. 获得 Bot Token（格式：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

![截图：BotFather 对话界面]

步骤 2：启用 Telegram 插件

在终端中执行（插件默认是关闭的）：

openclaw plugins enable telegram

步骤 3：配置 Bot Token

在终端中执行：

openclaw config set channels.telegram.botToken "你的Bot_Token"

将 你的Bot_Token 替换为第一步获取的 Token。

步骤 4：启动 Gateway

openclaw gateway run

如果报错，可以先尝试停止：

openclaw gateway stop
openclaw gateway run

步骤 5：配对验证

  1. 在 Telegram 中找到你的 bot
  2. 发送任意消息
  3. Bot 会返回一个验证码（6位数字）
  4. 在终端中执行：
openclaw pairing approve telegram 你的验证码

配对成功后，你就可以和 Bot 对话了！

![截图：Bot 首次对话]

3.2 配置多个 Bot（可选）

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的Bot Token",
      "dmPolicy": "pairing",
      "allowFrom": ["你的Telegram用户ID"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

方法 2：通过命令行（推荐）

openclaw config patch

然后输入配置 JSON。

重要配置项说明：

获取你的 Telegram 用户 ID

发送消息给 Bot 后，查看日志：

openclaw logs --follow

在日志中找到 from.id，那就是你的用户 ID。

![截图：日志中的用户 ID]

3.3 重启 Gateway

配置修改后，重启 Gateway：

openclaw gateway restart

或者用配置工具自动重启：

openclaw config patch  # 会自动触发重启

3.4 测试 Bot

在 Telegram 中：

  1. 搜索你的 Bot（比如 @myassistant_bot）
  2. 发送 /start
  3. 如果配置了 pairing，会收到配对码
  4. 批准配对：openclaw pairing approve telegram <配对码>

或者，如果你已经把用户 ID 加到 allowFrom，可以直接对话。

![截图：Bot 首次对话]

四、多 Bot 配置（进阶）

OpenClaw 支持同时运行多个 Bot，每个 Bot 可以有不同的用途。

4.1 为什么要多个 Bot？

4.2 配置多账号模式

编辑配置文件，使用 accounts 结构：

{
  "channels": {
    "telegram": {
      "accounts": {
        "main": {
          "name": "主Bot",
          "botToken": "第一个Bot的Token",
          "allowFrom": ["你的用户ID"]
        },
        "writer": {
          "name": "写作助手",
          "botToken": "第二个Bot的Token",
          "allowFrom": ["你的用户ID"]
        },
        "tech": {
          "name": "技术支持",
          "botToken": "第三个Bot的Token",
          "allowFrom": ["你的用户ID"]
        }
      }
    }
  }
}

4.3 实战案例：我的四个 Bot

在今天的配置过程中，我创建了四个 Bot：

  1. @fanshu123_bot - 主 Bot，日常使用
  2. @mupeilin_bot - 第二个 Bot，测试用
  3. @wujing123_bot - 第三个 Bot，实验功能
  4. @ttxcb_bot - 公众号写作助手

每个 Bot 都连接到同一个 OpenClaw 实例，共享记忆和配置，但有独立的对话历史。

![截图：四个 Bot 同时运行]

五、技能扩展（Skills）

OpenClaw 最强大的地方在于它的技能系统。你可以创建自定义技能，让 AI 具备特定的能力。

5.1 什么是 Skills？

Skills 是模块化的功能包，可以扩展 OpenClaw 的能力。每个 Skill 包含：

5.2 实战：创建图片生成 Skill

在配置过程中，我创建了两个实用的 Skill：

Skill 1：image-generator

功能： 使用 Nano Banana Pro (Gemini 3 Pro Image) API 生成高质量图片

特点：

使用示例：

python3 scripts/generate_image.py \
  --prompt "A tech blog banner with robots and code" \
  --aspect-ratio "16:9" \
  --resolution "2K"

实际应用：

这篇文章的封面图就是用这个 Skill 生成的！提示词是：

A cartoon-style banner image for OpenClaw installation guide. 
Features a cute robot AI assistant installing software on a laptop, 
with Telegram logo, terminal windows, and code snippets floating around. 
Blue and orange gradient background, modern tech aesthetic, 
flat design, friendly and approachable.

生成时间：约 45 秒（2K 分辨率）
文件大小：2.7 MB

Skill 2：cloudflare-r2-uploader

功能： 上传文件到 Cloudflare R2 对象存储，自动生成 CDN 链接

特点：

使用示例：

python3 scripts/upload_to_r2.py image.png

输出：

✅ Uploaded: https://gpimg.guapihub.net/2026/01/abc123def456.png

组合使用：

两个 Skill 可以配合使用，实现完整的工作流：

# 生成图片并上传
python3 scripts/generate_and_upload.py \
  --prompt "Tech blog banner" \
  --aspect-ratio "16:9" \
  --resolution "2K"

一条命令完成：

  1. 生成 AI 图片
  2. 上传到 R2 CDN
  3. 返回公开 URL

这就是我用来生成和上传文章封面图的完整流程！

5.3 其他可用 Skills

OpenClaw 生态还有很多实用的 Skills：

# 搜索 Skills
clawdhub search weather
# 安装 Skills
clawdhub install weather

常用 Skills：

六、浏览器自动化配置

OpenClaw 的另一个强大功能是浏览器自动化——可以打开网页、搜索信息、截图、点击等。

6.1 浏览器模式

OpenClaw 支持两种浏览器控制模式：

模式 1：独立浏览器（openclawprofile）

启动浏览器：

openclaw browser start

打开网页：

openclaw browser open "https://www.google.com"

截图：

openclaw browser screenshot

模式 2：Chrome 扩展模式（chromeprofile）

使用场景：

6.2 实战：搜索 Reddit

问题： 想搜索 Reddit 上关于 ChatGPT 的讨论，但 Reddit 有反爬虫机制。

解决方案： 在浏览器中登录 Reddit，然后用 OpenClaw 控制。

步骤 1：在独立浏览器中登录

openclaw browser start
openclaw browser open "https://www.reddit.com"

然后手动登录 Reddit。

步骤 2：搜索

openclaw browser navigate "https://www.reddit.com/search/?q=ChatGPT+backup"

步骤 3：获取页面内容

openclaw browser snapshot --efficient

![截图：Reddit 搜索结果]

6.3 实战：Google 搜索

Google 对自动化访问相对友好，可以直接搜索：

openclaw browser navigate "https://www.google.com/search?q=site:reddit.com+ChatGPT"
openclaw browser snapshot

技巧： 用 Google 搜索 Twitter/Reddit 内容，不需要登录就能看到公开信息。

![截图：Google 搜索 Reddit 内容]

七、常见问题和解决方案

7.1 配对失败

问题： 发消息给 Bot，提示需要配对，但配对码过期

原因： 配对码有效期只有 1 小时

解决：

7.2 浏览器自动化失败

问题： 让 AI 打开浏览器操作，报错 Chrome extension relay is running, but no tab is connected

原因： 浏览器控制需要额外配置

解决：

7.3 Reddit/Twitter 访问被拦截

问题： 访问 Reddit 或 Twitter 显示 “You’ve been blocked by network security”

原因： 网站检测到自动化访问

解决：

  1. 在浏览器中手动登录
  2. 使用 Google 搜索公开内容（site:reddit.com ChatGPT）
  3. 使用 DuckDuckGo（对自动化更友好）

八、进阶技巧

8.1 定时任务（Cron）

OpenClaw 支持定时任务，可以让 AI 定期执行某些操作：

openclaw cron add --schedule "0 9 * * *" --message "早上好，今天有什么安排？"

8.2 记忆系统

OpenClaw 有记忆功能，可以记住重要信息：

AI 会自动读取和更新这些文件。

8.3 多模型切换

OpenClaw 支持配置多个模型，可以根据任务选择：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "claude-sonnet-4-5"
      },
      "models": {
        "gpt-5.2": {},
        "claude-opus-4-5": {},
        "gemini-3-pro": {}
      }
    }
  }
}

九、总结

优点

✅ 真的能用 - 不是 Demo，是可以日常使用的工具
✅ 扩展性强 - 支持多种模型、多种平台、多种技能
✅ 开源 - 代码在 GitHub 上，可以自己改
✅ 文档齐全 - 官方文档写得很详细
✅ 多 Bot 支持 - 可以同时运行多个 Bot，功能分离
✅ 技能系统 - 可以创建自定义技能，扩展无限可能

缺点

❌ 需要一定技术基础 - 至少要会用命令行
❌ 配置略复杂 - 尤其是多 Bot 和技能配置
❌ API 费用 - 如果用得多，API 费用会是一笔开销

适合谁？

不适合谁？

十、参考资源

后记

折腾了一个下午，从安装到配置，从单 Bot 到多 Bot，从技能创建到自动化工作流，总算把 OpenClaw 跑起来了。

虽然过程中遇到了一些坑（主要是配置和技能开发），但最终效果还是挺满意的。现在我可以在 Telegram 里直接和 AI 对话，让它帮我：

感觉像是给自己配了一个 24 小时在线的助手，而且还能不断扩展新能力。

如果你也想折腾，建议先从最简单的配置开始，一步步来。遇到问题多看日志，多查文档，基本都能解决。

最后，如果你成功部署了 OpenClaw，欢迎分享你的经验和玩法！

到此这篇关于零基础入门OpenClaw 完整安装配置实战指南的文章就介绍到这了,更多相关OpenClaw安装配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！