OpenClaw 本地部署详细教程

从零开始搭建你的 AI 私人助手

---

一、什么是 OpenClaw？

OpenClaw 是一个开源的个人 AI 代理平台，让你拥有一个真正属于自己的 AI 助手。不同于传统聊天机器人，OpenClaw 是一个能够持续运行、主动工作、跨平台通信的智能代理。

核心特性：

🤖 持久化 AI 代理
像真正的助手一样持续运行，随时待命，主动帮你处理事务。

💬 多平台通信
支持 Telegram、WhatsApp、Discord、Signal、iMessage 等多种平台。

🔧 技能系统
可扩展的技能架构，能力几乎无限——从天气查询到代码执行，应有尽有。

⏰ 定时任务
内置 cron 系统，支持定时提醒和自动任务，心跳机制让 AI 保持活跃。

🧠 持久记忆
通过文件系统实现记忆持久化，AI 助手越用越懂你。

🔒 隐私优先
开源项目，数据运行在你自己的设备上，不经过第三方服务器。

---

二、环境准备

2.1 系统要求

• 操作系统：Linux（推荐 Ubuntu 20.04+）/ macOS / Windows（WSL2）
• Node.js：v22.x 或更高版本
• 内存：至少 2GB RAM
• 磁盘：至少 5GB 可用空间

2.2 安装 Node.js

Linux（推荐使用 nvm）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
node --version

macOS：

brew install node@22

2.3 安装其他依赖

Linux：

sudo apt update && sudo apt install -y git curl build-essential

macOS：

xcode-select --install

---

三、安装 OpenClaw

3.1 全局安装

npm install -g openclaw

安装完成后验证版本：

openclaw --version

3.2 工作目录

首次运行会在 ~/.openclaw 目录下自动创建配置和工作空间。

---

四、配置 OpenClaw

配置文件位于：~/.openclaw/openclaw.json

4.1 AI 模型配置

需要配置至少一个 AI 模型提供商：

• OpenAI（GPT-4o 等）
• Anthropic（Claude 系列）
• 小米 MiMo
• 其他 OpenAI 兼容接口

4.2 消息渠道配置

根据你使用的通讯平台配置：

• Telegram → 需要创建 Bot 并获取 Token
• WhatsApp → 需要扫描二维码连接
• Discord → 需要创建 Bot 应用
• Signal → 需要安装 signal-cli
• Webchat → 内置网页聊天界面，无需额外配置

4.3 Telegram 渠道配置示例

Step 1：在 Telegram 中找到 @BotFather

Step 2：发送 /newbot 创建新 Bot

Step 3：获取 Bot Token

Step 4：添加到配置文件：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "你的BOT_TOKEN"
    }
  }
}

---

五、启动与运行

启动 Gateway 服务：

openclaw gateway start

查看运行状态：

openclaw status

停止服务：

openclaw gateway stop

重启服务：

openclaw gateway restart

---

六、使用 WebChat

OpenClaw 内置 WebChat 界面，是最简单的入门方式。在配置文件中启用：

{
  "channels": {
    "webchat": {
      "enabled": true,
      "port": 3000
    }
  }
}

然后访问 http://localhost:3000 即可开始对话。

---

七、技能系统

OpenClaw 拥有强大的技能系统，可通过安装技能扩展能力。在对话中告诉你的 AI 助手：

帮我找找有什么技能可以安装

常用技能：

• weather — 天气查询
• summarize — 网页/视频/文档摘要
• github — GitHub 操作
• excel-xlsx — Excel 文件处理
• chart-image — 图表生成
• healthcheck — 系统安全检查
• 还有数十种更多技能...

---

八、定时任务（Cron）

OpenClaw 内置强大的定时任务系统。在对话中直接告诉 AI：

每天早上 8 点帮我查一下天气

AI 会自动创建对应的 cron 任务并准时执行。

---

九、多设备联动

OpenClaw 支持通过手机等设备联动：

• 📸 远程拍照（手机摄像头）
• 🖥️ 截屏
• 📍 获取位置
• 🔔 发送通知

---

十、常见问题

Q：npm install -g 失败怎么办？

配置 npm 全局目录到用户目录：

npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
npm install -g openclaw

Q：Gateway 启动失败？

检查端口占用和日志：

openclaw gateway status
cat ~/.openclaw/logs/gateway.log

Q：如何更新 OpenClaw？

npm update -g openclaw
openclaw gateway restart

Q：配置文件在哪里？

主配置：~/.openclaw/openclaw.json
工作空间：~/.openclaw/workspace/

---

十一、更多资源

• 📚 官方文档：https://docs.openclaw.ai
• 💻 GitHub：https://github.com/openclaw/openclaw
• 💬 社区 Discord：https://discord.com/invite/clawd
• 🧩 技能商店：https://clawhub.com

---

让每个人都能拥有一个真正属于自己的 AI 助手。
从今天开始，让你的 AI 为你工作吧！🦞