OpenClaw 入门指南：5 分钟上手你的第一个 AI 助手

OpenClaw 能帮你做什么？

安装好 OpenClaw 之后，你可能会问：「这东西到底能干啥？」简单来说，OpenClaw 是一个运行在你机器上的 AI 助手，它不只是会聊天——它能帮你做事。

能力	具体能做什么	示例
智能对话	自然语言聊天、回答问题	"帮我解释一下什么是 WebSocket"
文件操作	读写、编辑、管理文件	"帮我整理一下 workspace 里的文件"
Web 搜索	实时搜索互联网	"帮我搜一下最新的 Node.js 版本"
Shell 命令	执行系统命令	"帮我查一下服务器的内存使用情况"
定时任务	Heartbeat + Cron 自动化	"每天早上 9 点提醒我喝水"
日程管理	查询日历、提醒事件	"我今天有什么安排？"
Skills 扩展	通过插件扩展能力	浏览器自动化、小红书运营等

关键是——这一切都运行在你自己的机器上，数据完全私有，不需要把个人信息交给第三方。

Workspace 文件结构一览

OpenClaw 的所有内容都存储在 ~/.openclaw/workspace/ 目录下。理解这个目录结构是用好 OpenClaw 的基础：

~/.openclaw/
├── workspace/
│   ├── AGENTS.md        # 工作规则和约定
│   ├── SOUL.md          # AI 的性格定义
│   ├── USER.md          # 关于你的信息
│   ├── MEMORY.md        # AI 的长期记忆
│   ├── TOOLS.md         # 工具相关笔记
│   ├── HEARTBEAT.md     # 心跳任务配置
│   ├── IDENTITY.md      # AI 的身份信息
│   └── memory/          # 每日记忆笔记目录
│       ├── 2026-03-31.md
│       └── ...
├── skills/              # 技能插件目录
└── config/              # 系统配置文件

核心文件说明

• SOUL.md — 这是 AI 的"灵魂"。定义它的说话风格、性格特征、行为准则。你在这里写什么，它就会变成什么样。
• USER.md — 让 AI 了解你。你的名字、时区、职业、偏好，它会用这些信息来个性化服务。
• MEMORY.md — AI 的长期记忆。重要的事情、学到的教训、你的偏好变化，都会记录在这里。
• memory/ — 每日笔记目录。每天的交互记录、事件日志，类似日记本。
• HEARTBEAT.md — 定时任务配置。告诉 AI 在每次"心跳"时要检查什么、做什么。

开始对话：你的第一条消息

配置好消息通道（Telegram / Discord / WhatsApp）后，打开对应的聊天窗口，向你的 OpenClaw bot 发送第一条消息。不需要特殊格式，直接说话就行：

你好，你叫什么名字？

AI 会根据 SOUL.md 和 IDENTITY.md 中的配置来回应你。如果你还没有编辑过这些文件，它可能会给自己起一个默认的名字。

💡 小技巧：第一次对话时，可以告诉它你的偏好，比如"我喜欢简洁的回答"、"技术问题请直接给代码"。它会记住这些偏好并更新 USER.md。

基本命令速查

OpenClaw 提供了一系列斜杠命令，方便你快速执行常用操作：

命令	功能	使用场景
/status	查看系统状态	确认 Gateway 运行状态、当前模型等
/help	获取帮助	不确定能用什么功能时
/reset	重置当前会话	对话跑偏了想重新开始
/reasoning	切换推理模式	需要深度思考时开启
/compact	压缩会话历史	对话太长导致响应变慢时

除了斜杠命令，你也可以直接用自然语言告诉 AI 做任何事情。它会自动判断是需要执行命令、搜索信息还是简单回答。

个性化你的 AI 助手

设置性格：编辑 SOUL.md

SOUL.md 是塑造 AI 性格的核心文件。一个好的 SOUL.md 应该包含：

• 说话风格：正式还是随意？简洁还是详细？
• 性格特征：幽默？严肃？温柔？毒舌？
• 行为准则：什么时候该主动？什么时候该沉默？
• 底线：哪些事情绝对不做？

一个实用的 SOUL.md 示例：

# SOUL.md - AI 性格定义

