OpenClaw入门：从零开始搭建你的私有化AI助手

一句话简介：OpenClaw是一个可以在你自己的设备上运行的个人AI助手，支持多种通讯渠道（WhatsApp、Telegram、Slack等），让你拥有一个真正属于自己的智能助手，数据完全掌控在自己手中。

📋 目录

• OpenClaw是什么？
• 为什么选择OpenClaw？
• 安装与配置
• 首次运行：Onboarding向导
• 基础使用：发送第一条消息
• 核心概念解析
• 常见问题与故障排除
• 进阶功能探索
• 总结与资源

---

OpenClaw是什么？

通俗理解

想象你有一个24小时在线的私人助理，它能：

• 📱 在你常用的聊天软件里（微信、Telegram、WhatsApp、Slack等）回复你
• 🔊 用语音和你对话（支持ElevenLabs语音合成）
• 🎨 展示可视化界面（Live Canvas）
• 🌐 帮你控制浏览器自动执行任务
• 📸 使用手机摄像头和屏幕录制
• ⏰ 设置定时任务和提醒

最重要的是：这一切都在你自己的设备上运行，数据不经过第三方服务器，隐私完全由你掌控。

技术架构

graph TB subgraph "通讯渠道" A[WhatsApp] B[Telegram] C[Slack] D[Discord] end subgraph "OpenClaw Gateway" E[控制中心
localhost:18789] end subgraph "核心组件" F[Pi Agent
AI大脑] G[Browser工具] H[Voice语音] I[Nodes设备] end A --> E B --> E C --> E D --> E E --> F F --> G F --> H F --> I

---

为什么选择OpenClaw？

对比其他AI助手

特性	ChatGPT	Claude	OpenClaw
私有化部署	❌ 云端	❌ 云端	✅ 本地运行
多渠道接入	❌ 仅App/Web	❌ 仅App/Web	✅ WhatsApp/Slack/Telegram等
语音交互	⚠️ 有限	⚠️ 有限	✅ 完整语音支持
可扩展性	⚠️ 插件系统	⚠️ 有限	✅ Skills系统
成本	💰 订阅制	💰 订阅制	🆓 开源免费

适合谁用？

✅ 推荐：

• 隐私敏感用户（数据不想上云）
• 极客/开发者（喜欢折腾本地部署）
• 多平台用户（同时使用多个聊天工具）
• 需要自动化工作流的用户

❌ 不推荐：

• 完全不想配置的技术小白
• 没有稳定运行环境的用户
• 只需要简单问答的场景（用ChatGPT更方便）

---

安装与配置

系统要求

• 操作系统：macOS / Linux / Windows (WSL2)
• Node.js：≥ 22 版本
• 包管理器：npm / pnpm / bun
• 内存：建议 4GB+（运行本地模型需要更多）

安装步骤

方式1：通过npm安装（推荐）

# 安装OpenClaw CLI
npm install -g openclaw@latest

# 或者使用pnpm（更快）
pnpm add -g openclaw@latest

方式2：从源码安装（开发者）

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
pnpm install
pnpm ui:build

# 构建
pnpm build

# 运行向导
pnpm openclaw onboard --install-daemon

配置AI模型

OpenClaw支持多个AI提供商：

# 配置Anthropic Claude（推荐）
openclaw auth add anthropic --oauth

# 配置OpenAI
openclaw auth add openai --oauth

# 查看已配置的模型
openclaw models list

推荐配置：Anthropic Pro/Max + Opus 4.6（长上下文、更好的提示注入防护）

---

首次运行

启动向导

# 运行配置向导（会自动安装后台服务）
openclaw onboard --install-daemon

向导会引导你完成：

1. Gateway配置 - 设置控制平面
2. 工作空间 - 配置AI助手的工作目录
3. 渠道接入 - 连接WhatsApp/Telegram/Slack等
4. 技能安装 - 添加额外功能

启动Gateway服务

# 前台运行（调试模式）
openclaw gateway --port 18789 --verbose

# 检查状态
openclaw status

# 详细诊断
openclaw status --all

访问Web界面

Gateway启动后，可以通过浏览器访问：

• 本地地址：http://localhost:18789
• 查看Token：openclaw dashboard token

---

基础使用

方式1：命令行发送

# 发送消息到指定号码（示例）
openclaw message send \
  --to +1234567890 \
  --message "Hello from OpenClaw!"

方式2：与AI助手对话

# 直接和Pi Agent对话
openclaw agent --message "帮我写一个Python脚本计算斐波那契数列"

# 高级模式（显示思考过程）
openclaw agent \
  --message "分析这个错误日志" \
  --thinking high \
  --verbose

方式3：通过聊天应用

配置好渠道后，直接在你的WhatsApp/Telegram/Slack里发送消息给OpenClaw即可。

示例对话：

你：帮我查一下明天的天气
OpenClaw：正在查询天气预报...
[使用Browser工具打开天气网站]
北京明天多云，气温15-22℃...

---

核心概念解析

1. Gateway（网关）

理解：就像路由器的控制中心，所有消息都经过这里转发。

# Gateway常用命令
openclaw gateway start      # 启动
openclaw gateway stop       # 停止
openclaw gateway status     # 查看状态
openclaw gateway logs       # 查看日志

2. Agent（智能体）

理解：AI的大脑，负责理解你的意图并执行任务。

• Pi Agent：内置的默认助手
• 多Agent路由：可以为不同渠道配置不同Agent

# 查看Agent状态
openclaw agents list

# 切换Agent
openclaw agent --switch <agent-name>

