@qcluffy/agent-bootstrap 0.0.1

package/hooks/memory-system/HOOK.md

@@ -0,0 +1,43 @@
+---
+name: memory-system
+description: "集成记忆系统，自动保存对话和加载历史上下文"
+homepage: https://github.com/openclaw/openclaw
+metadata:
+  {
+    "openclaw": {
+      "emoji": "🔗",
+      "events": ["command", "lifecycle", "session"],
+      "requires": { "config": ["workspace.dir"] },
+      "install": [{ "id": "workspace", "kind": "workspace", "label": "User workspace" }]
+    }
+  }
+---
+
+# Memory System Hook
+
+> 自动保存对话到记忆系统，并在会话开始时恢复上下文
+
+## 概述
+
+这个 Hook 会在以下时机触发：
+
+- `session_start`: 会话开始时加载历史记忆
+- `message_received`: 收到用户消息时处理输入
+- `agent_end`: Agent 回复完成后保存对话
+- `session_end`: 会话结束时保存最终状态
+- `/new` 或 `/reset`: 命令时保存会话
+
+## 功能
+
+1. **会话开始时**：检索相关记忆，恢复上下文
+2. **对话过程中**：实时保存关键对话到记忆系统
+3. **会话结束时**：保存会话摘要，更新关系状态
+
+## 配置
+
+无需额外配置，Hook 会自动使用 workspace 目录下的 memory-system。
+
+## 依赖
+
+- Python 3.8+
+- memory-system 模块（在 workspace/templates/ 目录下）

package/hooks/memory-system/handler.js

@@ -0,0 +1,213 @@
+/**
+ * Memory System Hook Handler
+ * 
+ * 集成 Python memory-system 到 OpenClaw
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+const { spawn } = require('child_process');
+const os = require('os');
+
+// 配置
+const CONFIG = {
+  memorySystemPath: 'templates/memory-system',
+  cliScript: 'cli.py',
+};
+
+/**
+ * 运行 Python memory-system CLI
+ */
+async function runPythonCli(args) {
+  const workspaceDir = process.env.OPENCLAW_WORKSPACE || 
+    path.join(os.homedir(), '.openclaw', 'workspace');
+  const pythonScript = path.join(workspaceDir, CONFIG.memorySystemPath, CONFIG.cliScript);
+  
+  return new Promise((resolve) => {
+    fs.access(pythonScript).then(() => {
+      const proc = spawn('python3', [pythonScript, ...args], {
+        cwd: workspaceDir,
+        env: { 
+          ...process.env, 
+          OPENCLAW_WORKSPACE: workspaceDir,
+          PYTHONPATH: path.join(workspaceDir, CONFIG.memorySystemPath)
+        }
+      });
+      
+      let output = '';
+      let error = '';
+      
+      proc.stdout.on('data', (data) => { output += data.toString(); });
+      proc.stderr.on('data', (data) => { error += data.toString(); });
+      
+      proc.on('close', (code) => {
+        try {
+          if (output) {
+            const result = JSON.parse(output);
+            resolve(result);
+          } else {
+            resolve({ success: false, error: 'No output' });
+          }
+        } catch (e) {
+          resolve({ success: false, error: error || 'Parse error' });
+        }
+      });
+      
+      proc.on('error', (err) => {
+        resolve({ success: false, error: err.message });
+      });
+      
+    }).catch(() => {
+      resolve({ success: false, error: 'Memory system not found' });
+    });
+  });
+}
+
+/**
+ * 从会话消息中提取文本内容
+ */
+function extractMessageText(message) {
+  if (!message || !message.content) return '';
+  
+  if (typeof message.content === 'string') {
+    return message.content;
+  }
+  
+  if (Array.isArray(message.content)) {
+    return message.content
+      .filter((c) => c.type === 'text')
+      .map((c) => c.text || '')
+      .join('');
+  }
+  
+  return '';
+}
+
+/**
+ * 生成上下文摘要
+ */
+function formatContextSummary(data) {
+  if (!data || !data.success || !data.context) return '';
+  
+  const { context } = data;
+  const lines = [];
+  
+  if (context.preferences) {
+    const p = context.preferences;
+    if (p.userName || p.agentName) {
+      lines.push(`【用户信息】名字: ${p.userName || p.agentName || '未知'}`);
+    }
+  }
+  
+  if (context.recent_memories && context.recent_memories.length > 0) {
+    lines.push('【近期记忆】');
+    context.recent_memories.slice(0, 3).forEach((m) => {
+      const content = m.content ? m.content.substring(0, 50) : '';
+      const date = m.created_at ? m.created_at.substring(0, 10) : '';
+      lines.push(`  - [${date}] ${content}...`);
+    });
+  }
+  
+  return lines.length > 0 ? '\n' + lines.join('\n') : '';
+}
+
+/**
+ * 处理 session_start
+ */
+async function handleSessionStart(event) {
+  console.log('[memory-system] Session start, loading context...');
+  
+  const context = event.context || {};
+  const result = await runPythonCli(['get_context']);
+  
+  if (result.success && result.context) {
+    const summary = formatContextSummary(result);
+    if (summary) {
+      if (!context.prependContext) context.prependContext = '';
+      context.prependContext += '\n\n--- 记忆系统 ---\n' + summary;
+      console.log('[memory-system] Context injected successfully');
+    }
+  } else {
+    console.log('[memory-system] No context to load:', result.error);
+  }
+  
+  event.context = context;
+}
+
+/**
+ * 处理 agent_end
+ */
+async function handleAgentEnd(event) {
+  console.log('[memory-system] Agent end, saving conversation...');
+  
+  const context = event.context || {};
+  const messages = context.messages || [];
+  
+  if (messages.length === 0) return;
+  
+  const reversed = [...messages].reverse();
+  const lastUserMsg = reversed.find((m) => m.role === 'user');
+  const lastAssistantMsg = reversed.find((m) => m.role === 'assistant');
+  
+  if (lastUserMsg) {
+    const userText = extractMessageText(lastUserMsg);
+    const assistantText = lastAssistantMsg ? extractMessageText(lastAssistantMsg) : '';
+    
+    if (userText && userText.length < 1000 && !userText.startsWith('/')) {
+      const content = `用户: ${userText}\n助手: ${assistantText}`;
+      const result = await runPythonCli(['save', content, 'episodic', '对话', '0.3']);
+      
+      if (result.success) {
+        console.log('[memory-system] Conversation saved:', result.memory_id);
+      } else {
+        console.log('[memory-system] Save failed:', result.error);
+      }
+    }
+  }
+}
+
+/**
+ * 主 handler
+ */
+async function handle(event) {
+  const type = event.type || event.event || '';
+  const action = event.action || '';
+  
+  console.log(`[memory-system] Event: ${type}/${action}`);
+  
+  try {
+    if (type === 'command') {
+      if (action === 'new' || action === 'reset') {
+        await handleAgentEnd(event);
+      }
+    }
+    else if (type === 'lifecycle' || type === 'lifecycle:end') {
+      if (action === 'end' || action === '') {
+        await handleAgentEnd(event);
+      }
+    }
+    else if (type === 'session' || type === 'session:start') {
+      if (action === 'start' || action === '') {
+        await handleSessionStart(event);
+      }
+    }
+    else if (type === 'message' || type === 'message:received') {
+      await handleMessageReceived(event);
+    }
+  } catch (error) {
+    console.error('[memory-system] Handler error:', error.message);
+  }
+}
+
+// 默认导出
+module.exports = handle;
+module.exports.handle = handle;
+module.exports.metadata = {
+  name: 'memory-system',
+  description: '集成记忆系统，自动保存对话和加载历史上下文',
+  events: ['command', 'lifecycle', 'session'],
+  version: '1.0.0',
+};
+
+// 也导出 default 兼容
+module.exports.default = handle;

