@qcluffy/agent-bootstrap 0.0.1

package/hooks/bootstrap-system/handler.js

@@ -0,0 +1,220 @@
+/**
+ * Bootstrap System Hook Handler
+ * 
+ * 集成 Python bootstrap-system 到 OpenClaw
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+const { spawn } = require('child_process');
+const os = require('os');
+
+// 配置
+const CONFIG = {
+  bootstrapSystemPath: 'templates/bootstrap-system',
+  mainScript: 'main.py',
+};
+
+/**
+ * 运行 Python bootstrap-system CLI
+ */
+async function runPythonCli(args = []) {
+  const workspaceDir = process.env.OPENCLAW_WORKSPACE || 
+    path.join(os.homedir(), '.openclaw', 'workspace');
+  const pythonScript = path.join(workspaceDir, CONFIG.bootstrapSystemPath, 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.bootstrapSystemPath)
+        }
+      });
+      
+      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: 'Bootstrap 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 '';
+}
+
+/**
+ * 处理 session_start - 检查是否需要引导
+ */
+async function handleSessionStart(event) {
+  console.log('[bootstrap-system] Checking bootstrap status...');
+  
+  const result = await runPythonCli(['status', '--json']);
+  
+  if (result.success && result.output) {
+    try {
+      const status = JSON.parse(result.output);
+      event.context = event.context || {};
+      event.context.bootstrap = status;
+      
+      if (!status.is_completed && status.status === 'not_started') {
+        // 需要开始引导
+        event.needsBootstrap = true;
+        console.log('[bootstrap-system] Bootstrap needed');
+      } else if (status.is_completed) {
+        console.log('[bootstrap-system] Bootstrap already completed');
+      }
+    } catch (e) {
+      console.log('[bootstrap-system] Parse error:', e.message);
+    }
+  }
+  
+  return event;
+}
+
+/**
+ * 处理 bootstrap 命令
+ */
+async function handleBootstrapCommand(event) {
+  const action = event.action;
+  const input = event.input || '';
+  
+  if (action === 'start' || action === 'begin') {
+    // 开始引导
+    const result = await runPythonCli(['start']);
+    event.response = result.output;
+  }
+  else if (action === 'step') {
+    // 查看当前步骤
+    const result = await runPythonCli(['step']);
+    event.response = result.output;
+  }
+  else if (action === 'submit' || action === 'next') {
+    // 提交输入
+    const result = await runPythonCli(['submit', input]);
+    event.response = result.output;
+    
+    // 检查是否完成
+    if (result.output.includes('初始化完成') || result.output.includes('completed')) {
+      event.bootstrapCompleted = true;
+    }
+  }
+  else if (action === 'status') {
+    // 查看状态
+    const result = await runPythonCli(['status']);
+    event.response = result.output;
+  }
+  else if (action === 'reset') {
+    // 重置
+    const result = await runPythonCli(['reset']);
+    event.response = '✓ 引导已重置，请重新开始';
+  }
+  
+  return event;
+}
+
+/**
+ * 处理用户消息 - 检查是否是引导输入
+ */
+async function handleMessage(event) {
+  const context = event.context || {};
+  
+  // 检查是否正在进行引导
+  if (context.bootstrap && context.bootstrap.status === 'in_progress') {
+    const messages = context.messages || [];
+    const reversed = [...messages].reverse();
+    const lastUserMsg = reversed.find((m) => m.role === 'user');
+    
+    if (lastUserMsg) {
+      const userText = extractMessageText(lastUserMsg);
+      
+      if (userText && !userText.startsWith('/')) {
+        // 提交作为引导输入
+        console.log('[bootstrap-system] Submitting bootstrap input:', userText.substring(0, 20));
+        const result = await runPythonCli(['submit', userText]);
+        
+        event.bootstrapResponse = result.output;
+        
+        if (result.output.includes('初始化完成') || result.output.includes('completed')) {
+          event.bootstrapCompleted = true;
+        }
+      }
+    }
+  }
+  
+  return event;
+}
+
+/**
+ * 主 handler
+ */
+async function handle(event) {
+  const type = event.type || event.event || '';
+  const action = event.action || '';
+  
+  console.log(`[bootstrap-system] Event: ${type}/${action}`);
+  
+  try {
+    if (type === 'session' || type === 'session:start') {
+      await handleSessionStart(event);
+    }
+    else if (type === 'message' || type === 'message:received') {
+      await handleMessage(event);
+    }
+    else if (type === 'command') {
+      // 处理引导命令
+      if (action === 'bootstrap' || action === '引导' || action === '开始') {
+        await handleBootstrapCommand(event);
+      }
+      else if (['start', 'step', 'submit', 'status', 'reset'].includes(action)) {
+        await handleBootstrapCommand(event);
+      }
+    }
+  } catch (error) {
+    console.error('[bootstrap-system] Handler error:', error.message);
+  }
+  
+  return event;
+}
+
+module.exports = handle;
+module.exports.handle = handle;
+module.exports.metadata = {
+  name: 'bootstrap-system',
+  description: '初始化引导系统，交互式收集用户配置、塑造Agent人格',
+  events: ['session', 'message', 'command'],
+  version: '1.0.0',
+};
+
+module.exports.default = handle;

