OpenClaw入門(mén)教程之介紹與安裝、配置分享 (原Clawdbot)
OpenClaw(原名 Clawdbot,過(guò)渡名 Moltbot)是 2026 年 1 月突然爆火的開(kāi)源個(gè)人 AI 助手項(xiàng)目,由 Peter Steinberger(PSPDFKit 創(chuàng)始人)開(kāi)發(fā)。
OpenClaw 是一個(gè)可執(zhí)行任務(wù)的智能體,我們給指令,它不僅回答,還能主動(dòng)操作系統(tǒng)、訪問(wèn)網(wǎng)頁(yè)、處理郵件、整理文件、發(fā)起提醒甚至自動(dòng)編寫(xiě)代碼。
OpenClaw 是一個(gè)把 本地算力 + 大模型 Agent 自動(dòng)化 玩到極致的開(kāi)發(fā)者效率工具。
OpenClaw 目標(biāo)是讓 AI 不只是給建議,而是直接完成完整工程任務(wù)。
因?yàn)?Anthropic 在 1 月 27 日發(fā)律師函稱(chēng) Clawd / Clawdbot與 Claude 太像,項(xiàng)目在當(dāng)天緊急更名為 Moltbot(脫皮龍蝦之意,吉祥物是小龍蝦 Molty ??),但功能完全一致,舊命令 clawdbot 仍然兼容。
Moltbot 是項(xiàng)目組為了應(yīng)對(duì)侵權(quán)風(fēng)險(xiǎn)想出的過(guò)渡名字,OpenClaw 這是目前的最終官方名稱(chēng)。
- OpenClaw 官網(wǎng): https://openclaw.ai/
- Github 地址:https://github.com/openclaw/openclaw
- OpenClaw 技能合集: https://github.com/VoltAgent/awesome-openclaw-skills
Clawbot、Moltbot 和 OpenClaw 其實(shí)是同一個(gè)開(kāi)源項(xiàng)目,名字演進(jìn)順序?yàn)椋?/p>
Clawdbot → Moltbot → OpenClaw
| 名稱(chēng) | 時(shí)間線 | 背景/原因 | 本質(zhì)關(guān)系 |
|---|---|---|---|
| Clawdbot / Clawbot | 2025 年末至 2026 年 1 月初 | 最初項(xiàng)目名;靈感來(lái)自 Claude 和 claw(龍蝦爪)梗 | 原始名稱(chēng),是最早出現(xiàn)在 GitHub 的身份 |
| Moltbot | 2026 年 1 月 27 日 | 因 Anthropic 商標(biāo)顧慮被要求更名 | 中間過(guò)渡名字;功能、代碼與 Clawdbot 一致 |
| OpenClaw | 2026 年 1 月 30 日之后 | 拋棄版權(quán)沖突、強(qiáng)調(diào)開(kāi)源性/長(zhǎng)線品牌 | 當(dāng)前官方名稱(chēng),也是今后文檔、倉(cāng)庫(kù)等統(tǒng)一標(biāo)識(shí) |
OpenClaw安裝方法
OpenClaw 的安裝被設(shè)計(jì)得極為友好,即使是非開(kāi)發(fā)者也能快速上手。
系統(tǒng)要求(不一定 Mac mini但推薦使用mac mini上手容易,錯(cuò)誤少,就是成本略高,現(xiàn)在mac mini 16+256G已經(jīng)3800一臺(tái)了之前2800左右):
- 硬件:極低,2GB RAM 即可運(yùn)行。
- 環(huán)境:支持 Mac, Windows, Linux,需要安裝 Node.js (pnpm) 或使用 Docker。
1、推薦安裝方式(一鍵腳本):
直接通過(guò)終端,執(zhí)行以下命令。
macOS/Linux 系統(tǒng):
curl -fsSL https://openclaw.ai/install.sh | bash
Windows 系統(tǒng):
#PowerShell iwr -useb https://openclaw.ai/install.ps1 | iex #CMD curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
這會(huì)自動(dòng)安裝 Node.js(≥22)并完成基本配置。
2、手動(dòng)安裝
需要 Node.js ≥22并完成基本配置。
使用 npm:
npm i -g openclaw
或使用 pnpm:
pnpm add -g openclaw
安裝完成后,初始化并安裝后臺(tái)服務(wù)(launchd / systemd 用戶(hù)服務(wù)):
openclaw onboard
3、從源碼安裝(開(kāi)發(fā)模式)
git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm ui:build # 首次運(yùn)行會(huì)自動(dòng)安裝 UI 相關(guān)依賴(lài)并構(gòu)建前端界面 pnpm build # 構(gòu)建整個(gè)項(xiàng)目(包含后端與相關(guān)模塊) # 初始化 OpenClaw 并安裝為系統(tǒng)后臺(tái)服務(wù)(開(kāi)機(jī)自動(dòng)運(yùn)行) pnpm openclaw onboard --install-daemon # 開(kāi)發(fā)模式:監(jiān)聽(tīng) TypeScript 代碼變更并自動(dòng)重載網(wǎng)關(guān)服務(wù) pnpm gateway:watch
配置說(shuō)明
我們推薦使用一鍵腳本安裝。
macOS/Linux 系統(tǒng):
curl -fsSL https://openclaw.ai/install.sh | bash
Windows 系統(tǒng):
#PowerShell iwr -useb https://openclaw.ai/install.ps1 | iex #CMD curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
它會(huì)完成環(huán)境檢測(cè),并且安裝必要的依賴(lài),還會(huì)啟動(dòng) onboarding 流程。

