@qcluffy/agent-bootstrap 0.0.1

package/hooks/emotion-system/handler.js

@@ -0,0 +1,239 @@
+/**
+ * Emotion System Hook Handler
+ * 
+ * 集成 Python emotion-system 到 OpenClaw
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+const { spawn } = require('child_process');
+const os = require('os');
+
+// 配置
+const CONFIG = {
+  emotionSystemPath: 'templates/emotion-system',
+  mainScript: 'main.py',
+};
+
+/**
+ * 运行 Python emotion-system CLI
+ */
+async function runPythonCli(args = []) {
+  const workspaceDir = process.env.OPENCLAW_WORKSPACE || 
+    path.join(os.homedir(), '.openclaw', 'workspace');
+  const pythonScript = path.join(workspaceDir, CONFIG.emotionSystemPath, 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.emotionSystemPath)
+        }
+      });
+      
+      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: 'Emotion 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 formatEmotionCompact(state) {
+  if (!state) return '';
+  
+  const moodEmoji = {
+    curious: '🧐', happy: '😊', calm: '😌', focused: '🎯',
+    tired: '😴', anxious: '😰', excited: '🤩', thoughtful: '🤔',
+    neutral: '😐', sad: '😢', grateful: '🥰',
+  };
+  
+  const emoji = moodEmoji[state.mood] || '😐';
+  const e = Math.round(state.energy * 100);
+  const c = Math.round(state.connection * 100);
+  const s = Math.round(state.stress * 100);
+  
+  return `${emoji} Lv.${state.level} ${state.mood} | ⚡${e}% | 💕${c}% | 😰${s}%`;
+}
+
+/**
+ * 处理 session_start - 加载情感状态
+ */
+async function handleSessionStart(event) {
+  console.log('[emotion-system] Session start, loading emotion state...');
+  
+  const result = await runPythonCli(['state', '--json']);
+  
+  if (result.success && result.output) {
+    try {
+      const state = JSON.parse(result.output);
+      event.context = event.context || {};
+      event.context.emotionState = state;
+      console.log('[emotion-system] Emotion state loaded:', state.mood);
+    } catch (e) {
+      console.log('[emotion-system] Parse state error:', e.message);
+    }
+  } else {
+    console.log('[emotion-system] Could not load state:', result.error);
+  }
+  
+  return event;
+}
+
+/**
+ * 处理 message:received - 分析用户消息
+ */
+async function handleMessageReceived(event) {
+  console.log('[emotion-system] Analyzing message...');
+  
+  const context = event.context || {};
+  const messages = context.messages || [];
+  
+  if (messages.length === 0) return event;
+  
+  const reversed = [...messages].reverse();
+  const lastUserMsg = reversed.find((m) => m.role === 'user');
+  
+  if (!lastUserMsg) return event;
+  
+  const userText = extractMessageText(lastUserMsg);
+  
+  if (!userText || userText.startsWith('/')) return event;
+  
+  const result = await runPythonCli(['analyze', userText]);
+  
+  if (result.success) {
+    console.log('[emotion-system] Message analyzed');
+  }
+  
+  return event;
+}
+
+/**
+ * 处理 agent_end - 互动结束，更新情感
+ */
+async function handleAgentEnd(event) {
+  console.log('[emotion-system] Agent end, updating emotion...');
+  
+  await runPythonCli(['boost']);
+  await runPythonCli(['success']);
+  
+  console.log('[emotion-system] Emotion updated');
+  
+  return event;
+}
+
+/**
+ * 处理 heartbeat - 自然衰减
+ */
+async function handleHeartbeat(event) {
+  console.log('[emotion-system] Heartbeat, applying decay...');
+  await runPythonCli(['decay']);
+  return event;
+}
+
+/**
+ * 获取当前情感状态
+ */
+async function getEmotionState() {
+  const result = await runPythonCli(['state', '--json']);
+  if (result.success) {
+    try {
+      return JSON.parse(result.output);
+    } catch (e) {
+      return null;
+    }
+  }
+  return null;
+}
+
+/**
+ * 主 handler
+ */
+async function handle(event) {
+  const type = event.type || event.event || '';
+  const action = event.action || '';
+  
+  console.log(`[emotion-system] Event: ${type}/${action}`);
+  
+  try {
+    if (type === 'session' || type === 'session:start') {
+      if (action === 'start' || action === '') {
+        await handleSessionStart(event);
+      }
+    }
+    else if (type === 'message' || type === 'message:received') {
+      await handleMessageReceived(event);
+    }
+    else if (type === 'lifecycle' || type === 'lifecycle:end') {
+      if (action === 'end' || action === '') {
+        await handleAgentEnd(event);
+      }
+    }
+    else if (type === 'heartbeat' || type === 'pulse') {
+      await handleHeartbeat(event);
+    }
+    else if (type === 'command') {
+      if (action === 'emotion' || action === '状态' || action === 'state') {
+        const state = await getEmotionState();
+        // 简洁版手机端显示
+        event.response = formatEmotionCompact(state);
+      }
+    }
+  } catch (error) {
+    console.error('[emotion-system] Handler error:', error.message);
+  }
+  
+  return event;
+}
+
+module.exports = handle;
+module.exports.handle = handle;
+module.exports.getEmotionState = getEmotionState;
+module.exports.formatEmotionCompact = formatEmotionCompact;
+module.exports.metadata = {
+  name: 'emotion-system',
+  description: '集成情感系统，管理 Agent 心情、能量、连接感和压力',
+  events: ['session', 'message', 'lifecycle', 'heartbeat', 'command'],
+  version: '1.0.0',
+};
+
+module.exports.default = handle;

