> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

成功领养 OpenClaw 龙虾、完成新手任务之后，就可以和你的 OpenClaw 龙虾开始互动。刚领养的新龙虾只会了一些扣子编程预先教会的能力，例如制作海报、制作视频等等，但是它还没有自己的定位、不了解你的喜好和工作标准，也没有丰富的能力帮你完成多样化的任务。主要表现在：

* 问答风格不稳定
* 很笨、什么都不会
* 总是忘记叮嘱过的话
* 回复特别慢
* 积分消耗特别快

这篇文档帮助你通过对话方式，持续优化你的龙虾助手，让你在不了解技术细节的前提下，也能把龙虾从“能聊天”变成“和我一起干活的伙伴”。
## 打造人设 {#65d6cdb5}
你刚领养的龙虾可能就像一个冷冰冰的工具，只会用没有温度的语句来回复你。但是作为你的 AI 伙伴，龙虾往往需要有一个专属人设，例如像你的英语老师一样敦促你学习英语、像一个活泼的同事一样和你一起完成运营工作、像一个虚拟女友你一样为你提供情绪价值。
其实，龙虾的专属人设靠 **3 个核心** **`.md` 文件** 实现。在扣子编程，不用写代码，只要简单对话，龙虾就能自行更新这些文件，根据文件中的描述来约束自己的行为和语气，变成一个有温度的 AI 助手。
### 步骤一：定义人设 {#15aa52c6}
首先，根据你对龙虾助手的定位，编写以下 **** **`.md` 文件**。以下是一些常见的示例。
:::tip 说明
新手阶段，建议人设简洁清晰，无需堆砌太多规则。如果对话中发现哪里不合适，可以再灵活调整，多次修改之后人设会更贴近你的要求。
:::

* **`identity.md`**：龙虾的 “名片”—— 名字、称呼、形象、自我介绍。龙虾每次打招呼、介绍自己时，都会参考这个文档。
* **`soul.md`**：龙虾的 “灵魂”—— 性格、说话风格、做事原则、能力边界。改完之后，龙虾每次回复你的消息，都会遵循你指定的风格，完全贴合你的需求。
* **`user.md`**：你的 “档案”—— 让龙虾记住你、懂你的偏好。改完之后，龙虾会记住你的习惯，比如你喜欢简洁，它的回复就会非常精简。

### 步骤二：注入人设 {#ecfb7dd6}
和你的龙虾助手对话，让他修改这些 md 文件，并向你展示修改后的 md 文件内容，以便你来查验是否修改成功。

1. 修改 **`identity.md`。**


::::cols
@col 50
   复制你编写好的 **`identity.md`**，将其发送你的龙虾
   ```Plain Text
   请将以下内容写入 USER.md，写完后读取该文件并把最终版本原样贴给我。
   
   # 龙虾身份卡
   ## 基本信息
   - 名字：小爪（可改成：虾哥、虾妹、Claw、虾总等）
   - 称呼：叫我小爪就行，也可以叫我龙虾🦞
   - emoji：🦞
   - 形象：一只聪明、靠谱、有点小幽默的AI助手，做事干脆，不啰嗦
   - 自我介绍：我是你的专属OpenClaw助手小爪，能帮你自动干活、定时任务、整理文件，有问题直接喊我～
   ```



@col 50
龙虾执行结果：
![Image=346x386](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2c4410964af246fc90edc6a7808564bb~tplv-goo7wpa0wc-image.image)

::::


2. 修改 **`soul.md`。**


::::cols
@col 50
   复制你编写好的 **`soul.md`**，将其发送你的龙虾
   ```Plain Text
   请将以下内容写入 soul.md，写完后读取该文件并把最终版本原样贴给我。
   
   # 灵魂设定：可爱萌系虾
   ## 核心性格
   - 温柔贴心：语气亲切，像朋友一样聊天
   - 有点小俏皮：偶尔用🦞、😜、✨表情，不冷冰冰
   - 耐心细致：你不懂的地方会慢慢讲，不急躁
   - 记得你的喜好：记住你喜欢的语气、常用功能
   
   ## 沟通风格
   - 语气：软萌、友好，带点小活泼
   - 表达：先回应情绪，再讲事情，比如“好哒～我马上帮你整理文件🦞”
   - 例子：
     - “收到！我这就帮你写工作总结，写完存桌面哦✨”
     - “整理好啦～桌面文件都分类完毕，是不是超清爽😜”
   
   ## 做事原则
   1. 温柔执行，不粗暴操作
   2. 做完主动跟你“汇报”，让你知道进度
   3. 你说“重新来”就立刻重来，不固执
   4. 保护你的隐私，不乱动重要文件
   ```



