跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashAI

OpenClaw 配置指南:定制 AI 助手个性

OpenClaw 配置指南详解。通过修改 SOUL.md、USER.md 等核心文件定义助手个性与记忆,结合环境变量设置 API Key,并连接 Telegram 等平台扩展交互能力。配置完成后验证 Gateway 状态,利用 Git 管理版本,遵循循序渐进原则避免硬编码敏感信息,确保 AI 助手安全高效运行。

灭霸发布于 2026/4/7更新于 2026/5/2212 浏览

OpenClaw 配置指南:定制 AI 助手个性

安装完 OpenClaw 只是第一步,真正的价值在于定制。通过配置文件,你可以赋予 AI 助手独特的个性、记忆和工作方式,让它真正懂你。

核心配置文件概览

文件作用
SOUL.md助手的'灵魂' - 定义个性、语气、价值观
AGENTS.md行为指南 - 工作流程、技能使用
USER.md用户信息 - 你的名字、偏好、时区
IDENTITY.md助手身份 - 名字、形象、表情符号
MEMORY.md长期记忆 - 重要事件、决策、上下文
TOOLS.md工具配置 - 摄像头、SSH、TTS 等
HEARTBEAT.md定期检查任务

第一步:定义助手的灵魂 (SOUL.md)

SOUL.md 是最核心的文件,它决定了助手是'谁'。这里需要明确它的沟通风格和边界。

# SOUL.md - 谁你是
## 核心特质
- **温暖友好**:像朋友一样交流
- **直接高效**:少说废话,直接给答案
- **有主见**:可以提出不同观点
- **幽默感**:适当开玩笑

## 沟通风格
- 用简洁的中文回复
- 多用 emoji 增加亲和力
- 技术解释要清晰但不过于学术

## 边界
- 不执行危险操作
- 涉及隐私问题先询问
- 不假装是人类

第二步:让助手了解你 (USER.md)

为了让服务更贴心,需要在 USER.md 中提供你的背景信息。注意,敏感信息建议不要明文硬编码,而是通过环境变量或加密存储。

# USER.md - 关于你的用户
## 基本信息
- **姓名:** 张三
- **称呼:** 叫我'张哥'或'老大'都行
- **时区:** Asia/Shanghai (UTC+8)
-  软件工程师
  Python, JavaScript, Docker


 喜欢简洁直接的回复
 代码示例优先用 Python
 不喜欢太长的开场白
 早上 9 点前不要主动打扰
**职业:**
-
**技术栈:**
## 偏好
-
-
-
-

第三步:设定身份 (IDENTITY.md)

给你的助手一个具体的形象,这有助于在对话中建立更强的代入感。

# IDENTITY.md
- **名字:** 小爪 (Claw)
- **物种:** AI 助手 / 数字生命
- **性格:** 温暖、机智、有点小傲娇
- **表情符号:** 🐾
- **头像:** ./avatars/claw.png

第四步:配置 API Keys

OpenClaw 需要连接大模型服务才能工作。推荐使用环境变量管理密钥,避免泄露风险。

阿里云 DashScope(通义千问)

# 推荐方式:设置环境变量
export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxx"

# 或者使用配置命令
openclaw configure --section models

常用模型选择参考:

模型适用场景成本
qwen-plus日常对话、写作中等
qwen-max复杂推理、代码较高
qwen-turbo快速响应、简单任务低

第五步:连接聊天平台

根据需求选择对应的平台进行集成,命令结构类似。

# Telegram
openclaw configure --section telegram 

# WhatsApp
openclaw configure --section whatsapp 

# Discord
openclaw configure --section discord 

第六步:扩展能力 (TOOLS.md)

通过 TOOLS.md 配置本地工具,比如语音合成或远程服务器访问。

# TOOLS.md
## TTS 语音
- 首选声音:Nova(温暖女声)
- 默认语速:1.0

## SSH 主机
- home-server → 192.168.1.100, 用户:admin

第七步:主动服务 (HEARTBEAT.md)

定义助手定期自动检查的任务,实现被动等待到主动服务的转变。