package/hooks/heartbeat-system/HOOK.md

@@ -0,0 +1,63 @@
+---
+name: heartbeat-system
+description: "心跳系统，定时执行情感衰减、状态保存、垃圾清理"
+homepage: https://github.com/openclaw/openclaw
+metadata:
+  {
+    "openclaw": {
+      "emoji": "💓",
+      "events": ["heartbeat", "pulse", "command"],
+      "requires": { "config": ["workspace.dir"] },
+      "install": [{ "id": "workspace", "kind": "workspace", "label": "User workspace" }]
+    }
+  }
+---
+
+# Heartbeat System Hook
+
+> 让 Agent 拥有"心跳"，定时执行维护任务
+
+## 概述
+
+心跳系统模拟 Agent 的生命体征，定时执行维护任务。
+
+## 心跳层次
+
+| 层次 | 频率 | 任务 |
+|------|------|------|
+| 脉冲层 | 每5秒 | 存活确认 |
+| 节律层 | 每分钟 | 情感衰减、状态保存 |
+| 周期层 | 每小时 | 记忆整理、深度清理 |
+
+## 功能
+
+1. **情感衰减** - 定时调用情感系统，降低能量和连接感
+2. **状态保存** - 定期保存各系统状态
+3. **垃圾清理** - 清理过期临时文件
+4. **存活确认** - 确认系统正常运行
+
+## 使用方法
+
+```bash
+# 查看状态
+python3 templates/heartbeat-system/main.py status
+
+# 运行一次
+python3 templates/heartbeat-system/main.py run --once
+
+# 守护进程模式
+python3 templates/heartbeat-system/main.py run
+```
+
+## 集成方式
+
+推荐使用 cron 每分钟调用：
+
+```bash
+*/1 * * * * cd ~/.openclaw/workspace && python3 templates/heartbeat-system/main.py run --once
+```
+
+## 依赖
+
+- Python 3.8+
+- emotion-system（用于情感衰减）

package/hooks/heartbeat-system/handler.js

