@wu529778790/open-im 1.11.1-beta.9 → 1.11.2-beta.0

package/README.md

@@ -2,66 +2,45 @@
 
 **English** · [中文](./README.zh-CN.md)
 
-Multi-platform IM bridge for AI CLI tools. Connect Telegram, Feishu, WeCom, DingTalk, QQ, WeChat (WorkBuddy), and WeChat (ClawBot) to Claude Code, Codex, and CodeBuddy — use your AI coding assistant from any phone or chat window.
+> Your AI coding assistant, in every chat app.
+
+open-im bridges Claude Code, Codex, and CodeBuddy to Telegram, Feishu, WeCom, DingTalk, QQ, WeChat (WorkBuddy), and WeChat (ClawBot). Send a message from your phone, get code written on your server.
 
 ## Architecture
 
 ![Open-IM Architecture](./diagram/architecture/open-im-architecture.svg)
 
-## Features
-
-- **Seven IM platforms** — Telegram, Feishu, WeCom, DingTalk, QQ, WorkBuddy, ClawBot
-- **Three AI backends** — Claude (Agent SDK), Codex, CodeBuddy (per-platform override supported)
-- **Streaming, media, sessions** — live output where supported; `/new` for a fresh AI session
-- **Web UI** — dashboard bundled in the package; default **`http://127.0.0.1:39282`**
-
-## Requirements
-
-- Node.js ≥ 20
-- At least one IM platform configured + credentials for your AI tool
-
-## Quick start
-
-```bash
-npx @wu529778790/open-im start
-```
-
-Or: `npm install -g @wu529778790/open-im` then `open-im start`.
+## Why
 
-Config: **`~/.open-im/config.json`**
+- **Work from anywhere** — trigger Claude Code from your phone while commuting, waiting in line, or on the couch
+- **Seamless handoff** — open-im shares sessions with the Claude Code CLI; pick up on your computer exactly where you left off on your phone
+- **Full power, simple interface** — stream responses, manage sessions, switch models — all through chat commands
+- **One bridge, many platforms** — same bot works on Telegram, Feishu, DingTalk, WeChat, and more
 
-## CLI
-
-| Command | Description |
-| --- | --- |
-| `open-im init` | Interactive setup (does not start the bridge) |
-| `open-im start` | Run the bridge in the background |
-| `open-im stop` | Stop the background bridge |
-| `open-im restart` | Stop then start |
-| `open-im dashboard` | Web config server only (no bridge) |
-
-After `start`, the CLI prints the dashboard URL (default **`http://127.0.0.1:39282`**).
+## Features
 
-## Chat commands
+### Chat commands
 
 | Command | Description |
 | --- | --- |
