foliko 1.0.41 → 1.0.44

package/.dockerignore

@@ -0,0 +1,45 @@
+# 依赖
+node_modules
+.agent/node_modules
+
+# 日志
+*.log
+npm-debug.log*
+
+# 环境变量（包含敏感信息）
+.env
+.env.local
+
+# Git
+.git
+.gitignore
+
+# IDE
+.idea
+.vscode
+*.swp
+*.swo
+
+# 文档（可选保留）
+*.md
+!README.md
+
+# 测试
+test
+tests
+coverage
+
+# 临时文件
+tmp
+temp
+*.tmp
+
+# Docker 相关（避免递归）
+Dockerfile*
+docker-compose*
+.dockerignore
+
+# CI/CD
+.github
+.gitlab-ci.yml
+.travis.yml

package/.env.example

@@ -38,3 +38,13 @@ FROM_EMAIL=your-email@gmail.com
 
 # ========== Telegram Bot (optional) ==========
 TELEGRAM_BOT_TOKEN=your-telegram-bot-token
+
+# ========== Web Server (optional) ==========
+# Web 服务端口，默认 8088
+WEB_PORT=8088
+
+# Web 服务主机，默认 127.0.0.1
+WEB_HOST=127.0.0.1
+
+# 公网访问的 base URL（用于生成 webhook URL 等），不设置则使用 host:port
+WEB_BASE_URL=https://your-domain.com

package/Dockerfile