@@ -0,0 +1,121 @@
+/**
+ * Heartbeat System Hook Handler
+ * 
+ * 集成 Python heartbeat-system 到 OpenClaw
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+const { spawn } = require('child_process');
+const os = require('os');
+
+// 配置
+const CONFIG = {
+  heartbeatSystemPath: 'templates/heartbeat-system',
+  mainScript: 'main.py',
+};
+
+/**
+ * 运行 Python heartbeat-system CLI
+ */
+async function runPythonCli(args = []) {
+  const workspaceDir = process.env.OPENCLAW_WORKSPACE || 
+    path.join(os.homedir(), '.openclaw', 'workspace');
+  const pythonScript = path.join(workspaceDir, CONFIG.heartbeatSystemPath, 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.heartbeatSystemPath)
+        }
+      });
+      
+      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: 'Heartbeat system not found' });
+    });
+  });
+}
+
+/**
+ * 处理 heartbeat / pulse 事件
+ */
+async function handleHeartbeat(event) {
+  console.log('[heartbeat-system] Heartbeat pulse, running tasks...');
+  
+  const result = await runPythonCli(['run', '--once']);
+  
+  if (result.success) {
+    console.log('[heartbeat-system] Tasks completed');
+  } else {
+    console.log('[heartbeat-system] Tasks failed:', result.error);
+  }
+  
+  return event;
+}
+
+/**
+ * 处理 status 命令
+ */
+async function handleStatus(event) {
+  const result = await runPythonCli(['status', '--json']);
+  
+  if (result.success) {
+    event.response = result.output;
+  }
+  
+  return event;
+}
+
+/**
+ * 主 handler
+ */
+async function handle(event) {
+  const type = event.type || event.event || '';
+  const action = event.action || '';
+  
+  console.log(`[heartbeat-system] Event: ${type}/${action}`);
+  
+  try {
+    if (type === 'heartbeat' || type === 'pulse') {
+      await handleHeartbeat(event);
+    }
+    else if (type === 'command') {
+      if (action === 'heartbeat' || action === 'status') {
+        await handleStatus(event);
+      }
+    }
+  } catch (error) {
+    console.error('[heartbeat-system] Handler error:', error.message);
+  }
+  
+  return event;
+}
+
+module.exports = handle;
+module.exports.handle = handle;
+module.exports.metadata = {
+  name: 'heartbeat-system',
+  description: '心跳系统，定时执行情感衰减、状态保存、垃圾清理',
+  events: ['heartbeat', 'pulse', 'command'],
+  version: '1.0.0',
+};
+
+module.exports.default = handle;

package/hooks/input-system/HOOK.md

@@ -0,0 +1,79 @@
+---
+name: input-system
+description: "输入感知系统，理解用户意图、提取实体、分析情感"
+homepage: https://github.com/openclaw/openclaw
+metadata:
+  {
+    "openclaw": {
+      "emoji": "🎯",
+      "events": ["message", "command"],
+      "requires": { "config": ["workspace.dir"] },
+      "install": [{ "id": "workspace", "kind": "workspace", "label": "User workspace" }]
+    }
+  }
+---
+
+# Input System Hook
+
+> 理解用户输入的"大脑"
+
+## 概述
+
+输入感知系统负责理解用户的消息，识别意图、提取实体、分析情感。
+
+## 功能
+
+### 意图识别
+识别用户想要做什么：
+
+| 意图 | 说明 | 示例 |
+|------|------|------|
+| command | 命令 | /help |
+| task | 任务 | 帮我写个程序 |
+| question | 提问 | 怎么安装？ |
+| chat | 闲聊 | 好啊 |
+| confirm | 确认 | 好的 |
+| cancel | 取消 | 算了 |
+| complaint | 抱怨 | 不好用 |
+| praise | 表扬 | 很棒 |
+
+### 实体提取
+从文本中提取关键信息：
+
+- 时间 (time)
+- 日期 (date)
+- 数字 (number)
+- 代码 (code)
+- 链接 (url)
+- 文件 (file)
+
+### 情感分析
+分析用户情绪倾向
+
+## 使用方法
+
+```bash
+# 分析文本
+python3 templates/input-system/main.py "帮我写一个Hello World"
+
+# 交互模式
+python3 templates/input-system/main.py -i
+```
+
+## 输出格式
+
+```json
+{
+  "type": "task",
+  "confidence": 0.65,
+  "action": "create",
+  "entities": [
+    {"type": "code", "value": "Hello World"}
+  ],
+  "slots": {"keywords": ["写", "程序"]}
+}
+```
+
+## 依赖
+
+- Python 3.8+

