OpenClaw 快速学习指南

🎯 什么是 OpenClaw？

OpenClaw（代号"龙虾"）是一个开源的 AI 助理系统，让你能够部署自己的 AI 助手，具有记忆、学习和多通道能力。

✨ 核心特性：

持久记忆：记住你和它的每次对话，越用越懂你
技能系统：踩过的坑自动记录，下次自动避坑
多通道接入：支持微信、Telegram、钉钉、飞书等
Agent 路由：不同用户/群组分配不同 Agent
工具调用：可以搜索网络、读写文件、执行命令
自托管：数据隐私完全可控

💡 为什么选择 OpenClaw？

ChatGPT 是搜索工具，OpenClaw 是你的数字员工。它会记住你的偏好、工作习惯、项目背景，真正成为你的得力助手。

🆚 OpenClaw vs ChatGPT

🤖 ChatGPT

每次对话都是新开始
不记得你说过的偏好
无法访问你的文件
无法执行命令
无法集成到你的工作流
✓ 强大的语言理解能力
✓ 知识广泛

🦞 OpenClaw

✓ 持久记忆，越用越懂你
✓ 记住你的偏好和习惯
✓ 可以读写你的文件
✓ 可以执行系统命令
✓ 无缝集成到工作流
✓ 支持多个通信通道
✓ 技能系统自动学习

📌 类比：ChatGPT 就像一个博学但健忘的顾问，每次见面都要重新介绍背景。OpenClaw 就像一个长期共事的同事，知道你的工作方式、记住你说过的话、帮你处理日常事务。

🧠 核心概念

1. Agent（智能体）

Agent 是 OpenClaw 的核心概念，每个 Agent 都有独立的记忆、配置和技能。

# 示例：创建不同用途的 Agent
david      # 你的个人助理
xiaoding    # 丁法鑫的助理
marriom     # 雁铭的助理
                

2. Session（会话）

每次对话都是一个 Session，OpenClaw 会记录完整的对话历史。

3. Memory（记忆）

OpenClaw 有三层记忆系统：

MEMORY.md：长期记忆，萃取后的精华
memory/YYYY-MM-DD.md：每日日志，原始对话记录
USER.md：用户画像，记住你的偏好

4. Skills（技能）

Skills 是可重用的功能模块，比如：

读取公众号文章
生成思维导图
搜索网络信息
发送邮件通知

5. Channels（通道）

OpenClaw 支持多种通信通道，让你在不同平台使用同一个 AI 助理：

微信（企业微信/个人微信）
Telegram
钉钉
飞书
Discord
Signal
WhatsApp

🚀 安装部署

系统要求

操作系统：Linux / macOS / Windows (WSL)
Node.js：v18+
内存：至少 2GB
存储：至少 10GB 可用空间

安装步骤

安装 OpenClaw CLI
npm install -g openclaw
初始化 Gateway
openclaw init
启动 Gateway 服务
openclaw gateway start
验证安装
openclaw status

⚠️ 注意：首次启动需要配置 LLM API Key（OpenAI/Claude/等），OpenClaw 才能正常工作。

⚙️ 基础配置

1. 配置 LLM API

# 编辑配置文件
openclaw configure

# 或直接编辑 openclaw.json
{
  "llm": {
    "provider": "openai",
    "apiKey": "sk-...",
    "model": "gpt-4"
  }
}
                

2. 配置 Agent

# 创建新 Agent
openclaw agent create my-agent

# 配置 Agent 属性
openclaw agent config my-agent --name "我的助理"
                

3. 配置通道

# 添加微信通道
openclaw channel add weixin --token "your-token"

# 添加 Telegram 通道
openclaw channel add telegram --bot-token "your-bot-token"
                

🛠️ 技能系统

Skills 是 OpenClaw 的核心优势，让 AI 助理能够执行特定任务。

什么是 Skill？

💡 Skill 定义：Skill 是一个包含以下内容的功能包：

SKILL.md：技能说明文档
代码逻辑：Python/JavaScript/Bash 脚本
配置文件：所需参数和环境

技能来源

官方技能库：ClawHub 提供的社区技能
自建技能：根据自己需求编写
第三方技能：从 GitHub 或其他来源安装

技能管理

# 搜索技能
openclaw skill search "微信文章"

# 安装技能
openclaw skill install wechat-mp-reader

# 列出已安装技能
openclaw skill list

# 更新技能
openclaw skill update wechat-mp-reader
                

创建自定义技能