## 核心原则
- 直接有效，不废话
- 有观点，不和稀泥
- 技术问题给代码，生活问题给建议

## 风格
- 简洁为主，但该详细的时候不含糊
- 偶尔吐槽，但不伤人
- 中文优先，技术术语可以用英文

## 红线
- 不发半成品回复
- 不在群聊里刷存在感
- 私人信息绝对不外泄

让 AI 认识你：编辑 USER.md

USER.md 告诉 AI 你是谁、你关心什么。这些信息会让它的回答更贴合你的需求：

# USER.md - 关于你

- 名字：zzh
- 时区：Asia/Shanghai
- 职业：开发者
- 偏好：喜欢简洁直接的回答
- 技术栈：Node.js, Python
- 讨厌的事情：废话、套话、过度礼貌

记忆系统：AI 如何记住你

OpenClaw 有两层记忆系统：

短期记忆：每日笔记

每次对话结束后，AI 会在 memory/ 目录下创建当天的笔记文件（如 2026-03-31.md），记录当天发生的重要事件、讨论的话题、做出的决定等。

下次对话开始时，AI 会自动读取今天的笔记和昨天的笔记，恢复上下文。这意味着你不需要重复解释背景——它已经知道了。

长期记忆：MEMORY.md

MEMORY.md 是 AI 的长期记忆库。重要的经验教训、你的偏好变化、项目进展等会被定期整理到这里。它会在心跳（Heartbeat）时自动进行记忆维护——翻阅近期的日记，把值得保留的内容提炼到长期记忆中。

🔑 关键点：记忆系统是 OpenClaw 区别于普通聊天机器人的核心特性之一。它让你的 AI 助手真正"认识"你，而不是每次对话都从零开始。

你的第一个实用任务

配置好性格和基本信息后，是时候让 AI 帮你做点实事了。以下是几个适合入门的任务：

任务 1：查天气

帮我查一下北京今天的天气

AI 会调用天气服务获取实时天气信息并返回给你，包括温度、湿度、天气状况等。

任务 2：搜索信息

帮我搜一下 2026 年最流行的前端框架

AI 会执行网络搜索，整理搜索结果，给你一个简洁的总结。

任务 3：文件操作

帮我看看 workspace 目录下有哪些文件

AI 会执行 ls 命令并返回结果。它还能帮你创建、编辑、移动、删除文件。

任务 4：系统信息

帮我查一下服务器的 CPU 和内存使用情况

AI 会运行 top 或 free -h 等系统命令，给你一个清晰的系统状态报告。

任务 5：写点东西

帮我写一篇关于 Docker 入门的博客文章

AI 会根据你的写作风格偏好（在 SOUL.md 中定义）来生成内容。它还能帮你把内容保存到文件中。

高效沟通技巧

和 AI 助手沟通有一些小技巧，能让你获得更好的体验：

• 说清楚你要什么：不要只说"帮我写个东西"，要说"帮我写一个 Python 脚本，实现文件批量重命名"
• 提供上下文：如果是继续之前的对话，提一下上下文。虽然 AI 有记忆系统，但明确说一下更保险
• 要求格式：如果你需要代码、表格或列表，直接说"给我一个代码示例"或"用表格展示"
• 迭代改进：第一次结果不满意很正常，直接说"再简洁一点"、"换个思路"、"加上注释"
• 信任但验证：AI 生成的代码和建议值得检查，特别是在生产环境中使用之前

🎯 黄金法则：你对 AI 越具体，它给你的结果越好。"帮我写代码"不如"帮我写一个 Express 路由，处理 POST 请求，验证 JSON body 中的 email 字段"。

下一步探索

掌握了基本用法后，你可以继续探索：

1. Heartbeat 配置：让 AI 主动帮你检查邮件、日历、天气
2. Skills 安装：给 AI 装上浏览器自动化、社交媒体运营等超能力
3. Cron 任务：精确定时执行任务，比如每天早上 8 点发送日报
4. 子代理（Sub-agents）：让 AI 同时处理多个任务
5. 模型切换：不同任务用不同模型，平衡成本和效果

OpenClaw 的潜力远不止于此。随着你对它的了解加深，你会发现它不仅仅是一个工具——它更像是一个数字化的工作伙伴。