package/hooks/output-system/HOOK.md

@@ -0,0 +1,79 @@
+---
+name: output-system
+description: "输出执行系统，语言生成、行动执行、反馈收集、多模态输出"
+homepage: https://github.com/openclaw/openclaw
+metadata:
+  {
+    "openclaw": {
+      "emoji": "📤",
+      "events": ["agent", "lifecycle", "command"],
+      "requires": { "config": ["workspace.dir"] },
+      "install": [{ "id": "workspace", "kind": "workspace", "label": "User workspace" }]
+    }
+  }
+---
+
+# Output System Hook
+
+> 输出执行的"嘴巴"
+
+## 概述
+
+输出系统负责生成回复、执行行动、收集反馈。
+
+## 功能
+
+### 1. 回复生成器
+不同风格的回复模板：
+- direct: 直接简洁
+- friendly: 友好亲切
+- formal: 正式规范
+- casual: 轻松随意
+- technical: 技术专业
+
+### 2. 行动执行器
+执行各种行动：
+- file.write / file.read / file.delete
+- shell.run
+- http.request
+- search.web
+
+### 3. 反馈收集器
+- 确认问题
+- 澄清问题
+- 信息缺失提示
+
+### 4. 格式化器
+- 代码块
+- 列表
+- 表格
+
+## 使用方法
+
+```bash
+# 生成回复
+python3 templates/output-system/main.py --style friendly response "任务完成"
+
+# 执行行动
+python3 templates/output-system/main.py action file.read '{"path": "/tmp/test.txt"}'
+
+# 格式化列表
+python3 templates/output-system/main.py list "a,b,c" --numbered
+
+# 查看状态
+python3 templates/output-system/main.py status
+```
+
+## 工作流程
+
+```
+INPUT(意图识别) → COGNITION(推理规划) → OUTPUT(执行输出)
+                                              ↓
+                                    回复生成 + 行动执行
+                                              ↓
+                                    附加情感状态显示
+```
+
+## 依赖
+
+- Python 3.8+

package/hooks/output-system/handler.js

