@xwang152/claw-lark 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xwang152-jack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,242 @@
+# Lark Plugin for OpenClaw
+
+[中文文档](./README_zh.md)
+
+A channel plugin that enables OpenClaw to communicate via Lark (Larksuite) messaging platform.
+
+## Features
+
+- **Direct Messages**: Chat with your bot one-on-one
+- **Group Chats**: Add your bot to group conversations
+- **Text Messages**: Send and receive text messages
+- **Image Support**: Bot can send images generated by agents
+- **Webhook Mode**: For individual Lark accounts (tested)
+- **WebSocket Mode**: For enterprise accounts (tested, recommended)
+- **Auto-Recovery**: WebSocket and Webhook servers automatically reconnect/restart on crashes
+
+## Requirements
+
+- OpenClaw installed and configured
+- A Lark Developer account
+- A Lark app with Bot capability enabled
+
+## Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/xwang152-jack/claw-lark.git
+cd claw-lark
+
+# Install dependencies
+npm install
+
+# Install plugin into OpenClaw
+openclaw plugins install --link .
+```
+
+Or install directly via npm:
+
+```bash
+openclaw plugins install @xwang152/claw-lark
+```
+
+Verify installation:Restart Gateway to load the plugin
+openclaw gateway restart
+```
+
+Verify installation:
+
+```bash
+openclaw plugins list
+```
+
+You should see `lark` with status `loaded`.
+
+## Lark App Setup
+
+1. Go to [Lark Developer Console](https://open.larksuite.com/app)
+
+2. Create a new app or use an existing one
+
+3. Enable **Bot** capability under App Features
+
+4. Add the following permissions under Permissions & Scopes:
+
+| Permission | Scope | Description |
+| :--- | :--- | :--- |
+| `im:message` | Message | Send and receive messages |
+| `im:message.p2p_msg:readonly` | P2P Message | Read direct messages sent to the bot |
+| `im:message.group_at_msg:readonly` | Group Message | Receive messages where the bot is @mentioned in groups |
+| `im:message:send_as_bot` | Send | Send messages as the bot |
+| `im:resource` | Resource | Upload/download images and files |
+
+**Optional Permissions (add as needed):**
+
+| Permission | Scope | Description |
+| :--- | :--- | :--- |
+| `im:message.group_msg` | Group | Read all group messages (Sensitive permission) |
+| `im:message:readonly` | Read | Get historical messages |
+| `im:message:update` | Edit | Update/edit sent messages |
+| `im:message:recall` | Recall | Recall sent messages |
+| `im:message.reactions:read` | Reaction | View message emoji reactions |
+
+5. Note your **App ID** and **App Secret** from Credentials & Basic Info (you'll need these for configuration)
+
+6. Publish your app under Version Management
+
+## Configuration
+
+### Using Config Commands
+
+```bash
+# Required settings
+openclaw config set channels.lark.accounts.default.appId 'cli_xxxxx'
+openclaw config set channels.lark.accounts.default.appSecret 'your-app-secret'
+openclaw config set channels.lark.accounts.default.connectionMode 'webhook'
+
+# Optional settings
+openclaw config set channels.lark.accounts.default.webhookPort 3000
+openclaw config set channels.lark.accounts.default.domain 'lark'
+openclaw config set channels.lark.accounts.default.dmPolicy 'open'
+openclaw config set channels.lark.accounts.default.groupPolicy 'open'
+openclaw config set channels.lark.accounts.default.groupMentionGated false
+
+# Security settings (from Lark Developer Console > Events & Callbacks > Encryption Strategy)
+openclaw config set channels.lark.accounts.default.encryptKey 'your-encrypt-key'
+openclaw config set channels.lark.accounts.default.verificationToken 'your-verification-token'
+```
+
+### Using Environment Variables
+
+For the default account, you can use environment variables:
+
+```bash
+LARK_APP_ID=cli_xxxxx
+LARK_APP_SECRET=your-app-secret
+
+# Security settings (from Lark Developer Console > Events & Callbacks > Encryption Strategy)
+LARK_ENCRYPT_KEY=your-encrypt-key          # Optional, for decrypting event payloads
+LARK_VERIFICATION_TOKEN=your-token         # Optional, for verifying request authenticity
+```
+
+### Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `appId` | string | - | Lark App ID (required) |
+| `appSecret` | string | - | Lark App Secret (required) |
+| `connectionMode` | string | `websocket` | `webhook` or `websocket` |
+| `webhookPort` | number | `3000` | Port for webhook server |
+| `domain` | string | `feishu` | `feishu` (China) or `lark` (international) |
+| `encryptKey` | string | - | Encrypt key for decrypting event payloads (from Events & Callbacks > Encryption Strategy) |
+| `verificationToken` | string | - | Token for verifying request authenticity (from Events & Callbacks > Encryption Strategy) |
+| `dmPolicy` | string | `pairing` | `open`, `pairing`, or `allowlist` |
+| `groupPolicy` | string | `open` | `open`, `allowlist`, or `disabled` |
+| `groupMentionGated` | boolean | `true` | Require @mention in groups |
+
+## Webhook Mode Setup
+
+Choose the setup method based on your deployment environment.
+
+### 1. Development (Using ngrok)
+
+Recommended for local development and testing.
+
+> **Security & Privacy Notice**: ngrok exposes your local server to the internet. Keep the following in mind:
+> - Never share your ngrok URL publicly — anyone with the URL can send requests to your local machine
+> - Use a paid ngrok plan with authentication or IP restrictions for production use
+> - Stop ngrok when not in use to close the tunnel
+> - Consider using Lark's `encryptKey` and `verificationToken` for additional request validation
+
+1. Start ngrok to expose your local webhook server:
+
+```bash
+ngrok http 3000
+```
+
+2. Copy the HTTPS URL from ngrok (e.g., `https://abc123.ngrok.io`)
+
+3. Configure Events & Callbacks in Lark Developer Console:
+   - Add event subscription: `im.message.receive_v1`
+   - Set Request URL to your ngrok HTTPS URL (e.g., `https://abc123.ngrok.io`)
+
+### 2. Production (Server Deployment)
+
+When deploying on a server, ngrok is **not** required.
+
+1. **Open Port**: Ensure your server's firewall (Security Group) allows traffic on the port used by the plugin (default is `3000`).
+2. **Configure URL**: In Lark Developer Console, configure "Events & Callbacks":
+   - Set the "Request URL" to your server's public address: `http://your-server-ip:3000`.
+3. **(Recommended) Reverse Proxy**: Use Nginx or Caddy to set up a reverse proxy with SSL (HTTPS) and forward traffic to port `3000`.
+
+### 3. Start the Plugin
+
+1. Start OpenClaw:
+
+```bash
+openclaw start
+```
+
+2. The webhook server will start automatically and handle URL verification.
+
+## WebSocket Mode
+
+WebSocket mode is available for enterprise Lark accounts (Custom Apps) that support long connections. Set `connectionMode` to `websocket`:
+
+```bash
+openclaw config set channels.lark.accounts.default.connectionMode 'websocket'
+```
+
+**Advantages:**
+- **No Public IP Needed**: No need for ngrok or reverse proxy, suitable for local or intranet environments.
+- **Easy Setup**: Simply enable the "Receive events through persistent connection" toggle in the Lark Developer Console.
+- **High Stability**: The plugin supports automatic reconnection.
+
+**Configuration Steps:**
+1. Go to **Events & Callbacks** in the Lark Developer Console.
+2. Select **Receive events through persistent connection** under "Subscription Mode".
+3. Ensure the `im.message.receive_v1` event is added.
+
+## Multiple Accounts
+
+You can configure multiple Lark accounts:
+
+```bash
+openclaw config set channels.lark.accounts.work.appId 'cli_work_app'
+openclaw config set channels.lark.accounts.work.appSecret 'work-secret'
+openclaw config set channels.lark.accounts.personal.appId 'cli_personal_app'
+openclaw config set channels.lark.accounts.personal.appSecret 'personal-secret'
+```
+
+## Troubleshooting
+
+### Bot not receiving messages
+
+1. Verify the event subscription `im.message.receive_v1` is added
+2. Check that the callback URL is correctly configured
+3. Ensure the required permissions are enabled
+4. Make sure the app is published (not just saved as draft)
+
+### Permission errors when sending images
+
+Add the `im:resource` permission in Lark Developer Console and republish your app.
+
+### Webhook server not starting
+
+Check if port 3000 is already in use. Change the port:
+
+```bash
+openclaw config set channels.lark.accounts.default.webhookPort 3001
+```
+
+### Connection issues with WebSocket mode
+
+WebSocket mode requires enterprise Lark accounts. If you have an individual account, use webhook mode instead.
+
+## Contributing
+
+Issues and pull requests are welcome! If you encounter bugs or have feature requests, please open an issue at https://github.com/xwang152-jack/claw-lark/issues.
+
+## License
+
+MIT

package/README_zh.md

@@ -0,0 +1,240 @@
+# OpenClaw 飞书/Lark 插件
+
+这是一个为 OpenClaw 开发的频道插件，使 OpenClaw 能够通过飞书 (Larksuite) 平台进行通信。
+
+## 功能特性
+
+- **私聊消息**：与您的机器人进行一对一对话
+- **群聊消息**：将机器人加入群组对话
+- **文本消息**：发送和接收文本消息
+- **图片支持**：机器人可以发送由智能体生成的图片
+- **Webhook 模式**：适用于个人飞书账号（已测试）
+- **WebSocket 模式**：适用于企业级账号（已通过测试，推荐使用）
+- **自动恢复**：WebSocket 和 Webhook 服务在崩溃时会自动重连或重启
+
+## 前置要求
+
+- 已安装并配置 OpenClaw
+- 飞书开发者账号
+- 已启用机器人能力的飞书应用
+
+## 安装步骤
+
+```bash
+# 克隆仓库
+git clone https://github.com/xwang152-jack/claw-lark.git
+cd claw-lark
+
+# 安装依赖
+npm install
+
+# 将插件安装到 OpenClaw
+openclaw plugins install --link .
+```
+
+或者直接通过 npm 安装：
+
+```bash
+openclaw plugins install @xwang152/claw-lark
+```
+
+验证安装：# 重启 Gateway 以加载插件
+openclaw gateway restart
+```
+
+验证安装：
+
+```bash
+openclaw plugins list
+```
+
+您应该能看到 `lark` 插件且状态为 `loaded`。
+
+## 飞书应用设置
+
+1. 前往 [飞书开放平台](https://open.feishu.cn/app) (国内) 或 [Lark Developer Console](https://open.larksuite.com/app) (国际)
+
+2. 创建新应用或使用现有应用
+
+3. 在“应用能力”中启用 **机器人** 能力
+
+4. 在“权限管理”中添加以下权限：
+
+| 权限 | 范围 | 说明 |
+| :--- | :--- | :--- |
+| `im:message` | 消息 | 发送和接收消息 |
+| `im:message.p2p_msg:readonly` | 私聊 | 读取发给机器人的私聊消息 |
+| `im:message.group_at_msg:readonly` | 群聊 | 接收群内 @机器人 的消息 |
+| `im:message:send_as_bot` | 发送 | 以机器人身份发送消息 |
+| `im:resource` | 媒体 | 上传和下载图片/文件 |
+
+**可选权限（根据需求添加）：**
+
+| 权限 | 范围 | 说明 |
+| :--- | :--- | :--- |
+| `im:message.group_msg` | 群聊 | 读取所有群消息（敏感权限，慎用） |
+| `im:message:readonly` | 读取 | 获取历史消息 |
+| `im:message:update` | 编辑 | 更新/编辑已发送消息 |
+| `im:message:recall` | 撤回 | 撤回已发送消息 |
+| `im:message.reactions:read` | 表情 | 查看消息表情回复 |
+
+5. 从“凭证与基础信息”中获取 **App ID** 和 **App Secret**（配置时需要用到）
+
+6. 在“版本管理与发布”中发布您的应用
+
+## 配置说明
+
+### 使用配置命令
+
+```bash
+# 必要设置
+openclaw config set channels.lark.accounts.default.appId 'cli_xxxxx'
+openclaw config set channels.lark.accounts.default.appSecret 'your-app-secret'
+openclaw config set channels.lark.accounts.default.connectionMode 'webhook'
+
+# 可选设置
+openclaw config set channels.lark.accounts.default.webhookPort 3000
+openclaw config set channels.lark.accounts.default.domain 'feishu' # 'feishu' (国内) 或 'lark' (国际)
+openclaw config set channels.lark.accounts.default.dmPolicy 'open'
+openclaw config set channels.lark.accounts.default.groupPolicy 'open'
+openclaw config set channels.lark.accounts.default.groupMentionGated false
+
+# 安全设置（从飞书开发者后台 > 事件订阅 > 加密策略获取）
+openclaw config set channels.lark.accounts.default.encryptKey 'your-encrypt-key'
+openclaw config set channels.lark.accounts.default.verificationToken 'your-verification-token'
+```
+
+### 使用环境变量
+
+对于默认账号，您可以使用环境变量：
+
+```bash
+LARK_APP_ID=cli_xxxxx
+LARK_APP_SECRET=your-app-secret
+
+# 安全设置（从飞书开发者后台 > 事件订阅 > 加密策略获取）
+LARK_ENCRYPT_KEY=your-encrypt-key          # 可选，用于解密事件数据
+LARK_VERIFICATION_TOKEN=your-token         # 可选，用于验证请求真实性
+```
+
+### 配置项详情
+
+| 选项 | 类型 | 默认值 | 描述 |
+|--------|------|---------|-------------|
+| `appId` | string | - | 飞书 App ID (必填) |
+| `appSecret` | string | - | 飞书 App Secret (必填) |
+| `connectionMode` | string | `websocket` | `webhook` 或 `websocket` |
+| `webhookPort` | number | `3000` | Webhook 服务器端口 |
+| `domain` | string | `feishu` | `feishu` (国内版) 或 `lark` (国际版) |
+| `encryptKey` | string | - | 加密密钥（从事件订阅 > 加密策略获取） |
+| `verificationToken` | string | - | 验证令牌（从事件订阅 > 加密策略获取） |
+| `dmPolicy` | string | `pairing` | 私聊策略：`open`, `pairing`, 或 `allowlist` |
+| `groupPolicy` | string | `open` | 群聊策略：`open`, `allowlist`, 或 `disabled` |
+| `groupMentionGated` | boolean | `true` | 是否要求在群聊中 @机器人 |
+
+## Webhook 模式设置
+
+根据您的部署环境，选择相应的配置方式。
+
+### 1. 开发环境（使用 ngrok）
+
+推荐在本地开发调试时使用。
+
+> **安全与隐私提示**：ngrok 会将您的本地服务器暴露到公网。请注意：
+> - 不要公开分享您的 ngrok URL
+> - 生产环境建议使用付费版 ngrok 或自建反向代理
+> - 不使用时请关闭 ngrok 隧道
+> - 建议配置飞书的 `encryptKey` 和 `verificationToken` 以增强安全性
+
+1. 启动 ngrok 暴露本地 Webhook 端口：
+
+```bash
+ngrok http 3000
+```
+
+2. 从 ngrok 复制 HTTPS URL（例如：`https://abc123.ngrok.io`）
+
+3. 在飞书开发者后台配置“事件订阅”：
+   - 添加事件：`im.message.receive_v1` (接收消息 v1.0)
+   - 将“请求地址”设置为您的 ngrok HTTPS URL（例如：`https://abc123.ngrok.io`）
+
+### 2. 生产环境（服务器部署）
+
+在服务器上部署时，**不需要**使用 ngrok。
+
+1. **开放端口**：确保您的服务器防火墙（安全组）已开放插件使用的端口（默认是 `3000`）。
+2. **配置地址**：在飞书开发者后台配置“事件订阅”：
+   - 将“请求地址”设置为您的服务器公网地址：`http://您的服务器IP:3000`。
+3. **（推荐）反向代理**：建议使用 Nginx 或 Caddy 配置反向代理和 SSL 证书（HTTPS），然后将流量转发到 `3000` 端口。
+
+### 3. 启动插件
+
+1. 启动 OpenClaw：
+
+```bash
+openclaw start
+```
+
+2. Webhook 服务器会自动启动并处理 URL 验证。
+
+## WebSocket 模式
+
+WebSocket 模式适用于支持长连接的企业级飞书账号（自建应用）。将 `connectionMode` 设置为 `websocket`：
+
+```bash
+openclaw config set channels.lark.accounts.default.connectionMode 'websocket'
+```
+
+**优势：**
+- **无需公网 IP**：不需要配置 ngrok 或反向代理，适合本地或内网环境。
+- **配置简单**：只需在飞书后台开启“使用长连接接收事件”开关即可。
+- **稳定性高**：插件支持自动重连。
+
+**配置步骤：**
+1. 在飞书开发者后台 -> **事件订阅**。
+2. 在“订阅方式”中选择 **使用长连接接收事件**。
+3. 确保已添加 `im.message.receive_v1` 事件。
+
+## 多账号配置
+
+您可以配置多个飞书账号：
+
+```bash
+openclaw config set channels.lark.accounts.work.appId 'cli_work_app'
+openclaw config set channels.lark.accounts.work.appSecret 'work-secret'
+openclaw config set channels.lark.accounts.personal.appId 'cli_personal_app'
+openclaw config set channels.lark.accounts.personal.appSecret 'personal-secret'
+```
+
+## 故障排除
+
+### 机器人收不到消息
+
+1. 检查是否订阅了 `im.message.receive_v1` 事件
+2. 检查回调 URL 是否配置正确且公网可访问
+3. 检查权限是否已开启
+4. 确保应用已发布（不仅是保存草稿）
+
+### 发送图片权限错误
+
+在飞书开发者后台添加 `im:resource` 权限并重新发布应用。
+
+### Webhook 服务器启动失败
+
+检查端口 3000 是否被占用。可以修改端口：
+
+```bash
+openclaw config set channels.lark.accounts.default.webhookPort 3001
+```
+
+### WebSocket 模式连接问题
+
+WebSocket 模式需要企业级飞书账号。如果是个人账号，请使用 Webhook 模式。
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！如果您发现 Bug 或有功能建议，请在 https://github.com/xwang152-jack/claw-lark/issues 提交。
+
+## 开源协议
+
+MIT

package/index.ts

@@ -0,0 +1,42 @@
+/**
+ * OpenClaw Lark Plugin
+ *
+ * Provides Lark/Feishu (Larksuite) messaging integration for OpenClaw.
+ * Supports WebSocket-based real-time messaging with direct
+ * messages and group chats.
+ */
+
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+
+import { larkPlugin } from "./src/channel.js";
+import { setLarkRuntime } from "./src/runtime.js";
+
+// Re-export for programmatic usage
+export { larkPlugin } from "./src/channel.js";
+export { createLarkClient, createLarkWSClient } from "./src/client.js";
+export { monitorLarkProvider, stopMonitor } from "./src/monitor.js";
+export { startWebhookServer } from "./src/webhook.js";
+export type {
+  LarkDomain,
+  LarkConnectionMode,
+  LarkAccountConfig,
+  ResolvedLarkAccount,
+  LarkChannelConfig,
+  LarkMessageEvent,
+  ParsedMessage,
+  SendResult,
+} from "./src/types.js";
+
+const plugin = {
+  id: "lark",
+  name: "Lark",
+  description: "Lark (Larksuite) channel plugin for OpenClaw",
+  configSchema: emptyPluginConfigSchema(),
+  register(api: OpenClawPluginApi) {
+    setLarkRuntime(api);
+    api.registerChannel({ plugin: larkPlugin });
+  },
+};
+
+export default plugin;

package/openclaw.plugin.json

@@ -0,0 +1,86 @@
+{
+  "id": "lark",
+  "channels": ["lark"],
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "accounts": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable this account"
+            },
+            "appId": {
+              "type": "string",
+              "description": "Lark App ID (cli_xxx)"
+            },
+            "appSecret": {
+              "type": "string",
+              "description": "Lark App Secret"
+            },
+            "encryptKey": {
+              "type": "string",
+              "description": "Encrypt key for event verification (optional)"
+            },
+            "domain": {
+              "type": "string",
+              "enum": ["lark", "feishu"],
+              "default": "feishu",
+              "description": "API domain: feishu (China) or lark (international)"
+            },
+            "connectionMode": {
+              "type": "string",
+              "enum": ["websocket", "webhook"],
+              "default": "websocket",
+              "description": "Connection mode: websocket (enterprise) or webhook (individual accounts)"
+            },
+            "verificationToken": {
+              "type": "string",
+              "description": "Verification token for webhook events (from Lark app settings)"
+            },
+            "webhookPort": {
+              "type": "number",
+              "default": 3000,
+              "description": "Port for webhook server (webhook mode only)"
+            },
+            "dmPolicy": {
+              "type": "string",
+              "enum": ["open", "pairing", "allowlist"],
+              "default": "pairing",
+              "description": "DM access policy"
+            },
+            "groupPolicy": {
+              "type": "string",
+              "enum": ["open", "allowlist", "disabled"],
+              "default": "open",
+              "description": "Group chat access policy"
+            },
+            "groupMentionGated": {
+              "type": "boolean",
+              "default": true,
+              "description": "Require @mention in group chats"
+            }
+          }
+        }
+      }
+    }
+  },
+  "uiHints": {
+    "appSecret": {
+      "label": "App Secret",
+      "sensitive": true
+    },
+    "encryptKey": {
+      "label": "Encrypt Key",
+      "sensitive": true
+    },
+    "verificationToken": {
+      "label": "Verification Token",
+      "sensitive": true
+    }
+  }
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@xwang152/claw-lark",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Lark/Feishu channel plugin for OpenClaw with WebSocket and Webhook support",
+  "license": "MIT",
+  "author": "jackwang",
+  "keywords": [
+    "openclaw",
+    "lark",
+    "feishu",
+    "plugin",
+    "bot"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xwang152-jack/claw-lark.git"
+  },
+  "bugs": {
+    "url": "https://github.com/xwang152-jack/claw-lark/issues"
+  },
+  "homepage": "https://github.com/xwang152-jack/claw-lark#readme",
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "@larksuiteoapi/node-sdk": "^1.37.0"
+  },
+  "peerDependencies": {
+    "openclaw": "^2026.1.29"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "openclaw": "^2026.1.29",
+    "typescript": "^5.0.0"
+  }
+}

package/src/openclaw-plugin-sdk.d.ts

@@ -0,0 +1,28 @@
+declare module "openclaw/plugin-sdk" {
+  export type MoltbotConfig = {
+    channels?: Record<string, unknown>;
+  };
+
+  export type OpenClawConfig = MoltbotConfig;
+
+  export type ChannelPlugin<TAccount> = Record<string, unknown>;
+
+  export type MoltbotPluginApi = {
+    logger: {
+      debug: (msg: string) => void;
+      info: (msg: string) => void;
+      warn: (msg: string) => void;
+      error: (msg: string) => void;
+    };
+    inbound: {
+      handleMessage: (args: Record<string, unknown>) => Promise<void>;
+    };
+    registerChannel: (args: { plugin: unknown }) => void;
+    runtime: any;
+    config: any;
+  };
+
+  export type OpenClawPluginApi = MoltbotPluginApi;
+
+  export function emptyPluginConfigSchema(): unknown;
+}