🦞 MicroClaw

MicroClaw 是一个集成式 AI 自动化平台，将 OpenClaw 开源 Agent 框架打包为 Windows 桌面应用。内置聊天界面、本地 Gateway、浏览器自动化、Office 文档编辑、Microsoft 365 集成及沙盒权限管理，开箱即用。

亮点

• 一键安装：向导式安装器自动下载 Node.js、配置 OpenClaw，无需手动操作命令行
• 本地 Gateway：内置 OpenClaw Gateway（端口 18789，仅 loopback），无需外部服务
• 52+ 内置技能 + 8 托管技能：浏览器控制、Office 三件套、Bing 搜索、语音、智能家居等
• 技能完整性校验：SHA-256 + Ed25519 签名，启动时自动检测篡改
• 沙盒权限管理：集成 Sandboxie，图形化配置文件访问权限
• 中国网络优化：npmmirror / 腾讯镜像源，淘宝 npm registry，国内下载不卡
• 微信频道插件：扫码登录，将 OpenClaw 接入微信
• Teams Bot 集成：通过 Azure Bot Service 接入 Microsoft Teams

---

项目组成

组件	路径	技术栈	说明
桌面应用	desktop/	Electron 33 + TypeScript + Vue 3 + Element Plus	聊天界面、Gateway 生命周期管理、托盘菜单
权限管理器	permissions-manager/	Electron 33 + TypeScript + Vue 3	Sandboxie 沙盒文件权限配置 GUI
安装器	deploy.py + deployer/	Python 3 + Tkinter	向导式图形化安装器（可打包为单文件 exe）
技能包	skills/	Markdown + JSON + Python/Node	Office、搜索、浏览器自动化等托管技能
微信插件	plugins/openclaw-weixin/	TypeScript + OpenClaw Plugin SDK	微信频道接入
Teams Bot	TeamsBot/	Azure Bot Service	Teams 聊天/频道集成
WorkIQ	WorkIQ/	MCP + 浏览器扩展	Microsoft 365 数据连接器

---

快速开始

方式一：使用安装器（推荐）

直接使用打包好的 MicroClawInstaller.exe，双击运行，按向导操作即可。

安装器旁边需要有 .env 文件，填入你的 API Key。

方式二：从源码运行安装器

git clone <repo-url>
cd microclaw

# （可选）创建虚拟环境
python -m venv .venv
.venv\Scripts\activate

# 安装可选依赖
pip install -r requirements.txt

配置 .env 文件：

MODEL_BASE_URL=https://your-model-endpoint.example.com
MODEL_API_KEY=sk-your-api-key-here
MODEL_NAME=your-model-name

⚠️ .env 包含敏感信息，已被 .gitignore 排除。

启动安装器：

python deploy.py
# 或双击 launch.bat

安装器会自动完成以下步骤：

步骤	说明
下载 Node.js 22	从 npmmirror / 腾讯镜像，安装到 ~/.openclaw-node/
安装 OpenClaw	通过 npm（淘宝源），全局安装
选择技能	图形化技能选择器，默认勾选 Windows 兼容技能
写入配置	生成 openclaw.json，配置模型、端口、技能白名单
释放桌面应用	解压 MicroClaw 桌面应用到安装目录

方式三：手动启动 Gateway

start-gateway.cmd

Gateway 运行于 127.0.0.1:18789，仅接受本地连接。

---

桌面应用

Electron 桌面应用是用户的主要交互入口：

• 聊天界面：基于 Vue 3 + Element Plus，支持多会话
• Gateway 管理：自动启动/重启本地 OpenClaw Gateway
• WebSocket 通信：JSON RPC 协议，Ed25519 设备认证
• 技能完整性检测：启动时 SHA-256 校验所有技能文件，Ed25519 验签
• 系统托盘：后台运行，状态指示

开发模式：

cd desktop
npm install
npm run dev

---

权限管理器

独立 Electron 应用，用于配置 Sandboxie 沙盒的文件访问权限：

• 读写 / 只读 / 拒绝访问 三级权限
• 通过 SbieIni.exe CLI 操作 Sandboxie.ini
• 支持多个沙盒容器

cd permissions-manager
npm install
npm run dev

---

技能系统

内置技能（52 个）

随 OpenClaw 一同安装，通过 skills.allowBundled 白名单控制启用。涵盖：

类别	技能示例
生产力	obsidian, notion, trello, slack, discord, things-mac
AI / 编码	coding-agent, gh-issues, oracle, skill-creator
通信	imsg, bluebubbles, wacli, voice-call
智能家居	openhue, blucli, sonoscli, eightctl
媒体	spotify-player, songsee, video-frames
工具	weather, healthcheck, session-logs, model-usage, tmux
语音	openai-whisper, sherpa-onnx-tts, sag

托管技能（8 个）

