本文档基于项目当前源码与文档整理，面向产品官网、落地页、产品介绍页使用。内容重点突出产品能力、差异化价值与创新设计。
MaClaw / CodeClaw 是一个面向 AI 编程时代的统一工作台：把多种 AI Coding CLI、项目环境、技能扩展、远程会话、移动控制和安全治理整合进同一套桌面到云边协同体系中，让用户既能在本机高效开发，也能在离开电脑后继续掌控任务进展。
- 统一管理 Claude Code、OpenAI Codex、Google Gemini CLI、OpenCode、CodeBuddy、Qoder CLI 等主流 AI 编程工具。
- 通过统一界面完成模型配置、启动参数、认证方式和运行环境管理，避免在多个 CLI 之间反复切换和重复配置。
- 支持一键启动，降低不同工具的上手门槛，让用户更快进入开发状态。
适合官网表达：
一个入口，连接多种 AI 编程能力。
不再为不同 CLI 分别配置、分别维护、分别启动。
- 启动时可自动检测依赖环境与所需工具状态，减少手工排障成本。
- 针对不同工具的首次运行向导、主题选择、信任确认、认证方式等交互阻塞，提供预处理机制，避免每次启动都被首次配置打断。
- 对 Gemini、Claude 系工具分支等做专门 onboarding 兼容处理，提升启动成功率和体验一致性。
适合官网表达：
从“能装上”升级到“能直接开工”。
自动跨过首次启动、交互向导和环境差异带来的阻塞。
- 支持在同一工作台中管理多个项目，并通过标签式切换快速进入不同工作上下文。
- 每个项目都可以独立绑定工作目录、模型配置、启动模式、权限模式和 Python 环境。
- 对需要快速切换上下文的高频开发者、外包团队、顾问、独立开发者尤其友好。
适合官网表达：
多项目并行，不打断思路。
每个项目都有自己的启动配置和环境边界。
- 自动识别系统中的 Conda / Anaconda / Miniconda 环境。
- 启动项目时可按项目选择独立 Python 运行环境，适合 AI、数据分析、自动化脚本等场景。
- 在 Windows、macOS、Linux 的不同路径结构中都做了兼容性搜索与激活处理。
适合官网表达：
AI 编程不只写代码，还要跑环境。
内置 Python 环境识别与项目级绑定能力。
- 支持 “Original / 原厂模式”，可一键回到工具官方原生认证与运行方式。
- 在平台代理模式下，可使用统一配置、统一环境变量和统一管理机制提升可用性。
- 既满足追求便利性的用户，也照顾对官方纯净环境有要求的开发者和团队。
适合官网表达：
想要统一管理，就用平台模式。
想要原生纯净，就切回原厂模式。
- 对同一服务商的配置做跨工具复用，减少重复输入和重复维护。
- 帮助用户把复杂的模型接入流程收敛为更低认知负担的统一配置体验。
适合官网表达：
配一次，多个工具共享。
把复杂模型接入，简化成可复用的统一配置。
- 内置技能管理能力，支持通过 Skill ID 或 Zip 包引入扩展能力。
- Zip 技能可被多个工具共享，形成跨工具可复用的能力层。
- 系统内置官方文档和常用技能包，降低新手学习与进阶使用门槛。
适合官网表达：
不只是启动 AI，而是给 AI 装上可复用的能力模块。
让扩展能力从“工具私有”走向“全局共享”。
- 当模型回答中暴露“能力缺口”时，系统会自动识别并到 SkillHub 搜索匹配技能。
- 支持候选技能筛选、下载、安装、注册与立即执行，形成“发现能力不足 -> 自动寻找扩展 -> 补齐执行链路”的闭环。
- 支持多 SkillHub 并发搜索、延迟优选和推荐刷新机制。
适合官网表达：
当 AI 不会时，系统不是停下来，而是主动去补能力。
这是从“AI 助手”走向“AI 能力编排平台”的关键一步。
- 内置长期记忆存储，可保存用户事实、偏好、项目知识、指令和对话摘要。
- 支持基于用户问题的相关记忆召回，把跨会话经验转化为后续协作上下文。
- 会话内容可归档为长期知识，避免每次都从零开始沟通。
适合官网表达：
不是每次都重新认识你。
让项目知识、用户偏好和历史经验持续积累。
- 支持将常用启动方案保存为会话模板，包括工具、项目路径、模型配置、Yolo 模式与环境变量等。
- 适合团队内部复用标准任务入口，也适合个人反复使用高频工作流。
适合官网表达：
把高频流程固化成模板。
每次启动，都按你的最佳实践来。
- 把桌面应用从“启动器”升级为“会话宿主”，可以在本机托管真实 AI 编码会话。
- 远程会话的核心执行仍然留在用户自己的电脑上，保护本地环境、代码上下文和运行控制权。
- 当前远程能力优先围绕 Claude Code 建设，同时已经为多工具扩展预留执行层结构。
适合官网表达：
会话留在你的电脑上，控制可以走得更远。
真正做到“本机执行，远程掌控”。
- 远程系统并不是简单把终端原样搬到手机，而是把会话处理为摘要、关键事件和预览输出。
- 桌面端持续产出 summary、important events、preview delta，并同步到 Hub。
- 手机端优先看到当前任务、最近结果、关键文件、是否等待用户、下一步建议，而不是嘈杂原始输出。
适合官网表达：
不是把满屏终端塞进手机，而是把真正重要的信息送到手机。
为移动场景重新设计 AI 编程远程体验。
- 支持 PWA 作为移动远程入口，无需安装完整桌面级应用即可查看会话状态。
- 提供机器列表、会话列表、会话详情等移动优先界面。
- 会话详情聚焦状态、任务、结果、事件和建议动作，适合碎片化时间快速掌握进展。
适合官网表达：
用手机查看 AI 编程进度，不需要完整 IDE。
只看关键状态，只处理关键动作。
- Hub 是工作控制平面，负责机器注册、会话缓存、PWA 托管、REST / WebSocket API 和管理后台。
- Hub Center 是入口解析中心，负责 Hub 注册、心跳、邮箱到入口的解析和平台治理。
- “Center 负责找到该去哪里，Hub 负责判断你是谁”，架构边界清晰，便于自托管、扩展和治理。
适合官网表达：
不是单点远程工具，而是一套可扩展的远程协作基础设施。
既适合个人，也适合私有部署和平台化运营。
- 用户在手机端只需输入邮箱，无需手动输入 SN 或复杂设备信息。
- 通过邮箱确认链接完成登录，降低移动端操作复杂度。
- 当存在多个 Hub 时，可智能解析并返回单个、多个或无入口结果。
适合官网表达：
手机登录远程工作台，不该要求用户记住复杂编号。
用邮箱作为自然入口，降低远程协作门槛。
- 远程会话支持发送输入、interrupt、中止 kill 等控制动作。
- 支持远程截图和指定窗口截图，便于 GUI 调试、运行状态确认和视觉问题排查。
- 对截图结果做数据校验、空白图检测和平台兼容处理，提高远程观测的可靠性。
适合官网表达：
不只看状态，还能远程干预。
当问题发生时，你可以发指令、打断任务、甚至直接看见屏幕。
- 内置风险评估器，可根据工具类型、参数内容、目标目录、权限模式和连续调用频率评估风险等级。
- 结合策略引擎，对不同风险操作执行 allow / ask / audit / deny 等动作。
- 对高风险、关键风险行为支持审计记录和用户确认，形成安全闭环。
适合官网表达：
给 AI 执行能力，也给它边界。
从权限判断到风险控制，默认考虑真实生产环境的安全要求。
- 支持按日期分片、按大小滚动、带保留期的审计日志。
- 可查询工具调用、风险级别、策略结果和执行结果，满足追溯和治理需要。
- 为团队环境、受控环境和后续合规扩展打下基础。
适合官网表达：
每一次关键操作，都可被追踪、回看和审计。
让 AI 协作从“可用”迈向“可治理”。
- Hub 提供首次初始化、管理员登录、注册模式管理、黑名单、手动绑定等管理能力。
- Hub Center 提供 Hub 检查、邮箱封禁、IP 封禁、Hub 禁用等平台治理骨架。
- 为未来的邀请制、审批流、共享 Hub、公开 Hub 提供了可演进基础。
适合官网表达：
既适合个人用户，也为平台级治理预留了成长空间。
多数同类产品停留在“帮你启动某个 CLI”。
MaClaw / CodeClaw 更进一步，把工具管理、项目上下文、技能扩展、记忆、模板、权限、安全和远程协作整合成一个完整运行层，形成统一的 AI 编程工作台。
创新价值：
- 从单工具启动，升级到多工具编排。
- 从一次性调用，升级到持续会话管理。
- 从本地桌面，升级到跨端协作。
传统远程方案更接近屏幕共享或终端透传。
本项目的核心创新在于：把远程编程信息抽象为“摘要 + 关键事件 + 预览输出 + 推荐动作”，并优先为手机场景优化。
创新价值：
- 减少移动端认知负荷。
- 弱网下仍可高效获取关键信息。
- 让 AI 编程远程控制从“勉强可看”变成“真正可用”。
真实 AI 编码会话持续运行在用户自己的机器上，而不是完全迁移到云端。
创新价值：
- 代码、依赖、环境和权限留在本地，减少迁移成本。
- 保留用户对执行环境的控制权。
- 兼顾远程便利性与本地可信性。
项目没有把“入口解析、平台治理、用户身份、会话转发、PWA 托管”全部糅在同一个服务里，而是拆分为 Hub 与 Hub Center 两层架构。
创新价值：
- 适合单机自托管，也适合多 Hub 扩展。
- 架构边界清晰，便于平台化部署。
- 为后续共享协作、组织治理和多入口调度保留了空间。
项目不把模型回答失败视为终点，而是把“不会做”视为一个可被自动修复的能力缺口。
创新价值：
- 让系统具备动态扩展能力，而不是静态能力上限。
- 把 SkillHub 变成 AI 能力供应层。
- 用户体验从“换个模型试试”升级为“系统自动寻找更合适的能力”。
风险评估、策略判断、审计记录、权限模式并不是外围附加功能，而是深入远程执行链路的核心机制。
创新价值：
- 更适合真实项目和生产环境。
- 让自动化、Yolo 模式和高权限操作具备可治理边界。
- 在“效率”和“控制”之间建立系统化平衡。
- 技能解决“系统会不会做”。
- 记忆解决“系统记不记得”。
- 模板解决“系统怎么稳定复现最佳实践”。
这三者组合后，产品不再只是一个 AI 外壳，而是一个能够持续学习、持续复用、持续标准化的 AI 工作环境。
项目并非停留在抽象层，而是深入处理了首次启动向导、主题提示、认证交互、ConPTY、截图、Python 环境、原厂模式、Windows 管理员权限等大量工程细节。
创新价值：
- 真正解决“工具看起来支持，但实际上不好用”的问题。
- 把多工具兼容做成可落地产品能力，而不是仅停留在概念集成。
- 一个工作台，统一管理多种 AI 编程工具
- 自动准备环境、自动处理首次启动阻塞，打开就能开始写
- 多项目、多模型、多环境并行切换，适配真实开发工作流
- 会话留在本机运行，手机也能随时查看进度与发送指令
- 不是屏幕共享，而是面向移动场景重构的 AI 编程远程体验
- 内置技能市场、长期记忆、会话模板与安全审计，让 AI 开发真正可持续
- Unified AI Coding Workspace for Claude, Codex, Gemini and more
- Local-first session hosting with remote mobile control
- Compressed-state sync for pocket-friendly remote coding visibility
- SkillHub-powered capability expansion with automatic gap detection
- Policy-driven risk control, auditing and execution governance
- Multi-project, multi-environment, multi-tool orchestration in one desktop app
- 提升 AI 编程工具使用效率，降低多工具切换成本
- 把个人 AI 编程体验升级为可沉淀、可复用、可治理的工作系统
- 让开发者离开电脑后，依然能掌握 AI 任务进展并进行关键干预
- 为个人用户、重度开发者、私有部署场景和平台化扩展同时准备
MaClaw / CodeClaw 不只是一个 AI CLI 启动器，而是一套面向未来软件开发方式的统一工作台。它把多工具接入、项目环境管理、技能扩展、长期记忆、安全治理和远程移动协作整合到同一体系中，让 AI 编程从“单次使用某个模型”进化为“持续管理一整套 AI 开发工作流”。