vault backup: 2026-03-17 12:39:28
This commit is contained in:
@@ -389,7 +389,9 @@ app.use("/mcp", async (c, next) => {
|
||||
- https://skills.sh/veithly/tavily-search/tavily-search: `npx skills add https://github.com/veithly/tavily-search --skill tavily-search`
|
||||
- 编程类
|
||||
- [x] ***using-superpowers***:强制Agent真正发挥高级能力。 #优化器
|
||||
- [ ] acpx:外部工具桥接器,可以用来控制ClaudeCode等编程工具,还需要额外配置。 #编程
|
||||
- [x] acpx:外部工具桥接器,可以用来控制ClaudeCode等编程工具,还需要额外配置。 #编程
|
||||
- OpenClaw特化类
|
||||
- [ ] [openclaw-workspace](https://github.com/win4r/openclaw-workspace):优化OpenClaw工作区。提示词:帮我用 openclaw-workspace 这个 skill 做一次 workspace审计/精简 AGENTS.md/ 优化 TOOLS.md"等。可以创建定时任务让他每周执行。
|
||||
- 进阶工具
|
||||
- [ ] brainstorming:一个关键词生成几十个独特角度和多种假设场景。 #创意生成器
|
||||
- [ ] copywriting:优化表达、打磨语调,不依赖老掉牙的一键生成模板。 #文字工匠
|
||||
|
||||
@@ -26,118 +26,107 @@
|
||||
# OpenClaw架构构思
|
||||
https://clawhub.ai/ Skill推荐:
|
||||
- Common
|
||||
- [x] ***find-skills***:在20万+Skills里自动找到所需工具。
|
||||
- [x] ***find-skills***:在20万+Skills里自动找到所需工具。 #导航员
|
||||
- [x] skill-creator:把你的工作流打包成可复用能力。 #工厂
|
||||
- [x] ***self-improving-agent***: 记录经验教训、错误和纠正措施,以实现持续改进。
|
||||
- [x] Summarize:使用 summarize CLI 对 URL 或文件进行汇总(网页、PDF、图像、音频、YouTube)。
|
||||
- [ ] 文档类
|
||||
- [ ] pdf-pro:合并、拆分、提取复杂PDF,无手动头疼。 #文档专家
|
||||
- 文档类
|
||||
- [x] pdf:合并、拆分、提取复杂PDF,无手动头疼。 #文档专家
|
||||
- [x] pptx:生成完整专业幻灯片,再也不用移动文本框。 #演示专家
|
||||
- [x] docx:创建结构化Word文档,直接用于官方用途。 #文书
|
||||
- [x] xlsx:带复杂公式和图表的Excel文件。 #数据分析师
|
||||
- 搜索相关
|
||||
- [x] GitHub 官方 MCP:claude mcp add github -- npx -y @modelcontextprotocol/server-github
|
||||
- [x] 搜索引擎类:输出的结果质量以及Token消耗量都不理想。
|
||||
- jina-reader:
|
||||
- https://clawhub.ai/ericsantos/jina-reader
|
||||
- https://skills.sh/sundial-org/awesome-openclaw-skills/jina-reader
|
||||
- Tavily
|
||||
- https://skills.sh/tavily-ai/skills/search: `npx skills add https://github.com/tavily-ai/skills --skill search`
|
||||
- https://skills.sh/tavily-ai/skills/research: `npx skills add https://github.com/tavily-ai/skills --skill research`
|
||||
- https://skills.sh/tavily-ai/skills/extract: `npx skills add https://github.com/tavily-ai/skills --skill extract`
|
||||
- https://skills.sh/veithly/tavily-search/tavily-search: `npx skills add https://github.com/veithly/tavily-search --skill tavily-search`
|
||||
- 编程类
|
||||
- [x] ***using-superpowers***:强制Agent真正发挥高级能力。 #优化器
|
||||
- [x] **acpx**:外部工具桥接器,可以用来控制ClaudeCode等编程工具,还需要额外配置。 #编程
|
||||
## Agent & Memory
|
||||
在默认工作区可以到以下文件,这些都是Agent提示词的主程部分:
|
||||
|
||||
| **文件名** | **角色定位** | **详细作用描述** |
|
||||
| ---------------- | ------------- | --------------------------------------------------------- |
|
||||
| **Bootstrap.md** | **引导程序/总纲** | 整个系统的入口。它负责协调其他模块,定义系统初始化的逻辑,并告诉 LLM 如何“读取”这一系列文件。 |
|
||||
| **SYSTEM.md** | **物理规则/底层协议** | 定义 AI 的基本运行准则。包含技术约束、输出格式要求(如必须使用 JSON)、安全边界和思考框架。 |
|
||||
| **IDENTITY.md** | **身份设定** | 定义“我是谁”。包含姓名、职业背景、专业领域和语气风格(Tone of Voice)。这是 AI 表层人格的来源。 |
|
||||
| **SOUL.md** | **核心价值观/灵魂** | 定义“我的底层逻辑”。包含道德准则、动机、偏好、情绪反应模型以及对待冲突的态度。它比 Identity 更深层。 |
|
||||
| **USER.md** | **用户画像/上下文** | 记录“你是谁”。包含用户偏好、当前任务背景、历史互动关键点。确保 AI 的响应具有针对性。 |
|
||||
| **TOOLS.md** | **能力清单/技能树** | 定义 AI 可以调用的外部函数或工具(如搜索、绘图、计算)。明确调用参数和返回格式。 |
|
||||
| **AGENTS.md** | **协作协议** | 定义多智能体协作逻辑。如果 AI 需要召唤“副手”或与其他代理交互,这里规定了沟通协议。 |
|
||||
| 文件 | 用途 | 加载时机 | 子 Agent 可见? |
|
||||
| ---------------------- | ------------------------------------- | ----------------------- | ----------- |
|
||||
| `AGENTS.md` | 启动序列、操作清单、行为规则 | 每次轮次(所有 Agent) | 是 |
|
||||
| `SOUL.md` | 人格、语气、价值观、连续性哲学 | 每次轮次(所有 Agent) | 是 |
|
||||
| `TOOLS.md` | 环境特定信息(SSH、TTS、摄像头、设备) | 每次轮次(主 Agent + 子 Agent) | 是 |
|
||||
| `USER.md` | 用户画像、偏好、关系背景 | 每次轮次(仅主会话) | 否 |
|
||||
| `IDENTITY.md` | 名称、Emoji、头像、自我描述 | 每次轮次 | 是 |
|
||||
| `HEARTBEAT.md` | 周期性检查任务和健康例程 | 每次心跳轮次 | 视情况而定 |
|
||||
| `BOOT.md` | 启动时执行的操作(需要 `hooks.internal.enabled`) | 网关启动时 | 否 |
|
||||
| `BOOTSTRAP.md` | 首次初始化脚本——用完即删 | 仅新工作区 | 否 |
|
||||
| `MEMORY.md` | 长期精华事实与铁律规则 | 仅主会话 | **永不** |
|
||||
| `memory/YYYY-MM-DD.md` | 每日会话日志 | 按 AGENTS.md 启动序列加载 | 否 |
|
||||
| `checklists/*.md` | 高风险操作的逐步指南 | 按需加载(从 AGENTS.md 引用) | 否 |
|
||||
### 各文件详解
|
||||
#### AGENTS.md — 操作手册
|
||||
这是每次会话中最先塑造 Agent 行为的文件(基础系统提示词之后)。它包含:
|
||||
- **启动序列**:有序列出需要在会话开始时读取的文件(SOUL → USER → MEMORY → 日志)
|
||||
- **清单路由表**:高风险操作 → 对应清单文件路径的映射
|
||||
- **安全规则**:哪些操作需要确认、哪些可以自主执行
|
||||
- **群聊规则**:在群聊中不应分享什么
|
||||
|
||||
**注意**:AGENTS.md 是规程文件,不是身份文件。人格和价值观属于 SOUL.md。
|
||||
|
||||
#### SOUL.md — 灵魂
|
||||
用第二人称书写("你不是一个聊天机器人,你正在成为某个人"),Agent 读取后将其内化为自我描述。
|
||||
包含:核心价值观、边界与底线、语气风格、关于连续性的哲学(每次会话都是全新开始,工作区文件就是记忆)。
|
||||
|
||||
#### TOOLS.md — 本地环境备忘录
|
||||
这是工作区中最容易被误用的文件。它应该是**当前机器的环境专属速查表**:SSH 主机、TTS 声音 ID、摄像头设备名称等。
|
||||
子 Agent 也会收到此文件——这是它们唯一的环境知识来源。请保持简洁,50 行以内为佳。
|
||||
|
||||
#### USER.md — 用户画像
|
||||
包含影响每次对话的人物相关事实:姓名、时区、语言偏好、沟通风格。
|
||||
仅在主会话中加载——绝不在群聊或子 Agent 会话中加载。
|
||||
|
||||
#### MEMORY.md — 铁律规则
|
||||
只保存"遗忘了就会出严重问题"的规则。每条规则要短且原子化,具有明确的行动指导意义。
|
||||
定期精炼(每月一次)。已经几个月没有出过问题的规则,可以考虑迁移到技能的 `SKILL.md` 文件中(更合适的归宿)。
|
||||
|
||||
#### checklists / * .md — 操作清单
|
||||
高风险操作(部署、网关重启、配置变更)的逐步指南。Agent 执行操作前主动读取对应清单。
|
||||
**正确模式** :AGENTS.md 只保留一行路由表条目,完整清单放在 `checklists/` 目录中(按需加载,不占用每轮 Token 预算)。
|
||||
---
|
||||
|
||||
## 2. 调用逻辑与顺序
|
||||
|
||||
|
||||
|
||||
**逻辑顺序如下:**
|
||||
1. **加载 `Bootstrap.md`**:确定系统引导协议,LLM 开始意识到自己是一个遵循 OpenClaw 协议的 Agent。
|
||||
2. **注入 `SYSTEM.md`**:建立底层规则。在产生任何性格之前,必须先确定“不能做什么”和“必须怎么思考”。
|
||||
3. **构建 `IDENTITY.md` 与 `SOUL.md`**:赋予生命力。LLM 此时从“纯粹的工具”转变为“具备特定性格的专家”。
|
||||
4. **读取 `USER.md`**:注入外部变量。AI 了解了交互对象,调整自己的姿态。
|
||||
5. **激活 `TOOLS.md` 与 `AGENTS.md`**:最后加载执行层。当 AI 明确了身份和规则后,再根据需要调用具体的手段。
|
||||
|
||||
|
||||
|
||||
1. Bootstrap 文件注入(新会话首个 turn)
|
||||
### 2. 调用逻辑与顺序
|
||||
按优先级读取顺序:
|
||||
AGENTS.md → SOUL.md → TOOLS.md → IDENTITY.md → USER.md
|
||||
|
||||
|
||||
|
||||
|
||||
2️⃣ 记忆文件读取
|
||||
• MEMORY.md — 长期记忆(仅私聊会话加载,群聊不加载)
|
||||
• memory/今天.md + memory/昨天.md — 日志(会话开始时读取)
|
||||
|
||||
3️⃣ Skill 加载(SKILL.md 注入)
|
||||
#### Skill 加载(SKILL.md 注入)
|
||||
三个来源,优先级从高到低:
|
||||
① < workspace >/skills(agent 独有)
|
||||
② ~/.openclaw/skills(全局共享)
|
||||
③ bundled skills(内置)
|
||||
同名 skill 高优先级覆盖低优先级
|
||||
|
||||
|
||||
|
||||
4️⃣ 会话历史
|
||||
已有的对话上下文(JSONL 存储)
|
||||
|
||||
|
||||
|
||||
5️⃣ 语义搜索(按需)
|
||||
agent 调用 memory_search 时,向量检索 MEMORY.md + memory/* .md
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
💡 建议:
|
||||
|
||||
#### 建议:
|
||||
如果你想把记忆用法精炼,推荐这样分层:
|
||||
|
||||
|
||||
|
||||
1. 通用行为规范 → AGENTS.md / SOUL.md(所有会话都加载)
|
||||
|
||||
2. 工具使用指南 → Skill 的 SKILL.md(按需触发加载)
|
||||
|
||||
3. 持久事实/偏好 → MEMORY.md(长期记忆)
|
||||
|
||||
4. 需要代码逻辑的 → Plugin(如自动 Token 管理、MCP 代理)
|
||||
|
||||
|
||||
|
||||
以 Redmine 为例的最佳实践:
|
||||
|
||||
• Skill:SKILL.md 写"怎么调用、什么时候触发、参数格式"
|
||||
|
||||
• Plugin:如果要做自动 Token 刷新、webhook 监听等,写成 Plugin
|
||||
|
||||
• MEMORY.md:只存"loujiajie 有权限的项目是 H78"这种事实
|
||||
|
||||
|
||||
|
||||
不建议把所有东西都塞进 MEMORY.md,
|
||||
### EmbeddingModel
|
||||
|
||||
|
||||
### 记忆移植方法
|
||||
|
||||
### 将记忆移植到Skill
|
||||
【Skill】= 教 agent "怎么做某件事"
|
||||
|
||||
• 本质是 SKILL.md(Markdown 指令)+ 可选脚本
|
||||
|
||||
• 注入到 agent 的上下文中,agent 按指令执行
|
||||
|
||||
• 适合:工具使用说明、操作流程、触发规则
|
||||
|
||||
• 例:RedmineSkill 告诉 agent 如何调用 MCP 查工单
|
||||
## Muti-Agent
|
||||
按照日常功能分出几个额外Agent,并让他们使用不同的Workspace。
|
||||
|
||||
@@ -81,26 +81,29 @@ POPO失忆:
|
||||
1. [x] 程世纪 Skill 接入
|
||||
2. [x] Freddy OpenClaw自拍Skill加入。
|
||||
3. [x] 程世纪Skill 添加发送文件到POPO的命令。
|
||||
4. [ ] OpenClaw 卡死问题解决。编写守护进程软件
|
||||
5. [ ] OpenClaw下载文件管理。
|
||||
6. [ ] OpenClaw Docker部署。
|
||||
7. [x] Grp账号申请
|
||||
8. [ ] grp 账号与龙虾关联问题解决。 https://open.popo.netease.com/docs/api/robot/msg-send
|
||||
9. [ ] Skill
|
||||
4. [ ] 记忆优化技能(TODO:需要加入确认内容):https://github.com/win4r/openclaw-workspace
|
||||
5. [ ] 三层记忆:https://www.bilibili.com/video/BV1JrNKz7EUv/?spm_id_from=333.337.search-card.all.click&vd_source=d47c0bb42f9c72fd7d74562185cee290
|
||||
6. [ ] LanceDB与插件:
|
||||
7. [ ] OpenClaw 卡死问题解决。编写守护进程软件
|
||||
8. [ ] OpenClaw下载文件管理。
|
||||
9. [ ] OpenClaw Docker部署。
|
||||
10. [x] Grp账号申请
|
||||
11. [x] ~~grp 账号与龙虾关联问题解决~~。 https://open.popo.netease.com/docs/api/robot/msg-send
|
||||
12. [ ] Skill
|
||||
1. [ ] AI PM
|
||||
1. [x] 多用户同时使用(stdIO)
|
||||
2. [ ] Cookie获取优化。
|
||||
3. [ ] HttpStream改造。
|
||||
4. [ ] 自动化拆单 易协作上的
|
||||
2. [ ] POPO 云文档 修改。
|
||||
10. [ ] MutiAgent
|
||||
13. [ ] MutiAgent
|
||||
1. [x] POPO 多Agent问题查找。
|
||||
2. [ ] 多Agent A2A协议。
|
||||
11. [ ] OpenClaw 体验优化
|
||||
14. [ ] OpenClaw 体验优化
|
||||
1. [ ] Subagent规则
|
||||
2. [ ] 铁律
|
||||
12. [ ] OpenClaw ACP 控制其他智能体。 https://www.bilibili.com/video/BV1X4wAzEEMe/?spm_id_from=333.1387.upload.video_card.click&vd_source=d47c0bb42f9c72fd7d74562185cee290
|
||||
13. [ ] OpenClaw控制 其他OpenClaw。
|
||||
15. [x] OpenClaw ACP 控制其他智能体。 https://www.bilibili.com/video/BV1X4wAzEEMe/?spm_id_from=333.1387.upload.video_card.click&vd_source=d47c0bb42f9c72fd7d74562185cee290
|
||||
16. [ ] OpenClaw控制 其他OpenClaw。
|
||||
|
||||
- 视频
|
||||
- [ ] 【🚀OpenClaw高级使用经验分享!2026年最强生产力!五分钟打造多Agent协作编程开发团队!模型容灾机制深度配置+云端Gateway操控本地macOS!】 https://www.bilibili.com/video/BV1pScgzXEB7/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
|
||||
|
||||
Reference in New Issue
Block a user