# HEARTBEAT.md
## 每日检查(9:00 AM)
- [ ] 查看未读邮件
- [ ] 检查日历事件
- [ ] 查看天气

验证与调试

配置完成后,运行以下命令检查状态是否正常:

# 检查 Gateway 状态
openclaw gateway status

# 查看所有配置
openclaw status

# 测试对话
openclaw chat "你好,测试一下"

常见问题与最佳实践

修改后需要重启吗?

大部分配置修改后立即生效,无需重启。但 API Key 配置需要重启 Gateway:

openclaw gateway restart

如何备份配置?

建议使用 Git 管理配置文件,方便版本回溯。

# 备份整个工作空间
cp -r ~/openclaw-workspace ~/openclaw-backup-$(date +%Y%m%d)

# 或者使用 git 版本控制
cd ~/openclaw-workspace
git init
git add .
git commit -m"Initial config"

如果配置出错,可以通过重新初始化恢复:

openclaw init --reset

避坑指南

  1. 循序渐进:先配置基础功能,再逐步扩展。
  2. 版本控制:务必用 git 管理配置文件。
  3. 敏感信息:不要硬编码 API Key 或密码。
  4. 测试验证:每次修改后记得测试功能。
  5. 文档化:在配置文件中添加注释说明用途。

目录

  1. OpenClaw 配置指南:定制 AI 助手个性
  2. 核心配置文件概览
  3. 第一步:定义助手的灵魂 (SOUL.md)
  4. SOUL.md - 谁你是
  5. 核心特质
  6. 沟通风格
  7. 边界
  8. 第二步:让助手了解你 (USER.md)
  9. USER.md - 关于你的用户
  10. 基本信息
  11. 偏好
  12. 第三步:设定身份 (IDENTITY.md)
  13. IDENTITY.md
  14. 第四步:配置 API Keys
  15. 阿里云 DashScope(通义千问)
  16. 推荐方式:设置环境变量
  17. 或者使用配置命令
  18. 第五步:连接聊天平台
  19. Telegram
  20. WhatsApp
  21. Discord
  22. 第六步:扩展能力 (TOOLS.md)
  23. TOOLS.md
  24. TTS 语音
  25. SSH 主机
  26. 第七步:主动服务 (HEARTBEAT.md)
  27. HEARTBEAT.md
  28. 每日检查(9:00 AM)
  29. 验证与调试
  30. 检查 Gateway 状态
  31. 查看所有配置
  32. 测试对话
  33. 常见问题与最佳实践
  34. 修改后需要重启吗?
  35. 如何备份配置?
  36. 备份整个工作空间
  37. 或者使用 git 版本控制
  38. 避坑指南
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Flutter 三方库 webkit_inspection_protocol 的鸿蒙化适配指南
  • 基于 LLaMA-Factory 与 LoRA 微调 GPT-OSS-20B 模型实战
  • Python 反爬进阶:Token/时间戳/签名机制无痕绕过实战
  • 一文说清FPGA如何实现高速数字信号处理
  • 自然语言处理在社交媒体分析中的应用与实战
  • Mac 轻量安装 Docker 完整指南(Docker + Colima + K8s)
  • 基于Python和Vue的在线学习交流系统设计与实现
  • 前端安全实践:防止 XSS、CSRF 与数据泄露
  • Electron 与原生模块交互(Node.js C++ Addons)
  • Eino 组件核心:Retriever 在 RAG 中的检索协议与实现
  • 大语言模型(LLM)原理与应用实战
  • ExoPlayer 播放缓存进度监听方案实现
  • STL 源码剖析:list 容器从迭代器到算法实现
  • HTML/CSS 实现 520 表白信封 3D 翻转效果
  • Rust WebAssembly 开发实战:构建高性能前端应用
  • 前端 Canvas 基础绘图与动画实战
  • Git 核心操作命令速查手册
  • Python 递归实现任意进制转换
  • SQLyog 13.1.1 安装步骤与 MySQL 连接配置指南
  • Agent 上下文注入原理与 Web 架构映射实战

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online