@wu529778790/open-im 1.10.9-beta.20 → 1.10.9-beta.22

package/README.md

@@ -42,16 +42,6 @@ Config: **`~/.open-im/config.json`**
 
 After `start`, the CLI prints the dashboard URL (default **`http://127.0.0.1:39282`**).
 
-## Git co-authors
-
-`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.
-
-## Web dashboard
-
-`open-im start` and `open-im dashboard` serve the built-in SPA and **`/api/*`** on **`OPEN_IM_WEB_PORT`** (default **39282**). Open **`http://127.0.0.1:39282`** in a browser (same origin as the API). Override the displayed URL with **`OPEN_IM_PUBLIC_WEB_URL`** if behind a proxy.
-
-**Remote / LAN:** `export OPEN_IM_WEB_HOST=0.0.0.0` — first access from another host may show a one-time login link. Optional: **`OPEN_IM_ALLOW_REMOTE_API`**, **`OPEN_IM_CORS_ORIGINS`**.
-
 ## Chat commands
 
 | Command | Description |
@@ -64,15 +54,13 @@ After `start`, the CLI prints the dashboard URL (default **`http://127.0.0.1:392
 | `/cd` / `/pwd` | Working directory |
 | `/allow` / `/y`, `/deny` / `/n` | Permission prompts |
 
-Session state is stored in **`~/.open-im/data/sessions.json`** (per user, not IM chat logs).
-
 ## Session continuity
 
-open-im and Claude Code CLI share the same session storage. When you work in the same directory, you can seamlessly switch between phone and computer.
+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 automatically resumes the latest CLI session in the same directory — no configuration needed.
+**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 conversation that was continued on open-im.
+**Computer → Phone:** use `claude --continue` (or `claude -c`) to pick up the phone conversation.
 
 ```
 # On computer
@@ -85,33 +73,35 @@ cd /my-project && claude        # work as usual, then Ctrl+C
 claude -c                       # continues the phone conversation
 ```
 
-> **Note:** only one side can be active at a time. Exit the CLI before sending messages from the phone, and vice versa.
+> Only one side can be active at a time. Exit the CLI before sending messages from the phone, and vice versa.
 
-## Configuration
+## Git co-authors
 
-### Per-platform AI
+`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.
 
-Set **`platforms.<name>.aiCommand`** per channel (`claude` / `codex` / `codebuddy`). If unset, the process **`AI_COMMAND`** env var is used when present; otherwise it defaults to **`claude`**.
+## Minimal config
 
 ```json
 {
+  "tools": {
+    "claude": { "workDir": "/path/to/project", "skipPermissions": true, "timeoutMs": 600000 }
+  },
   "platforms": {
-    "telegram": { "enabled": true, "aiCommand": "codex", "botToken": "..." }
+    "telegram": { "enabled": true, "botToken": "YOUR_TELEGRAM_BOT_TOKEN" }
   }
 }
 ```
 
-### Claude (Agent SDK)
+Add other platforms under **`platforms`** as needed. Run **`open-im init`** for a full template.
 
-No local `claude` binary required. Credentials: env → **`config.json`** **`tools.claude.env`** → **`~/.claude/settings.json`** (dashboard saves API fields here).
+### Claude (Agent SDK)
 
-Third-party / compatible API example:
+No local `claude` binary required. Third-party / compatible API:
 
 ```json
 {
   "tools": {
     "claude": {
-      "workDir": "/path/to/project",
       "env": {
         "ANTHROPIC_AUTH_TOKEN": "your-token",
         "ANTHROPIC_BASE_URL": "https://your-api-endpoint",
@@ -122,88 +112,25 @@ Third-party / compatible API example:
 }
 ```
 
-### CodeBuddy
-
-```bash
-npm install -g @tencent-ai/codebuddy-code
-codebuddy login
-```
+### Per-platform AI
 
-### Minimal `config.json` shape
+Set **`platforms.<name>.aiCommand`** (`claude` / `codex` / `codebuddy`) per channel. Default: `claude`.
 
-```json
-{
-  "tools": {
-    "claude": { "workDir": "/path/to/project", "skipPermissions": true, "timeoutMs": 600000 }
-  },
-  "platforms": {
-    "telegram": { "enabled": true, "aiCommand": "claude", "botToken": "YOUR_TELEGRAM_BOT_TOKEN" }
-  }
-}
-```
+### Web dashboard
 
-Add Feishu, QQ, WeCom, DingTalk, WorkBuddy under **`platforms`** as needed. Run **`open-im init`** for a full template. WeChat (WorkBuddy) is easiest via **`open-im init`**.
+`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`.
 
 ### Environment variables
 
-Use **`config.json`** (platforms, `tools.*`, etc.) or environment variables; the dashboard exposes common options. 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. The root-level **`config.json` `env`** field is no longer read.
+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.
 
 ### 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`**.
 
-### Platform credentials
-
-| Platform | Notes |
-| --- | --- |
-| Telegram | [@BotFather](https://t.me/BotFather) |
-| Feishu | [Open Platform](https://open.feishu.cn/) |
-| QQ | [QQ Open Platform](https://bot.q.qq.com/) |
-| DingTalk | Open Platform — bot **Stream Mode**; optional **`cardTemplateId`** for AI assistant cards |
-| WeCom | [Admin](https://work.weixin.qq.com/) |
-| WeChat | **`open-im init`** → WorkBuddy OAuth |
-| ClawBot (WeChat) | QR code login via iLink API; see [ClawBot setup](#clawbot-setup) |
-
-### ClawBot setup
-
-ClawBot connects to WeChat via the official iLink Bot API (same protocol as `@tencent-weixin/openclaw-weixin`). It supports text, voice, image, file, and video messages.
-
-**Setup:**
-
-1. Enable in config:
-   ```json
-   {
-     "platforms": {
-       "clawbot": { "enabled": true }
-     }
-   }
-   ```
-2. Open the Web dashboard → **ClawBot** section → **Scan QR code** with WeChat.
-3. After scanning, `bot_token` and `apiUrl` are saved automatically.
+## Platform setup & troubleshooting
 
-**Config fields:**
-
-| Field | Default | Description |
-| --- | --- | --- |
-| `apiUrl` | `https://ilinkai.weixin.qq.com` | iLink API base URL |
-| `apiToken` | — | Bot token (auto-set after QR login) |
-| `aiCommand` | `claude` | AI backend override |
-
-**Protocol:** POST + JSON body + Bearer token auth. Long-polling via `ilink/bot/getupdates` with `get_updates_buf` cursor.
-
-## Troubleshooting
-
-| Issue | What to try |
-| --- | --- |
-| Telegram / network | `proxy` or **`TELEGRAM_PROXY`** |
-| QQ | Check **`QQ_BOT_APPID`** / **`QQ_BOT_SECRET`**; update if duplicate replies |
-| Feishu cards | **`/mode ask`** or **`/mode yolo`** without card callbacks |
-| WeCom | Send the bot a message first |
-| DingTalk | Stream Mode + credentials; custom bots may be text-only |
-| Codex disconnect | **`CODEX_PROXY`** or **`tools.codex.proxy`** |
-| CodeBuddy login | **`codebuddy login`** |
-| WorkBuddy | Re-run **`open-im init`** (tokens expire) |
-| ClawBot | QR re-login via Web UI; `apiUrl` defaults to `https://ilinkai.weixin.qq.com` |
+See **[docs/platforms.md](./docs/platforms.md)** for detailed per-platform configuration, credential setup, and troubleshooting.
 
 ## License
 

package/README.zh-CN.md

@@ -42,16 +42,6 @@ npx @wu529778790/open-im start
 
 `start` 后会提示控制台地址（默认 **`http://127.0.0.1:39282`**）。
 
-## Git 共同作者
-
-默认在 AI 发起的提交里追加 `Co-authored-by`。**关闭**：设置环境变量 **`OPEN_IM_GIT_COAUTHOR=0`** 并重启桥接。
-
-## Web 控制台
-
-`open-im start` / `open-im dashboard` 在 **`OPEN_IM_WEB_PORT`**（默认 **39282**）提供内置页面与 **`/api/*`**。浏览器打开 **`http://127.0.0.1:39282`** 即可（与 API 同源）。反向代理时可设 **`OPEN_IM_PUBLIC_WEB_URL`**。
-
-**局域网 / 远程：** `export OPEN_IM_WEB_HOST=0.0.0.0` — 首次外网访问可能需一次性登录链接。可选 **`OPEN_IM_ALLOW_REMOTE_API`**、**`OPEN_IM_CORS_ORIGINS`**。
-
 ## IM 内命令
 
 | 命令 | 说明 |
@@ -64,8 +54,6 @@ npx @wu529778790/open-im start
 | `/cd` / `/pwd` | 工作目录 |
 | `/allow` / `/y`、`/deny` / `/n` | 权限确认 |
 
-会话状态保存在 **`~/.open-im/data/sessions.json`**（按用户，与 IM 聊天记录无关）。
-
 ## 会话接力
 
 open-im 和 Claude Code CLI 共享同一份 session 存储。在同一个目录下，手机和电脑可以无缝切换。
@@ -85,33 +73,35 @@ cd /my-project && claude        # 正常工作，退出时 Ctrl+C
 claude -c                       # 接上手机端的对话
 ```
 
-> **注意：** 同一时刻只能有一端活跃。从手机发消息前先退出 CLI，反之亦然。
+> 同一时刻只能有一端活跃。从手机发消息前先退出 CLI，反之亦然。
 
-## 配置说明
+## Git 共同作者
 
-### 按平台指定 AI
+默认在 AI 发起的提交里追加 `Co-authored-by`。**关闭**：设置环境变量 **`OPEN_IM_GIT_COAUTHOR=0`** 并重启桥接。
 
-在每个已启用渠道上设置 **`platforms.<name>.aiCommand`**（`claude` / `codex` / `codebuddy`）。若未设置，会尝试进程环境变量 **`AI_COMMAND`**；再否则默认为 **`claude`**。
+## 最小配置
 
 ```json
 {
+  "tools": {
+    "claude": { "workDir": "/path/to/project", "skipPermissions": true, "timeoutMs": 600000 }
+  },
   "platforms": {
-    "telegram": { "enabled": true, "aiCommand": "codex", "botToken": "..." }
+    "telegram": { "enabled": true, "botToken": "YOUR_TELEGRAM_BOT_TOKEN" }
   }
 }
 ```
 
-### Claude（Agent SDK）
+在 **`platforms`** 下按需补充其他平台。完整模板请用 **`open-im init`**。
 
-无需本地 `claude` 可执行文件。凭证顺序：环境变量 → **`config.json`** 的 **`tools.claude.env`** → **`~/.claude/settings.json`**（控制台保存的 API 配置写入后者）。
+### Claude（Agent SDK）
 
-第三方兼容接口示例：
+无需本地 `claude` 可执行文件。第三方兼容接口示例：
 
 ```json
 {
   "tools": {
     "claude": {
-      "workDir": "/path/to/project",
       "env": {
         "ANTHROPIC_AUTH_TOKEN": "your-token",
         "ANTHROPIC_BASE_URL": "https://your-api-endpoint",
@@ -122,88 +112,25 @@ claude -c                       # 接上手机端的对话
 }
 ```
 
-### CodeBuddy
-
-```bash
-npm install -g @tencent-ai/codebuddy-code
-codebuddy login
-```
+### 按平台指定 AI
 
-### 最小配置结构
+在每个平台上设置 **`platforms.<name>.aiCommand`**（`claude` / `codex` / `codebuddy`）。默认 `claude`。
 
-```json
-{
-  "tools": {
-    "claude": { "workDir": "/path/to/project", "skipPermissions": true, "timeoutMs": 600000 }
-  },
-  "platforms": {
-    "telegram": { "enabled": true, "aiCommand": "claude", "botToken": "YOUR_TELEGRAM_BOT_TOKEN" }
-  }
-}
-```
+### Web 控制台
 
-在 **`platforms`** 下按需补充飞书、QQ、企业微信、钉钉、WorkBuddy。完整模板请用 **`open-im init`**。微信建议 **`open-im init`** 走 WorkBuddy OAuth。
+`open-im start` 在 **`OPEN_IM_WEB_PORT`**（默认 **39282**）提供内置页面与 **`/api/*`**。局域网访问：`export OPEN_IM_WEB_HOST=0.0.0.0`。
 
 ### 环境变量
 
-可在 **`config.json`**（平台与 `tools.*` 等）或环境变量中设置；控制台会展示常用项。常见：**`ANTHROPIC_*`**（shell 或 **`tools.claude.env`**）、**`TELEGRAM_BOT_TOKEN`**、**`OPEN_IM_WEB_PORT`**、**`OPEN_IM_WEB_HOST`**，以及各平台的 `*_APP_ID`、`*_SECRET`、`WORKBUDDY_*` 等。根级 **`config.json` `env`** 已不再使用。
+常见：**`ANTHROPIC_*`**（shell 或 **`tools.claude.env`**）、**`TELEGRAM_BOT_TOKEN`**、**`OPEN_IM_WEB_PORT`**、**`OPEN_IM_WEB_HOST`**，以及各平台的 `*_APP_ID`、`*_SECRET`、`WORKBUDDY_*` 等。
 
 ### 隐私
 
 为改进稳定性，可能记录**匿名**运行信息（不含聊天或 prompt 内容）。若需关闭：环境变量 **`OPEN_IM_TELEMETRY=false`**，或 **`config.json`** 中 **`"telemetry": { "enabled": false }`**。
 
-### 平台凭证
-
-| 平台 | 说明 |
-| --- | --- |
-| Telegram | [@BotFather](https://t.me/BotFather) |
-| 飞书 | [开放平台](https://open.feishu.cn/) |
-| QQ | [QQ 开放平台](https://bot.q.qq.com/) |
-| 钉钉 | 开放平台创建应用，机器人开 **Stream Mode**；可选 **`cardTemplateId`** 走 AI 助理卡片 |
-| 企业微信 | [管理后台](https://work.weixin.qq.com/) |
-| 微信 | **`open-im init`** → WorkBuddy OAuth |
-| ClawBot（微信） | 扫码登录 iLink API，参见 [ClawBot 配置](#clawbot-配置) |
-
-### ClawBot 配置
-
-ClawBot 通过官方 iLink Bot API 连接微信（与 `@tencent-weixin/openclaw-weixin` 协议相同）。支持文本、语音、图片、文件和视频消息。
-
-**使用方法：**
-
-1. 在配置中启用：
-   ```json
-   {
-     "platforms": {
-       "clawbot": { "enabled": true }
-     }
-   }
-   ```
-2. 打开 Web 控制台 → **ClawBot** 区域 → **扫码登录**（用微信扫码）。
-3. 扫码成功后 `bot_token` 和 `apiUrl` 自动保存。
+## 平台配置与故障排除
 
-**配置字段：**
-
-| 字段 | 默认值 | 说明 |
-| --- | --- | --- |
-| `apiUrl` | `https://ilinkai.weixin.qq.com` | iLink API 地址 |
-| `apiToken` | — | Bot Token（扫码后自动写入） |
-| `aiCommand` | `claude` | AI 后端覆盖 |
-
-**协议：** POST + JSON body + Bearer token 鉴权，通过 `ilink/bot/getupdates` 长轮询 + `get_updates_buf` 游标拉取消息。
-
-## 故障排除
-
-| 现象 | 处理 |
-| --- | --- |
-| Telegram / 网络 | 配置 `proxy` 或 **`TELEGRAM_PROXY`** |
-| QQ | 核对 **`QQ_BOT_APPID`**、**`QQ_BOT_SECRET`**；重复回复请升级版本 |
-| 飞书卡片 | 未配回调时用 **`/mode ask`** 或 **`/mode yolo`** |
-| 企业微信 | 先给机器人发一条消息 |
-| 钉钉 | 开启 Stream Mode；自定义机器人可能仅纯文本 |
-| Codex 断流 | **`CODEX_PROXY`** 或 **`tools.codex.proxy`** |
-| CodeBuddy 登录 | **`codebuddy login`** |
-| WorkBuddy / 微信 | 重跑 **`open-im init`**（Token 会过期） |
-| ClawBot | Web 控制台重新扫码；`apiUrl` 默认 `https://ilinkai.weixin.qq.com` |
+详见 **[docs/platforms.zh-CN.md](./docs/platforms.zh-CN.md)**。
 
 ## License
 

package/dist/adapters/opencode-adapter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * OpenCode Adapter — run tasks through OpenCode CLI (`opencode run`)
+ */
+import type { RunCallbacks, RunHandle, RunOptions, ToolAdapter } from './tool-adapter.interface.js';
+export declare class OpenCodeAdapter implements ToolAdapter {
+    private cliPath;
+    readonly toolId = "opencode";
+    constructor(cliPath: string);
+    run(prompt: string, sessionId: string | undefined, workDir: string, callbacks: RunCallbacks, options?: RunOptions): RunHandle;
+}