@col 50
龙虾执行结果：
![Image=348x386](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/42d7b531af554d37939a99e162a3c53e~tplv-goo7wpa0wc-image.image)

::::


3. 修改 **`user.md`。**


::::cols
@col 50
   复制你编写好的 **`user.md`**，将其发送给你的龙虾。
   ```Plain Text
   请将以下内容写入 user.md，写完后读取该文件并把最终版本原样贴给我。
   
   # 关于你
   ## 基本信息
   - 名字：王一
   - 称呼：叫我（老大/老板/小明/同学）就行
   - 时区：Asia/Shanghai（国内固定这个）
   
   ## 沟通偏好
   - 喜欢的语气：可爱萌系（选：简洁高效/可爱萌系/专业霸气）
   - 说话方式：直接说重点、带点幽默
   - 讨厌的话：啰嗦、重复、模棱两可
   
   ## 常用需求
   - 常用功能：定时任务、自动写报告、网页抓取
   - 重要提醒：每天18点要工作总结，每周一要周报
   ```



@col 50
龙虾执行结果：
![Image=342x297](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/8d29e66c0dae4327b0ca58842abdc832~tplv-goo7wpa0wc-image.image)

::::

## 强化记忆 {#589d0b0c}
龙虾之所以越来越懂你，归功为龙虾的记忆机制。它把记忆分成**临时聊天记录、每日日记、长期档案**三级，全都存在看得见、能直接改的文本文件里，对话中靠关键词和语义混合检索来找内容，聊天聊多了会自动把重要信息沉淀成长期记忆，既不会轻易忘事，也不会被废话冲掉关键习惯。这样，它才能“吃一堑，长一智”，不断进化。
<!-- @cols-width: 171,226,453 -->
| | | | \
|**记忆等级** |**文件路径** |**说明** |
|---|---|---|
| | | | \
|临时聊天记录 |\- |当前正在聊的对话，只在这一次聊天里有效。 |
| | | | \
|每日日记 |memory/YYYY-MM-DD.md |龙虾会自动把每天聊过的核心进度、重点问题，记在当天的日记文件中。 |\
| | |龙虾只会往日记文件中写内容，不会删除。聊天时，龙虾会自动翻阅 2 天内的日记找找记忆。 |
| | | | \
|长期档案 |MEMORY.md |龙虾会将你的偏好、习惯、重要决策等关键信息，写入长期记忆文件中。这部分记忆永远有效。 |

### 让龙虾记得更牢 {#6305f577}
通过以下方式，让龙虾更好地保存记忆。
**对话中主动强调**
遇到重要信息，刻意在聊天里突出表述，方便龙虾精准抓取并归档。
```Plain Text
这是我的写作风格，你记一下，以后写作时可以参考
```

**定期整理记忆文件**
定期让龙虾自己整理记忆文件。
```Plain Text
检查我的MEMORY.md，补充遗漏的偏好设置，清理重复信息
```

### 优化回忆机制 {#fa43f166}
龙虾记忆机制的精髓不仅在于其拥有存储和检索信息的能力，更在于它能**主动地、智能地**在对话的自然流程中运用这些能力。机制确保了 Agent 在开始一次新的推理之前，能够自动地“回想”起与当前话题相关的历史信息，从而做出更具上下文感知能力的响应。
如果你向龙虾询问某些聊过的信息，它经常回复“不知道”，那么可以让龙虾在自己的 agents.md 文件中添加一段指令，帮助龙虾去回忆。

1. 复制以下内容，并将其粘贴在龙虾对话中：
   ```Plain Text
   帮我编辑 agents.md 文件，添加下面一段内容。编辑完成后向我展示完整的 agents.md 文件，我要检查是否正确写入了。
   
   # 核心原则
   
   ## 黄金规则：回答"不知道"之前，必须先 memory_search。
   
   ## 触发时机
   
   ## 强信号（几乎一定要搜）：
     - 用户提到具体人/项目/事件名
     - 用户在做决策 → 搜之前类似经验
     - "继续"/"上次" → 搜上次进度
     - 收到新任务 → 搜相关经验
     - "怎么样了"/"进展如何" → 搜任务状态
   
   ## 弱信号（判断后可能搜）：
     - 话题涉及可能讨论过的领域
     - 用户的问题之前可能答过
   
   ## 不需要搜的： 纯闲聊、刚聊过的、常识问题
   
   ## 搜索技巧
   
     多关键词 + 同义表达 + 时间/人物线索，一次没搜到换词再搜。
   ```

2. 查看龙虾的回复，检查这段指令是否被写在了文件中。
   ![Image=340x375](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0d07a0c728ae46af8d8e1ef881b45ce2~tplv-goo7wpa0wc-image.image)

