📖 使用说明书 | ❓ FAQ | English | 中文
MaClaw（码卡龙） 是你的编程小龙虾 —— 无论是专业软件开发者还是普通白领，它都是你身边最贴心的 AI 搭档。它不仅懂代码，更懂你：可定制人格、长期记忆你的偏好，在你工作时给予精神陪伴，在你忙碌时自动接管任务。基于 Wails + Go + React 构建，集三态编程、智能体编排、人格系统、长期记忆、SSH/浏览器监管于一体，软件开发、白领办公、日常事务统统拿下。
它是程序员的编程搭档，也是白领的办公助手，更是每个普通人的智能伙伴。当你工作时它陪你，当你离开时它替你干活。
编程流畅就像吃马卡龙。
MaClaw 首创三态编程模式，覆盖从本地开发到全自动编排的全链路场景：
| 编程态 | 描述 | 适用场景 |
|---|---|---|
| 本地 AI 编程 | AI CLI 工具在本地直接运行，完整访问文件系统与开发环境 | 日常编码、调试、重构 |
| 远程 AI 编程 | 通过 MaClaw Hub 提供浏览器远程访问，支持 PWA、移动端 | 远程办公、跨设备协作 |
| AI 自动编排 | Swarm 编排器智能拆分任务，多智能体并行执行，自动合并 | 大型需求、批量重构、自动化流水线 |
三态之间可无缝切换，系统根据工具可用性、网络状况和任务类型智能路由。
MaClaw 提供两种操作模式，满足不同用户群体的需求：
| 模式 | 目标用户 | 特点 |
|---|---|---|
| 专业模式 (Pro) | 软件研发人员 | 完整暴露三态编程、Swarm 编排、SSH/浏览器监管、MCP 管理、记忆系统等全部高级功能 |
| 简洁模式 (Simple) | 普通白领 & 日常用户 | 精简界面，聚焦对话式 AI 交互，隐藏技术细节，零门槛上手，写文档、做报表、查资料样样行 |
两种模式可在设置中一键切换——开发者用专业模式写代码，白领用简洁模式办公，一家人整整齐齐。
- Swarm 编排器：支持 Greenfield（从零构建）和 Maintenance（增量维护）两种运作模式
- 多智能体并行：最多 5 个 AI 开发者智能体并发执行，含冲突检测与自动合并
- 反馈闭环：每任务最多 5 轮自动反馈迭代，持续优化输出质量
- 后台任务管理：槽位式并发控制，支持编程、定时、自动、SSH、浏览器五类任务槽
MaClaw 不只是一个冰冷的工具，它是你的编程小龙虾——拥有独立人格、记住你的习惯、理解你的风格、陪伴你的每一次编码：
- 可定制智能体身份：自定义角色名称、角色描述，定义小龙虾的性格与行为风格
- 动态角色切换：对话中可临时覆盖角色设定，适配不同场景需求（严肃代码审查 / 轻松结对编程）
- 系统提示注入：角色信息自动注入系统提示词，确保行为一致性与人格连贯
- 精神陪伴：在漫长的编码夜中，小龙虾始终在线，随时响应、永远耐心
- 长期记忆存储：基于 BM25 + 向量语义索引的持久化记忆系统，小龙虾跨会话记住你的偏好与项目知识
- 多维度评分：综合时效性（Recency）、重要性（Importance）、相关性（Relevance）进行记忆检索
- 记忆生命周期：支持记忆的置顶（Pin）、归档（Archive）、压缩（Compress）与垃圾回收（GC）
- 六类记忆分类：自我认知、用户事实、用户指令、偏好设定、项目知识、会话检查点
- 知识图谱：自动关联相似记忆，形成结构化知识网络
MaClaw 独创的 SSH 运行监管系统，为软件运维提供端到端的远程管控能力：
- 远程终端管理：内置 SSH 客户端，支持最多 10 个并发远程会话
- 实时会话监控：远程操作全程可视化，支持进程状态追踪
- 运维自动化：结合智能体实现远程部署、日志分析、故障诊断等运维操作
- 操作审计：全程记录远程操作日志，满足安全合规要求
- 批量化运维：支持批量命令下发与结果回收，提升运维效率
MaClaw 独创的浏览器运行监管系统，为自动化测试与业务流程自动化提供核心支撑：
- 流程录制与回放：基于 Chrome DevTools Protocol，录制浏览器操作并支持回放
- 后台自动化执行：浏览器任务作为后台任务运行，支持暂停/恢复/取消
- OCR 集成：支持 RapidOCR 及 LLM 视觉模型进行屏幕文字提取
- 定时回放：支持按时间计划自动触发浏览器自动化任务
- 差异变量覆盖：回放时动态替换变量，实现参数化自动化测试
- 智能验证：内置执行结果验证机制，自动检测操作正确性
- 混合检索路由：BM25 + 向量语义双重检索，智能匹配最相关工具
- 本地 MCP 服务器：Stdio 协议接入，自动发现与健康监控
- 远程 MCP 服务器：HTTP 协议接入，支持认证与健康检查
- 动态工具预算：每请求最多 30 个工具，按相关性动态分配
- 🚀 环境自动准备：启动时自动检测并准备 AI CLI 环境（Claude Code, Codex, Gemini, OpenCode, CodeBuddy, Qoder CLI），支持自动安装与版本更新
- 🖼️ 统一侧边栏 UI：现代化垂直侧边栏导航，支持在不同 AI 编程工具间快速切换
- 📢 消息中心 (BBS)：集成实时公告，第一时间获取工具更新动态与社区信息
- 📚 交互式教程 (Tutorial)：内置新手引导与进阶教程，通过 Markdown 交互展示
- 🛒 API 商店：精选优质 API 服务商，一键直达
- 🛠️ 统一技能管理：支持 Skill ID 与 Zip 包两种格式，智能兼容性检查，内置系统技能
- 📂 多项目管理 (Vibe Coding)：多标签页切换、独立配置、Python 环境支持（Conda/Anaconda）
- 🔄 多模型 & 跨平台支持：集成 Claude Code、OpenAI Codex、Google Gemini CLI、OpenCode、CodeBuddy、Qoder CLI；支持"原厂"模式与 API Key 智能同步
- 🖱️ 系统托盘支持：一键启动及退出程序
- ⚡ 一键启动：大按钮一键启动对应 CLI 工具，自动处理认证与环境配置
首次启动 MaClaw 后，引导式向导带你快速上手：
| 步骤 | 内容 | 说明 |
|---|---|---|
| 第一步：注册账号 | 邮箱注册 | 输入邮箱地址完成注册（部分地区需邀请码），注册后即可启用远程编程能力 |
| 第二步：选择模式 | Pro / Simple | 专业模式面向开发者，简洁模式面向白领与普通用户，可随时切换 |
| 第三步：配置 AI | 选择 LLM 服务商 | 从预设服务商中选择，输入 API Key 并测试连通性，也支持 OAuth 一键登录和免费体验 |
| 第四步：绑定微信 | 扫码绑定（可选） | 扫描二维码即可将小龙虾绑定到你的微信，之后随时随地通过微信与小龙虾对话，让它帮你干活 |
四步完成，你的编程小龙虾就绑好了——电脑上用界面操作，手机上用微信指挥，随时随地都在线。
直接运行 MaClaw.exe (Windows) 或 MaClaw.app (macOS)。
程序首次启动会自动检测运行环境（如 Node.js），缺少的组件会自动安装/更新。
- 本地编程：在侧边栏选择 AI 工具，点击 "Launch" 启动本地终端
- 远程编程：通过 MaClaw Hub 进行浏览器远程访问
- 自动编排：配置 Swarm 编排器，让 AI 自动拆分并执行任务
- 版本：V5.3.0.9800
- 作者：Dr. Daniel
- GitHub：RapidAI/MaClaw
- 产品网站：maclaw.top
- 资源：CS146s 中文版
本工具仅作为配置管理辅助，请确保遵守各模型厂商的服务条款。
