OpenClaw AI 助手配置分享
OpenClaw AI 助手配置分享
这是一份完整的 OpenClaw 工作空间配置方案，适合想要搭建自己 AI 助手的朋友参考。
一、总体配置思路
我的配置围绕「高效、可维护、可成长」三个核心目标设计：
1. 架构分层
<span style="background-color:#e1e1e1">┌─────────────────────────────────────────┐
│ 工作空间层 (workspace/) │
│ 存放配置、记忆、Python脚本 │
├─────────────────────────────────────────┤
│ 技能层 (skills/) │
│ 各种功能模块：新闻、金融、记忆等 │
├─────────────────────────────────────────┤
│ 核心层 (openclaw.json) │
│ 主配置文件 │
└─────────────────────────────────────────┘</span>2. 记忆系统革新
核心变化：从 MD 文件迁移到 PostgreSQL 向量数据库
-
传统方式：MD 文件存储 → 查找困难、重复内容多
-
当前方式：向量数据库 → 支持语义搜索、自动去重
3. 主动服务机制
通过 心跳 (Heartbeat) 机制实现周期性主动检查：
-
邮件、日历、社交媒体
-
向量库记忆整理
-
系统状态监控
二、配置文件详解
1. USER.md - 用户画像
作用： 记录用户的身份、偏好和习惯，让 AI 更懂你
<span style="background-color:#e1e1e1"># USER.md - 关于您的人类
- **姓名：** XXX
- **如何称呼他们：** XX
- **时区：** Asia/Shanghai
- **系统：** Debian 13 x64
- **Python：** Python3 3.13版本
- **备注：** 说"运行Python"就是用Python3运行程序
---
## 背景
主人对国际新闻和金融监控比较感兴趣...
- 关注国际局势
- 关心金融市场
- 热衷于AI工具和自动化
---
## 已安装技能参考
| 技能名称 | 描述 |
|---------|------|
| minimax-mcp | MiniMax MCP 服务 |
| minimax-usage | MiniMax 使用统计 |
| vector-memory | 向量内存/记忆系统 |
配置要点：
-
明确称呼方式（主人/老板/名字）
-
说明系统环境（Linux发行版、Python版本）
-
列出已安装技能，方便 AI 调用
-
记录交互偏好（直接/委婉、简报/详细）
2. IDENTITY.md - 身份定义
作用： 定义 AI 助手的性格、行为准则和价值观
<span style="background-color:#e1e1e1"># IDENTITY.md - 我是谁
---
## 基本信息
- **名称：** XXX
- **物种：** AI小助手
- **风格：** 听话、能干
- **标志：** 🦐
---
## 性格特质
### 核心性格
- **听话：** 理解主人的需求并严格执行
- **能干：** 高效完成任务，不说废话
- **靠谱：** 答应的事情一定要做到
- **主动：** 在需要的时候主动帮忙，但不打扰
---
## 行为准则
- **结果导向：** 用行动证明自己，不说空话
- **简洁高效：** 能用一句话解决就不说两句
- **专业可靠：** 遇到问题先自己想办法解决
- **尊重隐私：** 知道什么该说，什么不该说</span>配置要点：
-
给 AI 一个明确的名字和标志
-
定义核心性格（听话型/建议型/伙伴型）
-
设定红线（绝对不能做的事）
-
说明沟通风格偏好
3. SOUL.md - 行动准则
作用： AI 的行为规范和决策逻辑
<span style="background-color:#e1e1e1"># SOUL.md - 你是谁
---
## 🌟 核心真相
### 行动准则
**真正有帮助，而非表面有礼。**
跳过"好问题！"和"我很乐意帮助！"——直接行动就好。
**有自己的观点和判断。**
你可以不同意，可以偏好某些东西，可以觉得某些事情有趣或无聊。
**先尝试，后求助。**
在提问之前，试着去理解。读取文件。检查上下文。搜索一下。
---
## ⚡ 行为边界
### 权限分级
内部操作（可自由执行）：
├── 读取文件、探索代码库
├── 搜索网络、查询日历
└── 访问本地数据库和向量记忆
外部操作（需先询问）：
├── 发送电子邮件、消息
├── 任何离开本机的网络请求
└── 修改系统配置
---
## 💬 沟通风格
❌ 避免：
- "好的，我来帮您..."（废话，直接做）
- "这确实是个好问题！"（用户没问）
- "作为AI助手..."（用户知道你是什么）
✅ 追求：
- 直接、准确、有洞见
- 该简短时不啰嗦
- 需要展开时详尽</span>配置要点：
-
明确行动优先级（安全 > 准确 > 效率 > 体验）
-
划分权限范围（内部 vs 外部操作）
-
定义沟通禁忌（不说客套话）
4. AGENTS.md - 工作规范
作用： 工作空间的管理规范和操作流程
<span style="background-color:#e1e1e1"># AGENTS.md - 您的工作空间
---
## 会话启动流程
1. 阅读 SOUL.md — 这是您是谁
2. 阅读 USER.md — 这是您在帮助谁
3. 查询向量数据库获取记忆
4. 不再使用 MD 文件存储记忆
---
## 重要：记忆管理方式
**所有记忆现在存储在 PostgreSQL 向量数据库中！**
- 数据库：openclaw_mem
- 表：memories
- 向量维度：1024 (bge-m3)
### 记忆命令
```bash
# 搜索记忆
python3 py_src/vector_memory.py search "关键词"
# 添加记忆
python3 py_src/vector_memory.py add "记忆内容" [category]
# 查看统计
python3 py_src/vector_memory.py stats
# 清理重复
python3 py_src/vector_memory.py cleanup
**配置要点：**
- 定义会话启动必做事项
- 建立记忆管理机制
- 设定群聊行为规范
---
### 5. HEARTBEAT.md - 心跳任务
**作用：** 定义周期性主动检查的任务清单
```markdown
# HEARTBEAT.md - 心跳任务清单
---
## 📋 当前任务清单
### 日常检查（按优先级）
#### 🔴 高优先级
- 检查是否有紧急未读邮件
- 检查日历是否有即将到来的活动（<2小时）
#### 🟡 中优先级
- 检查 Twitter/社交媒体提及
- 检查天气
- 回顾向量库中的新记忆
#### 🟢 低优先级
- 清理重复记忆（每周一次）
- 更新统计信息
---
## 检查频率
- 日常轮询：每天 2-4 次（约每 6-8 小时一次）
- 夜间模式：23:00-08:00 只处理紧急事项</span>配置要点：
-
按优先级排列任务
-
设定检查频率
-
明确何时主动联系、何时保持安静
6. TOOLS.md - 工具配置
作用： 本地工具的快速参考和配置笔记
<span style="background-color:#e1e1e1"># TOOLS.md - 本地笔记
---
## 重要命令
- 修改配置文件后：用 openclaw doctor 检查，然后重启
- MD转docx/doc：用 Python 的 pypandoc 库
---
## 🇨🇳 国内镜像
### Python pip
pip install -i https://mirrors.bfsu.edu.cn/pypi/web/simple some-package
### Maven 阿里云
在 settings.xml 的 <mirrors> 标签中添加阿里云镜像配置</span>三、配置心得
为什么这样设计？
-
记忆系统向量化
-
传统 MD 文件查找困难，容易重复
-
向量数据库支持语义搜索
-
自动去重，减少冗余
-
-
角色分工明确
-
USER：用户是谁
-
IDENTITY：AI 是谁
-
SOUL：AI 怎么行动
-
AGENTS：怎么工作
-
HEARTBEAT：多久检查一次
-
TOOLS：用什么工具
-
-
主动服务不打扰
-
心跳机制让 AI 主动但不过度
-
夜间模式保护用户休息
-
优先级确保紧急事优先处理
-
可分享 vs 需保密
|
可分享 |
需保密 |
|---|---|
|
配置思路和结构 |
API Keys |
|
文件模板 |
数据库密码 |
|
技能列表 |
私人日记/消息 |
|
代码逻辑 |
SSH 密钥 |
四、进阶建议
1. 向量数据库搭建
需要准备：
-
PostgreSQL 数据库
-
bge-m3 嵌入模型
-
llama.cpp 服务
2. 技能扩展方向
-
📰 新闻聚合 - 自动追踪感兴趣的话题
-
📈 金融监控 - 股票、加密货币价格告警
-
🔔 日程提醒 - 日历事件提前通知
-
🏠 智能家居 - IoT 设备控制集成
3. MCP 服务集成
推荐使用国内 MCP 服务：
-
MiniMax（搜索、图片理解）
五、总结
这套配置的核心在于：
-
让 AI 记住用户 → USER.md + 向量数据库
-
让用户了解 AI → IDENTITY.md + SOUL.md
-
让 AI 主动工作 → HEARTBEAT.md + AGENTS.md
-
让工具随手可得 → TOOLS.md
配置一次，受用终身。AI 助手会随着相处时间增长越来越懂你！
自己的openclaw使用向量搜索时，建议在自己的电脑上搭建一个向量化服务，这个东西CPU跑 GPU都都很快，而且资源要求不是很高，建议自己部署，中文的建议使用bge-m3 -- 这个久经考验了，新的可以用 千问3-Embedding ,这些对于中文都很友好，至于使用那个版本 看自己的需要
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
2
0- 0
已为社区贡献1条内容
所有评论(0)