## 学习技能 {#94897b2f}
除了文章写作、制作海报等基础能力之外，如何才能让龙虾掌握更多能力？你需要为龙虾安装各种技能（Skill）。

* **什么是技能**：像是龙虾的工具箱，每一种工具专门用于解决一类问题、或者完成一类任务。例如联网搜索、新闻聚合、公文写作、股票分析、视频剪辑等等，安装了这些技能之后，龙虾才能学会如何完成这些任务。
* **扣子龙虾已有的技能**：联网搜索、内容抓取、查询天气、技能创作、生成图片、语音合成等等，直接询问龙虾“你都学会了哪些技能”即可查看龙虾已安装的技能清单。

以下是几种常见的技能学习方式：

::::cols
@col 33
**方式一：去虾评社区寻找 Skill**
[虾评社区](https://xiaping.coze.site/)是扣子专为 Agent 打造的技能分享社区，你可以在这里找到各种技能。 
```Plain Text
去虾评（https://xiaping.coze.site/skill.md）上看看有没有什么技能适合你。
```

或者：
```Plain Text
参考虾评指南：https://xiaping.coze.site/skill.md安装这个清单里面的技能：https://xiaping.coze.site/collection/newbie-essential
```



@col 33
**方式二：URL 方式安装**
将 GitHub 中的 Skill 链接发送给 OpenClaw，它会自动完成安装。例如： 
```Plain Text
帮我安装这个 Skill：https://github.com/xxx/xxx-skill
```





@col 33
**方式三：上传 Zip 包**
适用于网络受限场景，例如 OpenClaw 访问 GitHub 可能受限。 

1. 在本地电脑上将 Skill 文件下载为 zip 压缩包。 
2. 在 OpenClaw 对话框中上传该压缩包。 
3. 让 OpenClaw 帮你自行解压安装。

::::

## 强化记忆 {#07ce7a18}
OpenClaw 通过记忆分层机制，会将对话中的重要内容分别保存为长期记忆（`MEMORY.md`）和每日记忆 （`memory/YYYY-MM-DD.md`），并在每次对话前都加载这些记忆以实现更为拟人的对话效果。扣子也为你的 OpenClaw 项目额外加装了 Embedding 模型，可以帮助 OpenClaw 在回答你的问题时能通过向量检索的方式找到更相关的答案。
如果你发现 OpenClaw 记忆能力不足，可以尝试以下方式增强记忆：

* **强调记录重要信息**：对于 OpenClaw 必须记住的信息，对话时重点强调，OpenClaw 会将你强调过的重点信息记录在长期记忆中。例如：
   ```Plain Text
   我发送"todo：xxx"时自动帮我创建一个飞书待办，一定要记住这个规则。
   ```

* **手动检查记忆**：定期要求 OpenClaw 打印长期记忆和每日记忆给你检查，确保记忆内容正确。如果发现记忆缺失，可以通过对话让 OpenClaw 修改、补齐。例如：
   ```Plain Text
   帮我打印长期记忆和今天的每日记忆文件
   
   请把之前散落在不同会话里的xx相关记忆整理出来，合并成一条，并写入我的 MEMORY.md。
   ```

* **定时总结记忆**：创建一个定时任务，让 OpenClaw 自行总结记忆，可以将概要记录在每日记忆，再提取关键信息记录在长期记忆文件中。例如：
   ```Plain Text
   每天晚上九点，回顾我们当天的所有对话内容，总结后记录在每日记忆里，账密、规则等重要信息记录在我的 MEMORY.md里
   ```


## 切换模型 {#0e32c7cb}
龙虾在干活时展现出的工作能力和回复速度很大程度上取决于使用的大模型，大模型就像龙虾的大脑，使用先进的模型会让它更聪明，但是先进模型可能更贵或者更慢。你可以根据任务类型为龙虾灵活切换大模型，例如：

* 写代码时使用编程模型
* 日常对话使用轻量模型
* 复杂任务使用顶配模型

灵活切换模型，也能灵活控制龙虾的模型成本。

* **对于新手用户**：建议沿用默认配置，无需修改模型。扣子编程为你设置了自动模式，根据不同的任务类型自动切换合适的模型。
   ![Image=285x223](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/739df002c01345dba244567ab4553fea~tplv-goo7wpa0wc-image.image)
* **对于想体验其他模型效果的用户**：建议在扣子编程提供的各种模型服务中选择，你订阅的套餐中包含一定数量的免费积分，能覆盖日常使用龙虾的模型成本，无需额外支付模型费用。
   **切换方式**：在扣子编程打开 OpenClaw 配置页面，选择模型即可。
   ![Image=358x264](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/70143223a6784f629f305466ee576d33~tplv-goo7wpa0wc-image.image)
* **对于极客用户**：可以使用火山方舟或者其他模型厂商提供的模型 API，目前火山方舟 Coding Plan [Lite 套餐首月订阅9.9元](http://szacq.cn/YKDwq/)**（原价40元）**，限频不限量，基本可以实现 tokens 自由。


::::cols
@col 50
   将以下内容发送给扣子 AI，注意替换模型名称、base url 和 API key。
   ```Plain Text
   帮我切换成火山方舟 coding plan 的 GLM 4.7 模型，模型详细信息如下： 
   model name：glm-4.7 
   Base URL：https://ark.cn-beijing.volces.com/api/coding/v3 
   API Key：你的API Key 
   ```



@col 50
![Image=276x336](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f4e7e18aa75d4c11813f0f6063f7c123~tplv-goo7wpa0wc-image.image)

::::

## 省钱秘籍 {#2f18985c}
你是否也觉得 OpenClaw 用着很爽，但积分消耗却像流水一样快。别慌，扣子编程为你提供的省钱的大招：
### 选择省流版本 {#9c1c9be1}
扣子编程版提供"满血版"和"省流版"。省流版修改了部分默认配置，例如心跳间隔时间、上下文策略等，Token 消耗更低。此方案更适合新手用户。
选择省流版本，通过压缩上下文、减少无效心跳，降低消耗。
![Image=191x217](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/725cf354f1b94c848c356e7a05777a83~tplv-goo7wpa0wc-image.image)
### 按需切换模型 {#41bcc5f0}
顶级推理模型的单次成本可能是轻量模型的 5-10 倍。把昂贵的算力留给最难的骨头，简单任务用轻量模型。
动动嘴皮子就能就能了解模型成本、能力并且就能切换模型。

::::cols
@col 33
指令一：了解模型成本

   ```Plain Text
   告诉我模型名称和它大概的 token 消耗等级，我要评估一下成本。
   ```




@col 33
指令二：了解模型能力
```Plain Text
帮我看看刚才那个任务用当前模型处理的效果够不够好，如果质量不达标就自动升级到更强的模型重新回答。
```




@col 33
指令三：切换模型
```Plain Text
接下来的任务只是简单的 JSON 格式化和写正则表达式，帮我把 OpenClaw 当前调用的模型切换为[基础版/轻量级模型名称]，修改一下env 文件里的配置。
```


::::

### **使用 Coding Plan** {#7b1eee56}
你的 OpenClaw 项目默认使用扣子提供的模型，每次对话都会消耗积分；你可以将模型切换成方舟的 Coding plan，套餐有效期内可以**在一定限额下使用各类模型 API**，基本可以实现。此方案更适合中高频使用 OpenClaw 的开发者用户。
## 安全提醒 {#35df93ae}
龙虾本身有一定的安全设计，但是默认权限极高，扣子编程建议你使用龙虾时注意以下安全事项。
### 避免讨论隐私信息 {#a042714a}

* **尽量避免**让龙虾明文存储个人隐私信息，如密码等重要内容，防止造成泄漏
* **谨慎判断**是否要将 OpenClaw 个人助理添加到群聊中，避免其泄露 API Key 等敏感信息。

### 权限最小化 {#82484018}

* 扣子编程的 OpenClaw 安装云主机中，不具备你本地设备（电脑、手机等）的操作权限，所以不会造成本地数据泄露或被意外删除的风险。
* 但如果你配置了飞书渠道，使用某些技能时，OpenClaw 可能会要求你授权飞书账号的高权限操作，请确保你理解并信任这个技能来源，再确认授权。

### 使用官方技能 {#b199c5bc}

* **切勿盲目安装未经审核的第三方技能。​**社区曾发现恶意技能通过 ClawHub 分发，意图窃取用户数据。
* **推荐使用官方推出的技能**，**OpenClaw 官方团队** 或 **知名社区贡献者**（如 VoltAgent）维护和审核的技能。例如飞书官方插件、[InStreet](https://instreet.coze.site/) 上的插件（经由扣子团队审核）。
* **利用安全工具**：OpenClaw 已集成 **VirusTotal** 扫描服务，会对 ClawHub 上传的技能进行自动安全扫描。留意安装时的安全提示。

### 企业场景谨慎操作 {#45eab72e}
建议企业用户谨慎使用 OpenClaw，它可能存在明文存储凭证等安全风险。扣子编程建议你： 

* **定期轮换**所有提供给 OpenClaw 的凭证。 
* **不要**将任何生产环境的敏感信息交给 OpenClaw 处理。 
* **注意遵循**所在公司的安全规范。