OpenClaw 配置指南 - 定制你的 AI 助手个性

OpenClaw 配置指南 - 定制你的 AI 助手个性

📅 更新时间:2026 年 3 月
🎯 适合人群:已经安装 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(通义千问):

# 方式 1:使用配置命令 openclaw configure --section models # 方式 2:设置环境变量exportDASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxx"

常用模型推荐:

模型适用场景成本
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 定义助手定期检查的任务。

示例配置:

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

配置验证

完成配置后,运行以下命令验证:

# 检查 Gateway 状态 openclaw gateway status # 查看所有配置 openclaw status # 测试对话 openclaw chat "你好,测试一下"

常见问题

Q1: 修改配置文件后需要重启吗?

大部分配置修改后立即生效,无需重启。

但 API Key 配置需要重启 Gateway:

openclaw gateway restart 

Q2: 如何备份配置?

# 备份整个工作空间cp-r ~/openclaw-workspace ~/openclaw-backup-$(date +%Y%m%d)# 或者使用 git 版本控制cd ~/openclaw-workspace git init gitadd.git commit -m"Initial config"

Q3: 配置错了如何恢复?

# 重新初始化 openclaw init --reset

配置最佳实践

✅ 推荐做法:

  1. 循序渐进 - 先配置基础功能,再逐步扩展
  2. 版本控制 - 用 git 管理配置文件
  3. 定期备份 - 重要配置定期备份
  4. 文档化 - 在配置文件中添加注释
  5. 测试验证 - 每次修改后测试功能

❌ 避免做法:

  1. 不要硬编码敏感信息
  2. 不要一次性配置太多
  3. 不要忽略错误提示

下一步

配置完成后,你可以:

  1. 📝 开始和助手日常对话
  2. 🔧 安装技能扩展功能
  3. 📱 连接更多聊天平台
  4. 🧪 尝试高级功能

资源链接

  • 📚 官方文档:https://docs.openclaw.ai
  • 💬 社区 Discord:https://discord.com/invite/clawd
  • 🐙 GitHub 源码:https://github.com/openclaw/openclaw
  • 🔌 技能市场:https://clawhub.com
  • 📖 上一篇:OpenClaw 安装教程

有问题? 欢迎在评论区留言讨论!

觉得有帮助请点赞收藏支持~ 👍

下一篇预告:《OpenClaw 技能开发 - 创建第一个自定义技能》🚀

Read more

【前端高频面试题】 - TypeScript 篇

【前端高频面试题】 - TypeScript 篇 1. 请解释 TypeScript 是什么?它与 JavaScript 的核心区别是什么? 面试回答需突出 TS 的核心价值(类型安全)和与 JS 的关键差异,结构清晰: * TypeScript 定义:TS 是 JavaScript 的超集(Superset),在 JS 语法基础上增加了静态类型系统,最终会编译为纯 JS 运行(支持所有 JS 环境),核心目标是提升代码可维护性、减少运行时错误。 * 与 JavaScript 的核心区别(分点对比): 1. 类型系统:TS 有静态类型(编译阶段检查类型,变量声明时需指定/推断类型);JS 是动态类型(

Clawdbot Web Chat平台部署避坑指南:Qwen3:32B代理直连常见问题解析

Clawdbot Web Chat平台部署避坑指南:Qwen3:32B代理直连常见问题解析 1. 为什么需要这份避坑指南 你是不是也遇到过这样的情况:明明照着文档一步步操作,Clawdbot界面能打开,聊天框也能输入文字,可按下回车后——光标一直转圈,半天没反应,最后弹出“连接超时”或“API调用失败”?或者更糟,页面直接白屏、控制台报一堆502 Bad Gateway、ERR_CONNECTION_REFUSED? 这不是你的环境有问题,也不是Qwen3:32B模型本身不给力。真正卡住大多数人的,是Clawdbot与本地Ollama服务之间那层看似简单、实则脆弱的代理链路:从浏览器 → Clawdbot前端 → 内部反向代理(8080端口)→ Ollama网关(18789端口)→ Qwen3:32B模型。 这份指南不讲“如何安装Ollama”,也不重复官方启动命令。它只聚焦一件事:把你在真实部署中踩过的、查日志才定位到的、搜遍论坛都找不到答案的典型断点,一条条拎出来,配上可验证的检查项和一招见效的修复方法。全文基于实际生产环境反复验证,

轻松实现Office在线编辑:基于Collabora的Web集成指南

引言 在Web项目中嵌入Office文档编辑功能可以显著提升用户体验。Collabora Online基于LibreOffice核心,提供开源解决方案,支持主流格式(DOCX/XLSX/PPTX等)的实时协作编辑。以下指南详细介绍了如何部署和集成Collabora,实现媲美Office 365的网页端编辑体验。 核心组件与原理 Collabora Online Development Edition (CODE) 服务端提供文档渲染与协作引擎(通过Docker部署),前端通过<iframe>嵌入编辑窗口。 WOPI协议 定义Web应用与Office服务间的通信标准,关键操作包括文件加载、保存回调和权限控制。 部署Collabora服务端 环境要求 Linux服务器(Ubuntu/CentOS)、Docker。 步骤 拉取Collabora镜像: docker pull collabora/code 启动容器: docker run -t -d -p 9980:9980

【前端|2 ES6 + 核心语法全解析】

ES6 + 核心语法全解析(极简可运行代码 + 避坑 + 快速回顾) 前言 学 ES6 语法时总记混let/const作用域、箭头函数this指向、解构赋值传参规则,还踩过 “const 定义对象改属性报错”“模板字符串换行空格” 的坑,整理了 10 个高频核心语法的「问题 + 思路 + 极简例子」,每个例子都能直接复制运行,方便自己后续快速唤醒记忆,也能让新手看懂核心用法。 一、核心思路 / 概念 ES6(ECMAScript 2015)及后续版本是 JavaScript 的重大升级,核心是解决旧语法痛点 + 简化代码:比如用let/const解决var的全局 / 函数作用域混乱问题,用箭头函数简化回调写法并固定this指向,用解构 / 扩展运算符快速操作数组 / 对象,用Promise/Async-Await解决回调地狱。所有语法都围绕 “写更少的代码,做更多的事”,且完全兼容日常开发(