@@ -0,0 +1,35 @@
+# ========== Foliko - 插件化 Agent 框架 ==========
+# 基于 Node.js 20 LTS
+
+FROM node:20-slim
+
+# 安装 Python 和构建工具（部分 npm 包需要编译）
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    python3 \
+    python3-pip \
+    curl \
+    git \
+    && rm -rf /var/lib/apt/lists/* \
+    && ln -sf /usr/bin/python3 /usr/bin/python
+
+# 安装 uv（快速的 Python 包管理器）
+RUN pip3 install uv
+
+# 设置工作目录
+WORKDIR /app
+
+# 全局安装 foliko CLI
+RUN npm install -g foliko
+
+# 暴露端口
+# 8088: Web 服务端口
+EXPOSE 8088
+
+# 环境变量（可以在 docker-compose 或运行时覆盖）
+ENV NODE_ENV=production
+ENV WEB_PORT=8088
+ENV WEB_HOST=127.0.0.1
+
+# 默认命令：运行聊天界面
+CMD ["foliko", "chat"]

package/cli/src/commands/chat.js

@@ -101,11 +101,11 @@ async function chatCommand(args) {
   const agent = framework.createAgent({
     name: 'FolikoAgent',
     systemPrompt: `你是一个有帮助的助手，擅长回答问题和执行任务。
-    **注意事项：**
-      1、遇到npx skills add,npx skills remove, npx skills list 命令时:
-        --添加"-a openclaw","-y"参数
-        --不要加-g 参数
-    `,
+
+**命令执行规范：**
+- 执行 npx skills add / npx skills remove / npx skills list 命令时，必须自动添加参数：-a openclaw -y
+- 禁止添加 -g 参数
+- 例如：npx skills add xxx 应该执行为 npx skills add xxx -a openclaw -y`,
     sharedPrompt: `工作目录: {{WORK_DIR}}`,
     metadata: {
       WORK_DIR: process.cwd()  // 覆盖内置的 WORK_DIR

package/docker-compose.yml

@@ -0,0 +1,33 @@
+# ========== Foliko Docker Compose ==========
+# 使用方式: docker-compose up -d
+
+services:
+  foliko:
+    build: .
+    container_name: foliko-agent
+    restart: unless-stopped
+    ports:
+      - "8088:8088"
+    environment:
+      # AI 配置
+      - FOLIKO_PROVIDER=${FOLIKO_PROVIDER:-minimax}
+      - FOLIKO_MODEL=${FOLIKO_MODEL:-}
+      - FOLIKO_BASE_URL=${FOLIKO_BASE_URL:-}
+      - FOLIKO_API_KEY=${FOLIKO_API_KEY:-}
+      # Web 服务配置
+      - WEB_PORT=8088
+      - WEB_HOST=0.0.0.0
+      - WEB_BASE_URL=${WEB_BASE_URL:-}
+      # Telegram 配置（可选）
+      - TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN:-}
+      # 飞书配置（可选）
+      - FEISHU_APP_ID=${FEISHU_APP_ID:-}
+      - FEISHU_APP_SECRET=${FEISHU_APP_SECRET:-}
+    volumes:
+      # 持久化数据
+      - foliko-data:/app/.agent/data
+    tty: true
+    stdin_open: true
+
+volumes:
+  foliko-data:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.0.41",
+  "version": "1.0.44",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "bin": {

package/plugins/feishu-plugin.js

@@ -18,7 +18,12 @@ class FeishuPlugin extends Plugin {
     this.description = '飞书对话插件，使用 WebSocket 长连接接收消息'
     this.priority = 80
     this.enabled = false
-    this.systemPrompt = '你是一个飞书助手。回复内容不要使用markdown格式文本。'
+    this.systemPrompt = `你是一个飞书助手。回复内容不要使用markdown格式文本。
+
+**命令执行规范：**
+- 执行 npx skills add / npx skills remove / npx skills list 命令时，必须自动添加参数：-a openclaw -y
+- 禁止添加 -g 参数
+- 例如：npx skills add xxx 应该执行为 npx skills add xxx -a openclaw -y`
 
     this.config = {
       appId: config.appId || process.env.FEISHU_APP_ID,
@@ -100,6 +105,11 @@ class FeishuPlugin extends Plugin {
         this._framework.on('scheduler:reminder', async (data) => {
           await this._handleScheduledReminder(data)
         })
+
+        // 监听 webhook 事件
+        this._framework.on('webhook:received', async (data) => {
+          await this._handleWebhookNotification(data)
+        })
       }
 
       console.log('[Feishu] WebSocket client started')
@@ -195,7 +205,9 @@ class FeishuPlugin extends Plugin {
     }
 
     const agent = this._framework.createSessionAgent(`feishu_${openId}`, {
-      systemPrompt: this.systemPrompt
+      systemPrompt: this.systemPrompt,
+      sharedPrompt: `工作目录: {{WORK_DIR}}`,
+      metadata: { WORK_DIR: process.cwd() }
     })
     this._sessionAgents.set(openId, agent)
 
@@ -238,6 +250,27 @@ class FeishuPlugin extends Plugin {
     }
   }
 
+  /**
+   * 处理 webhook 通知
+   */
+  async _handleWebhookNotification(data) {
+    const { data: webhookData, response, sessionId } = data
+
+    if (!sessionId || !sessionId.startsWith('feishu_')) {
+      return
+    }
+
+    const openId = sessionId.replace('feishu_', '')
+    const notificationText = `📥 [Webhook 接收]\n\n路径: ${webhookData.path}\n方法: ${webhookData.method}\n\n处理结果: ${response || '处理中...'}`
+
+    try {
+      await this._sendTextMessage(openId, notificationText)
+      console.log(`[Feishu] Webhook notification sent to ${openId}`)
+    } catch (err) {
+      console.error(`[Feishu] Failed to send webhook notification:`, err.message)
+    }
+  }
+
   async _processChat(openId, text, originalMsg) {
     const sessionInfo = this._getSessionAgent(openId)
     if (!sessionInfo) return

package/plugins/telegram-plugin.js

@@ -26,7 +26,12 @@ class TelegramPlugin extends Plugin {
     this.description = 'Telegram 对话插件，绑定主Agent进行持续对话'
     this.priority = 80
     this.enabled = false
-    this.systemPrompt = '你是一个有帮助的AI助手。回复内容不要使用markdown格式文本。'
+    this.systemPrompt = `你是一个有帮助的AI助手。回复内容不要使用markdown格式文本。
+
+**命令执行规范：**
+- 执行 npx skills add / npx skills remove / npx skills list 命令时，必须自动添加参数：-a openclaw -y
+- 禁止添加 -g 参数
+- 例如：npx skills add xxx 应该执行为 npx skills add xxx -a openclaw -y`
 
     this.config = {
       botToken: config.botToken || process.env.TELEGRAM_BOT_TOKEN,
@@ -97,6 +102,11 @@ class TelegramPlugin extends Plugin {
         this._framework.on('scheduler:reminder', async (data) => {
           await this._handleScheduledReminder(data)
         })
+
+        // 监听 webhook 事件
+        this._framework.on('webhook:received', async (data) => {
+          await this._handleWebhookNotification(data)
+        })
       }
     } catch (err) {
       console.error('[Telegram] Failed to initialize bot:', err.message)
@@ -135,6 +145,27 @@ class TelegramPlugin extends Plugin {
     }
   }
 
+  /**
+   * 处理 webhook 通知
+   */
+  async _handleWebhookNotification(data) {
+    const { data: webhookData, response, sessionId } = data
+
+    if (!sessionId || !sessionId.startsWith('telegram_')) {
+      return
+    }
+
+    const chatId = sessionId.replace('telegram_', '')
+    const notificationText = `📥 [Webhook 接收]\n\n路径: ${webhookData.path}\n方法: ${webhookData.method}\n\n处理结果: ${response || '处理中...'}`
+
+    try {
+      await this._bot.sendMessage(chatId, notificationText)
+      console.log(`[Telegram] Webhook notification sent to chat ${chatId}`)
+    } catch (err) {
+      console.error(`[Telegram] Failed to send webhook notification:`, err.message)
+    }
+  }
+
   _getMainAgent() {
     if (this._framework._mainAgent) return this._framework._mainAgent
     const agents = this._framework._agents || []
@@ -147,7 +178,9 @@ class TelegramPlugin extends Plugin {
     }
 
     const agent = this._framework.createSessionAgent(`telegram_${chatId}`, {
-      systemPrompt: this.systemPrompt
+      systemPrompt: this.systemPrompt,
+      sharedPrompt: `工作目录: {{WORK_DIR}}`,
+      metadata: { WORK_DIR: process.cwd() }
     })
     this._sessionAgents.set(chatId, agent)
 

package/plugins/web-plugin.js

@@ -202,7 +202,22 @@ class WebPlugin extends Plugin {
 
       // 1. 静态文件
       const staticResult = this._serveStatic(pathname)
-      if (staticResult) return staticResult
+      if (staticResult) {
+        if (staticResult.type === 'file') {
+          return c.newResponse(staticResult.content, {
+            headers: { 'Content-Type': staticResult.contentType }
+          })
+        }
+        if (staticResult.type === 'notFound') {
+          return c.json({ error: 'Not Found' }, 404)
+        }
+        if (staticResult.type === 'forbidden') {
+          return c.json({ error: 'Forbidden' }, 403)
+        }
+        if (staticResult.type === 'error') {
+          return c.json({ error: staticResult.message }, 500)
+        }
+      }
 
       // 2. Webhook（精确匹配）
       const webhook = this._webhooks.get(pathname)
@@ -261,7 +276,7 @@ class WebPlugin extends Plugin {
     const finalSessionId = sessionId || `web_${Date.now()}`
 
     // 触发 webhook 接收事件
-    this._framework.emit('webhook:received', { webhook, data: webhookData })
+    this._framework.emit('webhook:received', { webhook, data: webhookData, sessionId: finalSessionId })
 
     if (!webhook.awaitResponse) {
       // 不等待，立即返回
@@ -281,7 +296,7 @@ class WebPlugin extends Plugin {
         }
 
         // 触发 webhook 处理完成事件
-        this._framework.emit('webhook:received', { webhook, data: webhookData, response: responseText })
+        this._framework.emit('webhook:received', { webhook, data: webhookData, response: responseText, sessionId: finalSessionId })
       }).catch(err => {
         console.error('[Web] Webhook error:', err.message)
       })
@@ -307,7 +322,7 @@ class WebPlugin extends Plugin {
       }
 
       // 触发 webhook 处理完成事件
-      this._framework.emit('webhook:received', { webhook, data: webhookData, response: responseText })
+      this._framework.emit('webhook:received', { webhook, data: webhookData, response: responseText, sessionId: finalSessionId })
 
       return { success: true, message: 'Webhook processed', response: responseText }
     } catch (err) {

package/plugins/weixin-plugin.js

@@ -21,7 +21,12 @@ class WeixinPlugin extends Plugin {
     // 默认不启用，需要在 plugins.json 中设置 enabled: true
     this.enabled = false
     this.path=`.agent/data`
-    this.systemPrompt='你是一个微信助手。回复内容不要使用markdown格式文本'
+    this.systemPrompt=`你是一个微信助手。回复内容不要使用markdown格式文本
+
+**命令执行规范：**
+- 执行 npx skills add / npx skills remove / npx skills list 命令时，必须自动添加参数：-a openclaw -y
+- 禁止添加 -g 参数
+- 例如：npx skills add xxx 应该执行为 npx skills add xxx -a openclaw -y`
 
     this.config = {
       forceLogin: config.forceLogin || process.env.WEIXIN_FORCE_LOGIN === 'true',
@@ -69,6 +74,12 @@ class WeixinPlugin extends Plugin {
         console.log('[WeChat] Received scheduler reminder:', data)
         await this._handleScheduledReminder(data)
       })
+
+      // 监听 webhook 事件
+      this._framework.on('webhook:received', async (data) => {
+        console.log('[WeChat] Received webhook event:', data)
+        await this._handleWebhookNotification(data)
+      })
     }
 
     // 异步初始化 Bot
@@ -160,7 +171,9 @@ class WeixinPlugin extends Plugin {
 
     // 创建新 agent
     const agent = this._framework.createSessionAgent(`weixin_${userId}`, {
-      systemPrompt: this.systemPrompt
+      systemPrompt: this.systemPrompt,
+      sharedPrompt: `工作目录: {{WORK_DIR}}`,
+      metadata: { WORK_DIR: process.cwd() }
     })
     this._sessionAgents.set(userId, agent)
     console.log('[WeChat] Created new session agent for userId:', userId)
@@ -327,6 +340,33 @@ class WeixinPlugin extends Plugin {
     }
   }
 
+  /**
+   * 处理 webhook 通知
+   */
+  async _handleWebhookNotification(data) {
+    const { data: webhookData, response, sessionId } = data
+
+    if (!this._bot) {
+      console.warn('[WeChat] Bot not ready, cannot send webhook notification')
+      return
+    }
+
+    // 只处理 weixin 相关的 session
+    if (!sessionId || !sessionId.startsWith('weixin_')) {
+      return
+    }
+
+    const userId = sessionId.replace('weixin_', '')
+    const notificationText = `📥 [Webhook 接收]\n\n路径: ${webhookData.path}\n方法: ${webhookData.method}\n\n处理结果: ${response || '处理中...'}`
+
+    try {
+      await this._bot.sendText(userId, notificationText)
+      console.log(`[WeChat] Webhook notification sent to user ${userId}`)
+    } catch (err) {
+      console.error(`[WeChat] Failed to send webhook notification:`, err.message)
+    }
+  }
+
   /**
    * 获取插件状态
    */

package/test.txt

@@ -0,0 +1,3 @@
+Hello from static resource test!
+This is a test file for verifying static resource serving.
+Timestamp: 2026-03-24