本文檔為開(kāi)源個(gè)人AI助手平臺(tái)“OpenClaw”（曾用名Clawdbot、Moltbot）的完全使用手冊(cè)。該平臺(tái)于2026年初發(fā)布，憑借其本地優(yōu)先架構(gòu)、強(qiáng)大的自動(dòng)化執(zhí)行能力和豐富的通訊平臺(tái)集成，迅速成為增長(zhǎng)Z快的開(kāi)源項(xiàng)目之一。本手冊(cè)旨在為用戶(hù)提供一份多面的指南，內(nèi)容涵蓋了從項(xiàng)目簡(jiǎn)介、核心特性、海量功能玩法，到針對(duì)國(guó)內(nèi)網(wǎng)絡(luò)環(huán)境的專(zhuān)門(mén)配置、多平臺(tái)的本地部署詳解，以及至關(guān)重要的安全與Z佳實(shí)踐。文檔強(qiáng)調(diào)OpenClaw的核心定位是“用戶(hù)專(zhuān)屬的數(shù)字員工”，能夠通過(guò)自然語(yǔ)言指令操作電腦系統(tǒng)，處理文件、控制瀏覽器、執(zhí)行命令等，適用于個(gè)人知識(shí)管理、團(tuán)隊(duì)協(xié)作及開(kāi)發(fā)者擴(kuò)展等多種場(chǎng)景。

OpenClaw是一款開(kāi)源的個(gè)人AI助手平臺(tái)，其核心價(jià)值在于從理解指令到執(zhí)行任務(wù)的“行動(dòng)”能力，標(biāo)志著AI從“顧問(wèn)”向“數(shù)字員工”的轉(zhuǎn)變。其核心特性與優(yōu)勢(shì)包括：采用本地優(yōu)先架構(gòu)，保障數(shù)據(jù)隱私、支持離線使用并賦予用戶(hù)完全控制權(quán)；支持通過(guò)Telegram、WhatsApp、飛書(shū)、釘釘?shù)缺姸鄧?guó)內(nèi)外主流通訊平臺(tái)進(jìn)行交互；擁有以自然語(yǔ)言描述即可創(chuàng)建新技能的“技能插件系統(tǒng)”（Skills），生態(tài)中有超過(guò)3000個(gè)社區(qū)技能；以及具備基于Markdown文件的持久化記憶能力。自2026年1月發(fā)布后，其GitHub星標(biāo)數(shù)在短時(shí)間內(nèi)快速增長(zhǎng)至18萬(wàn)以上，擁有活躍的開(kāi)發(fā)者社區(qū)和技能市場(chǎng)。該平臺(tái)適用于個(gè)人用戶(hù)進(jìn)行知識(shí)管理、日程處理，團(tuán)隊(duì)用于智能客服、運(yùn)維監(jiān)控，以及開(kāi)發(fā)者進(jìn)行技能開(kāi)發(fā)和原型驗(yàn)證。

本地部署指南

本章提供了在不同操作系統(tǒng)和環(huán)境下部署OpenClaw的詳細(xì)指南。先明確了運(yùn)行OpenClaw所需的硬件（Z低2核CPU、4GB內(nèi)存）和軟件（Node.js 22+等）依賴(lài)。針對(duì)Windows系統(tǒng)，提供了通過(guò)PowerShell安裝腳本或更推薦的WSL2子系統(tǒng)的部署方法。對(duì)于macOS用戶(hù)，推薦使用Homebrew進(jìn)行安裝，并針對(duì)Mac Mini和Apple Silicon芯片提供了優(yōu)化建議和本地模型運(yùn)行推薦。Linux部分則涵蓋了Ubuntu/Debian和CentOS/RHEL的安裝命令及服務(wù)器優(yōu)化設(shè)置（如配置Swap空間）。文檔強(qiáng)烈推薦使用Docker進(jìn)行部署，以獲取干凈隔離的環(huán)境，并給出了使用官方鏡像、Docker Compose以及國(guó)內(nèi)鏡像的詳細(xì)命令。對(duì)于云服務(wù)器部署，介紹了阿里云和騰訊云的一鍵部署或預(yù)裝鏡像方案，并對(duì)比了不同云平臺(tái)的特點(diǎn)。此外，本章還介紹了配置文件的結(jié)構(gòu)和優(yōu)化選項(xiàng)，如模型故障轉(zhuǎn)移配置、內(nèi)存優(yōu)化技巧以及定期的備份與恢復(fù)策略。

安全與Z佳實(shí)踐

本章重點(diǎn)闡述了使用OpenClaw時(shí)需要關(guān)注的安全問(wèn)題及防護(hù)措施。文檔先分析了主要安全風(fēng)險(xiǎn)，包括高風(fēng)險(xiǎn)的遠(yuǎn)程代碼執(zhí)行、提示詞注入和憑證泄露，并引用數(shù)據(jù)指出有超過(guò)42,000個(gè)實(shí)例暴露在公網(wǎng)且多數(shù)存在驗(yàn)證漏洞。攻擊場(chǎng)景包括公網(wǎng)暴露、通過(guò)PDF/網(wǎng)頁(yè)的間接提示詞注入以及安裝惡意技能。為此，文檔提供了一系列安全加固措施：在網(wǎng)絡(luò)安全上，應(yīng)避免將默認(rèn)端口（18789）暴露于公網(wǎng)，并通過(guò)VPN訪問(wèn)或修改端口；在系統(tǒng)安全上，應(yīng)以非root專(zhuān)用用戶(hù)運(yùn)行，或使用Docker進(jìn)行權(quán)限隔離；在應(yīng)用安全上，需及時(shí)更新軟件并嚴(yán)格審查所安裝技能的來(lái)源。權(quán)限管理應(yīng)遵循Z小權(quán)限原則，并利用平臺(tái)的配對(duì)驗(yàn)證功能和允許用戶(hù)列表來(lái)限制訪問(wèn)。Z后，應(yīng)建立監(jiān)控與審計(jì)機(jī)制，包括啟用詳細(xì)日志、監(jiān)控異常行為（如高頻API調(diào)用、大量文件操作）以及定期進(jìn)行安全審計(jì)（檢查端口、憑證、更新依賴(lài)等）。

附件：OpenClaw 完全使用手冊(cè)-所需的硬件依賴(lài),部署方法,配置文件的結(jié)構(gòu)和優(yōu)化選項(xiàng)