新手教程完整流程

OpenClaw零基础安装配置实战指南（完整流程）

2026-06-03

阅读 0

热度 0

作者菜鸟AI编辑部

摘要

OpenClaw，说白了就是一个开源框架，能让AI住进你的Telegram、帮你管电脑、写代码、甚至操作

OpenClaw，说白了就是一个开源框架，能让AI住进你的Telegram、帮你管电脑、写代码、甚至操作浏览器。听起来挺酷的，但部署起来也确实有点折腾——今天就把整个过程拆开揉碎了讲清楚，从环境准备到多Bot配置，从技能扩展到浏览器自动化，一步步走完。

先说几个核心判断：这玩意儿不是那种开箱即用的商业产品，但如果你愿意花点时间折腾，它带来的灵活性远超同类工具。特别是对于对数据隐私有点执着、或者想要深度定制AI工作流的开发者来说，OpenClaw绝对值得一试。

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

1.1 系统要求

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

环境参考：

考虑到主力机承担着日常任务，不如找台闲置电脑来部署。这次用的是Ubuntu 24.04 LTS，Node.js版本直接拉到v25.5.0，AI服务走的是aicodewith.com（国内中转）。

系统：Ubuntu 24.04 LTS
Node.js：v25.5.0
AI 服务：aicodewith.com

1.2 软件依赖

Node.js： v20 或 v25（v25更稳妥）
npm/pnpm： 包管理工具必备
Chrome/Chromium： 浏览器自动化会用到

1.3 必备资源

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

二、安装 OpenClaw

2.1 安装主程序

在终端里执行这一句就行：

npm install -g openclaw@latest

习惯用pnpm的话，换成：

pnpm add -g openclaw@latest

装完验证一下：

openclaw --version

不出意外会看到版本号，比如 2026.1.29。

![截图：openclaw 版本信息]

2.2 安装 AICodewith 插件（可选）

如果选择了aicodewith作为AI服务，需要额外装个插件：

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

按提示输入API Key就行。

查看可用模型：

openclaw models list | grep aicodewith

使用其他服务商：

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

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

启动配置流程：

openclaw onboard --install-daemon

跟着向导一步步来：

是否安装守护进程？ → 选 yes
配置模式 → 选 quick start
使用已有配置？ → 选 使用已有配置（如果有）
模型供应商 → 已配AICodewith就选 跳过；否则选你的服务商
选择默认模型 → 推荐 claude（工具调用能力确实最强）
聊天渠道 → 先 跳过，后面再配Telegram
安装 Skills → 推荐勾选这几个：
rss-reader（监控博客）、openclaw-docs（官方文档）、mcporter（管理MCP服务器）、obsidian（连Obsidian笔记）
按空格选择，选完回车确认
API Keys → 暂时用不到就都选 no
Hooks → 建议全开
权限申请 → 弹出的都同意

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

验证状态：

openclaw status

![截图：openclaw status 输出]

三、配置 Telegram Bot

OpenClaw需要配一个对话渠道才能用。目前体验最好的就是Telegram，原因很直接：

✅ 支持斜杠命令（/help、/status 等）
✅ 内联按钮和丰富交互都有
✅ 注册方便，挂个梯子就行

而且OpenClaw支持同时跑多个Bot，每个可以管不同的事。

3.1 创建第一个 Bot

步骤 1：获取 Telegram Bot Token

在Telegram里搜 @BotFather
发命令：/newbot
设置bot名称和用户名
拿到Bot Token（格式：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

![截图：BotFather 对话界面]

步骤 2：启用 Telegram 插件

openclaw plugins enable telegram

步骤 3：配置 Bot Token

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

步骤 4：启动 Gateway

openclaw gateway run

如果报错，先停了再起：

openclaw gateway stop
openclaw gateway run

步骤 5：配对验证

在Telegram里找你的bot
发任意消息
Bot会返回一个6位数验证码
在终端执行：

openclaw pairing approve telegram 你的验证码

配对成功就能正常对话了。

![截图：Bot 首次对话]

3.2 配置多个 Bot（可选）

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

通过命令行配置：

openclaw config patch

然后粘贴JSON配置。

关键配置项：

botToken：Bot Token
dmPolicy：私聊策略
pairing（推荐，需配对验证）、allowlist（仅白名单）、open（不推荐，谁都能用）
allowFrom：允许的用户ID列表
groups：群组配置
requireMention: true（需要@Bot才回复）

获取用户 ID

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

openclaw logs --follow

找到 from.id 即可。

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

3.3 重启 Gateway

openclaw gateway restart

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

openclaw config patch

3.4 测试 Bot

搜你的Bot（比如 @myassistant_bot）
发送 /start
配了pairing会收到配对码，批准即可
或者直接把用户ID加进 allowFrom，直接开聊

![截图：Bot 首次对话]

四、多 Bot 配置（进阶）

4.1 为什么要多个 Bot？

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

4.2 配置多账号模式

