CursorClaw

License: MIT TypeScript Bun GitHub Stars

通过飞书/钉钉/企业微信远程控制 Cursor AI 的智能助手

快速开始 · 功能特性 · 文档 · 贡献指南

✨ 简介

核心优势

架构设计

整体架构

手机飞书 ──WebSocket──→ feishu/server.ts ────┐
 ├──→ Cursor CLI ──→ 本地 Cursor IDE
手机钉钉 ──Stream─────→ dingtalk/server.ts ───┤ │
 │ │
手机企业微信 ─WebSocket→ wecom/server.ts ──────┘ │
 │
 ┌────────────────────────────────────────────────┘
 │
 ├─→ 项目路由 (projects.json)
 ├─→ 会话管理 (--resume, 自动恢复上下文)
 ├─→ 记忆系统 (.cursor/MEMORY.md + SQLite向量数据库)
 ├─→ 定时任务 (cron-jobs-*.json, AI 创建的定时任务)
 └─→ 心跳系统 (.cursor/HEARTBEAT.md, 定期维护)

工作原理

用户消息 → 解析项目路由 → 多模态处理(文本/图片/语音/文件)
 ↓
 传递给 Cursor CLI
 ↓
 AI 处理(思考、工具调用、回复)
 ↓
 实时流式推送进度卡片
 ↓
 最终结果 + 耗时统计

项目结构

cursorclaw/
├── shared/ # 共享模块(三个平台共用)
│ ├── memory.ts # 记忆管理器 v2(SQLite + 向量 + FTS5)
│ ├── memory-tool.ts # 记忆 CLI(统一版本,供 Agent 调用)
│ ├── scheduler.ts # 定时任务调度
│ ├── heartbeat.ts # 心跳系统
│ └── sync-apple-notes.ts # Apple Notes 同步
│
├── feishu/ # 飞书服务(独立)
│ ├── server.ts # 飞书主服务
│ ├── bridge.ts # OpenAI API 桥接
│ ├── memory-tool.ts # 记忆 CLI 包装(转发到 shared)
│ ├── service.sh # 飞书服务管理脚本
│ └── README.md # 飞书详细文档
│
├── dingtalk/ # 钉钉服务(独立)
│ ├── server.ts # 钉钉主服务
│ ├── dingtalk-client.ts # 钉钉 Stream 客户端
│ ├── memory-tool.ts # 记忆 CLI 包装(转发到 shared)
│ ├── service.sh # 钉钉服务管理脚本
│ └── README.md # 钉钉详细文档
│
├── wecom/ # 企业微信服务(独立)
│ ├── server.ts # 企业微信主服务
│ ├── wecom-helper.ts # 企业微信工具函数
│ ├── memory-tool.ts # 记忆 CLI 包装(转发到 shared)
│ ├── service.sh # 企业微信服务管理脚本
│ └── README.md # 企业微信详细文档
│
├── projects.json # 项目路由配置(共享)
├── cron-jobs-feishu.json # 飞书定时任务
├── cron-jobs-dingtalk.json # 钉钉定时任务
├── cron-jobs-wecom.json # 企业微信定时任务
├── manage-services.sh # 统一服务管理脚本
└── docs/ # 通用文档

功能特性

核心功能(三平台通用)

扩展功能(飞书/钉钉)

企业微信特色

快速开始

前置条件

选择你的渠道

🟦 安装飞书服务

# 1. 安装 Bun 运行时(如果未安装)
curl -fsSL https://bun.sh/install | bash
# 2. 安装 Cursor Agent CLI(如果未安装)
curl https://cursor.com/install -fsS | bash
# 3. 登录 Cursor(一次性操作,之后不需要配置 API Key)
~/.local/bin/agent login
# 4. 创建并配置文件
cd /path/to/cursorclaw
# 创建项目路由配置
cp projects.json.example projects.json
# 编辑 projects.json,配置你的工作区路径
# 创建定时任务配置
cp cron-jobs-feishu.json.example cron-jobs-feishu.json
# 配置飞书凭据
cd feishu
cp .env.example .env
# 编辑 .env,填入:
# - FEISHU_APP_ID=cli_你的APP_ID
# - FEISHU_APP_SECRET=你的SECRET
# - CURSOR_MODEL=auto # 建议用 auto 节省配额
# - 注释掉 CURSOR_API_KEY(已通过 agent login 登录)
# 5. 安装依赖并启动
cd feishu
bun install
bash service.sh install

🟦 安装钉钉服务

cd dingtalk
cp .env.example .env
# 编辑 .env 填入钉钉凭据
bun install
bash service.sh install

🟩 安装企业微信服务

cd wecom
# ⚠️ 重要:必须先创建 .env 文件
cp .env.example .env
# 编辑 .env 填入企业微信机器人凭据(BotID 和 Secret)
bun install
bash service.sh install

同时使用多个渠道

# 安装飞书
cd feishu && bash service.sh install && cd ..
# 安装钉钉
cd dingtalk && bash service.sh install && cd ..
# 安装企业微信
cd wecom && bash service.sh install && cd ..
# 使用统一管理脚本
bash manage-services.sh status

服务管理

方式一:各自目录独立管理

# 飞书服务
cd feishu
bash service.sh status # 查看状态
bash service.sh restart # 重启
bash service.sh logs # 查看日志
# 钉钉服务
cd dingtalk
bash service.sh status
bash service.sh restart
bash service.sh logs
# 企业微信服务
cd wecom
bash service.sh status
bash service.sh restart
bash service.sh logs

方式二:统一管理脚本

bash manage-services.sh status # 查看所有服务状态
bash manage-services.sh restart # 重启所有服务
bash manage-services.sh logs feishu # 查看飞书日志
bash manage-services.sh logs dingtalk # 查看钉钉日志
bash manage-services.sh logs wecom # 查看企业微信日志

使用指南

基本对话

@机器人 你好
@机器人 帮我分析一下当前项目的代码结构
@机器人 /帮助

功能差异说明

常用指令

核心指令(三平台通用)

扩展指令(飞书/钉钉专用)

项目路由(多工作区)

cd /path/to/cursorclaw
cp projects.json.example projects.json
# 编辑 projects.json,配置你的工作区

{
 "projects": {
 "mycode": { "path": "/Users/你/Projects/myapp", "description": "代码项目" },
 "docs": { "path": "/Users/你/Documents/文档", "description": "文档工作区" }
 },
 "default_project": "mycode",
 "memory_workspace": "mycode"
}

热点新闻定时推送 🆕

文件发送功能(飞书/钉钉)

/发送文件 ~/Desktop/report.pdf
/send /Users/me/Documents/data.xlsx

# 飞书
cd feishu
bun run send-file.ts /path/to/file.pdf <接收人ID>
# 钉钉
cd dingtalk
bun run send-file-dingtalk.ts /path/to/file.pdf <接收人ID>

配置文件管理

高级配置

语音识别(可选,推荐)

VOLC_STT_APP_ID=你的APP_ID
VOLC_STT_ACCESS_TOKEN=你的ACCESS_TOKEN

向量记忆搜索(可选)

VOLC_EMBEDDING_API_KEY=你的API_KEY
VOLC_EMBEDDING_MODEL=doubao-embedding-vision-250615

故障排查

飞书服务

钉钉服务

企业微信服务

通用问题

常见问题

详细文档

技术栈

致谢

主要变更

开源协议