package/hooks/cognition-system/HOOK.md

@@ -0,0 +1,75 @@
+---
+name: cognition-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" }]
+    }
+  }
+---
+
+# Cognition System Hook
+
+> 推理规划与决策的"大脑"
+
+## 概述
+
+认知系统负责推理规划、任务分解、学习适应和决策判断。
+
+## 功能
+
+### 1. 推理引擎
+基于上下文进行逻辑推理
+
+### 2. 任务规划器
+把复杂任务拆解成步骤：
+- 代码任务：分析 → 设计 → 实现 → 测试
+- 写作任务：大纲 → 撰写 → 修改
+- 调研任务：搜索 → 收集 → 总结
+
+### 3. 学习引擎
+从互动中学习用户偏好：
+- 沟通风格（直接/友好）
+- 详细程度（简洁/详细）
+- 常用操作
+
+### 4. 决策判断
+道德/安全决策辅助：
+- 拒绝有害请求
+- 拒绝非法请求
+- 保护隐私
+- 敏感操作警告
+
+## 使用方法
+
+```bash
+# 处理意图
+python3 templates/cognition-system/main.py process '{"action": "write", "type": "code"}'
+
+# 查看状态
+python3 templates/cognition-system/main.py status
+
+# 学习反馈
+python3 templates/cognition-system/main.py learn "详细一点"
+
+# 决策评估
+python3 templates/cognition-system/main.py decide "删除文件"
+```
+
+## 工作流程
+
+```
+用户输入 → INPUT(意图识别) → COGNITION(推理规划) → OUTPUT(执行输出)
+                              ↓
+                        任务分解 + 决策判断 + 学习适应
+```
+
+## 依赖
+
+- Python 3.8+
+- input-system（意图识别结果）

package/hooks/cognition-system/handler.js