{
  "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来实现不同的功能：

@fanshu123_bot - 主Bot，日常使用
@mupeilin_bot - 测试Bot
@wujing123_bot - 实验功能
@ttxcb_bot - 写作助手

所有Bot共享同一个OpenClaw实例，记忆和配置互通，但对话历史各自独立。

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

五、技能扩展（Skills）

5.1 什么是 Skills？

Skills是模块化的功能包，让AI具备特定能力。每个Skill包含：

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

5.2 实战：创建图片生成 Skill

Skill 1：image-generator

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

特点：

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

使用示例：

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

这篇文章的封面图就是用这个Skill生成的——提示词指定了卡通风格的安装向导场景，机器人拿着螺丝刀对着笔记本，旁边漂浮着Telegram标志和代码片段。

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

Skill 2：cloudflare-r2-uploader

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

特点：

✅ 自动路径生成：{year}/{month}/{md5}.{ext}
✅ MD5去重（相同文件相同URL）
✅ 自定义域名支持
✅ 批量上传

使用示例：

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"

这正是文章封面图的完整处理流程——生成→上传→返回公开URL。

5.3 其他可用 Skills

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

常用Skills：

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

六、浏览器自动化配置

6.1 浏览器模式

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

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

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

启动：

openclaw browser start

打开网页：

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

截图：

openclaw browser screenshot

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

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

适用场景： 需要访问已登录网站（Twitter、Reddit等）或使用浏览器cookie/session。

6.2 实战：搜索 Reddit

场景： 想搜Reddit上关于ChatGPT的讨论，但Reddit有反爬机制。

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

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

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

手动登录。

步骤 2：搜索

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

步骤 3：获取页面内容

openclaw browser snapshot --efficient

![截图：Reddit 搜索结果]

6.3 实战：Google 搜索

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

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

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

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

七、常见问题和解决方案

7.1 配对失败

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

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

解决：

直接把用户ID加到 allowFrom 列表
或者快速完成配对流程

7.2 浏览器自动化失败

问题： 报错 Chrome extension relay is running, but no tab is connected

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

解决：

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

7.3 Reddit/Twitter 访问被拦截

问题： 显示 “You've been blocked by network security”

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

解决：

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

八、进阶技巧

8.1 定时任务（Cron）

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

8.2 记忆系统

日志： memory/YYYY-MM-DD.md（每日记录）
长期记忆： MEMORY.md（重要信息）

AI会自动读写这些文件。

8.3 多模型切换

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

九、总结

优点

✅ 真的能用 - 不是Demo，是日常可用的工具
✅ 扩展性强 - 多模型、多平台、多技能随意组合
✅ 开源 - 代码在GitHub上，想改就改
✅ 文档齐全 - 官方文档写得很细
✅ 多 Bot 支持 - 功能分离，管理方便
✅ 技能系统 - 自定义扩展，可能性无限

缺点

❌ 需要技术基础 - 至少要会用命令行
❌ 配置略复杂 - 多Bot和技能配置需要耐心
❌ API 费用 - 用得多的话，是一笔开销

适合谁？

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

不适合谁？

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

十、参考资源

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

后记

从环境准备到多Bot配置，从技能创建到自动化工作流，折腾一个下午总算把OpenClaw跑起来了。虽然中间踩了些坑——主要是配置和技能开发——但最终效果确实让人满意。现在可以在Telegram里直接跟AI对话，让它生成文章封面图、上传到CDN、管理服务器、写代码、查资料、写文章……相当于给手机里装了个24小时在线的助手，而且能力还能不断扩展。

如果也想折腾，建议从最简单的配置开始，一步步来。遇到问题多看日志，多查文档，基本都能解决。最后，成功部署了别忘了分享经验——这玩意儿越玩越有意思。

来源：互联网

上一篇 OpenClaw部署后Tools权限禁用？一行配置快速修复 下一篇 Ollama最新版安装教程：5分钟快速下载与部署

免责声明

本网站新闻资讯均来自公开渠道，力求准确但不保证绝对无误，内容观点仅代表作者本人，与本站无关。若涉及侵权，请联系我们处理。本站保留对声明的修改权，最终解释权归本站所有。

OpenClaw零基础安装配置实战指南（完整流程）

摘要

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

1.1 系统要求

1.2 软件依赖

1.3 必备资源

二、安装 OpenClaw

2.1 安装主程序

2.2 安装 AICodewith 插件（可选）

2.3 配置 API

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

三、配置 Telegram Bot

3.1 创建第一个 Bot

步骤 1：获取 Telegram Bot Token

步骤 2：启用 Telegram 插件

步骤 3：配置 Bot Token

步骤 4：启动 Gateway

步骤 5：配对验证

3.2 配置多个 Bot（可选）

通过命令行配置：

获取用户 ID

3.3 重启 Gateway

3.4 测试 Bot

四、多 Bot 配置（进阶）

4.1 为什么要多个 Bot？

4.2 配置多账号模式

4.3 实战案例：四个 Bot 的配置

五、技能扩展（Skills）

5.1 什么是 Skills？

5.2 实战：创建图片生成 Skill

Skill 1：image-generator

Skill 2：cloudflare-r2-uploader

5.3 其他可用 Skills

六、浏览器自动化配置

6.1 浏览器模式

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

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

6.2 实战：搜索 Reddit

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

步骤 2：搜索

步骤 3：获取页面内容

6.3 实战：Google 搜索

七、常见问题和解决方案

7.1 配对失败

7.2 浏览器自动化失败

7.3 Reddit/Twitter 访问被拦截

八、进阶技巧

8.1 定时任务（Cron）

8.2 记忆系统

8.3 多模型切换

九、总结

优点

缺点

适合谁？

不适合谁？

十、参考资源

后记

相关文章推荐