安装到 ~/.openclaw/skills/，包含本项目定制的高级技能：

技能	说明
excel-xlsx	Excel 工作簿创建与编辑
powerpoint-pptx	PowerPoint 演示文稿创建与编辑
word-docx	Word 文档创建与编辑
playwright-browser	本地浏览器自动化（默认 Edge）
web-search	Bing 网页搜索（无需 API Key）
image-search	Bing 图片搜索（无需 API Key）
video-search	Bing 视频搜索（无需 API Key）
microsoft-workiq	Microsoft 365 搜索与交互（via WorkIQ MCP）

---

微信插件

plugins/openclaw-weixin/ — 将 OpenClaw 接入微信：

• 扫码登录，无需用户名密码
• 多账号 + 发送者隔离
• 支持文字、图片、视频、文件消息
• 长轮询消息更新

---

Teams Bot 集成

通过 Azure Bot Service 将 MicroClaw 接入 Microsoft Teams。

• Bot ID：1eca551c-76f2-4283-888a-cd35734bc0d1
• 支持频道消息、聊天、通话
• 配置详见 teamsbotconfig.md 和 AzureBotConfig.md

---

WorkIQ — M365 Connector

通过 WorkIQ MCP 插件访问 Microsoft 365 数据（邮件、日历、文件、聊天、人员）。

使用步骤

1. 启动 M365 Connector 服务

   npx m365connector

2. 安装浏览器扩展

   • 解压 WorkIQ/ 目录下的 zip 文件
   • Chrome/Edge → chrome://extensions/ → 开发者模式 → 加载已解压的扩展程序
   • 完成登录

3. 配置 MCP

   在 openclaw.json 中添加：

   "M365Connector": {
     "type": "http",
     "url": "http://127.0.0.1:52366/mcp"
   }

---

安全特性

机制	说明
技能完整性校验	SHA-256 哈希 + Ed25519 签名，启动时检测所有技能文件是否被篡改
设备认证	每台设备生成 Ed25519 密钥对，Gateway 连接时签名认证
技能白名单	allowBundled / allowManaged 控制可用技能范围
沙盒隔离	可选 Sandboxie 沙盒，限制文件系统访问
本地 Gateway	仅绑定 loopback，不接受远程连接

---

构建

完整构建流程（PowerShell）：

.\build.ps1

该脚本依次执行：

1. 构建桌面应用（desktop/ → Electron Builder）
2. 构建权限管理器（permissions-manager/ → Electron Builder）
3. 创建便携版 zip 包（dist/microclaw-portable.zip、dist/permissions-manager-portable.zip）
4. 打包安装器 exe（PyInstaller → dist/MicroClawInstaller.exe）

前置条件

• Node.js 22+
• Python 3.10+（安装 PyInstaller）
• npm 依赖已安装（cd desktop && npm install、cd permissions-manager && npm install）

---

项目结构

├── deploy.py                    # 安装器主程序（Tkinter GUI）
├── deployer/
│   ├── config.py                # 配置管理（.env + YAML）
│   ├── logger.py                # 线程安全日志 + 内存环形缓冲
│   ├── skill_catalog.py         # 52 内置 + 8 托管技能目录
│   ├── skill_manager_ui.py      # 技能选择器对话框
│   └── windows_setup.py         # Windows 安装逻辑（Node/npm/OpenClaw）
├── desktop/                     # Electron 桌面应用
│   ├── src/                     # 主进程（TypeScript）
│   └── renderer/                # Vue 3 渲染进程
├── permissions-manager/         # Electron 权限管理器
│   ├── src/                     # 主进程
│   └── renderer/                # Vue 3 渲染进程
├── skills/                      # 托管技能定义
├── plugins/openclaw-weixin/     # 微信频道插件
├── TeamsBot/                    # Teams Bot 清单
├── WorkIQ/                      # M365 Connector 浏览器扩展
├── scripts/                     # 辅助脚本
├── docs/plans/                  # 设计文档
├── build.ps1                    # 一键构建脚本
├── launch.bat                   # 安装器快捷启动
├── start-gateway.cmd            # 手动启动 Gateway
├── MicroClawDeployer.spec       # PyInstaller 打包配置
└── requirements.txt             # Python 依赖

配置说明

配置项	位置	说明
MODEL_API_KEY	.env	必填 — LLM API 密钥
MODEL_BASE_URL	.env	必填 — 模型 API 端点
MODEL_NAME	.env	可选 — 模型名称
技能白名单、端口等	openclaw.json	安装器自动生成，也可手动编辑

系统要求

• Windows 10/11
• Python 3.10+（仅运行安装器需要）
• 网络连接（支持中国大陆镜像源）
• 可选：Sandboxie-Plus（沙盒隔离）、Microsoft Edge（浏览器技能）

License

MIT