3. Channels（渠道）

理解：OpenClaw和你的聊天应用之间的桥梁。

支持的渠道：

• 📱 消息类：WhatsApp、Telegram、Signal、iMessage
• 💼 办公类：Slack、Discord、Microsoft Teams、Google Chat
• 🌐 其他：Matrix、Zalo、WebChat

配置示例（~/.openclaw/openclaw.json）：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    },
    "slack": {
      "enabled": true,
      "appToken": "xapp-...",
      "botToken": "xoxb-..."
    }
  }
}

4. Tools（工具）

理解：Agent的手和眼睛，让它能执行实际操作。

工具	功能
Browser	控制Chrome浏览器自动操作
Canvas	可视化工作界面
Voice	语音对话（ElevenLabs）
Nodes	设备控制（摄像头、屏幕录制）
Cron	定时任务

5. Skills（技能）

理解：扩展功能包，像浏览器插件一样增强能力。

# 查看已安装技能
openclaw skills list

# 安装新技能
openclaw skills install <skill-name>

# 从GitHub安装
openclaw skills install github:user/repo@skill-name

---

常见问题

Q1: 安装后无法启动Gateway？

排查步骤：

# 1. 检查Node版本
node --version  # 需要≥22

# 2. 检查端口占用
lsof -i :18789  # macOS/Linux
netstat -ano | findstr 18789  # Windows

# 3. 查看详细日志
openclaw gateway --verbose

# 4. 运行诊断
openclaw doctor

Q2: 卡在"Wake up my friend"界面？

解决方案：

1. 检查网络连接（需要访问AI提供商API）
2. 验证API密钥配置：openclaw auth list
3. 重启Gateway：openclaw gateway restart
4. 查看日志：openclaw logs --follow

Q3: 如何保护隐私和安全？

安全建议：

• 启用DM配对模式（默认）：陌生人需要验证码才能对话
• 配置允许列表：allowFrom字段
• 定期运行安全检查：openclaw doctor
• 不要在配置文件中硬编码敏感信息

{
  "channels": {
    "telegram": {
      "dmPolicy": "pairing",  // 需要配对
      "allowFrom": ["@your_username"]  // 只允许特定用户
    }
  }
}

Q4: 如何远程访问Gateway？

方案1：Tailscale（推荐）

# 配置Tailscale
openclaw config set gateway.tailscale.mode serve

# 或者公开访问（需要密码）
openclaw config set gateway.tailscale.mode funnel
openclaw config set gateway.auth.mode password

方案2：SSH隧道

# 本地转发
ssh -L 18789:localhost:18789 your-server

# 远程访问
openclaw gateway --remote wss://your-server:18789

---

进阶功能

1. 浏览器自动化

让AI帮你自动操作浏览器：

# 使用openclaw管理的浏览器
openclaw browser open "https://example.com"

# AI会自动：
# - 打开页面
# - 分析内容
# - 执行点击、填写表单等操作
# - 截图保存结果

2. 语音交互（macOS/iOS/Android）

设置语音唤醒：

# 启用Voice Wake
openclaw voice wake --enable

# 语音对话
openclaw talk --start

体验：就像Siri或Alexa，但完全本地运行，隐私更可控。

3. Live Canvas可视化

AI可以在Canvas上实时展示信息：

• 📊 数据可视化
• 🎨 流程图生成
• 📝 协作白板
• 🖼️ 图片编辑

4. 定时任务（Cron）

设置自动化工作流：

# 添加定时任务
openclaw cron add "0 9 * * *" "发送每日摘要"

# 查看任务
openclaw cron list

# 删除任务
openclaw cron remove <job-id>

5. 自定义Skills开发

创建自己的技能扩展：

# 初始化技能
openclaw skills init my-skill

# 开发技能...
# 参考：skills/目录下的示例

# 本地测试
openclaw skills install ./my-skill

---

总结

核心优势

✅ 私有化 ：数据完全掌控在自己手中

✅ 多渠道 ：统一接入各种聊天应用

✅ 可扩展 ：Skills系统无限扩展能力

✅ 开源：免费、透明、社区驱动

学习路径

Week 1: 安装配置 → 基础对话 → 单渠道接入
Week 2: 多渠道配置 → 工具使用 → 语音交互
Week 3: Skills开发 → 自动化工作流 → 进阶优化
Week 4: 生产部署 → 监控维护 → 社区贡献

参考链接

• 🌐 官网 : openclaw.ai - 验证状态: ✅
• 📚 文档 : docs.openclaw.ai - 验证状态: ✅
• 💻 GitHub : github.com/openclaw/op... - Stars: 173k - 验证状态: ✅
• 💬 Discord : discord.gg/clawd - 验证状态: ✅
• 🔧 快速开始 : Getting Started - 验证状态: ✅
• ❓ FAQ : docs.openclaw.ai/start/faq - 验证状态: ✅

下一步行动

1. ✅ 完成安装和Onboarding向导
2. ✅ 配置至少一个聊天渠道（推荐Telegram或Slack）
3. ✅ 尝试第一条AI对话
4. ✅ 探索Browser和Voice工具
5. ✅ 加入Discord社区获取支持

---

最后提醒 ：OpenClaw是一个快速发展的开源项目，功能更新频繁。建议定期查看CHANGELOG获取最新特性，并保持版本更新。

💡 小贴士：刚开始可能会遇到配置问题，不要灰心！社区很活跃，Discord上有大量热心的开发者愿意帮助新手。记住：一旦配置完成，你就拥有了一个真正属于自己的AI助手！