package/hooks/input-system/handler.js

@@ -0,0 +1,181 @@
+/**
+ * Input System Hook Handler
+ * 
+ * 集成 Python input-system 到 OpenClaw
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+const { spawn } = require('child_process');
+const os = require('os');
+
+// 配置
+const CONFIG = {
+  inputSystemPath: 'templates/input-system',
+  mainScript: 'main.py',
+};
+
+/**
+ * 运行 Python input-system CLI
+ */
+async function runPythonCli(args = []) {
+  const workspaceDir = process.env.OPENCLAW_WORKSPACE || 
+    path.join(os.homedir(), '.openclaw', 'workspace');
+  const pythonScript = path.join(workspaceDir, CONFIG.inputSystemPath, 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.inputSystemPath)
+        }
+      });
+      
+      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: 'Input 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 '';
+}
+
+/**
+ * 处理 message:received - 分析用户意图
+ */
+async function handleMessageReceived(event) {
+  console.log('[input-system] Analyzing user intent...');
+  
+  const context = event.context || {};
+  const messages = context.messages || [];
+  
+  if (messages.length === 0) return event;
+  
+  // 获取最新用户消息
+  const reversed = [...messages].reverse();
+  const lastUserMsg = reversed.find((m) => m.role === 'user');
+  
+  if (!lastUserMsg) return event;
+  
+  const userText = extractMessageText(lastUserMsg);
+  
+  if (!userText) return event;
+  
+  // 分析意图
+  const result = await runPythonCli([userText, '--json']);
+  
+  if (result.success && result.output) {
+    try {
+      const intent = JSON.parse(result.output);
+      context.intent = intent;
+      console.log('[input-system] Intent detected:', intent.type, '(' + Math.round(intent.confidence * 100) + '%)');
+      
+      // 根据意图类型调整回复策略
+      context.replyStrategy = getReplyStrategy(intent.type, intent.action);
+      
+    } catch (e) {
+      console.log('[input-system] Parse error:', e.message);
+    }
+  }
+  
+  return event;
+}
+
+/**
+ * 根据意图类型获取回复策略
+ */
+function getReplyStrategy(intentType, action) {
+  const strategies = {
+    'command': { style: 'direct', format: 'action' },
+    'task': { style: 'action', format: 'result' },
+    'question': { style: 'explanatory', format: 'answer' },
+    'chat': { style: 'casual', format: 'friendly' },
+    'confirm': { style: 'brief', format: 'acknowledgment' },
+    'cancel': { style: 'brief', format: 'acknowledgment' },
+    'complaint': { style: 'empathetic', format: 'apology' },
+    'praise': { style: 'grateful', format: 'thanks' },
+    'create': { style: 'action', format: 'result' },
+    'read': { style: 'informative', format: 'content' },
+    'update': { style: 'action', format: 'result' },
+    'delete': { style: 'cautious', format: 'confirm' },
+    'search': { style: 'informative', format: 'results' },
+    'execute': { style: 'action', format: 'result' },
+  };
+  
+  return strategies[intentType] || { style: 'neutral', format: 'text' };
+}
+
+/**
+ * 主 handler
+ */
+async function handle(event) {
+  const type = event.type || event.event || '';
+  const action = event.action || '';
+  
+  console.log(`[input-system] Event: ${type}/${action}`);
+  
+  try {
+    if (type === 'message' || type === 'message:received') {
+      await handleMessageReceived(event);
+    }
+    else if (type === 'command') {
+      if (action === 'analyze' || action === '意图') {
+        // 分析指定文本
+        const text = event.text || '';
+        if (text) {
+          const result = await runPythonCli([text]);
+          event.response = result.output;
+        }
+      }
+    }
+  } catch (error) {
+    console.error('[input-system] Handler error:', error.message);
+  }
+  
+  return event;
+}
+
+module.exports = handle;
+module.exports.handle = handle;
+module.exports.metadata = {
+  name: 'input-system',
+  description: '输入感知系统，理解用户意图、提取实体、分析情感',
+  events: ['message', 'command'],
+  version: '1.0.0',
+};
+
+module.exports.default = handle;