什么是 OpenClaw？
OpenClaw 是一个可自托管的个人 AI 助手。它运行在你自己的电脑上，通过 Telegram 等聊天渠道接收消息，再调用执行、网页、浏览器等能力，帮你完成各种自动化操作。
数据完全留在本地，支持接入多种大模型（DeepSeek、Claude、GPT 等），适合注重隐私和自主可控的用户。
这篇教程适合零基础新手，跟着步骤一步步操作即可完成安装，预计耗时 1～2 小时。
开始前需要准备什么？
- 一台闲置的电脑（Windows 系统）
- 注册一个 Telegram 机器人，并保存 Bot Token；同时获取自己的 Telegram 用户 ID（后续配置白名单用）
- 注册一个大模型 API 平台账号（推荐 OpenRouter），并先充值少量余额
一、注册 Telegram 机器人
1
打开 Telegram，搜索并进入 @BotFather
2
给 @BotFather 发送命令：
/newbot
3
按提示依次输入：
• 机器人显示名：用户看到的名字
• 机器人用户名：用于搜索，只能使用英文字母、数字、下划线，必须以 bot 结尾
例如：my_xiaoc752_bot 或 Myxiaoc752Bot
4
创建成功后，BotFather 会发你一串 Token，格式类似：
123456789:AAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️ 重要：这串 Token 一定要保存好，后面配置 Telegram 时会用到。
二、获取自己的 Telegram 用户 ID
1
打开 Telegram，搜索并进入 @userinfobot 或 @GetMyID_bot
2
点击 开始 / Start
3
机器人会自动回复你的账号信息，其中显示你的 Telegram 用户 ID（纯数字）
4
复制并保存这串数字，后面配置白名单时会用到
三、注册 OpenRouter 获取 API Key
推荐使用 OpenRouter，它支持用一个 API Key 接入多种模型（DeepSeek、Claude、GPT 等），比较适合新手。
1
打开网站：https://openrouter.ai/
2
注册账户并登录
3
创建一个 API Key，先充值少量余额
⚠️ 重要：创建的 Key 要保存下来，后续配置时需要粘贴。
第一步：安装 WSL2 + Ubuntu
1
开始菜单搜索 PowerShell → 以管理员身份运行
2
在 PowerShell 中输入以下命令：
wsl --install
安装完成后可能需要重启电脑。
第二～三步：打开 Ubuntu 并安装 OpenClaw
第二步：在开始菜单打开 Ubuntu，首次打开需设置 Linux 用户名和密码。
💡 提示：输入密码时不会显示字符，这是正常的，输完按回车即可。
第三步：在 Ubuntu 终端中执行以下命令安装 OpenClaw：
curl -fsSL https://openclaw.ai/install.sh | bash
等待安装完成，一般需要几分钟。
第四步：完成新手向导配置
1
确认安装方式：提示 "I understand this is personal-by-default..." 时选择 YES，按回车（用键盘方向键选择）
2
选择安装模式：选择 QuickStart
3
选择模型提供商：选择 OpenRouter → 选择 Paste API key now → 粘贴你的 API Key → 选择模型（推荐 DeepSeek V3.1）
4
配置聊天渠道：选择 Telegram → 选择 Enter Telegram bot token → 输入你保存的 Bot Token
5
Skills 配置：提示 "Configure skills now?" 时建议先选 NO，后面有需要再安装
💡 提示：这一项通常需要先按空格选中，再按回车确认。
6
其他配置项：后续如果出现需要填写额外 API Key 的地方，先全部选择 NO
7
安装完成！在 Ubuntu 中输入以下命令打开控制面板：
openclaw dashboard
第五步：开启完整权限 + 设置白名单
修改工具权限
1
打开控制台：在 Ubuntu 中输入 openclaw dashboard
2
进入 配置 → 点击 All Settings → 在下方选择 Raw
3
找到 tools 配置，将原来的内容替换为：
// 替换前（原始配置）
"tools": {
"profile": "messaging"
}
// 替换后（完整权限配置）
"tools": {
"profile": "full",
"exec": {
"host": "gateway",
"security": "full",
"ask": "off"
},
"web": {
"fetch": {
"enabled": true
}
}
}
4
点击 Save 保存。Tools 显示 Full 就表示设置成功。
这表示把工具配置从仅消息模式改成完整模式，并把本机执行权限开到最高，同时关闭逐次确认。
设置 Telegram 白名单
为防止他人随意使用你的机器人，建议开启白名单：
1
在控制台中点击 频道
2
找到 Allow From → 点击 Add
3
添加你的 Telegram 用户 ID（纯数字，不是用户名）
4
滑到最下方点 Save 保存
⚠️ 注意：这里填写的是 Telegram 用户 ID（纯数字），不是用户名。
第六步：配置 Telegram 代理（可选）
💡 提示：只有在你发现 Telegram 连不上、收不到消息时，才需要配置这一项。
1
先确认你本地代理软件（VPN）的端口号
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
3
重启服务：
openclaw gateway restart
openclaw channels status --probe
openclaw logs --follow
4
打开 Telegram，给你的机器人发一条消息，测试是否正常。
到这里，OpenClaw 就安装完成了！🎉
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 status | 查看状态 |
openclaw health | 检查网关健康 |
openclaw doctor | 诊断问题 + 自动修复 |
openclaw logs | 查看日志 |
技能、记忆与定时任务
| 命令 | 说明 |
|---|---|
openclaw skills install <skill> | 安装技能 |
openclaw skills list | 列出已安装技能 |
openclaw sessions | 列出历史会话 |
openclaw memory | 搜索记忆内容 |
openclaw cron add | 添加定时任务 |
openclaw cron list | 查看定时任务 |
openclaw update | 更新 CLI |
openclaw reset | 重置配置 |
openclaw uninstall | 完全卸载 |
常见问题 FAQ
Q1：什么是 OpenClaw？它能做什么？
A：OpenClaw 是可自托管的个人 AI 助手，运行在你的电脑上，通过 Telegram 等聊天渠道接收消息，调用执行、网页、浏览器能力完成自动化操作。支持接入 DeepSeek、Claude、GPT 等多种模型，数据完全本地化。
Q2：安装需要什么准备？
A：三样东西：一台闲置 Windows 电脑、一个 Telegram 机器人（通过 @BotFather 创建，获取 Bot Token 和用户 ID）、一个 OpenRouter API Key（充值少量余额即可）。
Q3：Windows 上怎么安装？
A：通过 WSL2：先在 PowerShell（管理员）中运行 wsl --install，然后在 Ubuntu 终端执行 curl -fsSL https://openclaw.ai/install.sh | bash。安装后跟随新手向导配置模型和 Telegram 即可。
Q4：怎么开启完整权限？
A：打开 openclaw dashboard，进入 配置 → All Settings → Raw，将 tools profile 从 messaging 改为 full，设置 exec.security 为 full、exec.ask 为 off，保存后 Tools 显示 Full 即成功。
Q5：怎么防止别人使用我的机器人？
A：在控制台 → 频道 → Allow From → Add，添加你的 Telegram 用户 ID（纯数字），保存后只有该账号可使用。
Q6：Telegram 连不上怎么办？
A：在 Ubuntu 中配置代理：设置 PORT 为本地 VPN 端口，获取宿主机 IP，运行 openclaw config set channels.telegram.proxy 设置代理地址，然后 openclaw gateway restart 重启即可。