然后,會(huì)提醒你這個(gè)龍蝦能力很強(qiáng),當(dāng)然風(fēng)險(xiǎn)也很大,我們選 yes(no 就不安裝了) 就好了:

接下來(lái)我們就選快速啟動(dòng) QuickStart 選項(xiàng):

接下來(lái)我們需要配置一個(gè)大模型,Model/Auth Provider 選擇 AI 供應(yīng)商,國(guó)內(nèi)外的供應(yīng)商基本都支持。

如果沒(méi)有海外的賬號(hào),配置咱們國(guó)內(nèi)的 Qwen、MiniMax、智譜的 API key 也是可以的。
然后會(huì)出現(xiàn)選擇聊天工具的選項(xiàng),海外的一般都沒(méi)有可以選最后一個(gè):國(guó)內(nèi)可以選擇飛書(shū)

其他配置,比如端口的設(shè)置 Gateway Port,按默認(rèn)的 18789 即可,比如 Skills、包的安裝管理器選 npm 或其他,可以一路 Yes 下去。

選一些自己喜歡的 skills,也可以直接跳過(guò),使用空格按鍵選擇:

這些 API key,沒(méi)有的直接選 no:

最后這三個(gè)鉤子可以開(kāi)啟,主要做內(nèi)容引導(dǎo)日志和會(huì)話記錄:

安裝完后,就會(huì)自動(dòng)訪問(wèn) http://127.0.0.1:18789/chat,就可以打開(kāi)聊天界面讓它開(kāi)始工作。
比如搜索最新的科技新聞:

啟動(dòng)后,我們可以使用 openclaw status 命令查看狀態(tài):
openclaw status
常用命令
openclaw gateway # 運(yùn)行 WebSocket 網(wǎng)關(guān)服務(wù)(可加 --port 指定端口) openclaw gateway start # 啟動(dòng) openclaw gateway stop # 停車(chē) openclaw gateway restart # 重啟 openclaw channels login # WhatsApp QR 配對(duì)登錄 openclaw channels add # 添加 Telegram/Discord/Slack 機(jī)器人(可加 --token) openclaw channels status --probe # 檢查通道健康狀態(tài) openclaw onboard # 交互式設(shè)置向?qū)В杉?--install-daemon) openclaw doctor --deep # 健康檢查與快速修復(fù) openclaw config get|set|unset # 讀取 / 寫(xiě)入配置值 openclaw models list|set|status # 模型管理與認(rèn)證狀態(tài) openclaw models auth setup-token # Anthropic 認(rèn)證流程設(shè)置
通道管理
- WhatsApp:
openclaw channels login(或掃描 QR) - Telegram:
openclaw channels add --channel telegram(需 Bot Token) - Discord:
openclaw channels add --channel discord(需 Bot Token) - iMessage:macOS 原生橋接
- Slack:
openclaw channels add --channel slack(需 Bot Token)
工作區(qū)結(jié)構(gòu)(Workspace Anatomy)
AGENTS.md:指令說(shuō)明USER.md:偏好設(shè)置MEMORY.md:長(zhǎng)期記憶HEARTBEAT.md:檢查清單SOUL.md:人格/語(yǔ)氣IDENTITY.md:名稱(chēng)/主題BOOT.md:?jiǎn)?dòng)配置- 根目錄:
~/.openclaw/workspace
聊天內(nèi)斜杠命令
/status:健康 + 上下文/context list:上下文貢獻(xiàn)者/model <m>:切換模型/compact:釋放窗口空間/new:全新會(huì)話/stop:中止當(dāng)前運(yùn)行/tts on|off:切換語(yǔ)音/think:切換推理模式
關(guān)鍵路徑映射(Essential Path Map)
- 主配置:
~/.openclaw/openclaw.json - 默認(rèn)工作區(qū):
~/.openclaw/workspace/ - 代理狀態(tài)目錄:
~/.openclaw/agents/<cid>/ - OAuth & API 密鑰:
~/.openclaw/credentials/ - 向量索引存儲(chǔ):
~/.openclaw/memory/<cid>.sqlite - 全局共享技能:
~/.openclaw/skills/ - 網(wǎng)關(guān)文件日志:
/tmp/openclaw/*.log
語(yǔ)音與 TTS
- 付費(fèi):OpenAI / ElevenLabs
- 免費(fèi):Edge TTS(無(wú)需 API Key)
- 自動(dòng) TTS:
messages.tts.auto: "always"
內(nèi)存與模型
- 向量搜索:
memory search "X" - 模型切換:
models set <model> - 認(rèn)證設(shè)置:
models auth setup - 日志:
memory/YYYY-MM-DD.md
Hooks 與技能
- ClawHub:
clawhub install <slug> - Hook 列表:
openclaw hooks list
故障排除
- 無(wú) DM 回復(fù) → 配對(duì)列表 → 批準(zhǔn)
- 群組中靜音 → 檢查提及模式配置
- 認(rèn)證過(guò)期 →
models auth setup-token - 網(wǎng)關(guān)關(guān)閉 →
doctor --deep - 內(nèi)存 Bug → 重建內(nèi)存索引
自動(dòng)化與研究
- 瀏覽器:
browser start/screenshot - 子代理:
/subagents list/info - 定時(shí)任務(wù):
cron list/run <cid> - 心跳:
heartbeat.every: "30m"
通過(guò)第三方云直接安裝配置
現(xiàn)在各大平臺(tái)都已經(jīng)支持這個(gè)智能體,如果不想安裝在本機(jī),可以一鍵部署云上OpenClaw:
- 阿里云:https://www.aliyun.com/activity/ecs/clawdbot
- 騰訊云:https://cloud.tencent.com/developer/article/2624973
使用阿里云的輕量級(jí)服務(wù)器安裝:https://www.aliyun.com/activity/ecs/clawdbot。

可以使用它們的鏡像,一鍵安裝:

使用騰訊云的輕量級(jí)服務(wù)器安裝: https://cloud.tencent.com/developer/article/2624973

常用命令
OpenClaw 常用命令如下:
| 命令 | 作用 | 備注 / 參數(shù) |
|---|---|---|
openclaw status | 查看 Gateway 當(dāng)前運(yùn)行狀態(tài) | 包含健康度與上下文信息 |
openclaw health | 健康檢查 | 檢測(cè) core、依賴(lài)與運(yùn)行環(huán)境 |
openclaw doctor | 綜合診斷與修復(fù)建議 | 支持 --deep 深度檢查 |
openclaw onboard | 交互式初始化向?qū)?/td> | 首次使用推薦 |
openclaw onboard --install-daemon | 安裝系統(tǒng)守護(hù)進(jìn)程 | 后臺(tái)常駐運(yùn)行 Gateway |
openclaw onboard --uninstall-daemon | 卸載守護(hù)進(jìn)程 | 不刪除數(shù)據(jù) |
openclaw configure | 交互式配置向?qū)?/td> | 模型、通道、憑據(jù)等 |
openclaw config get <path> | 獲取配置值 | JSON Path |
openclaw config set <path> <value> | 設(shè)置配置項(xiàng) | 支持 JSON5 / raw 文本 |
openclaw config unset <path> | 清除配置項(xiàng) | 移除單個(gè)鍵值 |
openclaw channels list | 列出已登錄通道 | WhatsApp / Telegram / Discord 等 |
openclaw channels login | 登錄新的通道賬號(hào) | 掃碼或授權(quán)流程 |
openclaw channels add | 添加通道 | Telegram / Discord / Slack |
openclaw channels status --probe | 通道健康檢查 | 檢測(cè)連接可達(dá)性 |
openclaw skills list | 列出技能 | 已安裝 / 可用技能 |
openclaw skills info <skill> | 技能詳情 | 參數(shù)、版本信息 |
clawhub install <slug> | 從 ClawHub 安裝技能 | 官方技能市場(chǎng) |
openclaw hooks list | 列出 Hook 列表 | 事件鉤子機(jī)制 |
openclaw plugins list | 列出插件 | 查看已安裝插件 |
openclaw plugins install <id> | 安裝插件 | 例如 @openclaw/voice-call |
openclaw plugins enable <id> | 啟用插件 | 通常需要重啟 Gateway |
openclaw models list | 列出可用模型 | 包含鑒權(quán)狀態(tài) |
openclaw models status | 模型狀態(tài) | 當(dāng)前可用性 |
openclaw models auth setup-token | 模型鑒權(quán)配置 | Cheatsheet 推薦方式 |
openclaw memory search "X" | 搜索長(zhǎng)期記憶 | 向量搜索 |
openclaw memory index | 重建記憶索引 | 修復(fù) memory 異常 |
openclaw logs | 查看日志 | 默認(rèn)聚合輸出 |
openclaw logs --follow | 實(shí)時(shí)日志 | --json / --plain / --limit |
openclaw gateway install | 安裝 Gateway 系統(tǒng)服務(wù) | 注冊(cè)為系統(tǒng)守護(hù)進(jìn)程 |
openclaw gateway start | 啟動(dòng) Gateway 服務(wù) | system service 模式 |
openclaw gateway stop | 停止 Gateway 服務(wù) | |
openclaw gateway restart | 重啟 Gateway 服務(wù) | 配置變更后使用 |
openclaw gateway status | Gateway 系統(tǒng)服務(wù)狀態(tài) | 不同于 openclaw status |
openclaw browser start | 啟動(dòng)瀏覽器代理 | Automation 能力 |
openclaw browser screenshot | 網(wǎng)頁(yè)截圖 | |
openclaw subagents list | 列出子代理 | |
openclaw cron list | 列出定時(shí)任務(wù) | |
openclaw cron run <id> | 執(zhí)行定時(shí)任務(wù) | |
openclaw uninstall | 卸載 Gateway 服務(wù)及數(shù)據(jù) | 官方推薦 |
openclaw uninstall --all --yes --non-interactive | 全自動(dòng)卸載 | 狀態(tài) / workspace / 插件 |
openclaw uninstall --state | 刪除狀態(tài)文件 | 不刪除 workspace |
openclaw uninstall --workspace | 刪除工作區(qū) | agent / workspace 數(shù)據(jù) |
openclaw uninstall --service | 僅卸載系統(tǒng)服務(wù) | 不刪除數(shù)據(jù) |
openclaw uninstall --dry-run | 模擬卸載 | 僅展示結(jié)果 |
為什么最近這么火?
- 真正做到了"像JARVIS一樣":能讀寫(xiě)文件、跑終端命令、操作瀏覽器、收發(fā)郵件、日歷、寫(xiě)代碼、訂機(jī)票、清空收件箱……
- 本地優(yōu)先 + 長(zhǎng)期記憶:所有對(duì)話跨平臺(tái)共享上下文,USER.md 和 memory/ 目錄會(huì)越用越聰明
- 支持幾乎所有大模型:Claude、Gemini、OpenAI、Ollama 本地模型、Pi 等
- 社區(qū)技能生態(tài)爆炸:ClawdHub 上已有 500+ 社區(qū)技能(Slack、Discord、GitHub、瀏覽器控制、macOS UI 自動(dòng)化……)
- 安裝簡(jiǎn)單像 npm install,實(shí)際能力卻很 spicy (開(kāi)發(fā)者原話)

其核心能力包括:
- 將自然語(yǔ)言目標(biāo)拆解為可執(zhí)行步驟
- 自動(dòng)調(diào)用終端命令
- 創(chuàng)建與修改項(xiàng)目文件
- 運(yùn)行代碼并檢測(cè)結(jié)果
- 根據(jù)報(bào)錯(cuò)自動(dòng)修復(fù)
相比 Claude Code/OpenCode 這種代碼補(bǔ)全工具,OpenClaw 更接近一個(gè)具備執(zhí)行權(quán)限的工程型智能體。
- Claude Code 與 OpenCode等 強(qiáng)在代碼質(zhì)量與理解
- OpenClaw 強(qiáng)在自動(dòng)完成整個(gè)工程流程
| 能力維度 | OpenClaw | Claude Code | OpenCode |
|---|---|---|---|
| 任務(wù)規(guī)劃 | 強(qiáng) | 中 | 中 |
| 自動(dòng)執(zhí)行 | 完整 | 部分 | 部分 |
| 自我修復(fù) | 有 | 無(wú) | 無(wú) |
| 工程級(jí)操作 | 強(qiáng) | 強(qiáng) | 中 |
| 本地自動(dòng)化 | 原生支持 | 較弱 | 較弱 |
到此這篇關(guān)于OpenClaw入門(mén)教程之介紹與安裝、配置分享 (原Clawdbot) 的文章就介紹到這了,更多相關(guān)OpenClaw安裝配置內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章

Windows 系統(tǒng)下的 WSL2 中安裝 OpenClaw 的完整詳細(xì)教程
在 Windows 系統(tǒng)下的 WSL2 中安裝 OpenClaw 的完整詳細(xì)教程,你可以讓它運(yùn)行在自己的電腦上,通過(guò) WhatsApp、Telegram、Discord、Slack 等你已經(jīng)在用的聊天軟件與它對(duì)話2026-03-01
本文將詳細(xì)介紹如何在 M1 Mac 安裝和配置OpenClaw 的完整過(guò)程,通過(guò)示例代碼介紹的非常詳細(xì),包括遇到的坑和解決方案,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2026-03-02



