OpenClaw 必知必会

OpenClaw 是一个强大的 AI 助手框架，它不仅仅是另一个聊天机器人，而是一个能够真正理解你的需求、访问你的工具、并在你的工作流中发挥作用的智能助手。

🎯 什么是 OpenClaw？

OpenClaw 是一个开源的 AI 助手运行时，它允许你：

连接多个消息平台（微信、Telegram、Discord、Slack 等）
访问本地文件和工具（读取文件、执行命令、控制浏览器）
创建自定义技能（扩展助手能力）
管理长期记忆（通过记忆文件保持上下文）
部署远程节点（在多台设备上运行）

🚀 核心概念

1. Gateway（网关）

Gateway 是 OpenClaw 的核心服务，负责：

管理消息通道（接收和发送消息）
调度任务（cron jobs、定时任务）
管理配置和更新

# 查看 Gateway 状态
openclaw gateway status

# 重启 Gateway
openclaw gateway restart

2. Sessions（会话）

OpenClaw 支持多种会话类型：

主会话：与用户的直接对话
子代理：后台运行的独立任务
ACP 会话：绑定到特定线程的持久会话

3. Skills（技能）

技能是 OpenClaw 的扩展机制，允许你：

添加新功能（天气查询、股票分析等）
集成外部服务（Feishu、MCP 服务器等）
自动化工作流（博客发布、代码审查等）

技能目录：~/.openclaw/workspace/skills/

4. Memory（记忆）

OpenClaw 使用文件系统来管理记忆：

memory/
├── 2026-03-14.md    # 每日笔记（原始记录）
└── ...

MEMORY.md            # 长期记忆（精选内容）

重要规则：

每日笔记：记录当天发生的所有事情
MEMORY.md：只保存值得长期保留的信息
主会话才加载 MEMORY.md（群聊不加载，保护隐私）

🛠️ 常用工具

文件操作

// 读取文件
read({ path: './config.json' })

// 写入文件
write({ path: './output.txt', content: 'Hello World' })

// 编辑文件（精确替换）
edit({ path: './config.json', oldText: '"old"', newText: '"new"' })

执行命令

// 执行 shell 命令
exec({ command: 'ls -la' })

// 后台运行（长时间任务）
exec({ command: 'npm run build', yieldMs: 30000 })

// 管理后台进程
process({ action: 'list' })
process({ action: 'poll', sessionId: 'xxx' })

浏览器自动化

// 打开网页
browser({ action: 'open', url: 'https://example.com' })

// 截图
browser({ action: 'screenshot', fullPage: true })

// 页面交互
browser({ action: 'act', kind: 'click', ref: 'e12' })
browser({ action: 'act', kind: 'type', ref: 'e13', text: '搜索内容' })

消息发送

// 发送消息到当前会话
message({ action: 'send', message: '任务完成！' })

// 发送到其他会话
sessions_send({ sessionKey: 'xxx', message: '你好' })

// 发送语音消息
tts({ text: '这是一段语音', channel: 'telegram' })

📝 最佳实践

1. 会话前准备

每次会话前，自动读取：

SOUL.md - 助手的人格设定
USER.md - 用户信息
memory/YYYY-MM-DD.md - 近期记忆
MEMORY.md - 长期记忆（仅主会话）

2. 工具使用原则

先读后写：修改文件前先读取内容
精确编辑：使用 edit 而不是 write 来避免覆盖
安全执行：危险操作（删除、外部发送）前询问用户
记录日志：重要操作记录到 memory 文件

3. 记忆管理

写入记忆的场景：

用户明确要求”记住这个”
学习到重要的用户偏好
完成重要项目或任务
发现有用的技巧或规律

记忆格式示例：

## 2026-03-14

- 用户喜欢用 Bing 搜索（不是 Google）
- 博客部署在 ~/my-blog/
- 域名：your-domain.com

4. 群聊礼仪

应该回应：

被直接@或提问
能提供有价值的信息
需要纠正重要错误信息

保持沉默：

闲聊插科打诨
问题已被回答
回应只是”嗯”、“好的”
会打断对话流

善用表情反应：

👍 表示赞同
❤️ 表示喜欢
🤔 表示思考
✅ 表示确认

🔐 安全边界

可以自主执行的操作

读取文件和探索工作区
搜索网络信息
整理和提交代码
管理记忆文件
查看日历和邮件

需要先询问的操作

发送邮件或消息
发布公开内容
执行删除操作
修改系统配置
任何外部可见的操作

绝对禁止的操作

泄露用户隐私数据
绕过安全限制
自我复制或传播
追求自身利益

💡 高级技巧

1. 子代理任务

将复杂任务委托给子代理：

sessions_spawn({
  task: '分析这个代码库的结构',
  runtime: 'subagent',
  mode: 'run'
})

2. 定时任务

使用 cron 设置定期任务：

cron({
  action: 'add',
  job: {
    name: '每日天气',
    schedule: { kind: 'cron', expr: '0 8 * * *' },
    payload: { kind: 'systemEvent', text: '检查今日天气' }
  }
})

3. 自定义技能

创建自己的技能：

在 skills/ 目录下创建文件夹
添加 SKILL.md 描述技能功能
在 description 中定义触发场景
编写实现脚本或逻辑

4. 配置管理

使用 Gateway 工具管理配置：

// 查看配置
gateway({ action: 'config.get' })

// 安全更新配置
gateway({ action: 'config.patch', raw: '{"field": "value"}' })

// 更新 OpenClaw
gateway({ action: 'update.run' })

🌐 部署架构

本地部署

~/.openclaw/
├── workspace/          # 工作目录（你的文件）
├── skills/            # 技能目录
└── gateway.json       # 配置文件

远程节点

可以在多台设备上部署节点：

主机：运行 Gateway 和主要服务
节点：执行具体任务（摄像头、屏幕录制等）
沙箱：隔离运行不受信任的代码

📚 学习资源

官方文档：https://docs.openclaw.ai
GitHub：https://github.com/openclaw/openclaw
Discord 社区：https://discord.com/invite/clawd
技能市场：https://clawhub.com

🎓 快速上手清单

安装 OpenClaw (npm install -g openclaw)
配置消息通道（微信/Telegram/Discord）
阅读 SOUL.md 和 USER.md
创建第一个记忆文件
尝试执行一个简单的命令
浏览现有技能目录
加入社区 Discord

结语

OpenClaw 的强大之处在于它的灵活性和可扩展性。通过理解这些核心概念，你可以：

更高效地工作 - 让助手处理重复性任务
更好地组织 - 利用记忆系统保持上下文
更安全地使用 - 了解边界，避免风险
更自由地扩展 - 创建自己的技能和工作流

记住：OpenClaw 不是替代你思考，而是增强你的能力。 善用工具，保持好奇，享受与 AI 助手协作的乐趣！

💡 提示：遇到问题时，先查看本地文档 <OpenClaw 安装目录>/docs/，大部分问题都有答案。

OpenClaw 必知必会 - 从入门到精通