什么是 OpenClaw？OpenClaw 是一個(gè)可自托管的個(gè)人 AI 助手。
它可以運(yùn)行在你自己的電腦上并通過 Telegram 等聊天渠道接收消息,再調(diào)用執(zhí)行、網(wǎng)頁、瀏覽器等能力，幫你完成各種自動(dòng)化操作
這篇教程適合零基礎(chǔ)新手，跟著步驟一步步操作即可完成安裝
預(yù)計(jì)耗時(shí)：1～2 小時(shí)

開始前需要準(zhǔn)備什么？

在正式開始之前，請(qǐng)先準(zhǔn)備好以下內(nèi)容：
●一臺(tái)閑置的電腦
●注冊(cè)一個(gè)Telegram機(jī)器人，并保存Bot Token
同時(shí)獲取自己的Telegram用戶ID（后續(xù)配置白名單會(huì)用到）
●注冊(cè)一個(gè)大模型API平臺(tái)賬號(hào)，并先充值少量余額

一、注冊(cè)Telegram機(jī)器人教程

1.打開Telegram，搜索并進(jìn)入 @BotFather
2.給@BotFather 發(fā)送命令：/newbot
3.按提示依次輸入兩項(xiàng)信息：
•機(jī)器人顯示名：用戶看到的名字
•機(jī)器人用戶名：用于搜索
機(jī)器人用戶名規(guī)則：只能使用 英文字母、數(shù)字、下劃線，必須以 bot 結(jié)尾
例如：my_xiaoc752_bot 或 Myxiaoc752Bot
4.創(chuàng)建成功后，會(huì)發(fā)你一串Token，格式類似：123456789:AA......
這串 Token 一定要保存好，后面配置Telegram時(shí)會(huì)用到

注冊(cè)Telegram機(jī)器人教程

二、獲取自己的Telegram用戶ID

1.打開 Telegram搜索并進(jìn)入以下任意一個(gè)機(jī)器人：@userinfobot 或 @GetMyID_bot
2.點(diǎn)擊 開始 / Start3.機(jī)器人會(huì)自動(dòng)回復(fù)你的賬號(hào)信息，其中會(huì)顯示你的 Telegram 用戶 ID
4.把這串純數(shù)字復(fù)制并保存，后面配置白名單時(shí)會(huì)用到

獲取自己的 Telegram 用戶 ID

三、注冊(cè)一個(gè)大模型API平臺(tái)賬號(hào)

這里推薦使用OpenRouter，它支持用一個(gè)API key接入多種模型，比較適合新手使用。

1.打開網(wǎng)站：https://openrouter.ai/
2.注冊(cè)一個(gè)賬戶并登錄，然后創(chuàng)建一個(gè)API，先充值少量余額，創(chuàng)建的key要保存下來

四、正式開始安裝

第一步：安裝 WSL2+Ubuntu

1.開始菜單搜索 PowerShell → 以管理員身份運(yùn)行2.在 owerShell 中輸入以下命令安裝
wsl --install

搜索 PowerShell → 以管理員身份運(yùn)行

輸入以下命令安裝
wsl --install

第二步：在開始菜單打開 Ubuntu

首次打開時(shí)，系統(tǒng)會(huì)提示你設(shè)置：
Linux 用戶名（可自行設(shè)置）
Linux 密碼（輸入密碼時(shí)不會(huì)顯示字符，正常情況，輸完后按回車）

第三步：在 Ubuntu 里安裝 OpenClaw

注意：下面這條命令需要在 Ubuntu 終端 中執(zhí)行，不是在 PowerShell 中執(zhí)行

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

輸入后等待安裝完成，一般需要幾分鐘

第四步：安裝完成后，進(jìn)入新手向?qū)?/h3>

1. 確認(rèn)安裝方式出現(xiàn)下面這句提示時(shí)：
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
這里選擇 YES，然后按回車，可以使用鍵盤方向鍵進(jìn)行選擇。

選擇 YES

2. 選擇安裝模式：QuickStart

3. 選擇模型提供商：OpenRouter接著選擇：Paste API key now然后粘貼你前面準(zhǔn)備好的 OpenRouter API Key模型選擇，這里我選擇的是：DeepSeek V3.1

選擇：OpenRouter

接著選擇：Paste API key now

粘貼你前面準(zhǔn)備好的 OpenRouter API Key

模型可以按自己的需求選擇

4. 配置聊天渠道聊天渠道這里選擇：Telegram然后選擇：Enter Telegram bot token接著輸入你前面保存好的 Telegram Bot Token

選擇：Telegram

選擇：Enter Telegram bot token

接著輸入你前面保存好的 Telegram Bot Token

5. Skills 配置出現(xiàn)下面這個(gè)選項(xiàng)時(shí)：Configure skills now?
這里建議先選擇：NO 后面有需要再安裝即可。
注意：這一項(xiàng)通常需要先按空格選中，再按回車確認(rèn)

6. 其他配置項(xiàng)后續(xù)如果出現(xiàn)需要填寫額外 API Key 的地方，先全部選擇：NO

全部選擇：NO

7.安裝完成后，可以在 Ubuntu 中輸入：

openclaw dashboard

這會(huì)打開 OpenClaw 的控制面板。

