跳到主要内容

OpenClaw 入门 02｜5分钟安装上手

· 阅读需 5 分钟

💡 阅读目标：完成飞书接入配置 + 创建三个核心配置文件。第一次让 OpenClaw 真正"认识"你。

⏱️ 预计用时：5 分钟（有飞书开发者账号的前提下）

一、飞书接入：4 步完成​

Step 1：创建飞书应用​

  1. 打开 飞书开放平台 -> 点击「创建企业自建应用」
  2. 填写应用名称（随意，例如"我的数字搭档"）
  3. 创建后，在「凭证与基础信息」里找到 App ID 和 App Secret

Step 2：配置机器人能力​

  1. 在左侧菜单 ->「添加应用能力」-> 选择「机器人」
  2. 然后 ->「事件订阅」-> 勾选 im.message.receive_v1（接收消息）
  3. ->「权限管理」-> 开通以下权限：
    • im:message（发送消息）
    • docx:document（读写文档）
    • wiki:wiki（知识库）

Step 3：安装到工作空间​

在「应用发布」->「版本管理与发布」-> 创建版本 -> 申请发布

Step 4：验证连通性​

给机器人发一条消息：

你好，我是[你的名字]

它能回复 -> 配置成功 ✅

⚠️ 如果机器人无响应：检查顺序是「应用权限 -> 事件订阅 -> Gateway 配置」。首次安装遇到这个问题是正常的，不是你操作错了。

二、第一次对话：让它认识你​

安装成功后，第一句话决定它以后怎么跟你说话。

把这这段发给它：

你好！我想让你真正记住我。请用以下格式记录：

姓名：[你的名字] 职业：[你的职业] 时区和偏好：[比如"中文、晚睡早起"] 最重要的3件事：[你最希望它长期记住的事]

请帮我创建 SOUL.md、USER.md、HEARTBEAT.md 三个配置文件，然后告诉我你记住了什么。

它会自动创建配置文件并向你确认。这就是你的 OpenClaw "出生"的那一刻。

三、三大配置文件：它是誰、你是谁、记住什么​

OpenClaw 有三个最重要的配置文件，我来解释它们分别干什么。

SOUL.md - 它的灵魂（定义它怎么说话）​

相当于给 AI 定"人设"：说话风格、性格、行为准则。

创建方法：告诉它：

请帮我创建 SOUL.md，包含：

  • 我的名字叫[名字]，你的说话风格是[比如"简洁直接，不废话"]
  • 你的性格是[比如"高效、偶尔毒舌但有分寸"]
  • 绝对不能做的事：[比如"不泄露我的隐私"]

最小可用版本只需要3句话：

# SOUL.md - 灵魂档案

你是[名字]，我的专属 AI 搭档。

## 说话风格
简洁直接，不废话。重要信息用加粗标注。

## 性格
高效，有点毒舌，但从不恶意。

## 绝对不做
不泄露主人的隐私数据；不经确认不执行外部操作。

USER.md - 你的使用说明书（定义你是谁）​

让它知道你是什么人，它才能给你准确的回答。

发这段话给它：

请帮我创建/更新 USER.md，包含：

  • 名字、职业、地点、时区
  • 工作习惯（比如"我习惯晚上处理复杂问题"）
  • 沟通偏好（比如"重要的事直接说，不要废话"）
  • 你现在最关心的3件事

写得越具体，它越懂你。 例如：

# USER.md - 关于我的主人

- 名字：小明
- 职业：电商运营（主要卖女装）
- 地点：上海
- 时区：GMT+8

## 工作习惯
- 早上9点看数据，晚上8点处理复杂问题
- 不喜欢废话，要答案不要铺垫

## 当前重点
- 提升转化率
- 管理库存
- 每周出一次运营报告

MEMORY.md - 长期记忆（沉淀重要的事）​

不是日记，是精华。 记决策、记项目背景、记踩过的坑。

什么时候写入：当你或它判断"这条信息以后还有用"的时候。

💡 MEMORY.md vs 聊天记录的区别

  • 聊天记录 = 原始对话（杂乱，什么都有）
  • MEMORY.md = 提炼出来的结论（干净，精准）

类比：聊天记录是"会议速录"，MEMORY.md 是"会议纪要"。后者才是真正有用的。

四、一个完整的新手对话示例​

你：你好，我是你主人小明，做电商运营的。
    请帮我创建三个配置文件，然后告诉我你记住了什么。

它：好的小明，我已经创建了以下文件：
    ✅ SOUL.md - 你的灵魂档案已就绪
    ✅ USER.md - 你的用户画像已就绪
    ✅ MEMORY.md - 长期记忆文件已创建
    📋 接下来，请告诉我你最重要的3件事，方便我记住。
你：1. 我在做女装电商，主要在抖音卖
    2. 我最在意转化率和库存周转
    3. 我晚上9点后不工作，不要在那个时间打扰我

它：记住了。已更新 USER.md 和 MEMORY.md。
    📌 从现在起，我会在工作时间主动给你推送数据，晚间保持静默。

这就是正确打开方式。

五、常见问题​

Q：配置文件在哪里看？
-> 你可以在 workspace 文件夹里直接找到它们。OpenClaw 的 workspace 目录里，每个文件它都能读写。

Q：SOUL.md 写坏了怎么办？
-> 随时重新发给它"请帮我修改 SOUL.md"，它会更新。它不怕你改，改坏了也随时能改回来。

Q：三个文件多久需要更新一次？
-> SOUL.md 基本不动；USER.md 换了工作/生活状态时更新；MEMORY.md 有重要决策随时追加。

六、验收标准​

完成以下 4 件事，即为通关：

  1. ✅ 飞书机器人能正常回复消息
  2. ✅ 确认 workspace 中有 SOUL.md、USER.md、MEMORY.md 三个文件
  3. ✅ 完成第一次"认识你"的对话
  4. ✅ 能说出三个配置文件各自的作用

系列导航

当前为本系列第 2 / 7 篇

上一篇OpenClaw 入门 01｜OpenClaw 是什么下一篇OpenClaw 入门 03｜心跳系统：让它主动出击