创建技能目录
mkdir ~/.openclaw/skills/my-skill
编写 SKILL.md
# ~/.openclaw/skills/my-skill/SKILL.md # 技能名称：我的第一个技能 # 触发条件：用户说"帮我..." # 执行逻辑：调用相应脚本
编写执行脚本
# ~/.openclaw/skills/my-skill/run.sh #!/bin/bash # 你的逻辑代码 echo "执行技能..."
测试技能
openclaw skill test my-skill

📝 记忆系统

OpenClaw 的记忆系统是其核心优势，让 AI 助理能够记住你和它的所有互动。

记忆层级

MEMORY.md（长期记忆）

精选的长期记忆
重要决策、规则、偏好
定期从每日日志中提炼
只在主会话加载

memory/YYYY-MM-DD.md（每日日志）

原始对话记录
保留具体内容和上下文
每天自动创建
作为 MEMORY.md 的素材来源

记忆管理

# 搜索记忆
openclaw memory search "思维导图"

# 查看特定日期的记忆
openclaw memory get 2026-03-26

# 更新长期记忆
openclaw memory update "新学到的知识"
                

💡 最佳实践：

定期（每周）review 每日日志，提炼重要信息到 MEMORY.md
在 MEMORY.md 中组织清晰的结构（项目、规则、偏好）
删除过时或不再准确的信息

🤖 Agent 管理

创建 Agent

# 创建新 Agent
openclaw agent create assistant

# 配置 Agent
openclaw agent config assistant \
  --name "我的助理" \
  --persona "友好、专业" \
  --instructions "你是一个专业的助理..."
                

Agent 路由

将不同用户或群组路由到不同的 Agent：

# 路由配置示例
{
  "routing": [
    {
      "channel": "weixin",
      "sender": "user-123",
      "agent": "david"
    },
    {
      "channel": "feishu",
      "sender": "ou_xxx",
      "agent": "xiaoding"
    }
  ]
}
                

多 Agent 协作

一个主 Agent 可以调用子 Agent 处理特定任务：

📌 实际案例：时代光华的 Agent 架构

david：大卫的个人助理（主要 Agent）
xiaoding：丁法鑫的助理（飞书私聊路由）
marriom：雁铭的助理（飞书私聊路由）

不同用户通过不同通道私聊时，自动路由到对应的 Agent，各自独立进化。

📡 通道配置

OpenClaw 支持多种通信通道，让你在不同平台使用 AI 助理。

支持的通道

通道	类型	配置难度
企业微信	官方 API	中等
Telegram	Bot API	简单
钉钉	机器人	中等
飞书	开放平台	中等
Discord	Bot	简单

配置示例：企业微信

创建企业微信应用
在企业微信管理后台创建应用，获取 CorpID、AgentId、Secret
配置回调 URL
https://your-domain.com/wecom/callback
添加通道
openclaw channel add wecom \ --corp-id "ww..." \ --agent-id "..." \ --secret "..."

🚀 高级功能

1. 定时任务（Cron）

设置定时任务，让 AI 助理自动执行操作：

# 创建每日提醒
openclaw cron create \
  --name "早报" \
  --schedule "0 9 * * 1-5" \
  --message "早安！今日 AI 资讯已更新"

# 查看所有定时任务
openclaw cron list
                

2. 工具调用

OpenClaw 支持丰富的工具能力：

文件操作：读写文件、创建目录
网络搜索：Brave、Tavily 搜索 API
浏览器自动化：控制浏览器抓取网页
消息发送：主动发送通知到各通道
节点控制：控制配对设备（摄像头、位置等）

3. 子会话（Sub-sessions）

主 Agent 可以创建独立的子会话处理特定任务：

# 创建子会话执行任务
openclaw session spawn \
  --agent "coder" \
  --task "开发思维导图工具" \
  --mode "session"
                

4. 心跳机制

配置定期心跳检查，让 AI 助理主动关心你的事务：

# 配置心跳检查
openclaw heartbeat enable \
  --prompt "检查邮件、日历、待办事项" \
  --interval "30m"
                

❓ 常见问题

Q1: OpenClaw 和 ChatGPT 有什么区别？

A: OpenClaw 有持久记忆、技能系统、多通道接入、可以执行命令，而 ChatGPT 每次都是新开始。OpenClaw 是你的数字员工，ChatGPT 是搜索工具。

Q2: 如何保护数据隐私？

A: OpenClaw 支持完全自托管，所有数据存储在你自己的服务器上。你可以选择不使用第三方 API，或使用私有部署的 LLM。

Q3: 支持哪些 LLM？

A: OpenClaw 支持所有兼容 OpenAI API 的 LLM，包括：