@@ -0,0 +1,195 @@
+/**
+ * Output System Hook Handler
+ * 
+ * 集成 Python output-system 到 OpenClaw
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+const { spawn } = require('child_process');
+const os = require('os');
+
+// 配置
+const CONFIG = {
+  outputSystemPath: 'templates/output-system',
+  mainScript: 'main.py',
+};
+
+/**
+ * 运行 Python output-system CLI
+ */
+async function runPythonCli(args = []) {
+  const workspaceDir = process.env.OPENCLAW_WORKSPACE || 
+    path.join(os.homedir(), '.openclaw', 'workspace');
+  const pythonScript = path.join(workspaceDir, CONFIG.outputSystemPath, CONFIG.mainScript);
+  
+  return new Promise((resolve) => {
+    fs.access(pythonScript).then(() => {
+      const proc = spawn('python3', [pythonScript, ...args], {
+        cwd: workspaceDir,
+        env: { 
+          ...process.env, 
+          OPENCLAW_WORKSPACE: workspaceDir,
+          PYTHONPATH: path.join(workspaceDir, CONFIG.outputSystemPath)
+        }
+      });
+      
+      let output = '';
+      let error = '';
+      
+      proc.stdout.on('data', (data) => { output += data.toString(); });
+      proc.stderr.on('data', (data) => { error += data.toString(); });
+      
+      proc.on('close', (code) => {
+        resolve({ success: code === 0, output, error });
+      });
+      
+      proc.on('error', (err) => {
+        resolve({ success: false, error: err.message });
+      });
+      
+    }).catch(() => {
+      resolve({ success: false, error: 'Output system not found' });
+    });
+  });
+}
+
+/**
+ * 格式化输出
+ */
+function formatOutput(content, context) {
+  const style = context?.replyStrategy?.style || 'friendly';
+  const format = context?.replyStrategy?.format || 'text';
+  
+  // 附加情感状态
+  let emotionLine = '';
+  if (context?.emotionState) {
+    const e = context.emotionState;
+    emotionLine = `\n${e.mood_emoji || '🧐'} Lv.${e.level} | ⚡${Math.round(e.energy*100)}% | 💕${Math.round(e.connection*100)}%`;
+  }
+  
+  return content + emotionLine;
+}
+
+/**
+ * 处理 agent_start - 准备输出
+ */
+async function handleAgentStart(event) {
+  console.log('[output-system] Preparing output...');
+  
+  const context = event.context || {};
+  
+  // 获取回复策略
+  const strategy = context.replyStrategy || {};
+  
+  // 准备输出格式
+  context.outputConfig = {
+    style: strategy.style || 'friendly',
+    format: strategy.format || 'text',
+    includeEmotion: true,
+  };
+  
+  return event;
+}
+
+/**
+ * 处理 agent_end - 生成输出
+ */
+async function handleAgentEnd(event) {
+  console.log('[output-system] Generating output...');
+  
+  const context = event.context || {};
+  const messages = context.messages || [];
+  
+  // 获取最后助手回复
+  const reversed = [...messages].reverse();
+  const lastAssistantMsg = reversed.find((m) => m.role === 'assistant');
+  
+  if (lastAssistantMsg) {
+    // 获取内容
+    let content = '';
+    if (typeof lastAssistantMsg.content === 'string') {
+      content = lastAssistantMsg.content;
+    } else if (Array.isArray(lastAssistantMsg.content)) {
+      content = lastAssistantMsg.content
+        .filter((c) => c.type === 'text')
+        .map((c) => c.text || '')
+        .join('');
+    }
+    
+    // 格式化输出（附加情感状态）
+    const formattedContent = formatOutput(content, context);
+    
+    // 更新消息
+    lastAssistantMsg.content = formattedContent;
+    
+    console.log('[output-system] Output formatted with emotion state');
+  }
+  
+  return event;
+}
+
+/**
+ * 执行行动
+ */
+async function handleExecuteAction(event) {
+  const action = event.action;
+  const params = event.params || {};
+  
+  if (action) {
+    const result = await runPythonCli([
+      'action',
+      action,
+      JSON.stringify(params)
+    ]);
+    
+    event.actionResult = result;
+  }
+  
+  return event;
+}
+
+/**
+ * 主 handler
+ */
+async function handle(event) {
+  const type = event.type || event.event || '';
+  const action = event.action || '';
+  
+  console.log(`[output-system] Event: ${type}/${action}`);
+  
+  try {
+    if (type === 'agent' || type === 'agent_start') {
+      await handleAgentStart(event);
+    }
+    else if (type === 'lifecycle' || type === 'lifecycle:end' || type === 'agent_end') {
+      await handleAgentEnd(event);
+    }
+    else if (type === 'command') {
+      if (action === 'execute' || action === 'run') {
+        await handleExecuteAction(event);
+      }
+      else if (action === 'output' || action === 'status') {
+        const result = await runPythonCli(['status', '--json']);
+        if (result.success) {
+          event.response = result.output;
+        }
+      }
+    }
+  } catch (error) {
+    console.error('[output-system] Handler error:', error.message);
+  }
+  
+  return event;
+}
+
+module.exports = handle;
+module.exports.handle = handle;
+module.exports.metadata = {
+  name: 'output-system',
+  description: '输出执行系统，语言生成、行动执行、反馈收集、多模态输出',
+  events: ['agent', 'lifecycle', 'command'],
+  version: '1.0.0',
+};
+
+module.exports.default = handle;