Skip to content
Back to search

lsbot

Lean & Secure Bot

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ruilisi--lsbot/badge.svg)](/listings/ruilisi--lsbot)

HTML

<a href="/listings/ruilisi--lsbot"><img src="/api/listings/ruilisi--lsbot/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 719 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. [English](./README_EN.md) | 中文
  2. <div align="center">
  3. <img src="https://files.lingti.com/images/lsbot-banner-dark.svg" alt="lsbot — Lean & Secure Bot" width="360" />
  4. </div>
  5. ---
  6. # lsbot — Lean & Secure Bot
  7. > **不需要信任的地方,就不应该建立信任依赖。**
  8. [![Go Version](https://img.shields.io/badge/Go-1.23+-00ADD8?style=flat&logo=go)](https://go.dev/)
  9. [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  10. [![Website](https://img.shields.io/badge/Website-lsbot.org-blue?style=flat)](https://lsbot.org)
  11. [![CN Mirror](https://img.shields.io/badge/国内镜像-lsbot.net-blue?style=flat)](https://lsbot.net)
  12. > 📖 **文档:[lsbot.org/docs](https://lsbot.org/docs)** | 国内镜像:[lsbot.net/docs](https://lsbot.net/docs)
  13. ---
  14. ## Bot Needs to be Secured
  15. 当你运行一个 AI Bot,你实际上把机器的钥匙交了出去:文件、终端、数据库、浏览器会话、凭证。Bot 读取你的代码、笔记、私人文档,并以你的名义执行命令。
  16. 问题不是 Bot 是否有用。**问题是:还有谁能看到它看到的东西?**
  17. 你每天操作电脑,层层加密加锁——密码管理器、磁盘加密、双重验证。但当你打开一个 AI Bot,这一切防线往往荡然无存。你的每一条消息、每一个工具调用结果,都在你不知情的情况下流经某台你不控制的服务器。
  18. 这不是理论风险。这是今天几乎所有 AI Bot 工具的默认配置。
  19. ---
  20. ## Why OpenClaw is Not Secured
  21. OpenClaw(以及大多数同类工具)以便利性和功能广度为设计目标,安全性是事后考虑,而非核心设计原则。
  22. | 问题 | 意味着什么 |
  23. |---|---|
  24. | 消息通过开发者的云服务路由 | 服务商可以读取每一条消息 |
  25. | 没有端到端加密 | 任何中继节点都可以审查内容 |
  26. | npm 依赖链 | 500+ 第三方包,任何一个都可能被攻击 |
  27. | Node.js 运行时 | 动态执行环境,攻击面庞大 |
  28. | 没有本地数据保证 | 对话历史、上下文、记忆——存储位置不明 |
  29. OpenClaw 在功能和集成方面做得出色。但它的架构假设你信任中继基础设施。对于个人电脑、企业环境,或任何数据敏感的场合,这个假设不成立。
  30. 当你把终端和文件的访问权限交给 AI Bot,传输层必须被当作敌对环境对待。OpenClaw 没有做到这一点。
  31. ---
  32. ## Why lsbot
  33. `lsbot` 是 **Lean Secure Bot** 的缩写。名字也呼应了 `ls`——Unix 最基础的命令,第一次拿到新机器时你敲的第一个命令。像 `ls` 一样,lsbot 是一个基础工具:精简、专注、永远可用。
  34. **lsbot 建立在一个核心原则上:你的数据属于你。**
  35. 这个原则决定了每一个架构选择:
  36. - **端到端加密,默认开启。** 所有 relay 流量使用 P-256 ECDH + AES-256-GCM 加密。中继服务器只看到密文,无法读取你的消息。
  37. - **单一静态二进制。** 没有运行时,没有包管理器,没有依赖链。攻击面就是这一个二进制文件——可审计、确定性、可复现。
  38. - **本地优先。** 对话历史、记忆、配置、凭证——全部存储在你的机器上。没有任何内容写入云端数据库。
  39. - **密钥验证带外进行。** 浏览器不会自动从服务器获取 Bot 的公钥。你从 `lsbot e2e pubkey` 手动粘贴,并核对指纹。中继服务器无法替换密钥。
  40. ---
  41. ## Lean Secure Bot
  42. ```bash
  43. lsbot relay --provider deepseek --api-key sk-xxx
  44. ```
  45. 一条命令启动安全 Bot:
  46. 1. 首次运行自动在 `~/.lsbot.pem` 生成持久化 P-256 密钥对
  47. 2. 通过 WebSocket 连接中继服务器
  48. 3. 仅发布**公钥**——私钥永远不离开你的机器
  49. 4. 每一条响应在离开你的进程前加密
  50. 5. 每一条消息到达你的进程后解密
  51. 中继服务器(lsbot.org,国内镜像 lsbot.net)只看到密文。它无法读取你的消息,无法记录你的对话,无法推断你在使用哪些工具或访问哪些文件。
  52. ```bash
  53. lsbot e2e pubkey
  54. # Key file: ~/.lsbot.pem
  55. # Public key: BK3x9f2...
  56. # Fingerprint: sha256:29f8954f
  57. ```
  58. 打开 Bot 页面,点击 **Secure**,粘贴公钥,核对指纹与命令行输出一致。此后每次访问自动激活加密。
  59. ---
  60. ## 我们不能相信任何聊天服务器
  61. **信任中继服务器是 AI Bot 安全的原罪。**
  62. 几乎所有主流 AI Bot 工具都依赖一个隐含假设:消息通过开发者的服务器路由是安全的。这个假设在以下任何场景中都会失效:
  63. - 服务商被攻击或遭受数据泄露
  64. - 政策变更导致日志保留或内容审查
  65. - 内部员工滥用访问权限
  66. - 法律程序要求披露用户数据
  67. - 服务商出售或被收购
  68. 你的 AI Bot 可以访问你的终端、你的文件、你的代码库。它知道你在做什么项目,知道你的工作流程,知道你的私人文档。**这些信息通过一个你不控制的服务器转发——这不是可接受的风险,这是一个架构缺陷。**
  69. lsbot 的设计前提是:中继服务器是不可信的。这不是对 lsbot.org 或 lsbot.net 的不信任,而是一个工程原则:**不需要信任的地方,就不应该建立信任依赖。**
  70. ---
  71. ## 数据库保存在本地
  72. lsbot 没有云端数据库。
  73. | 数据 | 存储位置 | 云端是否存在 |
  74. |---|---|:---:|
  75. | 对话历史 | 浏览器 IndexedDB(本地) | ❌ |
  76. | E2EE 私钥 | `~/.lsbot.pem` | ❌ |
  77. | 配置文件 | `~/.lsbot.yaml` | ❌ |
  78. | AI API 密钥 | `~/.lsbot.yaml` | ❌ |
  79. | Cron 任务数据库 | `~/.lingti.db` | ❌ |
  80. | 技能文件 | `~/.lingti/skills/` | ❌ |
  81. 云中继服务器(`lsbot.org`,国内镜像 `lsbot.net`)只做一件事:**路由加密后的消息**。它不保存任何内容,不分析任何内容,不记录任何内容。消息转发后立即丢弃。
  82. 即使中继服务器明天关闭,你所有的数据、配置、历史记录都完好无损在你的机器上。这不是承诺,这是架构决定的结果。
  83. ---
  84. ## 快速开始
  85. **两步启动,无需平台账号,无需公网服务器:**
  86. **第一步:安装**
  87. ```bash
  88. # macOS / Linux / WSL
  89. curl -fsSL https://files.lingti.com/install-lsbot.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 139 on GitHub
  90. # Windows (PowerShell)
  91. irm https://files.lingti.com/install-lsbot.ps1 | iex
  92. ```
  93. **第二步:运行**
  94. ```bash
  95. lsbot relay --provider deepseek --api-key sk-xxx
  96. ```
  97. 启动后自动输出你的专属 Bot 页面:
  98. ```
  99. Your bot page: https://lsbot.org/bots/xxx
  100. E2E fingerprint: sha256:a3f7c91b2d4e8f06
  101. ```
  102. > 国内用户:Bot 页面也可通过 `https://lsbot.net/bots/xxx` 访问。
  103. 打开链接,点击状态栏的 **Secure** → 粘贴公钥 → 核对指纹,即可在浏览器中与 Bot 进行端到端加密对话。
  104. > 支持的 `--provider`:`deepseek`、`claude`、`kimi`、`minimax`、`gemini`、`openai` 等,详见 [AI-PROVIDERS.md](AI-PROVIDERS.md)。
  105. #### 端到端加密(E2EE)
  106. Bot Page 默认启用**端到端加密**,relay 服务器(lsbot.org / lsbot.net)无法读取消息内容:
  107. - bot 首次启动时,在 `~/.lsbot.pem` 自动生成持久化 P-256 密钥,日志打印指纹
  108. - 浏览器打开 Bot Page,点击状态栏 **Secure** 进入设置面板
  109. - 从终端运行 `lsbot e2e pubkey`,将公钥粘贴到面板,核对指纹一致后点击 **Activate**
  110. - 状态栏出现**蓝色锁图标**,此后页面刷新自动恢复加密(密钥存储在浏览器本地)
  111. - 使用 `--plain` 可跳过 E2EE(不推荐)
  112. <div align="center">
  113. <img src="https://files.lingti.com/images/lsbot-pubkey.png" alt="只需粘贴公钥,即可与 Bot 进行端到端加密对话" width="600" />
  114. <p><em>只需提供公钥——私钥永远不离开你的机器,中继服务器只看到密文</em></p>
  115. </div>
  116. ```bash
  117. # 查看本机公钥和指纹
  118. lsbot e2e pubkey
  119. # 手动生成密钥对
  120. lsbot e2e keygen --save
  121. ```
  122. 详情:[端到端加密文档](https://lsbot.org/docs/e2e-encryption)
  123. ### 桌面客户端(MacOS/Windows)
  124. 桌面端不光拥有完整的安装、升级和使用 lsbot 的交互界面,还提供了 AI 网关、AI 加速等功能。
  125. 下载地址: [lsbot.org/download](https://lsbot.org/download)
  126. ### 移动端 App(Android / iOS)
  127. lsbot 官方 Android App 已发布,iOS 版本开发中。手机端支持端对端加密聊天,通过**扫描 QR Code** 一键配对 Bot,无需手动输入 Bot ID 或复制公钥。
  128. 下载:[lsbot.org/download](https://lsbot.org/download)
  129. Bot 启动后终端会自动打印配对 QR Code:
  130. ```
  131. [Relay] Scan with lsbot mobile to add this bot:
  132. ██████████████...
  133. ```
  134. 打开 App → 添加 Bot → 扫描,即可建立端对端加密连接。
  135. 详细文档:[移动端使用指南](https://lsbot.org/docs/mobile-app)
  136. ---
  137. ### 进阶:接入消息平台(企业微信、飞书等)
  138. 如需接入企业微信、飞书、钉钉等平台,追加对应平台参数即可:
  139. ```bash
  140. # 企业微信
  141. lsbot relay --platform wecom \
  142. --wecom-corp-id ww... --wecom-agent-id 1000002 \
  143. --wecom-secret xxx --wecom-token xxx --wecom-aes-key xxx \
  144. --provider deepseek --api-key sk-xxx
  145. # 飞书
  146. lsbot relay --platform feishu \
  147. --feishu-app-id cli_xxx --feishu-app-secret xxx \
  148. --provider claude --api-key sk-ant-xxx
  149. ```
  150. 详见 [云中继文档](https://lsbot.org/docs/cloud-relay)。
  151. ---
  152. ## 为什么选择 lsbot?
  153. ### lsbot vs OpenClaw
  154. | | **lsbot** | **OpenClaw** |
  155. |--|----------------|--------------|
  156. | **端到端加密** | ✅ 默认开启,P-256 ECDH + AES-256-GCM | ❌ 无 |
  157. | **服务器读取消息** | ❌ 不可能(只看密文) | ✅ 可以 |
  158. | **数据存储位置** | 本地 | 云端 |
  159. | **语言** | 纯 Go 实现 | Node.js |
  160. | **运行依赖** | 无(单一二进制) | 需要 Node.js 运行时 |
  161. | **依赖链风险** | 极低(Go 静态编译) | 高(500+ npm 包) |
  162. | **安装大小** | ~15MB 单文件 | 100MB+ (含 node_modules) |
  163. | **嵌入式设备** | ✅ ARM/MIPS | ❌ 需要 Node.js |
  164. | **中国平台** | 原生支持飞书/企微/钉钉 | 需自行集成 |
  165. | **云中继** | ✅ 免自建服务器 | ❌ 需自建 Web 服务 |
  166. > 详细功能对比:[OpenClaw vs lsbot 技术特性对比](https://lsbot.org/docs/openclaw-feature-comparison)
  167. ### 核心能力
  168. - 📱 **[移动端 App](https://lsbot.org/docs/mobile-app)** — Android 已发布,iOS 开发中;扫码配对,E2EE 加密聊天
  169. - 🔒 **端到端加密,默认开启** — P-256 ECDH + AES-256-GCM,中继服务器只路由密文
  170. - 🚀 **零依赖部署** — 单个 ~15MB 二进制文件,无需 Node.js/Python 运行时
  171. - ☁️ **[云中继](https://lsbot.org/docs/cloud-relay)加持** — 无需公网服务器、域名备案、HTTPS 证书,5 分钟接入企业微信/微信公众号
  172. - 🤖 **[浏览器自动化](https://lsbot.org/docs/browser-automation)** — 内置完整 CDP 控制引擎,无需 Puppeteer/Playwright/Node.js
  173. - 🌐 **[社交平台自动化](https://lsbot.org/docs/social-platform-automation)** — AI 代操作知乎、小红书等内容平台
  174. - 🛠️ **75+ MCP 工具** — 覆盖文件、Shell、系统、网络、日历、Git、GitHub 等全场景
  175. - 🌏 **中国平台原生支持** — 钉钉、飞书、企业微信、微信公众号开箱即用
  176. - 💬 **[内置 Web 聊天界面](#web-chat-ui)** — 无需任何客户端,浏览器直开,支持多会话并行
  177. - 🧠 **多 AI 后端** — 集成 Claude、DeepSeek、Kimi、MiniMax、Gemini 等 [16 种 AI 服务](AI-PROVIDERS.md)
  178. - 🔬 **Claude 深度思考** — 原生支持 Claude Extended Thinking API
  179. - 🩺 **健康诊断** — `lsbot doctor` 一键检查配置、连接、依赖
  180. ---
  181. ## 样例
  182. > 📺 **完整演示、截图和使用示例,请访问:[lsbot.net/docs/examples](https://lsbot.org/docs/examples)**
  183. 主要功能演示:
  184. - **[内置 Web 聊天界面](https://lsbot.org/docs/examples#web-chat-ui)** — 多会话并行,零配置,`--webapp-port 8080` 一键启用
  185. - **[定时任务](https://lsbot.org/docs/examples#cron-jobs)** — 用自然语言创建 Cron Job,AI 自动生成内容
  186. - **[企业微信文件助手](https://lsbot.org/docs/examples#wecom-file)** — 自然语言管理和传输文件
  187. - **[社交平台自动化](https://lsbot.org/docs/examples#social-automation)** — AI 代操作知乎、小红书等内容平台
  188. - **[浏览器自动化](https://lsbot.org/docs/examples#browser-automation)** — 自然语言驾驭 Chrome,无需 Puppeteer/Node.js
  189. ---
  190. ## Agents 与 Channels
  191. ### 什么是 Agent?
  192. **Agent** 是 lsbot 中的 AI 实例单元。每个 Agent 拥有独立的:
  193. - **AI 配置** — 可指定不同的 provider、model、API Key,或继承全局配置
  194. - **系统提示词(Instructions)** — 定义 Agent 的角色、风格、行为边界
  195. - **工作目录(Workspace)** — Agent 读写文件的默认根目录,天然沙箱隔离
  196. 典型用途:`work-assistant`(工作助手)、`coder`(专注代码)、`writer`(内容写作)……每个 Agent 可以有完全不同的人格和能力边界。
  197. ### 什么是 Channel?
  198. **Channel** 是消息的来源/目标通道,对应一个具体的聊天平台接入点(如某个企业微信应用、某个 Slack Bot、某个 Telegram Bot)。你可以为不同 Channel 绑定不同的 Agent,实现"同一个 lsbot 进程,多个平台、多套 AI 人格"的效果。
  199. ### 管理 Agents
  200. ```bash
  201. lsbot agents add # 交互式添加 Agent
  202. lsbot agents list # 列出所有 Agent
  203. lsbot agents info <name> # 查看某个 Agent 详情
  204. lsbot agents remove <name>
  205. ```
  206. ### 管理 Channels
  207. ```bash
  208. lsbot channels add # 交互式添加 Channel 凭证
  209. lsbot channels list # 列出所有已配置的 Channel
  210. lsbot channels remove <name>
  211. ```
  212. ### 添加 Channel 后如何启动?
  213. **`gateway` 模式**(适用于大多数平台:Telegram、Discord、Slack、钉钉、飞书等)
  214. ```bash
  215. lsbot gateway
  216. ```
  217. **`relay` 模式**(仅适用于需要云中继的平台:企业微信、微信公众号、飞书、Slack)
  218. ```bash
  219. lsbot relay --platform wecom # 企业微信
  220. lsbot relay --platform feishu # 飞书
  221. lsbot relay --platform wechat # 微信公众号
  222. ```
  223. > - `gateway` — 本地直连,支持所有平台,一条命令启动全部
  224. > - `relay` — 云中继,仅支持 wecom/feishu/wechat/slack,无需公网服务器
  225. ---
  226. ## 功能概览
  227. ### MCP Server — 标准协议,无缝集成
  228. lsbot 实现了完整的 [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) 协议,让任何支持 MCP 的 AI 客户端都能访问本地系统资源。
  229. | 客户端 | 状态 |
  230. |--------|------|
  231. | Claude Desktop | ✅ |
  232. | Cursor | ✅ |
  233. | Windsurf | ✅ |
  234. | 其他 MCP 客户端 | ✅ |
  235. ### 多平台消息网关 — 企业 IM 秒接入
  236. | 平台 | 协议 | 接入方式 | 文件发送 | 状态 |
  237. |------|------|----------|---------|------|
  238. | **企业微信** | 回调 API | 云中继 / 自建 | ✅ 全格式 | ✅ |
  239. | **微信公众号** | 云中继 | 10秒接入 | ✅ 图片/语音/视频 | ✅ |
  240. | **钉钉** | Stream Mode | 一键接入 | 🔜 计划中 | ✅ |
  241. | **飞书/Lark** | WebSocket | 一键接入 | 🔜 计划中 | ✅ |
  242. | **Slack** | Socket Mode | 一键接入 | 🔜 计划中 | ✅ |
  243. | **Telegram** | Bot API | 一键接入 | 🔜 计划中 | ✅ |
  244. | **Discord** | Gateway | 一键接入 | 🔜 计划中 | ✅ |
  245. | **WhatsApp** | Webhook + Graph API | 自建 | 🔜 计划中 | ✅ |
  246. | **LINE** | Webhook + Push API | 自建 | 🔜 计划中 | ✅ |
  247. | **Microsoft Teams** | Bot Framework | 自建 | 🔜 计划中 | ✅ |
  248. | **Matrix / Element** | HTTP Sync | 自建 | 🔜 计划中 | ✅ |
  249. | **Google Chat** | Webhook + REST | 自建 | 🔜 计划中 | ✅ |
  250. | **Mattermost** | WebSocket + REST | 自建 | 🔜 计划中 | ✅ |
  251. | **iMessage** | BlueBubbles | 自建 | 🔜 计划中 | ✅ |
  252. | **Signal** | signal-cli REST | 自建 | 🔜 计划中 | ✅ |
  253. | **Twitch** | IRC | 自建 | — | ✅ |
  254. | **NOSTR** | WebSocket Relays | 自建 | 🔜 计划中 | ✅ |
  255. | **Zalo** | Webhook + REST | 自建 | 🔜 计划中 | ✅ |
  256. | **Nextcloud Talk** | HTTP Polling | 自建 | 🔜 计划中 | ✅ |
  257. | **Web 聊天界面** | WebSocket | `--webapp-port` | — | ✅ |
  258. > 完整列表(含配置参数、环境变量):[聊天平台列表](https://lsbot.org/docs/chat-platforms)
  259. ### MCP 工具集 — 75+ 本地系统工具
  260. | 分类 | 工具数 | 功能 |
  261. |------|--------|------|
  262. | **文件操作** | 9 | 读写、搜索、整理、批量删除、废纸篓 |
  263. | **Shell 命令** | 2 | 命令执行、路径查找 |
  264. | **系统信息** | 4 | CPU、内存、磁盘、环境变量 |
  265. | **进程管理** | 3 | 列表、详情、终止 |
  266. | **网络工具** | 4 | 接口、连接、Ping、DNS |
  267. | **日历** | 6 | 查看、创建、搜索、删除日程 (macOS) |
  268. | **提醒事项** | 5 | 列表、添加、完成、删除 (macOS) |
  269. | **备忘录** | 6 | 文件夹、列表、读取、创建、搜索、删除 (macOS) |
  270. | **天气** | 2 | 当前天气、多日预报 |
  271. | **网页搜索** | 2 | DuckDuckGo 搜索、网页内容获取 |
  272. | **剪贴板** | 2 | 读写剪贴板 |
  273. | **截图** | 1 | 屏幕截图 |
  274. | **系统通知** | 1 | 发送桌面通知 |
  275. | **音乐控制** | 7 | 播放、暂停、切歌、音量、搜索 (macOS) |
  276. | **Git** | 4 | 状态、日志、差异、分支 |
  277. | **GitHub** | 6 | PR 列表/详情、Issue 管理、仓库信息 |
  278. | **[浏览器自动化](https://lsbot.org/docs/browser-automation)** | 14 | CDP 控制引擎,可接管已有 Chrome,快照定位、点击/输入/JS、多标签页、截图 |
  279. | **定时任务** | 5 | 创建、列表、删除、暂停、恢复计划任务 |
  280. ### 健康诊断
  281. ```bash
  282. lsbot doctor
  283. ```
  284. ```
  285. lsbot doctor
  286. =================
  287. OS: darwin/arm64, Go: go1.24.0
  288. Checks:
  289. ✓ Config file (~/.lsbot.yaml) — loaded
  290. ✓ AI API key — set (sk-ant-a..., provider: claude)
  291. ✓ AI provider connectivity — reachable (HTTP 200)
  292. ✓ Platform credentials — wecom, telegram
  293. ✓ Binary: gh — found
  294. ✗ Binary: chrome — not found in PATH
  295. 8 passed, 1 failed
  296. ```
  297. ### 按平台/频道模型切换
  298. ```yaml
  299. ai:
  300. provider: deepseek
  301. api_key: sk-xxx
  302. model: deepseek-chat
  303. overrides:
  304. - platform: telegram
  305. provider: claude
  306. api_key: sk-ant-xxx
  307. model: claude-sonnet-4-20250514
  308. - platform: slack
  309. channel_id: C12345
  310. provider: claude
  311. api_key: sk-ant-xxx
  312. ```
  313. ### Claude 深度思考 — 原生 Extended Thinking API
  314. | 命令 | 模式 | 思考 Token 预算 |
  315. |------|------|-----------------|
  316. | `/think off` | 关闭 | 0 |
  317. | `/think low` | 简单 | 1,024 |
  318. | `/think medium` | 中等(默认) | 4,096 |
  319. | `/think high` | 深度 | 16,384 |
  320. ### Skills — 模块化能力扩展
  321. ```bash
  322. lsbot skills # 列出所有 Skills
  323. lsbot skills check # 查看就绪状态
  324. lsbot skills info github
  325. ```
  326. 内置 8 个 Skills:Discord、GitHub、Slack、Peekaboo(macOS UI 自动化)、Tmux、天气、1Password、Obsidian。
  327. 详细文档:[Skills 指南](https://lsbot.org/docs/skills)
  328. ### 功能速览表
  329. | 模块 | 说明 | 特点 |
  330. |------|------|------|
  331. | **[移动端 App](https://lsbot.org/docs/mobile-app)** | Android 已发布,iOS 开发中 | QR Code 扫码配对,E2EE 加密,本地消息历史 |
  332. | **端到端加密** | P-256 ECDH + AES-256-GCM | 默认开启,中继服务器只路由密文 |
  333. | **MCP Server** | 标准 MCP 协议服务器 | 兼容 Claude Desktop、Cursor、Windsurf 等 |
  334. | **多平台消息网关** | [19 种聊天平台](https://lsbot.org/docs/chat-platforms) | 微信公众号、企业微信、Slack、飞书一键接入 |
  335. | **[Web 聊天界面](#web-chat-ui)** | 内置浏览器 UI | 多会话并行,独立记忆隔离,Markdown 渲染 |
  336. | **MCP 工具集** | 75+ 本地系统工具 | 文件、Shell、系统、网络、日历、Git、GitHub |
  337. | **Skills** | 模块化能力扩展 | 8 个内置 Skill,支持自定义和项目级扩展 |
  338. | **智能对话** | 多轮对话与记忆 | 上下文记忆、[16 种 AI 后端](AI-PROVIDERS.md) |
  339. | **深度思考** | Claude Extended Thinking | 原生 Thinking API,4 级思考深度 |
  340. | **健康诊断** | `doctor` 命令 | 一键检查配置、连接、依赖 |
  341. | **Docker 部署** | 容器化 | 多阶段构建,docker-compose 支持 |
  342. ---
  343. ## 云中继:零门槛接入企业消息平台
  344. > **告别公网服务器、告别复杂配置,让 AI Bot 接入像配置 Wi-Fi 一样简单**
  345. **工作原理:**
  346. ```
  347. 企业微信(用户消息) --> lsbot.org(云中继,只看密文) --WebSocket--> lsbot(本地AI处理)
  348. ```
  349. > 国内用户可使用镜像节点 `lsbot.net`,效果相同。
  350. | | 传统方案 | 云中继方案 |
  351. |---|---|---|
  352. | 公网服务器 | ✅ 需要 | ❌ 不需要 |
  353. | 域名/备案 | ✅ 需要 | ❌ 不需要 |
  354. | HTTPS证书 | ✅ 需要 | ❌ 不需要 |
  355. | 接入时间 | 数天 | **5分钟** |
  356. | AI处理位置 | 服务器 | **本地** |
  357. | 数据安全 | 云端存储 | **本地处理 + E2EE** |
  358. > 📖 [云中继技术方案详解](https://lsbot.org/docs/cloud-relay)
  359. ### 微信公众号
  360. 微信搜索公众号「**灵缇小秘**」,关注后发送任意消息获取接入教程。
  361. 详细教程:[微信公众号接入指南](https://lsbot.org/docs/wechat-integration)
  362. ### 企业微信
  363. ```bash
  364. lsbot relay --platform wecom \
  365. --wecom-corp-id YOUR_CORP_ID \
  366. --wecom-agent-id YOUR_AGENT_ID \
  367. --wecom-secret YOUR_SECRET \
  368. --wecom-token YOUR_TOKEN \
  369. --wecom-aes-key YOUR_AES_KEY \
  370. --provider deepseek \
  371. --api-key YOUR_API_KEY
  372. ```
  373. 详细教程:[企业微信集成指南](https://lsbot.org/docs/wecom-integration)
  374. ### 飞书
  375. 飞书原生支持 WebSocket 长连接,无需公网服务器:
  376. ```bash
  377. lsbot gateway \
  378. --feishu-app-id cli_your_app_id \
  379. --feishu-app-secret your_app_secret \
  380. --provider minimax \
  381. --api-key YOUR_API_KEY
  382. ```
  383. 详细教程:[飞书集成指南](https://lsbot.org/docs/feishu-integration)
  384. ### 钉钉
  385. ```bash
  386. lsbot gateway \
  387. --dingtalk-client-id YOUR_APP_KEY \
  388. --dingtalk-client-secret YOUR_APP_SECRET \
  389. --provider deepseek \
  390. --api-key YOUR_API_KEY
  391. ```
  392. ---
  393. ## Sponsors
  394. - **[灵缇游戏加速](https://game.lingti.com)** - PC/Mac/iOS/Android 全平台游戏加速、热点加速、AI 及学术资源定向加速
  395. - **[灵缇路由](https://router.lingti.com)** - 您的路由管家、网游电竞专家
  396. ---
  397. ## lingti-cli 生态
  398. **lsbot** 是 **lingti-cli** 五位一体平台的核心开源组件。
  399. | 模块 | 定位 | 说明 |
  400. |------|------|------|
  401. | **CLI** | 操控总台 | 统一入口,如同操作系统的引导程序 |
  402. | **Net** | 全球网络 | 跨洲 200Mbps 加速,畅享全球 AI 服务 |
  403. | **Token** | 数字员工 | Token 即代码,代码即生产力 |
  404. | **Bot** | 助理管理 | 数字员工接入与管理,简单到极致 ← *本项目* |
  405. | **Code** | 开发环境 | Terminal 回归舞台中央,极致输入效率 |
  406. **联系我们 / 加入我们**
  407. <table>
  408. <tr>
  409. <th align="center" width="56%">邮件联系</th>
  410. <th align="center" width="44%">扫码加群</th>
  411. </tr>
  412. <tr>
  413. <td width="56%">
  414. 无论您是追求极致效率的顶尖开发者、关注 AI 时代生产力变革的投资人,还是想成为 Sponsor,
  415. 欢迎联系:
  416. <code>jiefeng@ruc.edu.cn</code>
  417. /
  418. <code>jiefeng.hopkins@gmail.com</code>
  419. </td>
  420. <td width="44%" align="center">
  421. <img src="https://lingti-1302055788.cos.ap-guangzhou.myqcloud.com/contact_me_qr-2.png" alt="扫码加群" width="230" />
  422. </td>
  423. </tr>
  424. </table>
  425. ---
  426. ```
  427. lsbot
  428. +---------------+ +---------------+ +---------------+
  429. | MCP Server | | Message | | Agent |
  430. | (stdio) | | Gateway | | (Claude) |
  431. +-------+-------+ +-------+-------+ +-------+-------+
  432. | | |
  433. +--------------------+--------------------+
  434. |
  435. v
  436. +-------------------+
  437. | MCP Tools |
  438. | Files, Shell, Net |
  439. | System, Calendar |
  440. | Browser Automation|
  441. +-------------------+
  442. |
  443. +--------------------+--------------------+
  444. | |
  445. v v
  446. +---------------+ +------------------+
  447. | Claude Desktop| | Slack / Feishu |
  448. | Cursor, etc. | | Messaging Apps |
  449. +---------------+ +------------------+
  450. ```
  451. ---
  452. ## MCP Server 快速配置
  453. **Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
  454. ```json
  455. {
  456. "mcpServers": {
  457. "lsbot": {
  458. "command": "/path/to/lsbot",
  459. "args": ["serve"]
  460. }
  461. }
  462. }
  463. ```
  464. **Cursor** (`.cursor/mcp.json`):
  465. ```json
  466. {
  467. "mcpServers": {
  468. "lsbot": {
  469. "command": "/path/to/lsbot",
  470. "args": ["serve"]
  471. }
  472. }
  473. }
  474. ```
  475. ---
  476. ## 其他安装方式
  477. **从源码编译**
  478. ```bash
  479. git clone https://github.com/ruilisi/lsbot.git
  480. cd lsbot
  481. make build # 或: make darwin-arm64 / make linux-amd64
  482. ```
  483. **手动下载**
  484. - **命令行版本**:前往 [GitHub Releases](https://github.com/ruilisi/lsbot/releases) 下载
  485. - **桌面客户端**(Windows x64 / macOS Apple Silicon / macOS Intel):前往 [lsbot.org/download](https://lsbot.org/download) 下载
  486. **支持的目标平台:**
  487. | 平台 | 架构 | 编译命令 |
  488. |------|------|----------|
  489. | macOS | ARM64 (Apple Silicon) | `make darwin-arm64` |
  490. | macOS | AMD64 (Intel) | `make darwin-amd64` |
  491. | Linux | AMD64 | `make linux-amd64` |
  492. | Linux | ARM64 | `make linux-arm64` |
  493. | Linux | ARMv7 (树莓派等) | `make linux-arm` |
  494. | Windows | AMD64 | `make windows-amd64` |
  495. ---
  496. ## 配置优先级
  497. 所有配置项按以下优先级解析:**命令行参数 > 环境变量 > 配置文件 (`~/.lsbot.yaml`)**
  498. 完整的环境变量、命令行参数、配置文件对照表:[配置优先级](CONFIGURATION.md)
  499. ---
  500. ## 详细文档
  501. - [配置优先级](CONFIGURATION.md)
  502. - [AI 服务列表](AI-PROVIDERS.md) — 16 种 AI 服务详情、API Key 获取、别名
  503. - [端到端加密](https://lsbot.org/docs/e2e-encryption) — E2EE 架构、密钥管理、指纹验证
  504. - [聊天平台列表](https://lsbot.org/docs/chat-platforms) — 19 种聊天平台详情
  505. - [命令行参考](https://lsbot.org/docs/cli-reference) — 完整的命令行使用文档
  506. - [Skills 指南](https://lsbot.org/docs/skills)
  507. - [浏览器自动化指南](https://lsbot.org/docs/browser-automation) — CDP 引擎完整参考
  508. - [社交平台自动化指南](https://lsbot.org/docs/social-platform-automation)
  509. - [定时任务指南](https://lsbot.org/docs/cron-jobs)
  510. - [云中继技术方案详解](https://lsbot.org/docs/cloud-relay)
  511. - [OpenClaw 技术特性对比](https://lsbot.org/docs/openclaw-feature-comparison)
  512. ---
  513. ## 依赖
  514. - [mcp-go](https://github.com/mark3labs/mcp-go) - MCP 协议 Go 实现
  515. - [cobra](https://github.com/spf13/cobra) - CLI 框架
  516. - [gopsutil](https://github.com/shirou/gopsutil) - 系统信息
  517. - [slack-go](https://github.com/slack-go/slack) - Slack SDK
  518. - [oapi-sdk-go](https://github.com/larksuite/oapi-sdk-go) - 飞书/Lark SDK
  519. - [go-anthropic](https://github.com/liushuangls/go-anthropic) - Anthropic API 客户端
  520. ---
  521. ## 许可证
  522. MIT License
  523. ---
  524. **lsbot** — Lean & Secure Bot · [lsbot.org](https://lsbot.org) · [lsbot.net(国内)](https://lsbot.net) · [GitHub](https://github.com/ruilisi/lsbot)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.