OpenClaw 完全指南:打造你的私人 AI 助手
2026 年最火的 AI 助手框架!OpenClaw 让你轻松搭建属于自己的智能助手,支持 Telegram、WhatsApp、Discord 等多平台,拥有丰富的工具生态和技能系统。5 分钟快速部署,完全可控。
2026 年最火的 AI 助手框架!OpenClaw 让你轻松搭建属于自己的智能助手,支持多平台、多工具、完全可控。
🎯 你将学到什么
- OpenClaw 是什么,为什么这么火
- 如何在 5 分钟内部署 OpenClaw
- 连接多个聊天平台(Telegram、WhatsApp、Discord)
- 添加自定义工具和技能
- 配置记忆和个性化
- 高级功能:定时任务、多会话管理
- 实战案例:打造专属 AI 助手
官方文档: https://docs.openclaw.ai
一、OpenClaw 是什么?
1.1 核心特性
OpenClaw = AI Agent 框架 + 多平台集成 + 工具生态
┌────────────────────────────────────┐
│ 你的 AI 助手 │
│ (基于 Claude/GPT/Gemini) │
└───────────────┬────────────────────┘
│
┌───────┴───────┐
│ OpenClaw │
│ (框架层) │
└───────┬───────┘
│
┌──────────┼──────────┐
│ │ │
┌───▼────┐ ┌───▼────┐ ┌───▼───┐
│Telegram│ │WhatsApp│ │Discord│
└────────┘ └────────┘ └───────┘
核心能力:
- 多平台支持 — Telegram、WhatsApp、Discord、Slack、Signal
- 工具生态 — 邮件、日历、GitHub、天气、文件管理
- 记忆系统 — 短期记忆 + 长期记忆
- 技能系统 — 可扩展的技能插件
- 定时任务 — Cron 定时执行
- 多会话管理 — 支持多个独立会话
1.2 为什么选择 OpenClaw?
vs 其他方案:
| 特性 | OpenClaw | LangChain | AutoGPT |
|---|---|---|---|
| 易用性 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| 多平台 | ✅ | ❌ | ❌ |
| 工具生态 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
| 记忆系统 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ |
| 开箱即用 | ✅ | ❌ | ❌ |
适合谁?
- ✅ 想要私人 AI 助手的个人用户
- ✅ 需要多平台集成的开发者
- ✅ 想要完全控制数据的隐私用户
- ✅ 需要定制化功能的企业
二、快速开始(5 分钟部署)
2.1 系统要求
最低配置:
- 操作系统:macOS / Linux / Windows (WSL)
- Node.js:18.0+
- 内存:2GB+
- 磁盘:5GB+
推荐配置:
- 内存:4GB+
- 磁盘:10GB+
2.2 安装 OpenClaw
方法 1:npm 安装(推荐)
# 全局安装
npm install -g @openclaw/openclaw
# 验证安装
openclaw --version
方法 2:从源码安装
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 安装依赖
npm install
# 构建
npm run build
# 链接到全局
npm link
2.3 初始化配置
# 创建工作目录
mkdir ~/my-ai-assistant
cd ~/my-ai-assistant
# 初始化 OpenClaw
openclaw init
# 输出:
# ✅ 工作目录已创建
# ✅ 配置文件已生成:config.yaml
# ✅ 技能目录已创建:skills/
# ✅ 记忆目录已创建:memory/
2.4 配置 API 密钥
编辑 config.yaml:
# config.yaml
# AI 模型配置
ai:
provider: anthropic # anthropic / openai / google
model: claude-sonnet-4-5
api_key: your-api-key-here # 替换为你的 API 密钥
# 工作目录
workspace:
path: ~/my-ai-assistant
# 日志配置
logging:
level: info
file: logs/openclaw.log
2.5 启动 OpenClaw
# 启动 Gateway(后台服务)
openclaw gateway start
# 输出:
# ✅ OpenClaw Gateway 已启动
# 📡 监听端口:3000
# 🤖 AI 模型:claude-sonnet-4-5
# 📂 工作目录:~/my-ai-assistant
# 查看状态
openclaw status
# 输出:
# ✅ Gateway: 运行中
# 🤖 模型: claude-sonnet-4-5
# 💬 会话: 0 个活跃
三、连接聊天平台
3.1 Telegram(最简单)
步骤 1:创建 Telegram Bot
- 在 Telegram 搜索
@BotFather - 发送
/newbot - 按提示设置名称和用户名
- 获取 Bot Token(类似:
123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)
步骤 2:配置 OpenClaw
编辑 config.yaml:
channels:
telegram:
enabled: true
token: "你的-Bot-Token"
allowed_users: # 可选:限制允许的用户
- your_telegram_username
步骤 3:重启 Gateway
openclaw gateway restart
# 输出:
# ✅ Telegram Bot 已连接
# 🤖 Bot 用户名:@YourBotName
步骤 4:开始聊天
在 Telegram 搜索你的 Bot,发送 /start,开始对话!
3.2 WhatsApp
步骤 1:安装 WhatsApp 插件
openclaw plugin install whatsapp
步骤 2:扫码登录
openclaw whatsapp login
# 输出:
# 📱 请用 WhatsApp 扫描二维码:
# [显示二维码]
用手机 WhatsApp 扫码登录。
步骤 3:配置
channels:
whatsapp:
enabled: true
session_path: ~/.openclaw/whatsapion
3.3 Discord
步骤 1:创建 Discord Bot
- 访问 https://discord.com/developers/applications
- 点击 “New Application”
- 进入 “Bot” 标签,点击 “Add Bot”
- 复制 Bot Token
- 启用 “Message Content Intent”
步骤 2:邀请 Bot 到服务器
生成邀请链接:
https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=8&scope=bot
步骤 3:配置 OpenClaw
channels:
discord:
enabled: true
token: "你的-Discord-Bot-Token"
guild_id: "你的-服务器-ID" # 可选
四、添加工具和技能
4.1 安装官方技能
查看可用技能:
openclaw skills list
# 输出:
# 📦 可用技能:
# - github: GitHub 集成(issues, PRs, repos)
# - weather: 天气查询
# - email: 邮件管理(Gmail, Outlook)
# - calendar: 日历管理(Google Calendar)
# - file-manager: 文件操作
# - web-search: 网页搜索
安装技能:
# 安装 GitHub 技能
openclaw skills install github
# 输出:
# ✅ 技能已安装:github
# 📖 配置文档:~/.openclaw/skills/github/README.md
# 配置 GitHub Token
openclaw skills config github --token your-github-token
4.2 创建自定义技能
创建技能目录:
mkdir -p skills/my-skill
cd skills/my-skill
创建 SKILL.md:
---
name: my-skill
description: 我的自定义技能
---
# 我的技能
这是一个自定义技能示例。
## 工具
### hello_world
打招呼工具。
**用法:**
调用 hello_world 工具,传入 name 参数
**示例:**
用户: 跟 Alice 打个招呼
助手: [调用 hello_world(name=“Alice”)]
输出: Hello, Alice!
创建 tools.py:
# tools.py
from langchain.tools import tool
@tool
def hello_world(name: str) -> str:
"""
打招呼工具
Args:
name: 要打招呼的人名
Returns:
问候语
"""
return f"Hello, {name}!"
# 导出工具列表
tools = [hello_world]
测试技能:
# 重启 Gateway
openclaw gateway restart
# 在聊天中测试
你: 跟 Bob 打个招呼
AI: Hello, Bob!
五、配置记忆和个性化
5.1 设置个性化
创建 SOUL.md(AI 的灵魂):
# SOUL.md - 我的 AI 助手
## 核心身份
我是一个高效、专业的个人助手。
**核心特质:**
- 简洁直接,不废话
- 主动思考,提供建议
- 记住用户偏好
- 保护隐私
## 沟通风格
- 使用中文交流
- 简洁明了
- 必要时提供详细解释
- 友好但专业
## 工作原则
1. 先理解需求,再执行
2. 重要操作前确认
3. 记录重要信息
4. 定期总结和提醒
创建 USER.md(关于你):
# USER.md - 关于我
## 基本信息
- 名字:张三
- 时区:Asia/Shanghai
- 职业:软件工程师
## 偏好
- 沟通风格:简洁直接
- 工作时间:9:00-18:00
- 提醒方式:Telegram 通知
## 常用工具
- 代码托管:GitHub
- 邮箱:Gmail
- 日历:Google Calendar
5.2 记忆系统
OpenClaw 的记忆结构:
memory/
├── MEMORY.md # 长期记忆(重要信息)
├── 2026-02-22.md # 每日记录
├── 2026-02-21.md
└── ...
MEMORY.md 示例:
# MEMORY.md - 长期记忆
## 重要信息
### 项目
- **项目 A**:截止日期 2026-03-01
- **项目 B**:等待客户反馈
### 联系人
- **李四**:技术经理,邮箱 lisi@example.com
- **王五**:产品经理,Telegram @wangwu
### 偏好
- 喜欢用 VS Code
- 常用 Python 和 JavaScript
- 每天 9:00 查看日程
每日记录自动生成:
# 2026-02-22
## 对话记录
- 09:00 查看今天的日程
- 10:30 创建任务:完成项目 A 的文档
- 14:00 搜索 GitHub issue #123
- 17:00 发送邮件给李四
## 重要事项
- 项目 A 文档已完成
- 明天需要参加团队会议
六、定时任务
6.1 创建定时任务
每天早上 9:00 发送日程:
openclaw cron add \
--name "每日日程" \
--schedule "0 9 * * *" \
--task "查看今天的日程并发送给我"
每小时检查邮件:
openclaw cron add \
--name "邮件检查" \
--schedule "0 * * * *" \
--task "检查是否有紧急邮件"
查看所有任务:
openclaw cron list
# 输出:
# 📋 定时任务列表:
# 1. 每日日程 (0 9 * * *) - 下次运行:明天 09:00
# 2. 邮件检查 (0 * * * *) - 下次运行:1 小时后
6.2 Cron 表达式
┌───────────── 分钟 (0 - 59)
│ ┌───────────── 小时 (0 - 23)
│ │ ┌───────────── 日期 (1 - 31)
│ │ │ ┌───────────── 月份 (1 - 12)
│ │ │ │ ┌───────────── 星期 (0 - 7, 0 和 7 都是周日)
│ │ │ │ │
* * * * *
常用示例:
# 每天 9:00
0 9 * * *
# 每小时
0 * * * *
# 每周一 10:00
0 10 * * 1
# 每月 1 号 8:00
0 8 1 * *
# 每 30 分钟
*/30 * * * *
七、高级功能
7.1 多会话管理
创建独立会话:
# 创建工作会话
openclaw session create work
# 创建生活会话
openclaw session create life
# 列出所有会话
openclaw session list
# 输出:
# 📋 会话列表:
# - main (主会话)
# - work (工作)
# - life (生活)
切换会话:
# 切换到工作会话
openclaw session switch work
# 在工作会话中,AI 只能访问工作相关的记忆和工具
7.2 权限控制
配置工具权限:
# config.yaml
permissions:
# 文件操作需要确认
file_operations:
require_confirmation: true
allowed_paths:
- ~/Documents
- ~/Projects
# 邮件发送需要确认
email:
require_confirmation: true
allowed_recipients:
- "@example.com" # 只允许发送到公司邮箱
# GitHub 操作
github:
allowed_repos:
- your-username/* # 只允许操作自己的仓库
7.3 备份和恢复
备份:
# 备份所有数据
openclaw backup create
# 输出:
# ✅ 备份已创建:backup-2026-02-22.tar.gz
# 📦 大小:15.3 MB
# 📂 位置:~/.openclaw/backups/
恢复:
# 恢复备份
openclaw backup restore backup-2026-02-22.tar.gz
# 输出:
# ✅ 备份已恢复
# 🔄 请重启 Gateway
八、实战案例
8.1 打造个人效率助手
目标:
- 每天早上发送日程和待办
- 自动回复邮件
- 定期提醒重要事项
- 管理 GitHub issues
配置步骤:
1. 安装技能
openclaw skills install calendar
openclaw skills install email
openclaw skills install github
2. 配置定时任务
# 每天 8:00 发送日程
openclaw cron add \
--name "早安日程" \
--schedule "0 8 * * *" \
--task "查看今天的日程、待办事项和重要邮件,发送摘要"
# 每小时检查 GitHub
openclaw cron add \
--name "GitHub 检查" \
--schedule "0 * * * *" \
--task "检查我的 GitHub 仓库是否有新的 issue 或 PR"
3. 设置个性化
编辑 SOUL.md:
# SOUL.md - 效率助手
## 核心身份
我是一个专注于提高效率的个人助手。
# 每天早上主动发送日程摘要
2. 紧急邮件立即通知
3. 重要任务提前提醒
4. 定期总结工作进度
## 提醒规则
- 会议前 15 分钟提醒
- 任务截止前 1 天提醒
- 紧急邮件立即通知
4. 开始使用
在 Telegram 发送:
你: 早上好
AI: 早上好!今天的安排:
- 10:00 团队会议
- 14:00 客户演示
- 待办:完成项目 A 文档
📧 有 2 封未读邮件
🐙 GitHub 有 1 个新 issue
九、常见问题
Q1: OpenClaw 安全吗?
A: 非常安全!
- ✅ 所有数据存储在本地
- ✅ API 密钥加密存储
- ✅ 支持权限控制
- ✅ 开源可审计
Q2: 支持哪些 AI 模型?
A: 支持主流模型:
- Anthropic Claude (推荐)
- OpenAI GPT-4 / GPT-3.5
- Google Gemini
- 本地模型(Ollama)
Q3: 成本如何?
A: 取决于使用量:
- Claude Sonnet:约 $0.003/1K tokens
- GPT-3.5:约 $0. tokens
- 本地模型:免费
典型使用:
- 每天 100 次对话
- 每月成本:$5-20
Q4: 可以离线使用吗?
A: 部分功能可以:
- ✅ 本地工具(文件操作、系统命令)
- ✅ 本地模型(Ollama)
- ❌ 在线工具(邮件、日历、搜索)
Q5: 如何更新 OpenClaw?
A:
# npm 安装的
npm update -g @openclaw/openclaw
# 源码安装的
cd openclaw
git pull
npm install
npm run build
十、总结
10.1 关键要点
- OpenClaw 是最易用的 AI Agent 框架
- 5 分钟即可部署,开箱即用
- 支持多平台、多工具、完全可控
- 记忆系统让 AI 真正理解你
- 定时任务实现自动化
10.2 下一步
立即开始:
# 1. 安装 OpenClaw
npm install -g @openclaw/openclaw
# 2. 初始化
openclaw init
# 3. 配置 API 密钥
# 编辑 config.yaml
# 4. 启动
openclaw gateway start
# 5. 连接 Telegram
# 配置 Telegram Bot Token
# 6. 开始使用!
进阶学习:
- 📖 官方文档:https://docs.openclaw.ai
- 💬 社区讨论:https://discord.gg/openclaw
- 🐙 GitHub:https://github.com/openclaw/openclaw
- 🎓 视频教程:https://youtube.com/@openclaw
十一、资源链接
官方资源:
- 官网:https://openclaw.ai
- 文档:https://docs.openclaw.ai
- GitHub:https://github.com/openclaw/openclaw
- Discord:https://discord.gg/openclaw
技能市场:
- Clawhub:https://clawhub.com
- 官方技能:https://github.com/openclaw/skills
社区:
- Reddit:r/openclaw
- Twitter:@openclawai
- YouTube:@openclaw
🎉 结语
OpenClaw 不只是一个工具,而是一个生态。
从简单的聊天机器人到全能的个人助手,OpenClaw 让 AI 真正为你服务。
现在就开始,打造属于你的 AI 助手吧! 🚀
关注我,获取更多 AI 开发干货! 💪
如果觉得有帮助,欢迎点赞、收藏、转发! ❤️
有问题欢迎在评论区交流!
更多推荐



所有评论(0)