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

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

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

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

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

• 系统： Linux、Windows、macOS 都可以

我的环境：

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

• 系统：Ubuntu 24.04 LTS
• Node.js：v25.5.0
• AI 服务：aicodewith.com（国内中转，邀请链接：https://aicodewith.com/zh/login?tab=register&invitation=EK1S5F）

• Node.js： v20 或 v25（推荐 v25）
• npm/pnpm： 包管理工具
• Chrome/Chromium： 浏览器自动化需要

• AI API Key： OpenAI、Claude 或国内中转服务
• Telegram 账号： 用来创建 Bot

在终端中执行：

如果你使用 pnpm：

安装完成后验证：

应该看到版本号，比如 。

![截图：openclaw 版本信息]

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

在终端中执行：

然后启用插件：

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

如果使用 AICodewith：

运行认证命令：

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

查看可用模型：

如果使用其他服务商：

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

启动配置流程：

按照向导提示操作：

• 是否安装守护进程？ → 选择
• 配置模式 → 选择 （快速开始）
• 使用已有配置？ → 选择 （如果有）
• 模型供应商 → 如果已配置 AICodewith，选择 ；否则选择你的服务商
• 选择默认模型 → 推荐使用 （工具调用能力最强）
• 聊天渠道 → 暂时 ，后面再配置 Telegram
• 安装 Skills → 推荐选择以下几个：
• 按空格选择，选完后按回车确认
  • （监控/阅读博客）
  • （OpenClaw 文档）
  • （管理 MCP 服务器）
  • （连接 Obsidian 笔记）
• API Keys → 根据需要填写（如果暂时用不到可以都选 ）
• Hooks → 建议全部开启
• 权限申请 → 电脑会弹出一些权限申请，都同意即可

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

验证运行状态：

![截图：openclaw status 输出]

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

• ✅ 体验最好（创始人就是用 Telegram 控制的）
• ✅ 支持斜杠命令（、 等）
• ✅ 支持内联按钮和丰富交互
• ✅ 注册简单，手机挂梯子即可

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

步骤 1：获取 Telegram Bot Token

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

![截图：BotFather 对话界面]

步骤 2：启用 Telegram 插件

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

步骤 3：配置 Bot Token

在终端中执行：

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

步骤 4：启动 Gateway

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

步骤 5：配对验证

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

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

![截图：Bot 首次对话]

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

然后输入配置 JSON。

重要配置项说明：

• ：你的 Bot Token
• ：私聊策略
  • ：需要配对验证（推荐）
  • ：只允许白名单用户
  • ：所有人都能用（不推荐）
• ：允许的用户 ID 列表
• ：群组配置
  • ：需要 @Bot 才会回复

获取你的 Telegram 用户 ID

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

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

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

配置修改后，重启 Gateway：

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

在 Telegram 中：

1. 搜索你的 Bot（比如 ）
2. 发送
3. 如果配置了 ，会收到配对码
4. 批准配对：

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

![截图：Bot 首次对话]

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

• 功能分离： 一个用于日常对话，一个用于写作，一个用于技术支持
• 权限隔离： 不同 Bot 可以分享给不同的人
• 测试环境： 一个生产 Bot，一个测试 Bot

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

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

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

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

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

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

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

• SKILL.md – 技能说明和使用指南
• scripts/ – 可执行脚本
• references/ – 参考文档
• assets/ – 资源文件

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

Skill 1：image-generator

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

特点：

• ✅ 支持 4K 高清图像生成
• ✅ 多种宽高比（16:9, 1:1, 9:16 等）
• ✅ 自动文件命名
• ✅ 完善的错误处理

使用示例：

实际应用：

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

Skill 2：cloudflare-r2-uploader

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

特点：

• ✅ 自动路径生成：
• ✅ MD5 去重（相同文件 = 相同 URL）
• ✅ 自定义域名支持
• ✅ 批量上传

使用示例：

输出：

组合使用：

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

一条命令完成：

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

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

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

常用 Skills：

• weather – 天气查询
• bird – Twitter 操作
• coding-agent openclaw 安装 – 代码助手
• mcporter – MCP 服务器集成

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

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

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

• OpenClaw 启动并控制一个独立的 Chrome 浏览器
• 使用独立的用户数据目录
• 不共享系统 Chrome 的登录状态

启动浏览器：

打开网页：

截图：

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

• 可以控制你正在使用的 Chrome 浏览器
• 需要安装 OpenClaw Chrome 扩展
• 可以访问已登录的账号

使用场景：

• 需要访问已登录的网站（Twitter、Reddit 等）
• 需要使用浏览器的 cookie 和 session

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

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

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

然后手动登录 Reddit。

步骤 2：搜索

步骤 3：获取页面内容

![截图：Reddit 搜索结果]

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

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

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

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

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

解决：

• 直接把你的 Telegram 用户 ID 加到 列表中
• 或者快速完成配对流程

问题： 让 AI 打开浏览器操作，报错

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

解决：

• 使用独立浏览器模式（ profile）
• 或者安装 Chrome 扩展并连接标签页

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

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

解决：

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

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

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

• 日志： （每日记录）
• 长期记忆： （重要信息）

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

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

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

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

• 喜欢折腾的开发者
• 需要 AI 助手但不想用商业产品的人
• 想要自己掌控数据的人
• 需要多 Bot 管理不同任务的人
• 想要扩展 AI 能力的人

• 完全不懂技术的小白
• 只想要开箱即用的人
• 预算紧张的人（API 费用）

• 官方文档： https://docs.openclaw.ai
• GitHub： https://github.com/openclaw/openclaw
• 技能市场： https://clawdhub.com
• 社区： https://discord.com/invite/clawd

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

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

• 生成文章封面图
• 上传图片到 CDN
• 管理服务器
• 写代码
• 查资料
• 写文章

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

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

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

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