使用方法

作为 OpenClaw 中的技能

该技能将自动使用 OpenClaw 的飞书配置：

// 示例：用户要求“send me a screenshot”
// 该技能将自动：
// 1. 从 OpenClaw 配置中读取飞书凭证
// 2. 将截图上传到飞书
// 3. 发送给用户

作为 CLI 工具

向飞书用户发送图片：

node feishu-image.js --image /path/to/screenshot.png --to ou_xxxxxxxx

附带可选消息：

node feishu-image.js --image chart.png --to ou_xxxxxxxx --text "Q4 Sales Report"

发送到聊天群组：

node feishu-image.js --image announcement.png --to oc_xxxxxxxx --chat

作为 Node.js 库

const { FeishuImage } = require('./scripts/feishu-image.js');

const sender = new FeishuImage({
  appId: 'cli_xxxxxxxxxxxxxxxx',
  appSecret: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
});

// 向用户发送图片
await sender.sendImage({
  imagePath: '/path/to/screenshot.png',
  receiveId: 'ou_xxxxxxxx',
  receiveType: 'user'
});

// 发送带文本的图片
await sender.sendImage({
  imagePath: '/path/to/chart.png',
  receiveId: 'ou_xxxxxxxx',
  receiveType: 'user',
  text: 'Here is the sales report'
});

CLI 参考

选项

示例

# 基本用法
node feishu-image.js -i screenshot.png -t ou_123456

# 附带消息
node feishu-image.js --image chart.png --to ou_123456 --text "Q4 Report"

# 发送到群聊
node feishu-image.js -i announcement.png -t oc_789012 --chat

库 API 参考

new FeishuImage(config)

创建一个新的飞书图片发送器实例。

参数：

• config.appId (string): 飞书应用 ID
• config.appSecret (string): 飞书应用密钥
• config.baseUrl (string, optional): API 基础 URL，默认为 'https://open.feishu.cn/open-apis'

示例：

const sender = new FeishuImage({
  appId: process.env.FEISHU_APP_ID,
  appSecret: process.env.FEISHU_APP_SECRET
});

async sendImage(options)

上传图片并将其发送到飞书会话。

参数：

• options.imagePath (string, required): 本地图片文件路径
• options.receiveId (string, required): 接收者的 open_id（用户）或 chat_id（群组）
• options.receiveType (string, optional): 'user' 或 'chat'，默认为 'user'
• options.text (string, optional): 与图片一起发送的可选文本消息

返回： Promise - 已发送消息的 ID

抛出：

• FeishuImageError - 各种错误代码：MISSING_CREDENTIALS, AUTH_FAILED, FILE_NOT_FOUND, UPLOAD_FAILED, SEND_FAILED

示例：

try {
  const messageId = await sender.sendImage({
    imagePath: '/path/to/screenshot.png',
    receiveId: 'ou_xxxxxxxx',
    receiveType: 'user',
    text: 'Here is the screenshot you requested'
  });
  console.log('Image sent successfully, message ID:', messageId);
} catch (error) {
  console.error('Failed to send image:', error.message);
}

错误处理

所有错误都是 FeishuImageError 的实例，具有特定的错误代码：

错误处理示例：

const { FeishuImage, FeishuImageError } = require('./scripts/feishu-image.js');

try {
  await sender.sendImage({ ... });
} catch (error) {
  if (error instanceof FeishuImageError) {
    switch (error.code) {
      case 'MISSING_CREDENTIALS':
        console.error('Please set FEISHU_APP_ID and FEISHU_APP_SECRET');
        break;
      case 'AUTH_FAILED':
        console.error('Invalid credentials. Check your app ID and secret.');
        break;
      case 'FILE_NOT_FOUND':
        console.error(`Image file not found: ${error.details.path}`);
        break;
      default:
        console.error(`Error: ${error.message}`);
    }
  } else {
    console.error('Unexpected error:', error);
  }
}

限制

• 图片大小：受飞书 API 限制（请查阅飞书文档了解当前限制）
• 支持的格式：PNG、JPG、GIF（以飞书支持的格式为准）
• 速率限制：受飞书 API 速率限制

另请参阅

• 飞书开放平台文档
• 飞书图片上传 API
• 飞书消息发送 API
• Peekaboo - 截图工具（如适用）

每周安装数

167

代码仓库

zrong/skills

GitHub 星标数

2

首次出现

2026年3月7日

安全审计

Gen Agent Trust HubPassSocketPassSnykPass

安装于

kimi-cli166

gemini-cli166

amp166

cline166

github-copilot166

codex166