第五步：給 OpenClaw 開啟完整權(quán)限+設(shè)置白名單

1.打開網(wǎng)頁版控制臺(tái)，如果之前沒有打開，可以在 Ubuntu 中輸入：

openclaw dashboard

2. 進(jìn)入配置頁面進(jìn)入控制臺(tái)后：選擇 配置點(diǎn)擊 All Settings在下方選擇 Raw

點(diǎn)擊紅框標(biāo)注的地方

3. 修改工具權(quán)限把原來的：

"tools": {
"profile": "messaging"
}

替換為：

"tools": {
"profile": "full",
"exec": {
"host": "gateway",
"security": "full",
"ask": "off"
},
"web": {
"fetch": {
"enabled": true
}
}
},

替換后點(diǎn)Save保存

保存后即可生效。

點(diǎn)擊Tools這邊出現(xiàn)Full就是設(shè)置完成了

這表示把工具配置從僅消息模式改成完整模式，并把本機(jī)執(zhí)行權(quán)限開到最高，同時(shí)關(guān)閉逐次確認(rèn)。

4.給 Telegram 機(jī)器人設(shè)置白名單

為了防止別人隨意使用你的機(jī)器人，建議開啟白名單功能
開啟后，只有被添加到白名單里的 Telegram 用戶，才能給機(jī)器人發(fā)送指令并正常使用
設(shè)置方法打開 OpenClaw 控制臺(tái)點(diǎn)擊 頻道找到 Allow From點(diǎn)擊 Add添加你自己的 Telegram 用戶 ID滑到最下方點(diǎn)Save 保存設(shè)置設(shè)置完成后，只有這個(gè) Telegram ID 對(duì)應(yīng)的賬號(hào)可以使用該機(jī)器人。
注意：這里填寫的是 Telegram 用戶 ID（純數(shù)字），不是用戶名

給 Telegram 機(jī)器人設(shè)置白名單

第六步：給 Telegram 配置代理

只有在你發(fā)現(xiàn) Telegram 連不上、收不到消息，再配置這一項(xiàng)
1. 查看你的 梯子 代理端口先確認(rèn)你本地代理軟件的端口號(hào)

查看端口號(hào)

2. 在 Ubuntu 中執(zhí)行以下命令把下面的 你的端口數(shù)字 改成你自己的實(shí)際端口（很重要，記得修改你的端口數(shù)字）

PORT=你的端口數(shù)字
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.然后輸入代碼重啟

openclaw gateway restart
openclaw logs --follow

4.打開Telegram，給你的機(jī)器人發(fā)一條消息，測(cè)試是否可以正常聊天到這里，OpenClaw 就安裝完成了。

OpenClaw 常用操作指令

啟動(dòng)與運(yùn)行

openclaw gateway 啟動(dòng)網(wǎng)關(guān)服務(wù)（核心，必須運(yùn)行）

openclaw gateway start 后臺(tái)啟動(dòng)網(wǎng)關(guān)

openclaw gateway stop 停止網(wǎng)關(guān)

openclaw gateway restart 重啟服務(wù)

openclaw gateway status 查看 Gateway 狀態(tài)

openclaw tui 啟動(dòng)終端

openclaw dashboard 打開控制面板（可視化界面）

配置管理

openclaw onboard 首次引導(dǎo)

openclaw setup 初始化

openclaw configure 交互式配置（設(shè)置憑據(jù)、設(shè)備等）

openclaw config get 查看當(dāng)前配置

openclaw config set 設(shè)置配置項(xiàng)

openclaw config validate 校驗(yàn)配置文件

渠道管理（連接各種聊天平臺(tái)）

openclaw channels add 添加渠道

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

openclaw channels list 查看已連接的渠道

openclaw channels logout 退出渠道

消息發(fā)送

openclaw message send 發(fā)送消息

openclaw message broadcast 群發(fā)消息

狀態(tài)與診斷

openclaw status 查看狀態(tài)（渠道健康度、最近會(huì)話）

openclaw gateway status 查看網(wǎng)關(guān)狀態(tài)

openclaw health 檢查網(wǎng)關(guān)健康狀態(tài)

openclaw doctor 診斷問題 + 自動(dòng)修復(fù)

openclaw logs 查看日志

技能與插件

openclaw skills 技能管理（安裝、更新、刪除）

openclaw plugins 插件管理

openclaw skills install <skill> 安裝技能

openclaw skills list 列出已安裝技能

記憶與會(huì)話

openclaw sessions 列出歷史會(huì)話

openclaw memory 搜索記憶內(nèi)容

openclaw agents 管理獨(dú)立代理

定時(shí)任務(wù)

openclaw cron 定時(shí)任務(wù)管理

openclaw cron list 查看定時(shí)任務(wù)

openclaw cron add 添加定時(shí)任務(wù)

瀏覽器與節(jié)點(diǎn)

openclaw browser 控制瀏覽器（自動(dòng)化）

openclaw nodes 管理連接的節(jié)點(diǎn)（手機(jī)等）

openclaw node 單個(gè)節(jié)點(diǎn)控制

工具類

openclaw update 更新 CLI

openclaw reset 重置配置（保留 CLI）

openclaw uninstall 完全卸載

最新評(píng)論