package/dist/adapters/opencode-adapter.js

@@ -0,0 +1,45 @@
+/**
+ * OpenCode Adapter — run tasks through OpenCode CLI (`opencode run`)
+ */
+import { runOpenCode } from '../opencode/cli-runner.js';
+export class OpenCodeAdapter {
+    cliPath;
+    toolId = 'opencode';
+    constructor(cliPath) {
+        this.cliPath = cliPath;
+    }
+    run(prompt, sessionId, workDir, callbacks, options) {
+        return runOpenCode(this.cliPath, prompt, sessionId, workDir, {
+            onText: callbacks.onText,
+            onThinking: callbacks.onThinking,
+            onToolUse: callbacks.onToolUse,
+            onComplete: (raw) => {
+                const result = {
+                    success: raw.success,
+                    result: raw.result,
+                    accumulated: raw.accumulated,
+                    cost: raw.cost,
+                    durationMs: raw.durationMs,
+                    model: raw.model,
+                    numTurns: raw.numTurns,
+                    toolStats: raw.toolStats,
+                };
+                callbacks.onComplete(result);
+            },
+            onError: (err) => {
+                const msg = typeof err === 'string' ? err : String(err);
+                const friendly = msg.includes('session not found') ||
+                    msg.includes('Session not found') ||
+                    msg.includes('no sessions found')
+                    ? 'OpenCode 会话已失效，旧 session 已清理。请直接重试当前请求。'
+                    : msg;
+                callbacks.onError(friendly);
+            },
+            onSessionId: callbacks.onSessionId,
+            onSessionInvalid: callbacks.onSessionInvalid,
+        }, {
+            skipPermissions: options?.skipPermissions,
+            model: options?.model,
+        });
+    }
+}

