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

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

本地部署指南

本章提供了在不同操作系統(tǒng)和環(huán)境下部署OpenClaw的詳細(xì)指南。先明確了運(yùn)行OpenClaw所需的硬件（Z低2核CPU、4GB內(nèi)存）和軟件（Node.js 22+等）依賴。針對Windows系統(tǒng)，提供了通過PowerShell安裝腳本或更推薦的WSL2子系統(tǒng)的部署方法。對于macOS用戶，推薦使用Homebrew進(jìn)行安裝，并針對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以及國內(nèi)鏡像的詳細(xì)命令。對于云服務(wù)器部署，介紹了阿里云和騰訊云的一鍵部署或預(yù)裝鏡像方案，并對比了不同云平臺的特點(diǎn)。此外，本章還介紹了配置文件的結(jié)構(gòu)和優(yōu)化選項(xiàng)，如模型故障轉(zhuǎn)移配置、內(nèi)存優(yōu)化技巧以及定期的備份與恢復(fù)策略。

安全與Z佳實(shí)踐

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

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