《OpenClaw新手入門寶典》是由九章云極智能研究院于2026年3月發布的系統化教程,旨在幫助零基礎用戶多面了解、安裝并熟練使用OpenClaw。OpenClaw是一個本地優先的AI智能體平臺,其核心價值在于為大型語言模型賦予“動手執行”的能力,使其從聊天助手升J為能操作文件、瀏覽器、終端等系統的“數字員工”。文檔內容結構清晰,循序漸進,涵蓋了從概念認知、環境準備、安裝部署、接入常用辦公軟件(飛書/微信),到深入理解其核心組件Skill的原理與實戰的完整路徑,Z終目標是讓用戶能夠部署屬于自己的AI全能助手,并利用其自動化處理各類重復性任務。
本部分詳細說明了部署OpenClaw所需滿足的軟硬件及網絡環境。官方支持的操作系統包括Linux、macOS、Windows以及云容器實例,其中Windows用戶被強烈建議使用WSL2以避免兼容性問題。核心軟件依賴包括需要安裝Node.js 22.x或更高版本、Git以及一個模型后端,模型后端可選擇云端API或本地服務。網絡方面,使用云端模型需能穩定訪問相應API,使用本地模型則可離線運行。系統默認開放18789端口用于WebSocket通信。安全上要求本地部署需管理員權限,并建議啟用官方權限過濾策略。文檔為新手提供了快速部署建議,即使用官方提供的一鍵安裝腳本。同時,也給出了免部署的替代方案,即直接使用九章智算云提供的OpenClaw托管服務。
本部分以圖文并茂的形式,一步步引導用戶完成OpenClaw的安裝與初步使用。先指導用戶檢查并確保安裝正確版本的Node.js。隨后,通過一行命令npm install -g openclaw@latest進行全局安裝。安裝成功后,運行openclaw onboard --install-daemon命令啟動初始化向導。向導會交互式地引導用戶完成核心配置:包括選擇快速啟動模式、配置模型提供商(文檔示例為MiniMax)并輸入API Key、跳過或配置聊天渠道、選擇安裝必要的Hooks鉤子。關鍵一步是選擇訪問方式,文檔示例選擇了“Open the Web UI”,以便通過瀏覽器訪問OpenClaw的控制面板。配置完成后,在Web UI或終端中即可與OpenClaw進行次對話測試。文檔Z后還列出了Gateway啟動失敗、發送消息無回復、Web UI打不開等常見問題的排查思路與解決方法。
本部分詳細講解了如何將OpenClaw機器人接入飛書,實現通過飛書對話操控AI執行任務。整個流程分為四個明確步驟。D一步,在飛書開放平臺創建企業自建應用,獲取App ID和App Secret,并為應用添加機器人能力、配置消息接收權限,Z后發布應用。第二步,在OpenClaw側啟用feishu插件,并通過openclaw channels add命令交互式地添加飛書渠道,輸入從飛書平臺獲取的憑證。第三步,回到飛書開放平臺,在應用的事件與回調中啟用“長連接”事件訂閱,并確保已訂閱“接收消息”事件。文檔特別強調了操作順序的重要性,需要在OpenClaw網關啟動且配置好渠道后,才能在飛書平臺開啟長連接。第四步,在飛書客戶端中找到該應用,次交互時會收到一個配對碼,需在OpenClaw命令行中完成配對驗證,之后即可在飛書中正常@機器人或私聊發送指令。
本部分介紹了通過企業微信間接實現微信接入OpenClaw的方案。由于微信官方接口限制,此方案需先注冊一個企業微信,并在其中創建自建應用。核心步驟包括:在企業微信后臺創建應用并記錄AgentId和Secret;在應用內配置API接收地址,該地址需為公網可訪問的URL,并設置Token和EncodingAESKey;在OpenClaw中安裝專門的@openclaw-china/wecom-app插件,并在配置文件中填入企業微信的相關憑證和API接收配置;重啟OpenClaw網關后,回到企業微信完成API地址的保存。Z后,在企業微信后臺開啟“微信插件”并掃碼關注,即可在個人微信中收到一個企業微信消息入口,通過此入口即可與背后的OpenClaw機器人對話。文檔指出,此方案需要公網IP,因此本地部署可能無法滿足,并推薦使用其云容器實例產品。
本部分深入剖析了OpenClaw擴展能力的核心——Skill。Skill被定義為一個包含指令的文件夾,用于教AI如何處理特定任務,其價值在于“一次編寫,永久復用”,能標準化工作流并降低使用門檻。一個Skill文件夾的核心是SKILL.md文件,其中包含YAML元數據和自然語言編寫的詳細指令。文檔用廚房比喻區分了Skill和MCP:MCP像是提供工具和食材的廚房,負責連接外部服務;而Skill則是食譜,指導AI如何有效使用這些工具。Skill的設計遵循三大核心原則:漸進式披露以優化Token消耗、可組合性以支持多技能協同、可移植性以跨平臺使用。常見的Skill用例分為文檔與資源創建、工作流自動化、MCP增強三類。技術規范部分詳細規定了Skill的文件結構、命名規則,并重點說明了SKILL.md中YAML前置元數據的必需字段和格式。
本部分通過具體示例演示了Skill的創建、安裝與使用。先,通過一個“字幕轉markdown”的簡單Skill示例,展示了從創建文件夾、編寫SKILL.md到在Claude中加載并成功調用的全過程。接著,介紹了如何從ClawHub、skill4agent等資源站點搜索和安裝現有的社區Skill。文檔還說明了如何使用openclaw skills list等命令檢查和管理已安裝的Skill。重點展示了如何利用“skill-creator”這個Skill,通過自然語言對話來創建新的Skill。之后,以“daily-report”Skill為例,說明了在OpenClaw中調用Skill的幾種方式。Z后,文檔提供了一份詳盡的推薦Skill清單,分為核心必備、效率工具、內容創作、社媒運營和設備聯動五大類,并列舉了如文件處理、瀏覽器自動化、日程管理、知識庫同步等大量實用技能。
文檔在Z后部分匯總了與OpenClaw相關的大量官方與社區資源鏈接,為用戶提供了延伸學習和問題解決的入口。其中包括OpenClaw的官方文檔、GitHub倉庫、技能市場,以及Discord、Reddit、Hacker News等社區討論區。此外,還列出了多家科技媒體對OpenClaw及其創始人動態的新聞報道,以及項目版本更新日志的追蹤地址,幫助用戶保持對項目Z新進展和安全更新的關注。

![]() |
| 機器人底盤 Disinfection Robot 消毒機器人 講解機器人 迎賓機器人 移動機器人底盤 商用機器人 智能垃圾站 智能服務機器人 大屏機器人 霧化消毒機器人 展廳機器人 服務機器人底盤 具身智能教育機器人 智能配送機器人 導覽機器人 |