-| `/help` | Help |
-| `/new` | New AI session |
-| `/sessions` | Session history with preview |
-| `/resume [N]` | Resume session (no arg = most recent) |
-| `/status` | AI + session info |
-| `/cd` / `/pwd` | Switch work dir (auto-resumes that dir's session) |
-| `/allow` / `/y`, `/deny` / `/n` | Permission prompts |
-
-## Session continuity
+| `/help` | Show all commands |
+| `/new` | Start a fresh AI session |
+| `/sessions` | Browse session history with previews |
+| `/resume [N]` | Resume a session (no arg = most recent) |
+| `/history [N]` | View conversation messages in a session |
+| `/delete <N>` | Delete a session |
+| `/rename <title>` | Rename the current session |
+| `/fork [N]` | Fork a session (create a branch) |
+| `/models` | List available AI models |
+| `/context` | Show context window usage |
+| `/status` | Show AI tool, account, and session info |
+| `/cd <path>` / `/pwd` | Switch work directory (auto-resumes that dir's session) |
+| `/allow` / `/y`, `/deny` / `/n` | Respond to permission prompts |
+
+### Session continuity
 
 open-im and Claude Code CLI share the same session storage. In the same directory, you can seamlessly switch between phone and computer.
 
-**Phone → Computer:** open-im auto-resumes the latest CLI session — no configuration needed.
-
-**Computer → Phone:** use `claude --continue` (or `claude -c`) to pick up the phone conversation.
-
 ```
 # On computer
 cd /my-project && claude        # work as usual, then Ctrl+C
@@ -75,16 +54,43 @@ claude -c                       # continues the phone conversation
 
 > Only one side can be active at a time. Exit the CLI before sending messages from the phone, and vice versa.
 
-## Git co-authors
+### Platform support
 
-`Co-authored-by` is appended by default on AI-driven commits. **Disable:** set **`OPEN_IM_GIT_COAUTHOR=0`** in the environment and restart the bridge.
+Seven IM platforms, three AI backends, per-platform override:
 
-## Minimal config
+| Platform | Streaming | Media | Notes |
+| --- | --- | --- | --- |
+| Telegram | Yes | Images | Full bot support |
+| Feishu | Yes | Images | Streaming card |
+| WeCom | Yes | Images | Streaming card |
+| DingTalk | Partial | Images | Fallback to text |
+| QQ | Yes | Images | |
+| WorkBuddy | Yes | Images | WeChat-based |
+| ClawBot | Yes | Images | WeChat-based |
+
+Set `platforms.<name>.aiCommand` (`claude` / `codex` / `codebuddy`) per channel. Default: `claude`.
+
+### Web dashboard
+
+`open-im start` serves a built-in SPA and API at **`http://127.0.0.1:39282`** (configurable via `OPEN_IM_WEB_PORT`). For LAN access: `export OPEN_IM_WEB_HOST=0.0.0.0`.
+
+## Quick start
+
+```bash
+npx @wu529778790/open-im init    # interactive setup
+npx @wu529778790/open-im start   # run the bridge
+```
+
+Or install globally: `npm install -g @wu529778790/open-im` then `open-im start`.
+
+Config file: **`~/.open-im/config.json`**
+
+### Minimal config
 
 ```json
 {
   "tools": {
-    "claude": { "workDir": "/path/to/project", "skipPermissions": true, "timeoutMs": 600000 }
+    "claude": { "workDir": "/path/to/project", "skipPermissions": true }
   },
   "platforms": {
     "telegram": { "enabled": true, "botToken": "YOUR_TELEGRAM_BOT_TOKEN" }
@@ -92,11 +98,11 @@ claude -c                       # continues the phone conversation
 }
 ```
 
-Add other platforms under **`platforms`** as needed. Run **`open-im init`** for a full template.
+Run `open-im init` for a full template with all platforms.
 
 ### Claude (Agent SDK)
 
-No local `claude` binary required. Third-party / compatible API:
+No local `claude` binary required. Supports third-party / compatible APIs:
 
 ```json
 {
@@ -112,26 +118,37 @@ No local `claude` binary required. Third-party / compatible API:
 }
 ```
 
-### Per-platform AI
+### CLI reference
 
-Set **`platforms.<name>.aiCommand`** (`claude` / `codex` / `codebuddy`) per channel. Default: `claude`.
+| Command | Description |
+| --- | --- |
+| `open-im init` | Interactive setup (does not start the bridge) |
+| `open-im start` | Run the bridge in the background |
+| `open-im stop` | Stop the background bridge |
+| `open-im restart` | Stop then start |
+| `open-im dashboard` | Web config server only (no bridge) |
 
-### Web dashboard
+### Environment variables
 
-`open-im start` serves the built-in SPA and **`/api/*`** on **`OPEN_IM_WEB_PORT`** (default **39282**). For LAN access: `export OPEN_IM_WEB_HOST=0.0.0.0`.
+**`ANTHROPIC_*`** (shell or `tools.claude.env`), **`TELEGRAM_BOT_TOKEN`**, **`OPEN_IM_WEB_PORT`**, **`OPEN_IM_WEB_HOST`**, plus platform-specific `*_APP_ID`, `*_SECRET`, `WORKBUDDY_*`, etc.
 
-### Environment variables
+### Git co-authors
 
-Typical keys: **`ANTHROPIC_*`** (shell or **`tools.claude.env`**), **`TELEGRAM_BOT_TOKEN`**, **`OPEN_IM_WEB_PORT`**, **`OPEN_IM_WEB_HOST`**, plus platform-specific `*_APP_ID`, `*_SECRET`, `WORKBUDDY_*`, etc.
+`Co-authored-by` is appended by default on AI-driven commits. Disable: set **`OPEN_IM_GIT_COAUTHOR=0`** in the environment and restart the bridge.
 
 ### Privacy
 
-**Anonymous** usage information may be collected to improve reliability (no chat or prompt content). To disable: **`OPEN_IM_TELEMETRY=false`** or **`"telemetry": { "enabled": false }`** in **`config.json`**.
+**Anonymous** usage information may be collected to improve reliability (no chat or prompt content). To disable: **`OPEN_IM_TELEMETRY=false`** or `"telemetry": { "enabled": false }` in `config.json`.
 
 ## Platform setup & troubleshooting
 
 See **[docs/platforms.md](./docs/platforms.md)** for detailed per-platform configuration, credential setup, and troubleshooting.
 
+## Requirements
+
+- Node.js >= 20
+- At least one IM platform configured + credentials for your AI tool
+
 ## License
 
 [MIT](LICENSE)

package/README.zh-CN.md

@@ -2,65 +2,44 @@
 
 [English](./README.md) · **中文**
 
-多平台 IM 桥接：把 Telegram、飞书、企业微信、钉钉、QQ、微信（WorkBuddy）、微信（ClawBot）接到 Claude Code、Codex、CodeBuddy，在手机或聊天里使用 AI 编程助手。
+> 你的 AI 编程助手，在每个聊天 App 里。
+
+open-im 把 Claude Code、Codex、CodeBuddy 接入 Telegram、飞书、企业微信、钉钉、QQ、微信（WorkBuddy）、微信（ClawBot）。手机发条消息，服务器上就写好代码。
 
 ## 架构
 
 ![Open-IM 架构图](./diagram/architecture/open-im-architecture.svg)
 
-## 功能特性
+## 为什么用 open-im
 
-- **七个 IM 平台** — Telegram、飞书、企业微信、钉钉、QQ、WorkBuddy、ClawBot
-- **三种 AI 后端** — Claude（Agent SDK）、Codex、CodeBuddy（可按平台覆盖）
-- **流式、多媒体、会话** — 视平台能力；`/new` 开启新 AI 会话
-- **Web 控制台** — 随包内置，默认 **`http://127.0.0.1:39282`**
+- **随时随地** — 通勤、排队、躺沙发上，手机发消息就能让 Claude Code 干活
+- **无缝接力** — open-im 和 Claude Code CLI 共享 session，在手机上聊到一半，电脑上接着来
+- **完整能力，简单界面** — 流式输出、会话管理、模型切换，全靠聊天命令搞定
+- **一个桥接，多个平台** — 同一个 bot 支持 Telegram、飞书、钉钉、微信等
 
-## 环境要求
+## 功能
 
-- Node.js ≥ 20
-- 至少配置一个 IM 平台 + 所选 AI 的凭证
-
-## 快速开始
-
-```bash
-npx @wu529778790/open-im start
-```
-
-或：`npm install -g @wu529778790/open-im` 后执行 `open-im start`。
-
-配置：**`~/.open-im/config.json`**
-
-## CLI 命令
+### 聊天命令
 
 | 命令 | 说明 |
 | --- | --- |
-| `open-im init` | 交互配置（不启动桥接） |
-| `open-im start` | 后台运行桥接 |
-| `open-im stop` | 停止后台服务 |
-| `open-im restart` | 重启 |
-| `open-im dashboard` | 仅 Web 配置服务（不启动桥接） |
-
-`start` 后会提示控制台地址（默认 **`http://127.0.0.1:39282`**）。
-
-## IM 内命令
-
-| 命令 | 说明 |
-| --- | --- |
-| `/help` | 帮助 |
-| `/new` | 新 AI 会话 |
-| `/sessions` | 历史会话（含摘要预览） |
+| `/help` | 显示所有命令 |
+| `/new` | 开启新 AI 会话 |
+| `/sessions` | 浏览历史会话（含摘要预览） |
 | `/resume [序号]` | 恢复会话（无参数恢复最近一条） |
-| `/status` | AI 与会话信息 |
-| `/cd` / `/pwd` | 切换工作目录（自动恢复该目录的历史会话） |
+| `/history [序号]` | 查看会话对话记录 |
+| `/delete <序号>` | 删除历史会话 |
+| `/rename <标题>` | 重命名当前会话 |
+| `/fork [序号]` | 分支会话（创建副本） |
+| `/models` | 查看可用 AI 模型 |
+| `/context` | 查看上下文窗口占用 |
+| `/status` | 显示 AI 工具、账号、会话信息 |
+| `/cd <路径>` / `/pwd` | 切换工作目录（自动恢复该目录的历史会话） |
 | `/allow` / `/y`、`/deny` / `/n` | 权限确认 |
 
-## 会话接力
-
-open-im 和 Claude Code CLI 共享同一份 session 存储。在同一个目录下，手机和电脑可以无缝切换。
+### 会话接力
 
-**手机接电脑：** open-im 自动恢复同目录下最新的 CLI session，无需配置。
-
-**电脑接手机：** 使用 `claude --continue`（或 `claude -c`）接上 open-im 端的对话。
+open-im 和 Claude Code CLI 共享同一份 session 存储。同一个目录下，手机和电脑可以无缝切换。
 
 ```bash
 # 电脑端
@@ -75,16 +54,43 @@ claude -c                       # 接上手机端的对话
 
 > 同一时刻只能有一端活跃。从手机发消息前先退出 CLI，反之亦然。
 
-## Git 共同作者
+### 平台支持
+
+七个 IM 平台，三种 AI 后端，可按平台覆盖：
 
-默认在 AI 发起的提交里追加 `Co-authored-by`。**关闭**：设置环境变量 **`OPEN_IM_GIT_COAUTHOR=0`** 并重启桥接。
+| 平台 | 流式输出 | 备注 |
+| --- | --- | --- |
+| Telegram | 支持 | 完整 bot 支持 |
+| 飞书 | 支持 | 流式卡片 |
+| 企业微信 | 支持 | 流式卡片 |
+| 钉钉 | 部分 | 回退到纯文本 |
+| QQ | 支持 | |
+| WorkBuddy | 支持 | 微信生态 |
+| ClawBot | 支持 | 微信生态 |
 
-## 最小配置
+在每个平台上设置 `platforms.<name>.aiCommand`（`claude` / `codex` / `codebuddy`），默认 `claude`。
+
+### Web 控制台
+
+`open-im start` 在 **`http://127.0.0.1:39282`** 提供内置页面与 API（通过 `OPEN_IM_WEB_PORT` 配置端口）。局域网访问：`export OPEN_IM_WEB_HOST=0.0.0.0`。
+
+## 快速开始
+
+```bash
+npx @wu529778790/open-im init    # 交互式配置
+npx @wu529778790/open-im start   # 启动桥接
+```
+
+或全局安装：`npm install -g @wu529778790/open-im` 后执行 `open-im start`。
+
+配置文件：**`~/.open-im/config.json`**
+
+### 最小配置
 
 ```json
 {
   "tools": {
-    "claude": { "workDir": "/path/to/project", "skipPermissions": true, "timeoutMs": 600000 }
+    "claude": { "workDir": "/path/to/project", "skipPermissions": true }
   },
   "platforms": {
     "telegram": { "enabled": true, "botToken": "YOUR_TELEGRAM_BOT_TOKEN" }
@@ -92,11 +98,11 @@ claude -c                       # 接上手机端的对话
 }
 ```
 
-在 **`platforms`** 下按需补充其他平台。完整模板请用 **`open-im init`**。
+完整模板请用 `open-im init`。
 
 ### Claude（Agent SDK）
 
-无需本地 `claude` 可执行文件。第三方兼容接口示例：
+无需本地 `claude` 可执行文件。支持第三方兼容接口：
 
 ```json
 {
@@ -112,26 +118,37 @@ claude -c                       # 接上手机端的对话
 }
 ```
 
-### 按平台指定 AI
+### CLI 命令
 
-在每个平台上设置 **`platforms.<name>.aiCommand`**（`claude` / `codex` / `codebuddy`）。默认 `claude`。
+| 命令 | 说明 |
+| --- | --- |
+| `open-im init` | 交互配置（不启动桥接） |
+| `open-im start` | 后台运行桥接 |
+| `open-im stop` | 停止后台服务 |
+| `open-im restart` | 重启 |
+| `open-im dashboard` | 仅 Web 配置服务（不启动桥接） |
 
-### Web 控制台
+### 环境变量
 
-`open-im start` 在 **`OPEN_IM_WEB_PORT`**（默认 **39282**）提供内置页面与 **`/api/*`**。局域网访问：`export OPEN_IM_WEB_HOST=0.0.0.0`。
+**`ANTHROPIC_*`**（shell 或 `tools.claude.env`）、**`TELEGRAM_BOT_TOKEN`**、**`OPEN_IM_WEB_PORT`**、**`OPEN_IM_WEB_HOST`**，以及各平台的 `*_APP_ID`、`*_SECRET`、`WORKBUDDY_*` 等。
 
-### 环境变量
+### Git 共同作者
 
-常见：**`ANTHROPIC_*`**（shell 或 **`tools.claude.env`**）、**`TELEGRAM_BOT_TOKEN`**、**`OPEN_IM_WEB_PORT`**、**`OPEN_IM_WEB_HOST`**，以及各平台的 `*_APP_ID`、`*_SECRET`、`WORKBUDDY_*` 等。
+默认在 AI 发起的提交里追加 `Co-authored-by`。关闭：设置环境变量 **`OPEN_IM_GIT_COAUTHOR=0`** 并重启桥接。
 
 ### 隐私
 
-为改进稳定性，可能记录**匿名**运行信息（不含聊天或 prompt 内容）。若需关闭：环境变量 **`OPEN_IM_TELEMETRY=false`**，或 **`config.json`** 中 **`"telemetry": { "enabled": false }`**。
+为改进稳定性，可能记录**匿名**运行信息（不含聊天或 prompt 内容）。若需关闭：环境变量 **`OPEN_IM_TELEMETRY=false`**，或 `config.json` 中 `"telemetry": { "enabled": false }`。
 
 ## 平台配置与故障排除
 
 详见 **[docs/platforms.zh-CN.md](./docs/platforms.zh-CN.md)**。
 
+## 环境要求
+
+- Node.js >= 20
+- 至少配置一个 IM 平台 + 所选 AI 的凭证
+
 ## License
 
 [MIT](LICENSE)

package/dist/adapters/claude-sdk-adapter.js

@@ -15,6 +15,17 @@ import { createLogger } from '../logger.js';
 import { refreshClaudeEnvToProcess } from '../config/file-io.js';
 import { toReplyPlainText } from '../shared/utils.js';
 const log = createLogger('ClaudeSDK');
+/**
+ * 注入交互式上下文指令，让 Claude 认为这是交互式终端会话。
+ * 解决 query() 非交互环境下 Claude 跳过用户选择、直接自主决策的问题。
+ */
+const INTERACTIVE_CONTEXT = `[SYSTEM: You are in an interactive chat session via instant messenger. The user CAN and WILL respond to your messages — treat this like an interactive terminal session. Rules:
+1. When you need to make a decision involving user preference (choosing an approach, selecting between options, deciding what to do next), ALWAYS present clearly numbered options and WAIT for the user's response.
+2. Do NOT proceed autonomously when user input would be valuable.
+3. Only proceed autonomously for obvious single-path tasks (e.g. reading a file, running a simple command).
+4. When presenting options, format them as a numbered list and end with a question.
+]
+`;
 function loadUserPluginSettings() {
     try {
         const settingsPath = join(homedir(), '.claude', 'settings.json');
@@ -386,11 +397,15 @@ export class ClaudeSDKAdapter {
                     }
                 }
                 const q = query({
-                    prompt,
+                    prompt: INTERACTIVE_CONTEXT + prompt,
                     options: {
                         cwd: workDir,
                         model: resolvedModel,
                         permissionMode,
+                        // 启用完整工具集，与 cc 终端一致
+                        tools: { type: 'preset', preset: 'claude_code' },
+                        // 启用所有技能（superpowers, playwright 等），与 cc 终端一致
+                        skills: 'all',
                         ...(resumeId ? { resume: resumeId } : {}),
                         ...(options?.fallbackModel ? { fallbackModel: options.fallbackModel } : {}),
                         ...(options?.disallowedTools?.length ? { disallowedTools: options.disallowedTools } : {}),

package/dist/clawbot/client.d.ts

@@ -10,5 +10,5 @@
 import type { Config } from '../config.js';
 import type { ClawBotState } from './types.js';
 export declare function getChannelState(): ClawBotState;
-export declare function initClawbot(config: Config, eventHandler: (chatId: string, msgId: string, content: string) => Promise<void>, onStateChange?: (state: ClawBotState) => void): Promise<void>;
+export declare function initClawbot(config: Config, eventHandler: (chatId: string, msgId: string, content: string, imagePaths?: string[]) => Promise<void>, onStateChange?: (state: ClawBotState) => void): Promise<void>;
 export declare function stopClawbot(): void;

package/dist/clawbot/client.js

@@ -12,6 +12,7 @@ import { createLogger } from '../logger.js';
 import { jitteredDelay, isFatalReconnectError, SLOW_PROBE_MS } from '../shared/reconnect.js';
 import { cacheContextToken } from './message-sender.js';
 import { setClawbotContextToken, clearClawbotContextToken } from '../shared/active-chats.js';
+import { decryptAes256CbcMedia, saveBufferMedia, createMediaTargetPath } from '../shared/media-storage.js';
 import { CLAWBOT_POLL_INTERVAL_MS } from '../constants.js';
 const log = createLogger('ClawBot');
 const RECONNECT_DELAYS_MS = [3000, 5000, 10000, 20000, 30000];
@@ -110,6 +111,8 @@ function startPolling() {
                 }
                 // Process messages
                 const messages = res.messages ?? [];
+                // Step 1: Extract valid USER messages and cache context tokens
+                const userMessages = [];
                 for (const msg of messages) {
                     if (signal.aborted)
                         break;
@@ -120,7 +123,6 @@ function startPolling() {
                         continue;
                     const chatId = msg.from_user_id ?? '';
                     const msgId = String(msg.message_id ?? msg.seq ?? '');
-                    const content = extracted;
                     if (!chatId) {
                         log.warn('ClawBot message missing from_user_id, skipping');
                         continue;
@@ -130,10 +132,34 @@ function startPolling() {
                         cacheContextToken(chatId, msg.context_token);
                         setClawbotContextToken(msg.context_token);
                     }
-                    log.info(`ClawBot message: chatId=${chatId}, msgId=${msgId}, content="${content.substring(0, 100)}"`);
+                    // Extract and download images from message
+                    const imagePaths = await extractImages(msg);
+                    userMessages.push({ chatId, msgId, content: extracted, imagePaths: imagePaths.length > 0 ? imagePaths : undefined });
+                }
+                // Step 2: Aggregate consecutive messages from the same user
+                // ClawBot splits image+text into separate messages; combine them
+                const aggregated = [];
+                for (const m of userMessages) {
+                    const last = aggregated[aggregated.length - 1];
+                    if (last && last.chatId === m.chatId) {
+                        // Same user — merge content and image paths
+                        last.content = `${last.content}\n${m.content}`;
+                        if (m.imagePaths?.length) {
+                            last.imagePaths = [...(last.imagePaths ?? []), ...m.imagePaths];
+                        }
+                    }
+                    else {
+                        aggregated.push({ chatId: m.chatId, msgId: m.msgId, content: m.content, imagePaths: m.imagePaths });
+                    }
+                }
+                // Step 3: Dispatch aggregated messages
+                for (const m of aggregated) {
+                    if (signal.aborted)
+                        break;
+                    log.info(`ClawBot message: chatId=${m.chatId}, msgId=${m.msgId}, content="${m.content.substring(0, 100)}", images=${m.imagePaths?.length ?? 0}`);
                     if (messageHandler) {
                         try {
-                            await messageHandler(chatId, msgId, content);
+                            await messageHandler(m.chatId, m.msgId, m.content, m.imagePaths);
                         }
                         catch (err) {
                             log.error('Error in ClawBot message handler:', err);
@@ -212,6 +238,48 @@ function stopWatchdog() {
         watchdogTimer = null;
     }
 }
+/**
+ * Extract and download images from a ClawBot message's item_list.
+ * Images are encrypted with AES and hosted on CDN.
+ */
+async function extractImages(msg) {
+    if (!msg.item_list?.length)
+        return [];
+    const paths = [];
+    for (const item of msg.item_list) {
+        if (item.type !== 2 /* MessageItemType.IMAGE */)
+            continue;
+        const media = item.image_item?.media;
+        if (!media?.cdn_url)
+            continue;
+        try {
+            // Download from CDN
+            const response = await fetch(media.cdn_url, { signal: AbortSignal.timeout(30_000) });
+            if (!response.ok) {
+                log.warn(`Image download failed: HTTP ${response.status}`);
+                continue;
+            }
+            const buffer = Buffer.from(await response.arrayBuffer());
+            // Decrypt if AES key provided
+            let decrypted;
+            if (media.aes_key) {
+                decrypted = decryptAes256CbcMedia(buffer, media.aes_key);
+            }
+            else {
+                decrypted = buffer;
+            }
+            // Save to disk
+            const targetPath = createMediaTargetPath('.jpg', `clawbot-${Date.now()}`);
+            await saveBufferMedia(decrypted, targetPath);
+            paths.push(targetPath);
+            log.info(`ClawBot image saved: ${targetPath}`);
+        }
+        catch (err) {
+            log.warn('Failed to process ClawBot image:', err);
+        }
+    }
+    return paths;
+}
 /**
  * Extract text content from an iLink message's item_list.
  * Returns the first text item found, or a placeholder for media types.

package/dist/clawbot/event-handler.d.ts

@@ -7,6 +7,6 @@ export interface ClawBotEventHandlerHandle {
     stop: () => void;
     runningTasks: Map<string, import('../shared/ai-task.js').TaskRunState>;
     getRunningTaskCount: () => number;
-    handleEvent: (chatId: string, msgId: string, content: string) => Promise<void>;
+    handleEvent: (chatId: string, msgId: string, content: string, imagePaths?: string[]) => Promise<void>;
 }
 export declare function setupClawbotHandlers(config: Config, sessionManager: SessionManager): ClawBotEventHandlerHandle;

package/dist/clawbot/event-handler.js

@@ -33,8 +33,8 @@ export function setupClawbotHandlers(config, sessionManager) {
             return () => { };
         },
     };
-    async function handleEvent(chatId, msgId, content) {
-        log.info(`[handleEvent] chatId=${chatId}, msgId=${msgId}, content="${content.substring(0, 100)}"`);
+    async function handleEvent(chatId, msgId, content, imagePaths) {
+        log.info(`[handleEvent] chatId=${chatId}, msgId=${msgId}, content="${content.substring(0, 100)}", images=${imagePaths?.length ?? 0}`);
         const userId = chatId;
         const text = content.trim();
         const msgIdSender = {
@@ -61,11 +61,18 @@ export function setupClawbotHandlers(config, sessionManager) {
                 },
             }),
         });
+        // Prepend image paths to prompt so Claude can read them with its Read tool
+        let enrichedText = text;
+        if (imagePaths?.length) {
+            const imgRefs = imagePaths.map(p => `[用户发送了图片: ${p}]`).join('\n');
+            enrichedText = `${imgRefs}\n${text}`;
+        }
         await handleTextFlow({
             platform: 'clawbot',
             userId,
             chatId,
-            text,
+            text: enrichedText,
+            msgId,
             ctx,
             handleAIRequest,
             sendTextReply: (c, t) => sendTextReply(c, t),

package/dist/commands/handler.d.ts

@@ -24,6 +24,7 @@ export declare class CommandHandler {
     /** 若提供，本条消息的斜杠命令回复走此 sender（须与 handleTextFlow 的 sendTextReply 一致，如带 msgId）。 */
     senderOverride?: MessageSender): Promise<boolean>;
     private handleHelp;
+    private handlePlugins;
     private handleSessions;
     private handleResume;
     private handleNew;

package/dist/commands/handler.js

@@ -28,8 +28,9 @@ function truncateSummary(session, maxLen = 30) {
 }
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { execFile } from 'node:child_process';
-import { readdirSync } from 'node:fs';
+import { readdirSync, existsSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
 /**
  * Telegram 群聊等场景下命令常为 `/new@BotName`，需与 `/new` 等价。
  * 仅去掉「第一个」命令词上的 `@suffix`，保留 `/resume 1` 等参数。
@@ -75,6 +76,8 @@ export class CommandHandler {
             }
             if (t === '/help')
                 return this.handleHelp(chatId);
+            if (t === '/plugins')
+                return this.handlePlugins(chatId);
             if (t === '/new')
                 return this.handleNew(chatId, userId);
             if (t === '/sessions' || t === '/resume')
@@ -125,6 +128,7 @@ export class CommandHandler {
             '/rename <标题> - 重命名当前会话',
             '/fork [序号] - 分支会话（创建副本）',
             '/models - 查看可用模型',
+            '/plugins - 查看已安装插件',
             '/context - 查看上下文窗口占用',
             '/status - 显示状态',
             '/cd <路径> - 切换工作目录',
@@ -133,6 +137,34 @@ export class CommandHandler {
         await this.replySender().sendTextReply(chatId, help);
         return true;
     }
+    async handlePlugins(chatId) {
+        try {
+            const settingsPath = join(homedir(), '.claude', 'settings.json');
+            if (!existsSync(settingsPath)) {
+                await this.replySender().sendTextReply(chatId, '📦 未找到 ~/.claude/settings.json\n💡 先在 Claude Code 终端运行一次会自动创建');
+                return true;
+            }
+            const raw = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+            const plugins = (raw.enabledPlugins ?? {});
+            const entries = Object.entries(plugins);
+            if (entries.length === 0) {
+                await this.replySender().sendTextReply(chatId, '📦 暂无已安装插件\n💡 在 Claude Code 终端用 /install 安装插件');
+                return true;
+            }
+            const lines = ['📦 已安装插件:', ''];
+            for (const [name, enabled] of entries) {
+                lines.push(enabled ? `  ✅ ${name}` : `  ❌ ${name}`);
+            }
+            lines.push('');
+            lines.push('💡 在 ~/.claude/settings.json 管理，或在 Claude Code 终端用 /install');
+            await this.replySender().sendTextReply(chatId, lines.join('\n'));
+        }
+        catch (e) {
+            log.warn('Failed to read plugins:', e);
+            await this.replySender().sendTextReply(chatId, '❌ 读取插件列表失败');
+        }
+        return true;
+    }
     async handleSessions(chatId, userId, _platform) {
         const workDir = this.deps.sessionManager.getWorkDir(userId);
         const sessions = await ClaudeSDKAdapter.listSessionsForDir(workDir);