OpenAI（GPT-4、GPT-3.5）
Anthropic（Claude）
国内模型（通义千问、文心一言、智谱等）
开源模型（Llama、Mistral 等，通过本地部署）

Q4: 如何创建自定义技能？

A: 在 ~/.openclaw/skills/ 目录下创建新目录，编写 SKILL.md 和执行脚本即可。参考官方技能库的示例。

Q5: 可以在手机上使用吗？

A: 可以！通过微信、Telegram、钉钉等移动端应用，随时随地与你的 AI 助理对话。

📚 学习资源

官方资源

官网：https://docs.openclaw.ai
GitHub：https://github.com/openclaw/openclaw
社区：https://discord.com/invite/clawd
技能商店：https://clawhub.com

实战项目建议

🎯 项目 1：个人知识库助手

创建一个能够记住你所有笔记、文档、项目背景的 AI 助理，随时查询和整理。

🎯 项目 2：工作流自动化

配置 AI 助理自动整理会议纪要、生成周报、发送提醒。

🎯 项目 3：团队协作文档

为不同团队成员配置独立 Agent，协同完成文档编写、项目管理。

💼 实战案例

案例 1：光华养成日记

背景：时代光华的大卫想要记录与 AI 助理"光华"的每日互动，展示 AI 助理的成长过程。

实现方案：

配置每日定时任务（晚上 22:00）
自动汇总当天对话记录到 memory/YYYY-MM-DD.md
定期提炼重要信息到 MEMORY.md
自动同步到飞书文档

# 创建定时任务
openclaw cron create \
  --name "光华日记更新" \
  --schedule "0 22 * * *" \
  --payload "更新今日互动记录到飞书文档"
                

案例 2：每日 AI 资讯推送

背景：每天早上 9:00 自动推送 AI 行业最新资讯。

实现方案：

使用 Tavily API 搜索 AI 相关新闻
筛选和摘要重要资讯
通过飞书机器人推送给大卫

# 创建每日资讯任务
openclaw cron create \
  --name "每日 AI 资讯" \
  --schedule "0 9 * * 1-5" \
  --task "ai-news-pusher"
                

案例 3：公众号推文优化

背景：优化时代光华的公众号推文，提升阅读体验。

实现方案：

创建 SEO 规则记忆（品牌全称 > 代词）
分析历史推文的优劣
提供多个版本供选择
记录偏好到记忆系统

💡 关键学习：通过迭代，AI 助理逐渐掌握了你的写作风格和偏好，后续推文质量持续提升。

案例 4：小工具开发流水线

背景：一天内开发 8 个在线小工具。

开发流程：

需求沟通
大卫提出需求：开发 Markdown 编辑器、思维导图等工具
快速开发
使用 HTML/CSS/JavaScript 快速实现功能
本地测试
在 workspace/projects/ 目录下测试
SFTP 部署
~/.openclaw/scripts/deploy-sftp.sh <文件> <目录>
COS 备份
上传到腾讯云 COS 作为备份
更新导航
在工具导航页添加新工具卡片

✨ 成果：一天内完成贪吃蛇、俄罗斯方块、番茄钟、Markdown 编辑器、待办事项、思维导图等 8 个工具。

⭐ 最佳实践

1. 记忆管理

💡 定期 Review

每周 review 每日日志
提炼重要信息到 MEMORY.md
删除过时信息
保持结构清晰

2. 技能开发

💡 模块化设计

每个技能只做一件事
编写清晰的 SKILL.md
处理错误情况
记录使用示例

3. Agent 配置

💡 明确定位

为每个 Agent 定义清晰的职责
设置合适的 persona（人设）
编写详细的 instructions
定期更新和优化

4. 安全建议

⚠️ 安全要点

不要在对话中暴露敏感信息
定期备份记忆文件
使用环境变量存储 API Key
限制 Agent 的文件访问权限
在群聊中注意隐私保护

5. 性能优化

💡 提升响应速度

选择合适的模型（平衡速度和质量）
控制上下文长度
使用缓存机制
异步处理耗时任务

🔧 故障排查

问题 1：Gateway 无法启动

可能原因：

Node.js 版本过低（需要 v18+）
端口被占用
配置文件错误

解决方案：

# 检查 Node.js 版本
node --version

# 检查日志
openclaw gateway logs

# 验证配置
openclaw config validate
                    

问题 2：Agent 无法响应

可能原因：

LLM API Key 无效
网络连接问题
Agent 未正确配置

解决方案：

# 测试 API 连接
openclaw test llm

# 查看 Agent 状态
openclaw agent status