package/dist/adapters/registry.js

@@ -2,6 +2,7 @@ import { getConfiguredAiCommands } from '../config.js';
 import { ClaudeSDKAdapter, configureClaudeSdkSessionIdle } from './claude-sdk-adapter.js';
 import { CodexAdapter } from './codex-adapter.js';
 import { CodeBuddyAdapter } from './codebuddy-adapter.js';
+import { OpenCodeAdapter } from './opencode-adapter.js';
 import { createLogger } from '../logger.js';
 import { destroyAllLiveChildren } from '../shared/process-kill.js';
 const log = createLogger('Registry');
@@ -24,6 +25,10 @@ export function initAdapters(config) {
             log.info('CodeBuddy CLI adapter enabled');
             adapters.set('codebuddy', new CodeBuddyAdapter(config.codebuddyCliPath));
         }
+        if (aiCommand === 'opencode') {
+            log.info('OpenCode CLI adapter enabled');
+            adapters.set('opencode', new OpenCodeAdapter(config.opencodeCliPath));
+        }
     }
 }
 export function getAdapter(aiCommand) {

package/dist/commands/handler.js

@@ -189,12 +189,13 @@ export class CommandHandler {
     }
     getAiVersion(aiCommand) {
         if (aiCommand === 'claude') {
-            // Claude 使用 SDK，返回 SDK 版本
             return Promise.resolve('SDK Mode');
         }
         const cmd = aiCommand === 'codex'
             ? this.deps.config.codexCliPath
-            : this.deps.config.codebuddyCliPath;
+            : aiCommand === 'opencode'
+                ? this.deps.config.opencodeCliPath
+                : this.deps.config.codebuddyCliPath;
         return new Promise((resolve) => {
             execFile(cmd, ['--version'], { timeout: 5000 }, (err, stdout) => {
                 resolve(err ? '未知' : (stdout?.toString().trim() || '未知'));

package/dist/config/types.d.ts

@@ -1,6 +1,6 @@
 import type { LogLevel } from '../logger.js';
 export type Platform = 'clawbot' | 'dingtalk' | 'feishu' | 'qq' | 'telegram' | 'wework' | 'workbuddy';
-export type AiCommand = 'claude' | 'codex' | 'codebuddy';
+export type AiCommand = 'claude' | 'codex' | 'codebuddy' | 'opencode';
 export interface Config {
     enabledPlatforms: Platform[];
     telegramBotToken?: string;
@@ -24,6 +24,7 @@ export interface Config {
     clawbotAllowedUserIds: string[];
     codexCliPath: string;
     codebuddyCliPath: string;
+    opencodeCliPath: string;
     /** Claude 访问 API 的代理（如 http://127.0.0.1:7890） */
     claudeProxy?: string;
     /** Codex 访问 chatgpt.com 的代理（如 http://127.0.0.1:7890） */
@@ -182,6 +183,9 @@ export interface FileToolCodex {
 export interface FileToolCodeBuddy {
     cliPath?: string;
 }
+export interface FileToolOpenCode {
+    cliPath?: string;
+}
 export interface FileConfig {
     telegramBotToken?: string;
     feishuAppId?: string;
@@ -203,6 +207,7 @@ export interface FileConfig {
         claude?: FileToolClaude;
         codex?: FileToolCodex;
         codebuddy?: FileToolCodeBuddy;
+        opencode?: FileToolOpenCode;
     };
     logDir?: string;
     logLevel?: LogLevel;

package/dist/config-web.js

@@ -351,6 +351,7 @@ function buildInitialPayload(file) {
             claudeProxy: file.tools?.claude?.proxy ?? "",
             codexCliPath: file.tools?.codex?.cliPath ?? "codex",
             codebuddyCliPath: file.tools?.codebuddy?.cliPath ?? "codebuddy",
+            opencodeCliPath: file.tools?.opencode?.cliPath ?? "opencode",
             codexProxy: file.tools?.codex?.proxy ?? "",
             codexApiKey: (() => {
                 if (process.env.OPENAI_API_KEY)
@@ -505,6 +506,7 @@ function createProbeConfig(values) {
         logLevel: "INFO",
         telemetry: { enabled: true },
         codebuddyCliPath: "codebuddy",
+        opencodeCliPath: "opencode",
         platforms: {},
         ...values,
     };
@@ -704,6 +706,10 @@ function toFileConfig(payload, existing) {
                 ...existing.tools?.codebuddy,
                 cliPath: clean(payload.ai.codebuddyCliPath) ?? "codebuddy",
             },
+            opencode: {
+                ...existing.tools?.opencode,
+                cliPath: clean(payload.ai.opencodeCliPath) ?? "opencode",
+            },
         },
         platforms: {
             ...existing.platforms,

package/dist/config.js

@@ -231,6 +231,8 @@ export function loadConfig() {
             }
         }
     }
+    const topencode = file.tools?.opencode ?? {};
+    const opencodeCliPath = process.env.OPENCODE_CLI_PATH ?? topencode.cliPath ?? 'opencode';
     const claudeWorkDir = process.env.CLAUDE_WORK_DIR ?? tc.workDir ?? process.cwd();
     const skipPermissions = process.env.OPEN_IM_SKIP_PERMISSIONS === 'false'
         ? false
@@ -563,6 +565,7 @@ export function loadConfig() {
         clawbotAllowedUserIds,
         codexCliPath,
         codebuddyCliPath,
+        opencodeCliPath,
         claudeProxy,
         codexProxy,
         claudeWorkDir,

package/dist/opencode/cli-runner.d.ts

@@ -0,0 +1,32 @@
+/**
+ * OpenCode CLI runner — spawns `opencode run` in non-interactive mode.
+ *
+ * OpenCode outputs plain text to stdout. Session continuation uses `-s <id>`.
+ */
+export interface OpenCodeRunCallbacks {
+    onText: (accumulated: string) => void;
+    onThinking?: (accumulated: string) => void;
+    onToolUse?: (toolName: string, toolInput?: Record<string, unknown>) => void;
+    onComplete: (result: {
+        success: boolean;
+        result: string;
+        accumulated: string;
+        cost: number;
+        durationMs: number;
+        model?: string;
+        numTurns: number;
+        toolStats: Record<string, number>;
+    }) => void;
+    onError: (error: string) => void;
+    onSessionId?: (sessionId: string) => void;
+    onSessionInvalid?: () => void;
+}
+export interface OpenCodeRunOptions {
+    skipPermissions?: boolean;
+    model?: string;
+}
+export interface OpenCodeRunHandle {
+    abort: () => void;
+}
+export declare function buildOpenCodeArgs(prompt: string, sessionId: string | undefined, workDir: string, options?: OpenCodeRunOptions): string[];
+export declare function runOpenCode(cliPath: string, prompt: string, sessionId: string | undefined, workDir: string, callbacks: OpenCodeRunCallbacks, options?: OpenCodeRunOptions): OpenCodeRunHandle;

package/dist/opencode/cli-runner.js

@@ -0,0 +1,161 @@
+/**
+ * OpenCode CLI runner — spawns `opencode run` in non-interactive mode.
+ *
+ * OpenCode outputs plain text to stdout. Session continuation uses `-s <id>`.
+ */
+import { spawn } from 'node:child_process';
+import { createInterface } from 'node:readline';
+import { createLogger } from '../logger.js';
+import { processEnvForNonClaudeCliChild } from '../config/file-io.js';
+import { killProcessTree, trackChild } from '../shared/process-kill.js';
+const log = createLogger('OpenCodeCli');
+export function buildOpenCodeArgs(prompt, sessionId, workDir, options) {
+    const args = ['run'];
+    // Working directory
+    args.push('--dir', workDir);
+    // Session continuation
+    if (sessionId) {
+        args.push('--session', sessionId);
+    }
+    // Model override
+    if (options?.model) {
+        args.push('--model', options.model);
+    }
+    // Skip permissions
+    if (options?.skipPermissions) {
+        args.push('--dangerously-skip-permissions');
+    }
+    // Prompt as positional argument
+    args.push(prompt);
+    return args;
+}
+export function runOpenCode(cliPath, prompt, sessionId, workDir, callbacks, options) {
+    const args = buildOpenCodeArgs(prompt, sessionId, workDir, options);
+    const env = processEnvForNonClaudeCliChild();
+    log.info(`Spawning OpenCode: path=${cliPath}, cwd=${workDir}, session=${sessionId ?? 'new'}`);
+    const child = spawn(cliPath, args, {
+        cwd: workDir,
+        detached: process.platform !== 'win32',
+        stdio: ['pipe', 'pipe', 'pipe'],
+        env,
+        windowsHide: process.platform === 'win32',
+    });
+    trackChild(child);
+    // Close stdin — prompt is passed as argument
+    child.stdin?.end();
+    let accumulated = '';
+    let completed = false;
+    const toolStats = {};
+    const startTime = Date.now();
+    const rl = createInterface({ input: child.stdout });
+    const MAX_STDERR_HEAD = 4 * 1024;
+    const MAX_STDERR_TAIL = 6 * 1024;
+    let stderrHead = '';
+    let stderrTail = '';
+    let stderrTotal = 0;
+    let stderrHeadFull = false;
+    child.stderr?.on('data', (chunk) => {
+        const text = chunk.toString();
+        stderrTotal += text.length;
+        if (!stderrHeadFull) {
+            const room = MAX_STDERR_HEAD - stderrHead.length;
+            if (room > 0) {
+                stderrHead += text.slice(0, room);
+                if (stderrHead.length >= MAX_STDERR_HEAD)
+                    stderrHeadFull = true;
+            }
+        }
+        stderrTail += text;
+        if (stderrTail.length > MAX_STDERR_TAIL) {
+            stderrTail = stderrTail.slice(-MAX_STDERR_TAIL);
+        }
+        log.debug(`[stderr] ${text.trimEnd()}`);
+    });
+    rl.on('line', (line) => {
+        if (completed)
+            return;
+        // OpenCode outputs plain text — accumulate each line
+        const trimmed = line.trim();
+        if (!trimmed)
+            return;
+        // Skip spinner lines (ANSI escape sequences or common spinner chars)
+        if (/^[⠀-⣿\s⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏▪●◆⬤◉⬤⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏]+$/.test(trimmed))
+            return;
+        accumulated += (accumulated ? '\n' : '') + line;
+        callbacks.onText(accumulated);
+    });
+    // Also capture stdout as a raw stream for binary-like streaming
+    child.stdout?.on('data', (chunk) => {
+        // The readline interface handles line-by-line, but we also
+        // want to capture any partial data for streaming updates
+        const text = chunk.toString();
+        if (!completed && text.trim()) {
+            log.debug(`[stdout chunk] ${text.substring(0, 200)}`);
+        }
+    });
+    let exitCode = null;
+    let rlClosed = false;
+    let childClosed = false;
+    const finalize = () => {
+        if (!rlClosed || !childClosed)
+            return;
+        if (completed)
+            return;
+        if (exitCode !== null && exitCode !== 0) {
+            let errMsg = '';
+            if (stderrTotal > 0) {
+                if (!stderrHeadFull) {
+                    errMsg = stderrHead;
+                }
+                else if (stderrTotal <= MAX_STDERR_HEAD + MAX_STDERR_TAIL) {
+                    errMsg = stderrHead + stderrTail.slice(stderrTail.length - (stderrTotal - MAX_STDERR_HEAD));
+                }
+                else {
+                    errMsg =
+                        stderrHead +
+                            `\n\n... (omitted ${stderrTotal - MAX_STDERR_HEAD - MAX_STDERR_TAIL} bytes) ...\n\n` +
+                            stderrTail;
+                }
+            }
+            if (sessionId &&
+                (errMsg.includes('session not found') ||
+                    errMsg.includes('Session not found') ||
+                    errMsg.includes('no sessions found'))) {
+                callbacks.onSessionInvalid?.();
+            }
+            callbacks.onError(errMsg || `OpenCode exited with code ${exitCode}`);
+            return;
+        }
+        // Exit code 0 but no onComplete fired yet — treat accumulated text as result
+        if (!completed) {
+            completed = true;
+            callbacks.onComplete({
+                success: true,
+                result: accumulated,
+                accumulated,
+                cost: 0,
+                durationMs: Date.now() - startTime,
+                numTurns: 1,
+                toolStats,
+            });
+        }
+    };
+    rl.on('close', () => {
+        rlClosed = true;
+        finalize();
+    });
+    child.on('close', (code) => {
+        exitCode = code;
+        childClosed = true;
+        finalize();
+    });
+    child.on('error', (err) => {
+        log.error('OpenCode spawn error:', err);
+        callbacks.onError(`Failed to start OpenCode: ${err.message}`);
+    });
+    return {
+        abort: () => {
+            killProcessTree(child);
+        },
+    };
+}

package/dist/session/session-manager.d.ts

@@ -1,4 +1,4 @@
-type ToolId = 'claude' | 'codex' | 'codebuddy';
+type ToolId = 'claude' | 'codex' | 'codebuddy' | 'opencode';
 interface ConvHistoryEntry {
     convId: string;
     totalTurns: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wu529778790/open-im",
-  "version": "1.10.9-beta.20",
+  "version": "1.10.9-beta.22",
   "description": "Multi-platform IM bridge for AI CLI tools (Claude, Codex, CodeBuddy)",
   "type": "module",
   "main": "dist/index.js",