{"id":47637611,"url":"https://github.com/rapidai/maclaw","last_synced_at":"2026-06-07T22:01:09.596Z","repository":{"id":328253365,"uuid":"1114812203","full_name":"RapidAI/MaClaw","owner":"RapidAI","description":"下一代自主进化智能体平台（GUI/TUI/Service/SDK)","archived":false,"fork":false,"pushed_at":"2026-06-05T02:33:22.000Z","size":563156,"stargazers_count":111,"open_issues_count":4,"forks_count":20,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-05T04:13:28.104Z","etag":null,"topics":["claudecode","coder","codex","doubao","gemini","glm","kimi","minimax"],"latest_commit_sha":null,"homepage":"https://www.maclaw.top","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RapidAI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-11T23:25:28.000Z","updated_at":"2026-06-05T02:33:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/RapidAI/MaClaw","commit_stats":null,"previous_names":["znsoftm/cceasy","rapidai/cceasy","rapidai/codeclaw","rapidai/maclaw"],"tags_count":85,"template":false,"template_full_name":null,"purl":"pkg:github/RapidAI/MaClaw","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RapidAI%2FMaClaw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RapidAI%2FMaClaw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RapidAI%2FMaClaw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RapidAI%2FMaClaw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RapidAI","download_url":"https://codeload.github.com/RapidAI/MaClaw/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RapidAI%2FMaClaw/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34039495,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-07T02:00:07.652Z","response_time":124,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claudecode","coder","codex","doubao","gemini","glm","kimi","minimax"],"created_at":"2026-04-02T00:25:50.112Z","updated_at":"2026-06-07T22:01:09.588Z","avatar_url":"https://github.com/RapidAI.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MaClaw（码卡龙）\n\n[📖 使用说明书](UserManual_CN.md) | [❓ FAQ](faq.md) | [English](README_EN.md) | [中文](README.md)\n\n**MaClaw（码卡龙）** 是一个**通用可自进化智能体平台**——你的个人数智工作伙伴。它能理解你的意图、记住你的偏好、自主规划并执行复杂任务。无论是写商业计划、做竞品分析、审查合同、开发软件，还是管理远程服务器，它都能从需求梳理到成果交付全程陪你走完。基于 Wails + Go + React 构建，集**结构化工作流、知识库（外脑）、长期记忆、技能扩展、多通道协作**于一体，并通过 **Agent 动态 UI + 结构化数据管理**取代传统企业 MIS 系统的固定表单入口。企业版提供**数字员工**能力——物理用户的数字分身和云端虚拟化员工，7×24 替代重复岗位，降低薪资成本。\n\n\u003e 不只是聊天，而是替你干活。你说想法，它出成果。它有自己的知识库——你导入的文档和网页变成它的\"外脑\"，让它带着知识为你工作。\n\n## 它能做什么\n\nMaClaw 内置 **19 种结构化工作流模板**，覆盖从商业决策到技术实现的完整工作场景。每种工作流都遵循\"需求确认 → 方案设计 → 分步执行\"的质量闭环，确保产出物经过你的审阅和确认。\n\n| 领域 | 工作流 |\n|------|--------|\n| **商业与战略** | 商业计划书、竞品分析、项目提案、创新方案、招投标文件生成 |\n| **研究与分析** | 文献综述、研究报告、实验设计、专利分析 |\n| **合规与尽调** | 合同审查、尽职调查、合规审计 |\n| **学术写作** | 基金申请书、论文写作 |\n| **内容创作** | PPT 设计、活动策划 |\n| **产品与技术** | 产品设计（PRD）、软件测试、软件开发 |\n\n每个工作流按阶段推进，每个阶段产出文档后等待你确认，你可以修改、补充或跳过。不是一股脑把结果扔给你，而是和你一起把事情做对。\n\n## 🏢 企业版特性：数字员工\n\n\u003e **用 AI 数字员工替代重复岗位，7×24 不间断运转，显著降低企业薪资成本，提升运营效率。**\n\nMaClaw 企业版将 Agent 从\"辅助工具\"升级为\"独立工位\"——**数字员工**。一个数字员工就是一个 AI 驱动的虚拟岗位，能独立接受任务、执行业务、产出成果，并接入企业 IM/OA/CRM 等系统以\"员工\"身份参与协作。\n\n数字员工统一为两种形态：\n\n| 类型 | 定位 | 典型场景 |\n|------|------|---------|\n| **物理用户的数字分身** | 为真实员工创建的 AI 分身，代替本人处理日常事务 | 🍥 日常事务自动化、💬 信息咨询代理、📄 文档与报告生成、🔗 跨系统代办 |\n| **云端虚拟化员工** | 无对应真人的纯 AI 岗位，独立承担业务职能 | 🖥️ 虚拟前台与客服、✅ 流程审批助手、📊 数据录入与校验、📒 知识库运维员 |\n\n### 物理用户的数字分身\n\n为企业中的真实员工创建 AI 分身，继承该员工的权限、知识和工作习惯：\n\n*   **日常事务自动化**：邮件分类与回复草稿、会议纪要整理、日报/周报自动生成、待办事项跟踪与提醒\n*   **信息咨询代理**：同事/客户发来咨询时，数字分身根据知识库和历史对话自动应答，本人不在线时代为处理\n*   **文档与报告生成**：根据数据源和模板自动生成分析报告、项目汇报、商务文档，发送至指定审批人\n*   **跨系统代办**：代替员工在 OA、CRM、ERP 等系统中执行流程操作（提交审批、录入数据、查询状态），通过 MCP/API 连接企业内部系统\n\n### 云端虚拟化员工\n\n无需对应真人的独立 AI 岗位，直接部署到业务流程中承担职能角色：\n\n*   **虚拟前台与客服**：7×24 在线接待客户咨询、产品介绍、问题解答、工单创建，支持多通道（微信/飞书/网页/电话转文本）\n*   **流程审批助手**：自动审核报销单据（金额校验、发票验真、政策合规）、合同条款初审、采购询价比对，将结果提交人工终审\n*   **数据录入与校验**：从邮件/附件/扫描件中自动提取结构化数据、核对一致性、标记异常，减少人工录入错误\n*   **知识库运维员**：定期扫描企业知识源（文档库/Wiki/共享盘），自动发现新增/变更内容，更新知识库索引，维护知识质量评分\n\n### 与传统方案的对比\n\n| 维度 | 传统人力外包 | RPA 机器人 | MaClaw 数字员工 |\n|------|-----------|-----------|---------------|\n| **理解能力** | 强（人类） | 无（规则脚本） | 强（LLM 语义理解） |\n| **适应变化** | 中（需重新培训） | 弱（界面改动即失效） | 强（自动适配，自我修复） |\n| **7×24 可用** | 否（需轮班） | 是 | 是 |\n| **边际成本** | 线性增长 | 低 | 极低（一份部署，多实例复用） |\n| **知识积累** | 人员离职即丢失 | 无 | 持久化（长期记忆 + 知识库） |\n| **合规审计** | 依赖人工记录 | 有限 | 全链路自动审计 |\n\n### 部署与管理\n\n*   **MaClawSrv 多租户**：每个数字员工是一个 Instance，共享租户的知识库和配置，按角色分配权限\n*   **IM 通道绑定**：数字员工可绑定独立的企业微信/飞书账号，对外以\"员工\"身份与客户、同事交互\n*   **工作台监控**：管理员可查看所有数字员工的在线状态、任务执行记录、异常告警\n*   **人工兜底**：遇到超出能力范围的请求时，自动升级到对应真人处理，并记录学习\n\n## 核心能力\n\n### 企业 MIS 替代——Agent 动态 UI + 结构化数据管理\n\nMaClaw 的终极目标之一是**用 Agent + 自然语言交互取代传统企业 MIS 系统的固定菜单、固定页面和固定表单**。用户不再需要知道\"去哪个系统、打开哪个页面、填写哪些字段\"，而是直接用自然语言、图片、语音、文件表达意图，系统自动完成从意图理解到结构化数据落库的全流程。\n\n#### Agent 动态 UI（AG-UI）\n\n传统 MIS 的表单入口被 Agent 动态生成的受控界面取代：\n\n*   **动态表单生成**：Agent 理解用户意图后，自动从 Schema 注册表生成参数录入界面（表单、向导、表格编辑器、审批确认等），无需预先开发固定页面\n*   **智能字段抽取**：从自然语言、附件、图片、已有数据中自动抽取候选字段值，用户只需补全和确认\n*   **右侧 Task Panel**：左侧对话 + 右侧结构化操作面板，对话负责理解和解释，面板负责精确录入和确认\n*   **Adapter 自动推断**：从 Skill/Tool/MCP 的 Schema、OpenAPI、函数签名中自动生成 UI 适配器，标准 Skill 无需修改\n*   **业务对象识别**：用户说\"昨天去杭州见客户，高铁 174，午餐 86\"，系统自动识别为报销场景，生成报销单草稿\n*   **安全受控**：所有界面由注册组件和 Schema 白名单渲染，LLM 不能直接生成任意前端代码，不能绕过校验、权限和审批\n\n#### 结构化数据管理（MaClawDataSrv）\n\n内置企业级结构化数据底座，替代传统 MIS 的数据库层：\n\n*   **业务数据集**：支持销售（客户/商机/订单）、财务（费用/发票/付款/凭证）、HR（员工/考勤/薪资）、法务（合同）、采购（供应商/采购单）、库存（物料/仓库/出入库）、固定资产等完整企业数据结构\n*   **模板一键初始化**：内置 30+ 企业 MIS 模板（客户管理、销售订单、费用报销、薪资、合同、采购、库存等），一键创建数据集和字段定义\n*   **业务操作目录**：Agent 不直接操作底层 CRUD，而是通过业务操作（expense_submit、order_upsert、contract_status_update 等）执行，自带校验、审批和审计\n*   **业务视图**：预定义的查询视图（订单概览、客户目录、费用审核、合同登记等），控制字段投影和权限，Agent 查询时不暴露底层 SQL\n*   **仪表盘与报表**：内置业务仪表盘和报表，Agent 可直接运行并返回结果\n*   **治理与审批**：业务规则引擎（金额阈值、重复检测、必填校验）+ 审批流程（pending → approve/reject）+ 操作计划（高风险操作需管理员确认）\n*   **全链路审计**：每次结构化提交记录完整审计日志（原始输入、Agent 抽取结果、用户修改、最终数据、校验结果、审批结果）\n*   **多引擎支持**：本地 SQLite（个人/小团队）→ PostgreSQL（团队/企业），同一 API 无缝切换\n*   **Agent 友好 API**：Agent 通过 `mis_data` 工具调用业务操作，支持 dry-run 预检、业务意图解析、能力发现、操作计划生成\n\n#### 与传统 MIS 的对比\n\n| 维度 | 传统 MIS | MaClaw AG-UI + DataSrv |\n|------|---------|----------------------|\n| **入口** | 固定菜单 → 固定页面 → 固定表单 | 自然语言 → Agent 理解 → 动态 UI |\n| **开发成本** | 每个业务场景需开发专用页面 | Schema 声明 + Adapter 自动推断 |\n| **用户门槛** | 需要培训，记住操作路径 | 说人话即可，零学习成本 |\n| **数据录入** | 手动逐字段填写 | Agent 从对话/附件自动抽取，用户确认 |\n| **查询方式** | 固定筛选条件 | 自然语言查询，Agent 自动转换 |\n| **扩展方式** | 改代码、改数据库、改页面 | 加模板、加 Schema、加业务操作定义 |\n\n### 知识库（外脑）——结构化知识管理引擎\n\nMaClaw 内置一套完整的知识库系统（外脑），基于 SQLite 构建，能将各类文档、网页、对话产出物解析为结构化知识，供 Agent 在工作中精准检索和引用：\n\n*   **多格式文档导入**：支持 PDF、Word（.docx/.doc）、Excel（.xlsx/.xls/.csv）、PowerPoint（.pptx）、Markdown、纯文本等格式，批量导入整个目录或单文件\n*   **网页知识采集**：输入 URL 自动抓取网页内容，支持批量 URL 导入、域名策略管理（允许/屏蔽）、链接自动发现\n*   **三层知识结构**：原始文档 → 结构化节点（DocumentNode，保留标题/段落/表格/页码层级）→ 知识卡片（Card，提炼核心论断）→ 事实三元组（Fact，主语-谓语-宾语）\n*   **LLM 蒸馏**：导入文档后可选 LLM 蒸馏，自动提取实体、主题、标签、知识卡片和事实关系\n*   **全文检索 + 语义搜索**：SQLite FTS5 全文索引 + 向量嵌入双重检索，支持按来源类型、域名、标签、质量等级多维度过滤\n*   **知识图谱**：来源之间自动建立主题关联（Source Links），支持图谱可视化、路径查询、邻域探索\n*   **事实图谱**：从知识卡片中提取的实体-关系-实体三元组，支持实体画像、关系查询、图谱浏览\n*   **Context Pack**：Agent 工作时自动从知识库中检索相关知识，打包为上下文注入 LLM，实现\"带着知识干活\"\n*   **版本追踪**：每次刷新/更新自动保存版本快照，支持变更预览和历史回溯\n*   **质量管理**：自动质量评分（A/B/C/D 等级）、敏感信息扫描、重复卡片检测与抑制、维护计划自动生成与执行\n*   **标签系统**：手动标签 + 自动标签（基于文件路径和内容规则），支持按标签过滤和批量管理\n*   **导入导出**：支持 JSONL 格式的完整快照导出/导入，可跨设备迁移知识库\n*   **多租户隔离**：服务端部署时按 Owner/Tenant 隔离知识，互不干扰\n\n**与长期记忆的关系**：知识库是\"外脑\"——存储你主动导入的文档和网页知识；长期记忆是\"内脑\"——自动记住对话中的偏好、习惯和项目进展。两者协同工作，Agent 在回答问题时同时检索两个系统。\n\n### 长期记忆——它记得你的一切\n\nMaClaw 拥有持久化的记忆系统，跨会话记住你的偏好、项目知识和工作习惯：\n\n*   **语义检索**：BM25 + 向量双重索引，用自然语言就能找到之前的记忆\n*   **会话全文检索**：基于 SQLite FTS5 的历史对话全文索引，所有对话自动持久化并建立全文索引，支持跨会话搜索、BM25 排序和关键词高亮，随时回溯任意一次对话的完整内容\n*   **自动沉淀**：工作流产出物（需求文档、设计方案、任务列表）自动沉淀为长期记忆，对话历史截断后不丢失\n*   **知识图谱**：相关记忆自动关联，形成结构化知识网络\n*   **记忆生命周期**：置顶、归档、压缩、垃圾回收，自动管理记忆质量\n*   **多租户隔离**：服务端部署时按用户隔离记忆，互不干扰\n\n### 技能系统——能力可无限扩展\n\n通过安装技能（Skill），MaClaw 可以获得新的工作能力，就像给手机装 App：\n\n*   **多格式支持**：YAML 定义、Markdown 脚本、Claude SKILL.md 格式\n*   **多步骤工作流**：顺序执行、条件分支、变量传递、输出捕获\n*   **三源市场**：从 SkillHub（官方）、ClawHub（社区）、GitHub 搜索和安装\n*   **跨平台兼容**：Windows / macOS / Linux 自动路径规范化和 Shell 适配\n*   **自我进化**：`craft_tool` 可动态生成一次性自动化脚本，验证后可转化为可复用技能\n\n### MCP 集成——连接外部世界\n\n通过 Model Context Protocol（MCP）接入外部工具和服务：\n\n*   **动态发现**：自动发现 MCP Server 提供的工具\n*   **本地 + 远程**：支持 Stdio 本地协议和 HTTP 远程协议\n*   **健康监控**：自动检测 MCP Server 状态\n*   **无限扩展**：任何支持 MCP 的服务都可以成为 MaClaw 的能力\n\n### 工具路由——智能匹配最佳工具\n\nMaClaw 内置 40+ 工具，通过混合检索智能选择当前任务最需要的工具组合：\n\n*   **混合检索**：BM25 + 向量语义双重匹配\n*   **条件激活**：SSH、浏览器等工具按上下文关键词按需激活，不污染简单任务的工具列表\n*   **渐进式暴露**：核心工具始终可用，低频工具通过 `discover_tool` 按需加载\n*   **使用反馈闭环**：工具调用的成功/失败/重试记录回流到路由决策，高失败率工具自动降权\n\n### 自我进化——能力缺口自动补全\n\nMaClaw 不只是被动执行，它能主动发现自身能力不足并自动补全：\n\n*   **能力缺口检测**：Agent 遇到无法完成的任务时，自动搜索 SkillHub 寻找匹配的技能并安装\n*   **技能自修复**：技能执行失败后，LLM 自动分析错误原因并修补技能定义（修复步骤、参数、路径等），修复结果持久化\n*   **Nudge 系统**：复杂任务完成后，系统建议将成功的操作序列封装为可复用技能，推动技能库有机增长\n*   **craft_tool 转化**：一次性自动化脚本验证成功后可转化为永久技能\n\n### 办公文档处理\n\n内置文档生成和处理能力：\n\n*   **PDF 生成**：从 Markdown 内容直接生成 PDF，工作流各阶段文档自动生成 PDF 版本通过 IM 发送\n*   **Excel 读写**：读取和写入 Excel 文件\n*   **PPTX 读取**：解析 PowerPoint 文件内容\n*   **文件发送**：生成的文件可直接通过 IM 通道（飞书/微信/QQ）发送给用户\n\n### 信息获取\n\n*   **Web 搜索**：搜索互联网内容，返回标题、URL、摘要\n*   **网页抓取**：抓取指定 URL 的正文内容，自动编码检测（GBK/UTF-8），支持 JS 渲染和长页面续读\n*   **屏幕截图**：截取桌面屏幕并发送给用户，支持 IM 远程监督场景\n\n### 语音处理\n\n*   **语音消息识别**：IM 通道收到的语音消息自动转换为 WAV 格式，支持 ASR 语音识别（内置 Moonshine 模型）\n\n### 定时任务\n\n支持创建定时执行的自动化任务：\n\n*   按日/周/月调度，支持一次性任务\n*   自然语言描述任务内容，到时自动执行\n*   暂停、恢复、删除任务\n\n### 审计日志\n\n全程记录 Agent 操作，支持合规审查：\n\n*   工具调用、文件操作、SSH 命令等关键操作自动记录\n*   可通过工具查询审计日志\n\n### 意图理解\n\n三层融合意图分类系统，准确理解用户请求：\n\n*   **Layer 1**：关键词规则（\u003c1ms）\n*   **Layer 2**：BM25 语义检索（\u003c5ms）\n*   **Layer 3**：LLM 多轮对话确认（10-30s）\n*   自动路由到对应工作流模板或直接执行\n\n### 行为定制——Steering 规则系统\n\n通过 Markdown 文件声明行为规则，无需改代码即可定制 MaClaw 的工作方式：\n\n*   **四种注入模式**：始终注入、文件匹配注入、关键词匹配注入、手动引用\n*   **两级作用域**：用户级（`~/.maclaw/steering/`）和项目级（`\u003cproject\u003e/.maclaw/steering/`）\n*   **Token 预算**：智能控制规则注入量，不浪费上下文空间\n*   **热加载**：修改后 30 秒内自动生效\n\n## 多形态交互\n\nMaClaw 不限于一种使用方式，你可以在多个入口与它协作：\n\n| 形态 | 说明 |\n|------|------|\n| **桌面 AI 助手面板** | 原生 GUI，右侧 Markdown 预览区实时显示工作流文档，支持流式输出 |\n| **终端 TUI** | 命令行界面，支持聊天、记忆查看、技能管理、滚动条和流式显示 |\n| **微信 / 飞书 / QQ / Telegram** | 通过 IM 通道随时随地与 MaClaw 对话，手机上也能指挥它干活 |\n| **REST API（MaClawSrv）** | 多租户 REST 服务，供外部程序、自动化平台和控制面板集成 |\n\n### 双模式体验\n\n| 模式 | 适用人群 | 特点 |\n|------|----------|------|\n| **专业模式** | 开发者、研究人员 | 完整暴露所有工具、工作流、记忆系统、MCP 管理等高级功能 |\n| **简洁模式** | 白领、日常用户 | 精简界面，聚焦对话式交互，零门槛上手 |\n\n## 执行能力\n\n### SSH 远程管理\n\n内置 SSH 客户端，直接在对话中管理远程服务器：\n\n*   最多 10 个并发会话，支持密码/密钥/Agent 多种认证\n*   同步执行、后台任务、文件上传下载\n*   自动 sudo token 管理、Shell 响应性检测、连续失败自动清理\n*   操作全程记录，满足审计要求\n\n### 浏览器自动化\n\n基于 Chrome DevTools Protocol 的浏览器操作能力：\n\n*   页面导航、元素点击、文本输入、内容提取、截图\n*   流程录制与回放，支持定时触发和参数化变量\n*   OCR 集成（RapidOCR + LLM 视觉模型）\n\n### 桌面 GUI 自动化\n\n直接操控本机桌面程序（记事本、Excel、计算器等任意原生应用），无需浏览器：\n\n*   **Accessibility 元素树**：跨平台（Windows/macOS/Linux）读取窗口控件结构，获取按钮、输入框、菜单等元素信息\n*   **YOLO 视觉检测**：内置 OmniParser V2 模型，从屏幕截图中检测可交互 UI 元素（按钮、图标、输入框），不依赖 Accessibility API\n*   **鼠标键盘操作**：在指定坐标点击、输入文本\n*   **流程录制与回放**：录制 GUI 操作序列，保存为可重放的流程，支持参数化覆盖和后台异步执行\n*   **状态观测与验证**：`gui_observe` 返回窗口元素树 + OCR 文本（纯文本，不消耗 vision token）；`gui_verify` 验证 GUI 状态是否满足条件（文本包含、元素存在、窗口存在等）\n*   **多显示器支持**：列出所有连接的显示器，支持指定显示器截图\n\n### 软件开发\n\n编程是 MaClaw 的工作能力之一，通过编码工作流和外部编程工具协作完成：\n\n*   **结构化流程**：需求分析 → 技术设计 → 任务拆分 → 逐任务执行 → 集成联调\n*   **多工具支持**：Claude Code、Codex、OpenCode、CodeBuddy、Qoder CLI\n*   **编码 SubAgent**：纯净上下文编码执行器，每个任务独立 context，不会因历史膨胀而失效\n*   **Swarm 编排**：大型任务可拆分给多个 AI 开发者并行执行，自动合并\n\n### 本机后台进程管理\n\n通过 `bash(background=true)` 启动本机后台任务，系统自动捕获 PID 和日志路径：\n\n*   非阻塞查询状态、阻塞等待完成、终止任务\n*   与 SSH 后台任务管理对称的 Submit / Check / Wait / Kill 模式\n\n### 直通任务——紧急场景下的一键执行\n\n直通任务（Passthrough Task）是为**紧急运维、系统救援、快速操作**设计的预注册命令执行机制。跳过 Agent 的意图理解和工作流编排，直接执行预定义的脚本或命令，适用于服务器宕机恢复、紧急部署回滚、批量操作等不能等待 AI 思考的场景。\n\n*   **预注册命令**：将常用运维脚本（重启服务、清理日志、数据库备份、回滚部署等）注册为直通任务，一条命令即可触发\n*   **参数化模板**：支持定义参数（必填/可选/默认值/示例），执行时动态填充，避免硬编码\n*   **确认机制**：高风险操作默认需要用户确认（`confirm_required=true`），防止误操作\n*   **超时控制**：每个任务可设置执行超时（默认 120 秒），防止脚本挂起\n*   **审计追踪**：每次执行自动记录审计日志（谁执行、什么时间、什么参数、退出码、耗时），满足合规要求\n*   **启用/禁用**：可临时禁用某个直通任务，不删除定义\n*   **多入口触发**：桌面面板 `/runctl` 命令、IM 通道斜杠命令、Agent 工具调用（`passthrough_task`）均可触发\n*   **跨设备同步**：通过 Hub 远程注册，IM 通道可直接触发桌面机器上的直通任务\n\n**典型使用场景**：\n\n| 场景 | 示例命令 |\n|------|---------|\n| 服务器紧急重启 | `/runctl restart-nginx` |\n| 数据库备份 | `/runctl backup-db --target=production` |\n| 部署回滚 | `/runctl rollback --version=v2.3.1` |\n| 清理磁盘空间 | `/runctl cleanup-logs --days=7` |\n| 批量证书续期 | `/runctl renew-certs --domain=*.example.com` |\n| 应急切换 DNS | `/runctl switch-dns --target=backup` |\n\n## 快速开始\n\n### 安装后四步上手\n\n| 步骤 | 内容 | 说明 |\n|------|------|------|\n| **注册账号** | 邮箱注册 | 输入邮箱完成注册，启用远程协作能力 |\n| **选择模式** | 专业 / 简洁 | 随时可切换 |\n| **配置 AI** | 选择 LLM 服务商 | 输入 API Key 并测试连通性，也支持 OAuth 登录和免费体验 |\n| **绑定 IM（可选）** | 扫码绑定微信 | 绑定后可通过微信随时与 MaClaw 对话 |\n\n### 运行\n\n*   Windows：`MaClaw.exe`\n*   macOS：`MaClaw.app`\n*   Linux：`MaClaw.AppImage`\n*   终端：`maclaw-tui`\n\n首次启动自动检测运行环境，缺少的组件会自动安装。\n\n## MaClawSrv — REST Agent 服务\n\n[MaClawSrv](MaClawSrv/) 是 MaClaw 的多租户 REST 服务入口，将 Agent 能力以标准 HTTP API 的形式暴露给外部程序。\n\n**核心特点**：\n\n*   **多租户隔离**：数据按 `tenant → user` 层级隔离，同一用户下可同时运行多个 instance\n*   **共享用户数据**：同一用户的所有 instance 共享配置、记忆、Skill、MCP 状态\n*   **安全优先**：管理端 + 用户端双层鉴权；凭证 scrypt 摘要存储；支持 TLS\n*   **完整 API 覆盖**：Admin 控制面板、用户配置、Instance/Session/Message/Run 运行时、Skill/MCP 生命周期、异步 Job、Usage/Audit/Dashboard\n\n```bash\nexport MACLAW_ADMIN_SECRET=\"your-admin-secret-at-least-24-chars\"\nexport MACLAW_TOKEN_SECRET=\"your-token-secret-at-least-32-chars\"\ngo run ./MaClawSrv\n```\n\n**API 文档**：\n\n| 文档 | 说明 |\n|------|------|\n| [README](MaClawSrv/README.md) | 项目定位、接口分组、安全模型、数据布局 |\n| [API 对接手册（中文）](MaClawSrv/API_MANUAL.zh-CN.md) | 完整字段级说明，含鉴权、分页、错误模型 |\n| [API Manual (English)](MaClawSrv/API_MANUAL.md) | 英文版 API 手册 |\n| [5 分钟快速接入](MaClawSrv/QUICKSTART.zh-CN.md) | 最短可用链路 |\n| [Quickstart (English)](MaClawSrv/QUICKSTART.md) | 英文版快速接入 |\n| [缺口分析](MaClawSrv/GAP_ANALYSIS.zh-CN.md) | 已实现能力与待补全功能 |\n| [Gap Analysis](MaClawSrv/GAP_ANALYSIS.md) | 英文版缺口分析 |\n| OpenAPI | 服务运行后访问 `GET /openapi.json` |\n\n## srvdemo — API 演示客户端\n\n[srvdemo](srvdemo/) 是基于 Go + Wails 的桌面客户端，演示 MaClawSrv 全部 API 的对接方式。一键初始化演示数据、Token 交换、配置管理、Instance/Session/Message/Run 全生命周期操作、Skill 和 MCP 管理。详见 [srvdemo/README.md](srvdemo/README.md)。\n\n## 授权许可（Dual License）\n\n*   **开源用途**：用于开源项目时可自由使用\n*   **商业用途**：需获得商业授权，联系 **znsoft@163.com**\n\n## 关于\n\n*   **作者**：Dr. Daniel   人工智能大语言模型博士\n*   **GitHub**：[RapidAI/MaClaw](https://github.com/rapidai/maclaw)\n*   **产品网站**：[maclaw.top](https://maclaw.top)\n\n---\n*本工具仅作为配置管理辅助，请确保遵守各模型厂商的服务条款。*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frapidai%2Fmaclaw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frapidai%2Fmaclaw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frapidai%2Fmaclaw/lists"}