OpenClaw核心官網入口
OpenClaw 官方主頁:https://openclaw.ai/
官方文檔中心:https://docs.openclaw.ai/ (推薦,包含完整安裝、配置、技能開發指南)
GitHub 倉庫(最新源碼):https://github.com/openclaw/openclaw
技能市場(ClawHub):https://clawhub.com/ (100 + 社區開發的技能,如 Todoist 集成、財務跟蹤)
Discord 社區(技術支持):https://discord.com/invite/clawd (8,900 + 成員,實時問題解答)
重要提示:OpenClaw 是 Clawdbot(2026 年 1 月 27 日更名為 Moltbot)的最終品牌名稱,于 1 月 30 日正式確定。原 Clawdbot(https://clawd.bot/)和 Moltbot(https://molt.bot/)官網會自動跳轉至 OpenClaw 最新頁面,建議優先訪問上述官方資源。
OpenClaw在線使用指南
1. 官方核心文檔資源(推薦優先閱讀)
文檔類型 鏈接 適用場景
快速入門向導 https://docs.openclaw.ai/getting-started 5 分鐘完成基礎安裝與首次交互
消息平臺配置 https://docs.openclaw.ai/channels WhatsApp/Telegram/Discord 等平臺配對教程
模型配置指南 https://docs.openclaw.ai/models 云端 API(Claude/OpenAI)與本地模型(Ollama)設置
主動消息功能 https://docs.openclaw.ai/features/proactive-messaging 提醒、警報、每日簡報等主動通知配置
安全最佳實踐 https://docs.openclaw.ai/security DM 配對、Docker 沙箱、權限管控等安全設置
中文文檔(社區維護) https://holtchas.github.io/openclaw-docs-zh/ 適合國內用戶的中文教程
2. 5 分鐘快速上手流程(零基礎用戶推薦)
前置條件(必須滿足)
操作系統:macOS、Linux、Windows(僅支持 WSL2,不支持原生 Windows)
Node.js ≥22.0.0(核心依賴,低版本會導致安裝失敗)
AI 模型支持:Claude Pro/Max API 密鑰、OpenAI API 密鑰或 Ollama 本地模型(二選一)
安裝與初始化命令(直接復制執行)
bash
運行
# 1. 全局安裝最新版OpenClaw(兼容Clawdbot/Moltbot所有指令)
npm install -g openclaw@latest
# 2. 一鍵啟動官方初始化向導(自動配置網關、工作空間、消息平臺)
openclaw onboard --install-daemon
# 3. 消息平臺配對(選擇WhatsApp/Telegram等,按提示完成)
openclaw channels login
# 4. 啟動核心網關服務(默認端口18789)
openclaw gateway --port 18789
# 5. 驗證安裝成功(通過配對的消息平臺發送)
消息內容:嗨,你能做什么?
向導交互關鍵步驟
同意用戶協議
選擇安裝模式(推薦quickstart快速模式)
配置 AI 模型(輸入 API 密鑰或選擇本地模型)
選擇消息平臺(優先 WhatsApp/Telegram,操作簡單)
開啟守護進程(推薦,實現后臺自動運行)
3. 核心功能使用指南(常用場景)
(1)消息平臺配對詳細教程
平臺 配對步驟 關鍵注意事項
WhatsApp 1. 執行openclaw channels login→選擇 WhatsApp
2. 終端生成二維碼
3. 手機 WhatsApp「設置 - 鏈接設備」掃描二維碼 確保手機與電腦在同一局域網,二維碼有效期 2 分鐘
Telegram 1. 執行openclaw channels login→選擇 Telegram
2. 輸入 BotFather 獲取的 Bot Token
3. 發送/start到機器人完成配對 需先在 Telegram 搜索 @BotFather 創建機器人獲取 Token
Discord 1. 執行openclaw channels login→選擇 Discord
2. 輸入 Bot Token
3. 邀請機器人到服務器 需在 Discord 開發者平臺創建應用并添加 Bot 權限
(2)本地模型配置(無需云端 API,完全私有化)
安裝 Ollama(本地大模型運行環境):https://ollama.com/
拉取支持工具調用的模型:ollama pull glm-4:7b-flash
修改 OpenClaw 配置文件:
json
{
"agent": {
"model": "ollama/glm-4:7b-flash",
"endpoint": "http://127.0.0.1:11434/v1", // Ollama默認端點
"apiKey": "ollama" // 固定值,無需修改
}
}
重啟網關:openclaw gateway restart
(3)常用命令速查(高效管理)
bash
運行
openclaw status # 檢查服務狀態
openclaw health # 系統健康檢查
openclaw logs --follow # 實時查看日志
openclaw configure # 交互配置工具
openclaw skills list # 查看已安裝技能
openclaw daemon start # 啟動守護進程
4. 本地 Web UI 使用(可視化管理)
安裝成功并啟動網關后,通過瀏覽器訪問:
Web 控制臺:http://127.0.0.1:18789/ (管理會話、查看狀態、調試)
Web 聊天界面:http://127.0.0.1:18789/webui (直接與 AI 助手交互,無需消息平臺)
5. 常見問題排查(快速解決)
Node.js 版本過低:提示Unsupported engine → 通過 nvm 安裝 Node.js 22+
bash
運行
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 22 && nvm use 22
端口 18789 被占用:提示EADDRINUSE → 更換端口:openclaw gateway --port 18790
WhatsApp 配對失敗:二維碼掃描無反應 → 關閉網關后重新執行openclaw channels login
npm 安裝權限不足:提示Permission denied → 添加--unsafe-perm參數:
bash
運行
npm install -g openclaw@latest --unsafe-perm
三、兼容性說明(與 Clawdbot/Moltbot)
指令兼容:安裝 OpenClaw 后,舊指令moltbot、clawdbot仍可使用(為兼容舊腳本保留的別名)
bash
運行
moltbot gateway # 等價于 openclaw gateway
clawdbot channels login # 等價于 openclaw channels login
配置文件遷移:Clawdbot/Moltbot 的配置文件可直接復制到 OpenClaw 配置目錄
bash
運行
cp ~/.clawdbot/moltbot.json ~/.openclaw/config/openclaw.json
功能完全兼容:OpenClaw 保留了 Clawdbot/Moltbot 的所有核心功能,并新增了更多模型支持和安全特性
四、進階學習資源
技能開發指南:https://docs.openclaw.ai/skills-development (創建自定義技能)
多代理編排:https://docs.openclaw.ai/agents/multi-agent (多個 AI 代理協作完成復雜任務)
Docker 部署:https://docs.openclaw.ai/deployment/docker (容器化部署,提升安全性)
中文社區教程:https://www.howtouseopenclaw.com/zh (適合國內用戶的詳細指南)
本資訊來自互聯網,如有侵權強聯系刪除~