@@ -0,0 +1,186 @@
+/**
+ * Cognition System Hook Handler
+ * 
+ * 集成 Python cognition-system 到 OpenClaw
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+const { spawn } = require('child_process');
+const os = require('os');
+
+// 配置
+const CONFIG = {
+  cognitionSystemPath: 'templates/cognition-system',
+  mainScript: 'main.py',
+};
+
+/**
+ * 运行 Python cognition-system CLI
+ */
+async function runPythonCli(args = []) {
+  const workspaceDir = process.env.OPENCLAW_WORKSPACE || 
+    path.join(os.homedir(), '.openclaw', 'workspace');
+  const pythonScript = path.join(workspaceDir, CONFIG.cognitionSystemPath, 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.cognitionSystemPath)
+        }
+      });
+      
+      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: 'Cognition 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('[cognition-system] Processing with cognition...');
+  
+  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;
+  
+  // 获取已分析的意图（来自 input-system）
+  const intent = context.intent || {};
+  
+  if (intent.type) {
+    // 使用认知系统处理
+    const result = await runPythonCli(['process', JSON.stringify({
+      action: intent.action || intent.type,
+      type: intent.type,
+    }), '--json']);
+    
+    if (result.success && result.output) {
+      try {
+        const cognitionResult = JSON.parse(result.output);
+        context.cognition = cognitionResult;
+        
+        // 根据任务步骤调整回复策略
+        if (cognitionResult.allowed && cognitionResult.next_step) {
+          context.replyStrategy = {
+            ...context.replyStrategy,
+            task: cognitionResult.task,
+            nextStep: cognitionResult.next_step,
+          };
+        }
+        
+        console.log('[cognition-system] Cognition result:', cognitionResult.allowed ? 'allowed' : 'denied');
+      } catch (e) {
+        console.log('[cognition-system] Parse error:', e.message);
+      }
+    }
+  }
+  
+  return event;
+}
+
+/**
+ * 处理 feedback 命令
+ */
+async function handleFeedback(event) {
+  const feedback = event.feedback || event.text || '';
+  
+  if (feedback) {
+    const result = await runPythonCli(['learn', feedback]);
+    console.log('[cognition-system] Learning:', feedback);
+  }
+  
+  return event;
+}
+
+/**
+ * 主 handler
+ */
+async function handle(event) {
+  const type = event.type || event.event || '';
+  const action = event.action || '';
+  
+  console.log(`[cognition-system] Event: ${type}/${action}`);
+  
+  try {
+    if (type === 'message' || type === 'message:received') {
+      await handleMessageReceived(event);
+    }
+    else if (type === 'command') {
+      if (action === 'learn' || action === 'feedback') {
+        await handleFeedback(event);
+      }
+      else if (action === 'cognition' || action === 'status') {
+        const result = await runPythonCli(['status', '--json']);
+        if (result.success) {
+          event.response = result.output;
+        }
+      }
+    }
+  } catch (error) {
+    console.error('[cognition-system] Handler error:', error.message);
+  }
+  
+  return event;
+}
+
+module.exports = handle;
+module.exports.handle = handle;
+module.exports.metadata = {
+  name: 'cognition-system',
+  description: '认知系统，推理规划、任务分解、学习适应、决策判断',
+  events: ['message', 'command'],
+  version: '1.0.0',
+};
+
+module.exports.default = handle;

package/hooks/emotion-system/HOOK.md

@@ -0,0 +1,81 @@
+---
+name: emotion-system
+description: "集成情感系统，管理 Agent 心情、能量、连接感和压力"
+homepage: https://github.com/openclaw/openclaw
+metadata:
+  {
+    "openclaw": {
+      "emoji": "💖",
+      "events": ["session", "message", "lifecycle", "heartbeat", "command"],
+      "requires": { "config": ["workspace.dir"] },
+      "install": [{ "id": "workspace", "kind": "workspace", "label": "User workspace" }]
+    }
+  }
+---
+
+# Emotion System Hook
+
+> 管理 Agent 情感状态，让 Agent 更有"灵魂"
+
+## 概述
+
+这个 Hook 会在以下时机触发：
+
+- `session_start`: 会话开始时加载情感状态
+- `message_received`: 收到用户消息时分析情感
+- `agent_end`: Agent 回复完成后更新情感（提升连接感）
+- `heartbeat`: 心跳时应用自然衰减
+- `/emotion` 或 `/状态`: 命令时显示当前情感状态
+
+## 功能
+
+1. **情感状态管理**: 心情、能量、连接感、压力值
+2. **消息情感分析**: 分析用户消息的情感倾向
+3. **互动反馈**: 根据互动结果调整情感
+4. **自然衰减**: 模拟情感的自然变化
+5. **状态展示**: 可视化当前情感状态
+
+## 情感状态
+
+| 维度 | 范围 | 说明 |
+|------|------|------|
+| mood | 9种心情 | curious, happy, calm, focused, tired, anxious, excited, thoughtful, neutral |
+| energy | 0-100% | 能量水平，自然衰减 |
+| connection | 0-100% | 与用户的连接感，互动提升 |
+| stress | 0-100% | 压力值，失败增加，成功减少 |
+
+## 使用方法
+
+### 查看当前情感状态
+```bash
+python3 templates/emotion-system/main.py state
+```
+
+### 分析消息情感
+```bash
+python3 templates/emotion-system/main.py analyze "太棒了！"
+```
+
+### 提升连接感
+```bash
+python3 templates/emotion-system/main.py boost
+```
+
+### 互动成功
+```bash
+python3 templates/emotion-system/main.py success
+```
+
+### 自然衰减
+```bash
+python3 templates/emotion-system/main.py decay
+```
+
+## 配置
+
+无需额外配置，Hook 会自动使用 workspace 目录下的 emotion-system。
+
+## 依赖
+
+- Python 3.8+
+- emotion-system 模块（在 workspace/templates/ 目录下）