# Microi.OpenClaw **Repository Path**: mao_js/microi.openclaw ## Basic Information - **Project Name**: Microi.OpenClaw - **Description**: 🦞OpenClaw 吾码小龙虾,国内网络直连 · 无需额外网络工具 · 一键部署全套 AI 环境 · 秒级接入主流大模型。OpenClaw一站式本地桌面管理平台,基于 Electron + Vue 3 构建,支持 Windows / macOS / Linux 全平台。无论你是技术小白还是资深开发者,打开即用,零门槛搭建属于自己的私有 AI 智能助手,5 分钟内让 AI 为你工作。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: https://microi.net - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 26 - **Created**: 2026-03-19 - **Last Updated**: 2026-03-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 🦞 Microi.OpenClaw 吾码小龙虾 > **让每一个人都能轻松拥有自己的 AI 智能助手** > > 国内网络直连 · 无需额外网络工具 · 一键部署全套 AI 环境 · 秒级接入主流大模型

--- ## 📖 简介 **Microi.OpenClaw 吾码小龙虾** 是 [OpenClaw](https://github.com/openclaw/openclaw) 的 **一站式本地桌面管理平台**,基于 Electron + Vue 3 构建,支持 Windows / macOS / Linux 全平台。 无论你是技术小白还是资深开发者,打开即用 —— 零门槛搭建属于自己的私有 AI 智能助手,全程 **国内网络直连**,内置加速镜像,无需任何额外网络工具,一键完成 Node.js + OpenClaw + Git 全套环境安装,5 分钟内让 AI 为你工作。 >* Gitee开源地址:[https://gitee.com/microi-net/microi.openclaw](https://gitee.com/microi-net/microi.openclaw) ### 为什么选择吾码小龙虾? | 痛点 | 吾码小龙虾怎么解决 | |---|---| | 😖 环境配置太复杂,不知道装什么 | **一键安装**全套依赖,无需手动配置任何环境变量 | | 🌐 国内访问 npm / GitHub 速度慢 | 内置**国内加速镜像**,所有资源均可直连下载 | | 🤖 大模型 API 不知道怎么接 | 内置主流模型**一键模板**,填入 API Key 即可使用 | | 🔒 担心数据安全,不想用云端服务 | **完全本地运行**,对话数据不经过任何第三方服务器 | | 🛠️ 想扩展 AI 能力但不会开发 | 可视化**插件市场**,微信机器人/语音通话等一键安装 | ### 核心功能
功能说明
🚀 一键部署全自动下载安装 Node.js 22 便携版 + OpenClaw CLI + MinGit,全程国内加速镜像,3 分钟完成全套部署
💬 AI 对话内置高颜值聊天界面,支持流式输出(SSE),对话数据完全本地存储
🤖 多模型接入内置 DeepSeek-V3、通义千问、MiniMax、Ollama 本地模型、GPT-4o、Claude 等一键模板,填入 API Key 即用;也支持手动填写 Base URL + Key 接入任意 OpenAI 兼容推理服务
▶️ 服务管理可视化启停 OpenClaw 网关,实时日志 · 就绪检测 · CPU/内存/网络全维度监控
⚙️ AI 模型配置表单模式 + JSON 源码双模式 + 模型模板快选,改完即生效
🧩 插件管理可视化插件市场,一键安装微信机器人、语音通话、Teams、Matrix 等插件,支持 npm + CDN 双源
📢 消息平台飞书机器人集成,支持 WebSocket 长连接 / 轮询两种模式,自动接收消息并交由 AI 回复
⏰ 定时任务多步骤自动化:AI 写文 → 浏览器发文 → 消息推送,像搭积木一样组合(AI 内容生成、浏览器自动化、HTTP 请求、消息推送、延时等待),内置 6 套模板
🧠 技能管理管理 AI 内置技能(命令执行、浏览器、上下文压缩)及可安装技能(联网搜索、记忆、SEO),支持手动安装自定义技能包
🌍 浏览器自动化为 AI 赋予「眼睛和手」,headless/headed 模式,CSDN 发文、签到等任务
🔗 远程连接接入 Microi 吾码低代码平台,实现云端统一管理多节点
> 💡 **完全独立运行**:无需任何云端服务,开箱即用;也可搭配 **Microi 吾码低代码平台** 实现企业级多节点集中管控。 --- ## 📸 界面预览 --- ## 🏗️ 架构 ``` microi.openclaw/ ├── electron/ # Electron 主进程 │ └── main.js # 桌面应用入口 ├── src/ # 前端 (Vue 3 + Element Plus) │ ├── main.js │ ├── App.vue # 根组件 (暗色主题) │ ├── router/index.js │ └── views/ │ ├── Layout.vue # 侧边栏布局 │ ├── Chat.vue # 💬 AI 对话 │ ├── Home.vue # 主页 │ ├── Environment.vue # 环境管理 │ ├── Service.vue # 服务管理 (资源监控) │ ├── Config.vue # AI 模型配置 │ ├── Plugins.vue # 🧩 插件管理 │ ├── Tasks.vue # ⏰ 定时任务 │ ├── Skills.vue # 🧠 技能管理 │ ├── Channels.vue # 📢 消息平台 │ ├── Logs.vue # 实时日志 │ └── Remote.vue # 远程连接 │ ├── server/ # 后端 (Express + WebSocket) │ ├── index.js # 服务入口 │ ├── utils.js # 工具函数 │ ├── app-config.js # 应用持久化配置 │ ├── scheduler/ # ⏰ 定时任务引擎 │ │ ├── engine.js # Cron 调度 + 变量传递 │ │ └── executors.js # 步骤执行器 │ ├── services/ # 📢 外部服务集成 │ │ ├── feishu-poll.js # 飞书轮询服务 │ │ └── feishu-ws.js # 飞书 WebSocket 长连接 │ └── routes/ │ ├── chat.js # AI 对话代理 │ ├── env.js # 环境检测与安装 │ ├── service.js # Gateway 启停 │ ├── config.js # 配置读写 │ ├── plugins.js # 插件管理 │ ├── tasks.js # 定时任务 CRUD │ ├── skills.js # 技能管理 │ ├── channels.js # 消息平台 (飞书) │ ├── logs.js # 日志读取 │ ├── status.js # 系统状态 │ └── remote.js # 远程连接 │ ├── dist/ # 前端构建产物 └── release/ # 安装包输出目录 └── Microi.OpenClaw Setup 1.0.0.exe ``` --- ## 🚀 快速开始 ### 普通用户(推荐,3 分钟上手) 无需任何编程知识,下载安装包双击安装即可 —— **全程国内加速下载,无需额外网络工具**: | 平台 | 下载 | |---|---| | Windows | [Microi.OpenClaw Setup.exe](https://gitee.com/microi-net/microi.openclaw/releases) | | macOS (Intel) | [Microi.OpenClaw.dmg (x64)](https://gitee.com/microi-net/microi.openclaw/releases) | | macOS (Apple Silicon) | [Microi.OpenClaw-arm64.dmg](https://gitee.com/microi-net/microi.openclaw/releases) | | Linux (AppImage) | [Microi.OpenClaw.AppImage](https://gitee.com/microi-net/microi.openclaw/releases) | | Linux (deb) | [microi-openclaw.deb](https://gitee.com/microi-net/microi.openclaw/releases) | ### 开发者 ```bash git clone https://gitee.com/microi-net/microi.openclaw.git cd microi.openclaw npm install npm run dev ``` ## 🔧 开发命令 ```bash # 同时启动前端 + 后端(Web 开发模式) npm run dev # Electron 开发模式(桌面窗口) npm run dev:electron # 仅启动后端 npm run dev:server # 仅启动前端 npm run dev:client # 构建前端 npm run build:web # 构建 Windows 安装包 npm run build:win # 构建 macOS 安装包(Intel + Apple Silicon) npm run build:mac # 构建 Linux 安装包 npm run build:linux ``` --- ### 首次使用(5 步完成部署) 1. 打开 **吾码小龙虾**,进入 **环境管理** 页面 2. 点击 **🚀 一键安装全部依赖**(程序自动通过国内镜像下载 Node.js 22 便携版 + OpenClaw 小龙虾 CLI + MinGit,无需手动操作) 3. 全部显示 ✅ 后,进入 **AI 模型配置** 页面 4. 选择模型模板(如 **DeepSeek V3**),填入 API Key,点击保存 5. 进入 **服务管理** 点击启动,等待服务就绪提示后即可在 **AI 对话** 中与 AI 畅聊 --- ## ⚙️ 独立运行 vs 接入 Microi 平台 本工具**开箱即用**,完全独立运行,不依赖任何云端服务。 也可作为 [Microi 吾码低代码平台](https://microi.net) 的**本地节点**,实现多节点集中管控: ``` ┌─────────────────────────┐ │ Microi 吾码低代码平台 │ │ (云端 / 内网服务器) │ │ 统一管理多个节点 │ └─────┬───────────┬─────────┘ │ │ 心跳上报 │ │ 心跳上报 ▼ ▼ ┌───────────────┐ ┌───────────────┐ │ 节点A (Win) │ │ 节点B (Mac) │ │ microi.openclaw│ │ microi.openclaw│ │ ↓ 管理 ↓ │ │ ↓ 管理 ↓ │ │ OpenClaw GW │ │ OpenClaw GW │ └───────────────┘ └───────────────┘ ``` --- ## 🛠️ 技术栈 | 层级 | 技术 | 说明 | |---|---|---| | 桌面框架 | Electron 33 | 跨平台桌面应用 | | 前端框架 | Vue 3 + Vite | 现代化前端工具链 | | UI 组件 | Element Plus | 企业级组件库 | | 后端框架 | Express 4 | Node.js Web 框架 | | AI 运行时 | OpenClaw | Node.js/TypeScript AI 助手网关 | | 定时调度 | node-cron | 轻量级 Cron 定时任务引擎 | | 实时通信 | ws (WebSocket) | 日志推送 & 进程输出 & 任务状态 | | 进程管理 | tree-kill | 跨平台进程树终止 | | 机器标识 | node-machine-id | 生成机器唯一码 | --- ## 📝 配置说明 ### 配置文件 OpenClaw 使用 `~/.openclaw/openclaw.json` 作为全局配置文件,可通过管理界面的 **AI 模型配置** 页面修改。 ### 配置持久化 应用配置(API Key、模型、Provider 等)会自动保存到独立的持久化目录,**重装 exe 不会丢失**: | 平台 | 持久化路径 | |---|---| | Windows | `%APPDATA%\microi-openclaw\config.json` | | macOS | `~/Library/Application Support/microi-openclaw/config.json` | | Linux | `~/.config/microi-openclaw/config.json` | 重装后首次启动时,程序会自动从持久化配置恢复 OpenClaw 配置文件,无需重新手动配置。 ### 端口 | 服务 | 端口 | 说明 | |---|---|---| | 前端开发 | 5566 | Vite 开发服务器 | | 管理后端 | 5567+ | Express + WebSocket(占用时自动 +1,最多尝试 10 次) | | OpenClaw Gateway | 18789 | OpenClaw AI 网关(可在配置中修改) | --- #### Linux 安装部署 **方式一:AppImage(推荐,免安装)** ```bash # 下载后赋予执行权限 chmod +x Microi.OpenClaw-*.AppImage # 直接运行(带图形界面的桌面环境) ./Microi.OpenClaw-*.AppImage # 如果运行报错 FUSE,使用 --no-sandbox 参数 ./Microi.OpenClaw-*.AppImage --no-sandbox ``` **方式二:deb 包安装(Ubuntu / Debian)** ```bash sudo dpkg -i microi-openclaw_*.deb # 如有依赖缺失,执行: sudo apt-get install -f ``` **方式三:无图形界面的服务器(纯命令行部署)** 如果你的 Linux 服务器没有桌面环境,可以直接运行后端服务: ```bash # 1. 安装 Node.js 22(推荐使用 nvm) curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash source ~/.bashrc nvm install 22 # 2. 安装 OpenClaw CLI npm install -g openclaw@latest --registry https://registry.npmmirror.com # 3. 克隆项目并安装依赖 git clone https://gitee.com/microi-net/microi.openclaw.git cd microi.openclaw npm install --registry https://registry.npmmirror.com # 4. 构建前端 npm run build:web # 5. 启动服务(前端 + 后端管理面板) npm run start # 服务默认监听 5567 端口,浏览器访问 http://你的服务器IP:5567 即可打开管理界面 ``` > 💡 **后台运行提示**:可使用 `nohup`、`screen`、`tmux` 或 `pm2` 保持服务常驻: > ```bash > # 使用 pm2(推荐) > npm install -g pm2 > pm2 start server/index.js --name openclaw -- --production > pm2 save && pm2 startup > > # 或使用 nohup > nohup npm run start > openclaw.log 2>&1 & > ``` ## ❓ 常见问题 > **Windows 开发者注意(使用 nvm4w 时)** > > 如果你使用 [nvm for Windows](https://github.com/coreybutler/nvm-windows) 管理 Node.js 版本,首次切换版本后 PowerShell 可能报错: > ``` > 无法加载文件 npm.ps1,因为在此系统上禁止运行脚本 > ``` > 执行以下命令解决(只需一次): > ```powershell > Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser > ``` ### Q: 环境安装速度慢或失败? 程序默认走国内加速镜像(Node.js 镜像站 + npmmirror),正常情况下国内网络几十秒即可完成。如多次失败: - 检查本机网络是否正常 - 在环境管理页面重试单项安装 - 也可手动安装 Node.js 22 并加入 PATH,程序会自动识别 ### Q: 安装 OpenClaw CLI 失败? ```bash # 手动安装(国内加速) npm install -g openclaw@latest --registry https://registry.npmmirror.com ``` ### Q: 端口 5567 被占用? 程序会自动尝试 5567 ~ 5576 共 10 个端口。如果全部被占用,请先释放端口。 ### Q: 如何使用 Ollama 本地模型? 1. 安装并启动 [Ollama](https://ollama.com/) 2. 在配置编辑中选择 **Ollama** 模板 3. 确认 Base URL 为 `http://localhost:11434` 4. 填入模型名(如 `llama3.1`) 5. 保存并重启 Gateway ### Q: 如何从外网访问? 侧边栏底部显示当前服务的内网 IP 和端口。在路由器设置端口映射(将外网端口映射到该 IP:端口)即可外网访问。 ### Q: Linux 服务器(无桌面)如何部署? 不需要 Electron 桌面环境,直接用 Node.js 运行后端即可。详见上方「**无图形界面的服务器(纯命令行部署)**」章节,通过浏览器访问管理界面。 ### Q: Linux 运行 AppImage 报 FUSE 相关错误? 较新版本的 Linux 可能未预装 FUSE: ```bash # Ubuntu/Debian sudo apt-get install fuse libfuse2 # CentOS/RHEL sudo yum install fuse fuse-libs # 或直接加 --no-sandbox 参数运行 ./Microi.OpenClaw-*.AppImage --no-sandbox ``` ### Q: 安装插件超时或失败? 1. 切换下载源:在 **插件管理** 页面将下载源切换为 **CDN 加速源** 2. CDN 方式从 `https://static.itdos.com/openclaw` 下载,国内网络更稳定 3. 如果 CDN 也失败,检查网络连接或联系管理员确认 CDN 资源已上传 ### Q: 启动 Gateway 报端口 18789 被占用? 程序启动时会**自动尝试终止**占用 18789 端口的旧进程。如果仍然报错: ```bash # Windows:手动查找并终止占用端口的进程 netstat -ano | findstr :18789 taskkill /F /PID <上面查到的PID> # macOS / Linux lsof -i :18789 kill -9 ``` 也可以在 **AI 模型配置** 页面修改 Gateway 端口号(默认为 18789),避免与其他程序冲突。 ### Q: 对话时无响应(AI 不回复)? 1. 确认 **服务管理** 页面显示「✅ 已就绪」状态 2. 如果显示「启动中」或「已停止」,先点击启动并等待就绪 3. 检查 **AI 模型配置** 页面的 API Key 是否正确填写 4. 查看 **服务管理** 页面的日志,是否有 `Unknown model` 或 `401` 错误 5. 如使用 DeepSeek 等国产模型,确认 API 账户余额充足 ### Q: 在服务管理中更新 OpenClaw 提示 MODULE_NOT_FOUND? 这通常是因为通过**源码方式**运行项目,且 `node_modules` 目录不完整。解决方法: ```bash # 1. 在项目根目录重新安装依赖 npm install --registry https://registry.npmmirror.com # 2. 重新全局安装 OpenClaw CLI npm install -g openclaw@latest --registry https://registry.npmmirror.com ``` > ⚠️ 注意:项目路径中**不能包含中文或空格**,否则可能导致 npm 路径解析失败。建议将项目放在类似 `D:\Work\microi.openclaw` 的简短英文路径下。 > > 如果你使用的是安装包(exe / dmg / AppImage),则不会遇到此问题——安装包自带全部依赖。 ### Q: 如何使用阿里云 Coding Plan / 腾讯云 Coding Plan? 1. 进入 **AI 模型配置** 页面 2. 选择模板 **「阿里云百炼」** 或 **「腾讯云知码」** 3. 填入对应的 API Key(阿里云在 [百炼控制台](https://bailian.console.aliyun.com/) 获取,腾讯云在 [知码控制台](https://console.cloud.tencent.com/lke) 获取) 4. 保存并重启 Gateway 即可使用 --- ## 🤝 相关项目 | 项目 | 说明 | |---|---| | [OpenClaw 小龙虾](https://github.com/openclaw/openclaw) | OpenClaw Node.js AI 智能助手网关(吾码小龙虾的底层引擎) | | [Microi.net 吾码](https://microi.net) | Microi 吾码低代码平台,搭配小龙虾实现企业级多节点管控 | --- ## 💬 交流社群 有问题、有想法,或只是想和其他 AI 爱好者一起聊聊?欢迎加入官方 QQ 交流群,开发者在线答疑、共同探索 AI 新玩法!

点击加入 QQ 交流群:60831381

扫码加入 QQ 交流群

📌 群号:51050055  ·  点击徽章或扫描二维码即可加入  ·  欢迎开发者与 AI 爱好者!

--- ## 📄 许可证 MIT License ---

Made with ❤️ by Microi 吾码团队 · 让 AI 真正属于每一个人