# 重启 Gateway
openclaw gateway restart
                    

问题 3：通道消息无法接收

可能原因：

Webhook URL 配置错误
Token/Secret 过期
路由规则错误

解决方案：

# 检查通道配置
openclaw channel list

# 测试通道连接
openclaw channel test <通道名称>

# 查看路由配置
openclaw routing list
                    

问题 4：技能无法加载

可能原因：

SKILL.md 格式错误
依赖未安装
权限问题

解决方案：

# 验证技能
openclaw skill validate <技能名>

# 查看技能日志
openclaw skill logs <技能名>

# 重新安装
openclaw skill reinstall <技能名>
                    

🚀 进阶主题

1. 自定义 LLM 接入

OpenClaw 支持接入任何兼容 OpenAI API 的 LLM：

{
  "llm": {
    "provider": "custom",
    "baseUrl": "https://your-llm-api.com",
    "apiKey": "your-key",
    "model": "your-model"
  }
}
                

2. 插件开发

开发自定义插件扩展 OpenClaw 功能：

# 创建插件
openclaw plugin create my-plugin

# 插件目录结构
~/.openclaw/plugins/my-plugin/
├── package.json
├── index.js
├── SKILL.md
└── README.md
                

3. 多实例部署

部署多个 OpenClaw 实例实现负载均衡：

使用 Nginx 做反向代理
配置 Redis 共享 Session
使用消息队列处理任务

4. 监控和日志

# 启用监控
openclaw monitor enable

# 查看实时日志
openclaw logs tail

# 导出日志
openclaw logs export --last 24h
                

5. 数据备份和恢复

# 备份配置和记忆
openclaw backup create --include-memory

# 恢复备份
openclaw backup restore <备份文件>

# 自动备份
openclaw backup enable --schedule "daily"
                

🤝 社区贡献

如何贡献？

提交技能：分享你开发的技能到 ClawHub
报告 Bug：在 GitHub 提交 Issue
改进文档：完善官方文档
分享经验：在社区分享使用心得

贡献指南

Fork 仓库
在 GitHub Fork openclaw/openclaw
创建分支
git checkout -b feature/my-feature
提交更改
git commit -m "Add my feature"
推送分支
git push origin feature/my-feature
创建 Pull Request
在 GitHub 提交 PR

💡 贡献最佳实践：

遵循代码规范
编写测试用例
更新文档
回复 Review 意见

🦞 OpenClaw 快速学习指南

📚 目录导航

🎯 什么是 OpenClaw？

🆚 OpenClaw vs ChatGPT

🤖 ChatGPT

🦞 OpenClaw

🧠 核心概念

1. Agent（智能体）

2. Session（会话）

3. Memory（记忆）

4. Skills（技能）

5. Channels（通道）

🚀 安装部署

系统要求

安装步骤

⚙️ 基础配置

1. 配置 LLM API

2. 配置 Agent

3. 配置通道

🛠️ 技能系统

什么是 Skill？

技能来源

技能管理

创建自定义技能

📝 记忆系统

记忆层级

MEMORY.md（长期记忆）

memory/YYYY-MM-DD.md（每日日志）

记忆管理

🤖 Agent 管理

创建 Agent

Agent 路由

多 Agent 协作

📌 实际案例：时代光华的 Agent 架构

📡 通道配置

支持的通道

配置示例：企业微信

🚀 高级功能

1. 定时任务（Cron）

2. 工具调用

3. 子会话（Sub-sessions）

4. 心跳机制

❓ 常见问题

Q1: OpenClaw 和 ChatGPT 有什么区别？

Q2: 如何保护数据隐私？

Q3: 支持哪些 LLM？

Q4: 如何创建自定义技能？

Q5: 可以在手机上使用吗？

📚 学习资源

官方资源

推荐学习路径

实战项目建议

🎯 项目 1：个人知识库助手

🎯 项目 2：工作流自动化

🎯 项目 3：团队协作文档

💼 实战案例

案例 1：光华养成日记

案例 2：每日 AI 资讯推送

案例 3：公众号推文优化

案例 4：小工具开发流水线

⭐ 最佳实践

1. 记忆管理

2. 技能开发

3. Agent 配置

4. 安全建议

5. 性能优化

🔧 故障排查

问题 1：Gateway 无法启动

问题 2：Agent 无法响应

问题 3：通道消息无法接收

问题 4：技能无法加载

🚀 进阶主题

1. 自定义 LLM 接入

2. 插件开发

3. 多实例部署

4. 监控和日志

5. 数据备份和恢复

🤝 社区贡献

如何贡献？

贡献指南