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

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

本地部署指南

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

安全與Z佳實踐

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

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