0基础安装 OpenClaw 图文教程(Windows 系统)

什么是 OpenClaw？OpenClaw 是一个可自托管的个人 AI 助手。
它可以运行在你自己的电脑上并通过 Telegram 等聊天渠道接收消息,再调用执行、网页、浏览器等能力，帮你完成各种自动化操作
这篇教程适合零基础新手，跟着步骤一步步操作即可完成安装
预计耗时：1～2 小时

在正式开始之前，请先准备好以下内容：
●一台闲置的电脑
●注册一个Telegram机器人，并保存Bot Token
同时获取自己的Telegram用户ID（后续配置白名单会用到）
●注册一个大模型API平台账号，并先充值少量余额

1.打开Telegram，搜索并进入 @BotFather
2.给@BotFather 发送命令：/newbot
3.按提示依次输入两项信息：
•机器人显示名：用户看到的名字
•机器人用户名：用于搜索
机器人用户名规则：只能使用 英文字母、数字、下划线，必须以 bot 结尾
例如：my_xiaoc752_bot 或 Myxiaoc752Bot
4.创建成功后，会发你一串Token，格式类似：:AA……
这串 Token 一定要保存好，后面配置Telegram时会用到

注册Telegram机器人教程

1.打开 Telegram搜索并进入以下任意一个机器人：@userinfobot 或 @GetMyID_bot
2.点击 开始 / Start3.机器人会自动回复你的账号信息，其中会显示你的 Telegram 用户 ID
4.把这串纯数字复制并保存，后面配置白名单时会用到

获取自己的 Telegram 用户 ID

这里推荐使用OpenRouter，它支持用一个API key接入多种模型，比较适合新手使用。

1.开始菜单搜索 PowerShell → 以管理员身份运行2.在 owerShell 中输入以下命令安装
wsl –install

搜索 PowerShell → 以管理员身份运行

openclaw skills 教程

首次打开时，系统会提示你设置：
Linux 用户名（可自行设置）
Linux 密码（输入密码时不会显示字符，正常情况，输完后按回车）

注意：下面这条命令需要在 Ubuntu 终端 中执行，不是在 PowerShell 中执行

curl -fsSL https://openclaw.ai/install.sh | bash

输入后等待安装完成，一般需要几分钟

1. 确认安装方式出现下面这句提示时：
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
这里选择 YES，然后按回车，可以使用键盘方向键进行选择。

选择 YES

2. 选择安装模式：QuickStart

3. 选择模型提供商：OpenRouter接着选择：Paste API key now然后粘贴你前面准备好的 OpenRouter API Key模型选择，这里我选择的是：DeepSeek V3.1

选择：OpenRouter

接着选择：Paste API key now

粘贴你前面准备好的 OpenRouter API Key

模型可以按自己的需求选择

4. 配置聊天渠道聊天渠道这里选择：Telegram然后选择：Enter Telegram bot token接着输入你前面保存好的 Telegram Bot Token

选择：Telegram

选择：Enter Telegram bot token

接着输入你前面保存好的 Telegram Bot Token

5. Skills 配置出现下面这个选项时：Configure skills now?
这里建议先选择：NO 后面有需要再安装即可。
注意：这一项通常需要先按空格选中，再按回车确认

6. 其他配置项后续如果出现需要填写额外 API Key 的地方，先全部选择：NO

全部选择：NO

7.安装完成后，可以在 Ubuntu 中输入：

openclaw dashboard

这会打开 OpenClaw 的控制面板。

1.打开网页版控制台，如果之前没有打开，可以在 Ubuntu 中输入：

2. 进入配置页面进入控制台后：选择 配置点击 All Settings在下方选择 Raw

点击红框标注的地方

3. 修改工具权限把原来的：

替换为：

替换后点Save保存

保存后即可生效。

点击Tools这边出现Full就是设置完成了

这表示把工具配置从仅消息模式改成完整模式，并把本机执行权限开到最高，同时关闭逐次确认。

4.给 Telegram 机器人设置白名单

为了防止别人随意使用你的机器人，建议开启白名单功能
开启后，只有被添加到白名单里的 Telegram 用户，才能给机器人发送指令并正常使用
设置方法打开 OpenClaw 控制台点击 频道找到 Allow From点击 Add添加你自己的 Telegram 用户 ID滑到最下方点Save 保存设置设置完成后，只有这个 Telegram ID 对应的账号可以使用该机器人。
注意：这里填写的是 Telegram 用户 ID（纯数字），不是用户名

给 Telegram 机器人设置白名单

只有在你发现 Telegram 连不上、收不到消息，再配置这一项
1. 查看你的 梯子 代理端口先确认你本地代理软件的端口号

查看端口号

2. 在 Ubuntu 中执行以下命令把下面的 你的端口数字 改成你自己的实际端口（很重要，记得修改你的端口数字）

PORT=你的端口数字
HOST_IP=$(ip route show | awk ‘/default/ {print $3}’)
openclaw config set channels.telegram.proxy “http://$HOST_IP:$PORT”
openclaw config set channels.telegram.network.autoSelectFamily false
openclaw gateway restart
openclaw channels status –probe
openclaw logs –follow

3.然后输入代码重启

4.打开Telegram，给你的机器人发一条消息，测试是否可以正常聊天到这里，OpenClaw 就安装完成了。

openclaw gateway 启动网关服务（核心，必须运行）

openclaw gateway start 后台启动网关

openclaw gateway stop 停止网关

openclaw gateway restart 重启服务

openclaw gateway status 查看 Gateway 状态

openclaw tui 启动终端

openclaw dashboard 打开控制面板（可视化界面）

openclaw onboard 首次引导

openclaw setup 初始化

openclaw configure 交互式配置（设置凭据、设备等）

openclaw config get 查看当前配置

openclaw config set 设置配置项

openclaw config validate 校验配置文件

openclaw channels add 添加渠道

openclaw channels login 登录渠道（WhatsApp、Telegram等）

openclaw channels list 查看已连接的渠道

openclaw channels logout 退出渠道

openclaw message send 发送消息

openclaw message broadcast 群发消息

openclaw status 查看状态（渠道健康度、最近会话）

openclaw gateway status 查看网关状态

openclaw health 检查网关健康状态

openclaw doctor 诊断问题 + 自动修复

openclaw logs 查看日志

openclaw skills 技能管理（安装、更新、删除）

openclaw plugins 插件管理

openclaw skills install <skill> 安装技能

openclaw skills list 列出已安装技能

openclaw sessions 列出历史会话

openclaw memory 搜索记忆内容

openclaw agents 管理独立代理

openclaw cron 定时任务管理

openclaw cron list 查看定时任务

openclaw cron add 添加定时任务

openclaw browser 控制浏览器（自动化）

openclaw nodes 管理连接的节点（手机等）

openclaw node 单个节点控制

openclaw update 更新 CLI

openclaw reset 重置配置（保留 CLI）

openclaw uninstall 完全卸载