{"versions":{"0.3.0":{"name":"feishu-openclaw","version":"0.3.0","type":"module","description":"飞书机器人插件 - 让 AI 助手接入飞书，无需服务器 | Feishu/Lark channel plugin for Clawdbot / OpenClaw","author":{"name":"Alex Yang","email":"anyangsen@hotmail.com"},"license":"MIT","homepage":"https://github.com/AlexAnys/openclaw-feishu","repository":{"type":"git","url":"git+https://github.com/AlexAnys/openclaw-feishu.git"},"bugs":{"url":"https://github.com/AlexAnys/openclaw-feishu/issues"},"keywords":["clawdbot","openclaw","feishu","lark","飞书","飞书机器人","chatbot","ai-agent","ai助手","messaging","channel-plugin","websocket","企业微信替代"],"main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"clawdbot":{"extensions":["./dist/index.js"],"channel":{"id":"feishu","label":"Feishu","selectionLabel":"Feishu (飞书)","docsPath":"/channels/feishu","docsLabel":"feishu","blurb":"Feishu (Lark) messaging platform with Bot WebSocket API.","aliases":["lark","fs"],"order":85,"quickstartAllowFrom":true},"install":{"npmSpec":"feishu-openclaw","defaultChoice":"npm"}},"openclaw":{"extensions":["./dist/index.js"],"channel":{"id":"feishu","label":"Feishu","selectionLabel":"Feishu (飞书)","docsPath":"/channels/feishu","docsLabel":"feishu","blurb":"Feishu (Lark) messaging platform with Bot WebSocket API.","aliases":["lark","fs"],"order":85,"quickstartAllowFrom":true},"install":{"npmSpec":"feishu-openclaw","defaultChoice":"npm"}},"scripts":{"build":"tsc","clean":"rm -rf dist","prepublishOnly":"npm run clean && npm run build","typecheck":"tsc --noEmit"},"peerDependencies":{"clawdbot":">=2026.1.20","openclaw":">=2026.1.29"},"peerDependenciesMeta":{"clawdbot":{"optional":true},"openclaw":{"optional":true}},"dependencies":{"@larksuiteoapi/node-sdk":"^1.56.1"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"engines":{"node":">=20.0.0"},"gitHead":"ee5a0e0ab6130be435e72bc0d3a8be2b8a47111d","_id":"feishu-openclaw@0.3.0","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-S8oDlbr+XYaKRMYlg+fJ4yIJJjc6omMIOxANHDacQftKYiVnuBZ+74gUnFS7y7rI+jQBgoBo+2nJRmWaidAUPg==","shasum":"69d19ec7bd15e60cff885cb3acdb6e62504d8d0a","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/feishu-openclaw/-/feishu-openclaw-0.3.0.tgz","fileCount":61,"unpackedSize":131114,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAXcgPmtFE6d2z3r2bbRvzdcjUyxVzNFBEH6RvTvXFr6AiAlLu7dMuXmxmdZ7jHr4tGAhXOtAhWacqyTSMgWldNpdg=="}],"size":31915},"_npmUser":{"name":"anonymous","email":"anyangsen@hotmail.com"},"directories":{},"maintainers":[{"name":"anonymous","email":"anyangsen@hotmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/feishu-openclaw_0.3.0_1769874565512_0.16898633052610457"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2026-01-31T15:49:25.676Z","publish_time":1769874565676,"_source_registry_name":"default","contributors":[]},"0.3.1":{"name":"feishu-openclaw","version":"0.3.1","type":"module","description":"飞书机器人插件 - 让 AI 助手接入飞书，无需服务器 | Feishu/Lark channel plugin for Clawdbot / OpenClaw","author":{"name":"Alex Yang","email":"anyangsen@hotmail.com"},"license":"MIT","homepage":"https://github.com/AlexAnys/openclaw-feishu","repository":{"type":"git","url":"git+https://github.com/AlexAnys/openclaw-feishu.git"},"bugs":{"url":"https://github.com/AlexAnys/openclaw-feishu/issues"},"keywords":["clawdbot","openclaw","feishu","lark","飞书","飞书机器人","chatbot","ai-agent","ai助手","messaging","channel-plugin","websocket","企业微信替代"],"main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"},"./openclaw":{"import":"./dist/index.openclaw.js","types":"./dist/index.openclaw.d.ts"},"./clawdbot":{"import":"./dist/index.clawdbot.js","types":"./dist/index.clawdbot.d.ts"}},"clawdbot":{"extensions":["./dist/index.clawdbot.js"],"channel":{"id":"feishu","label":"Feishu","selectionLabel":"Feishu (飞书)","docsPath":"/channels/feishu","docsLabel":"feishu","blurb":"Feishu (Lark) messaging platform with Bot WebSocket API.","aliases":["lark","fs"],"order":85,"quickstartAllowFrom":true},"install":{"npmSpec":"feishu-openclaw","defaultChoice":"npm"}},"openclaw":{"extensions":["./dist/index.openclaw.js"],"channel":{"id":"feishu","label":"Feishu","selectionLabel":"Feishu (飞书)","docsPath":"/channels/feishu","docsLabel":"feishu","blurb":"Feishu (Lark) messaging platform with Bot WebSocket API.","aliases":["lark","fs"],"order":85,"quickstartAllowFrom":true},"install":{"npmSpec":"feishu-openclaw","defaultChoice":"npm"}},"scripts":{"build":"node scripts/build.js all","build:openclaw":"node scripts/build.js openclaw","build:clawdbot":"node scripts/build.js clawdbot","clean":"rm -rf dist src/sdk.ts","prepublishOnly":"npm run clean && npm run build","version":"node scripts/sync-version.js && git add *.plugin.json","typecheck":"tsc --noEmit"},"peerDependencies":{"clawdbot":">=2026.1.20","openclaw":">=2026.1.29"},"peerDependenciesMeta":{"clawdbot":{"optional":true},"openclaw":{"optional":true}},"dependencies":{"@larksuiteoapi/node-sdk":"^1.56.1"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"engines":{"node":">=20.0.0"},"gitHead":"b432ce721f5dfd4f42e0e1b0cc4ccab73a5f3592","_id":"feishu-openclaw@0.3.1","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-J9cAVrTQYYv6Jky1NpEx8bDEnjKyMalBaZM/d2/Y1CJLz1yGSPBmf7/Yx7Stz7FZIZOH9Amp+UvfWot8D/arSQ==","shasum":"f8024f22061dff84d703fd7cbd1c58ba944f2385","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/feishu-openclaw/-/feishu-openclaw-0.3.1.tgz","fileCount":71,"unpackedSize":138846,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGyyu9oA0i90FleeYaaM9dcueX/QWBP1r/XKLwF3cBhNAiBN4I/Uvfdj/zQIk993XdP2GhRYBc1YQvbSIiywMf6dEg=="}],"size":32912},"_npmUser":{"name":"anonymous","email":"anyangsen@hotmail.com"},"directories":{},"maintainers":[{"name":"anonymous","email":"anyangsen@hotmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/feishu-openclaw_0.3.1_1769926698253_0.7842475867825687"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2026-02-01T06:18:18.394Z","publish_time":1769926698394,"_source_registry_name":"default","contributors":[]}},"dist-tags":{"latest":"0.3.1"},"name":"feishu-openclaw","time":{"created":"2026-01-31T15:49:44.633Z","modified":"2026-02-01T06:18:27.763Z","0.3.0":"2026-01-31T15:49:25.676Z","0.3.1":"2026-02-01T06:18:18.394Z"},"readme":"# feishu-openclaw\n\n[![npm version](https://img.shields.io/npm/v/feishu-openclaw.svg)](https://www.npmjs.com/package/feishu-openclaw)\n\n> **v0.2.0** — 支持 OpenClaw 和 Clawdbot 双环境\n\n飞书 × AI 助手插件 — 无需服务器，WebSocket 长连接  \nFeishu × AI Assistant plugin — no server required, WebSocket long-connection\n\n---\n\n## ⚠️ 安装前必做（约 5 分钟）\n\n### 1. 创建飞书机器人\n\n1. [飞书开放平台](https://open.feishu.cn/app) → **创建企业自建应用**\n2. 添加「**机器人**」能力\n3. **权限配置** → 开启：\n   - `im:message`\n   - `im:message.group_at_msg`  \n   - `im:message.p2p_msg`\n4. **版本管理** → 创建版本 → 发布上线\n5. 记下 **App ID** (`cli_xxx`) 和 **App Secret**\n\n### 2. ⚠️ 事件订阅：必须先配好 App ID/Secret\n\n飞书要求先验证 App ID/Secret 才能配置「长连接」，所以顺序是：\n\n```\n先安装插件 → 配置 App ID/Secret → 重启 Gateway → 再去飞书开放平台配置长连接\n```\n\n---\n\n## 📦 安装\n\n### OpenClaw\n\n```bash\nopenclaw plugins install feishu-openclaw\n```\n\n### Clawdbot\n\n```bash\nclawdbot plugins install feishu-openclaw\n```\n\n---\n\n## 🔧 配置\n\n### 1. 配置 App ID 和 App Secret\n\n**OpenClaw:**\n```bash\nopenclaw config set channels.feishu.enabled true --json\nopenclaw config set channels.feishu.appId \"cli_你的AppID\"\nopenclaw config set channels.feishu.appSecret \"你的AppSecret\"\nopenclaw gateway restart\n```\n\n**Clawdbot:**\n```bash\nclawdbot config set channels.feishu.enabled true --json\nclawdbot config set channels.feishu.appId \"cli_你的AppID\"\nclawdbot config set channels.feishu.appSecret \"你的AppSecret\"\nclawdbot gateway restart\n```\n\n### 2. 配置飞书事件订阅\n\nGateway 重启后，再去飞书开放平台：\n\n1. **事件与回调** → 添加 `im.message.receive_v1`\n2. **订阅方式** → 选择 **「使用长连接接收事件」** ⚠️ 不是 Webhook！\n3. 保存\n\n### 3. 验证\n\n```bash\nopenclaw status  # 或 clawdbot status\n```\n\n应该看到：\n```\n│ Feishu   │ ON      │ OK     │ configured                    │\n```\n\n---\n\n## ❗ 常见问题\n\n### 收不到消息？\n\n| 检查项 | 说明 |\n|--------|------|\n| 应用已发布 | 不能是草稿状态 |\n| 用「长连接」 | **不是 Webhook** |\n| 权限已开启 | 三个 im 权限都要开 |\n\n### 报错 `unknown channel id: feishu`？\n\n这是 doctor 检查的 warning，**不影响实际运行**。只要 `openclaw status` 显示 `Feishu: ON | OK` 就是正常的。\n\n### 群聊不回复？\n\n@机器人，或消息末尾加问号。\n\n---\n\n## 特点\n\n- ✅ **无需服务器** — WebSocket 长连接，穿透 NAT\n- ✅ **双环境支持** — OpenClaw 和 Clawdbot\n- ✅ **私聊 + 群聊** — 支持 @mention\n- ✅ **图片文件收发**\n- ✅ **多账号支持**\n\n---\n\n## 链接\n\n- 📦 [npm: feishu-openclaw](https://www.npmjs.com/package/feishu-openclaw)\n- 🔌 [GitHub: openclaw-feishu](https://github.com/AlexAnys/openclaw-feishu)\n- 📖 [OpenClaw 文档](https://docs.openclaw.ai)\n- 📖 [Clawdbot 文档](https://docs.clawd.bot)\n\n---\n\n## License\n\nMIT","users":{}}