MaxClaw 是一款基于 Go 语言开发的本地优先 AI 智能体平台，强调数据隐私与完全本地运行。核心功能包括本地化工作流引擎、桌面与 Web 双界面访问、丰富的工具生态（网页搜索、文件操作、浏览器自动化）、智能记忆管理、多渠道通信集成（Telegram、Discord 等）及定时任务调度。支持 MCP 协议扩展技能系统。适用于个人知识管理、小微企业自动化、开发者生产力提升、家庭智能中心及教育机构学习平台等场景。提供一键安装脚本与手动构建选项，配置灵活，适合对数据安全有严格要求的用户。
MaxClaw 是一款采用 Go 语言开发的本地优先 AI 智能体平台，其设计理念深受 OpenClaw 项目启发，专注于提供低内存占用、完全本地运行、可视化操作且开箱即用的 AI 助手体验。作为面向个人与团队的 AI 代理解决方案，MaxClaw 将隐私保护置于核心地位，确保所有会话数据、记忆存储、工具执行记录和日志文件都完全保留在用户本地设备中，无需依赖任何第三方云服务。
技术定位：MaxClaw 在 AI 智能体生态中填补了高性能本地化解决方案的空白。与许多依赖云端处理或需要复杂配置的 AI 工具不同，MaxClaw 通过单二进制网关架构和优化的资源管理，实现了在有限硬件资源下的稳定长期运行。项目采用 Apache-2.0 开源许可证，鼓励社区贡献和透明开发，同时保持了商业友好的使用条款。
核心设计哲学：项目强调"本地优先"原则，这不仅体现在数据隐私保护上，更贯穿于整个系统架构。从 Go 语言后端的高效执行，到可视化 UI 的直观交互，再到多渠道的无缝接入，MaxClaw 致力于为用户提供既强大又易于掌控的 AI 助手体验。特别适合那些对数据安全有严格要求、希望完全控制 AI 工作流程、或需要在资源受限环境中部署 AI 能力的用户和团队。
MaxClaw 的核心优势在于其彻底的本地化设计。所有 AI 处理、数据存储和工具执行都在用户设备上完成，确保敏感信息永不离开本地环境。系统维护完整的工作流追溯能力，每个会话的交互记录、工具调用详情和系统日志都保存在本机目录结构中，用户可以随时审查和审计。这种设计特别适合处理机密文档、私有代码库或受监管行业的数据处理需求。
平台提供桌面应用和 Web UI 两种访问方式，两者共享相同的后端服务端口。桌面应用采用现代化 UI 设计，具备优雅的圆角卡片、流畅的动画效果和完整的浅色/深色主题支持。Web 界面则提供了跨平台访问的灵活性，用户可以通过浏览器从任何设备连接到本地运行的 MaxClaw 实例。两种界面都支持实时流式对话显示，具备打字机效果的消息呈现和智能打断功能。
MaxClaw 内置了丰富的工具集，支持多种自动化操作场景。网页搜索工具能够获取实时信息，文件操作工具支持本地文件的读写管理，Shell 命令工具允许执行系统级操作，而浏览器自动化工具则提供了复杂的网页交互能力。特别值得一提的是浏览器控制功能，支持多步骤的页面导航、元素点击、表单填写和截图操作，能够处理需要登录状态的网站交互任务。
系统采用双层记忆架构设计，长期事实记忆存储在 memory/MEMORY.md 文件中，始终注入到系统上下文中；历史摘要日志则记录在 memory/HISTORY.md 中，适合通过 grep 等工具进行检索。当会话消息达到预设阈值时，系统会自动将旧消息摘要归档到历史文件中。此外，MaxClaw 还支持心跳上下文机制，每轮对话自动加载工作区中的 heartbeat.md 文件，用于记录当前优先级、阻塞项和下一步检查点。
MaxClaw 支持与主流即时通讯平台的无缝集成，包括 Telegram、Discord、WhatsApp、Slack、QQ 和飞书等。每种渠道都有专门的配置选项和认证机制。对于 WhatsApp，项目通过独立的 Bridge 组件实现连接，Go 端通过 WebSocket 与 Bridge 通信。Telegram 和 Discord 则直接通过官方 API 集成。这种多渠道支持使用户可以通过自己习惯的通信工具与 AI 助手交互，极大提升了使用便利性。
平台内置了灵活的任务调度系统，支持 Cron 表达式、一次性执行和周期性重复三种任务模式。用户可以创建复杂的自动化工作流，如每日数据备份、定期网站监控、定时报告生成等。调度器提供完整的执行历史追踪和状态监控，确保任务可靠执行。结合 AI 的智能决策能力，定时任务可以动态调整执行策略，适应变化的环境条件。
MaxClaw 的技能系统允许用户通过简单的 @技能名 语法快速加载预定义的能力模板。技能文件可以存放在工作区的 skills 目录中，支持单文件或多目录结构。更重要的是，项目完全支持 Model Context Protocol 标准，可以无缝接入外部 MCP 服务器，将第三方工具和服务集成到 AI 助手的工具集中。这种开放架构使 MaxClaw 能够不断扩展其能力边界。
针对需要真实浏览器交互的场景，MaxClaw 提供了两种网页抓取模式：无状态的临时浏览器会话和可复用登录状态的持久化 Chrome 会话。后者特别适合需要处理登录认证的网站，用户只需通过 maxclaw browser login 命令完成一次手动登录，后续的自动化任务就可以复用该会话状态。系统还支持接管现有 Chrome 实例的远程调试连接，实现与用户日常浏览器的无缝集成。
MaxClaw 支持在 Linux 和 macOS 系统上运行，对硬件资源的要求相对适中。基础运行需要 Go 1.21 或更高版本作为后端运行时，Node.js 18 或更高版本用于 Web 界面和部分工具组件。虽然项目可以在资源受限的环境中运行，但为了获得最佳体验，建议配备至少 4GB 可用内存和 10GB 存储空间。对于需要浏览器自动化的功能，系统还需要安装 Chromium 或 Chrome 浏览器。
项目提供了便捷的一键安装脚本，能够自动检测操作系统类型并执行相应的安装流程。用户只需在终端中执行简单的 curl 命令即可完成安装。安装脚本会自动下载最新版本的二进制文件，设置必要的系统服务（如 Linux 的 systemd 或 macOS 的 launchd），并创建默认的配置文件结构。安装过程还包含依赖项检查和环境验证，确保系统满足所有运行要求。
对于希望更多控制安装过程的用户，MaxClaw 也支持手动构建和安装。用户需要先克隆项目仓库，然后使用 Make 工具执行构建命令。项目提供了完整的 Makefile，包含了开发构建、生产打包、依赖安装等常用任务。手动安装允许用户自定义安装路径、服务端口和其他运行参数，适合有特定部署需求的场景。
安装完成后，用户需要编辑 ~/.maxclaw/config.json 文件进行个性化配置。配置文件采用 JSON 格式，结构清晰易懂。核心配置包括 AI 模型提供商设置（支持 OpenRouter、MiniMax、Qwen/DashScope、智谱 GLM 等）、工作区路径定义、执行模式选择和安全限制选项。用户可以根据自己的需求选择不同的 AI 模型，配置本地或云端的 API 端点，设置工作区访问权限等。
MaxClaw 支持多种 AI 模型提供商，每种都有特定的配置格式。对于 OpenRouter，只需提供 API 密钥即可；对于 MiniMax，需要通过 OpenAI 兼容接口进行配置；Qwen 模型通过阿里云的 DashScope 服务访问；智谱 GLM 则需要使用专门的编码套餐端点。项目文档提供了每种提供商的详细配置示例，用户只需复制相应段落并替换为自己的 API 凭证即可。
工作区是 MaxClaw 存储会话数据、记忆文件和技能定义的核心目录。用户可以将其设置在任意位置，建议使用绝对路径以确保可靠性。安全方面，用户可以启用 restrictToWorkspace 选项，限制所有文件操作和命令执行只能在指定工作区内进行，这为生产环境部署提供了额外的安全保护。系统还支持环境变量扩展，允许在配置中使用 ~ 或 $HOME 等占位符。
MaxClaw 提供了三种不同的执行模式，适应不同的使用场景和安全需求。安全模式（safe）采用保守策略，偏向只读操作，适合初步探索和测试；询问模式（ask）是默认设置，在执行可能产生副作用的操作前会请求用户确认；自动模式（auto）则允许 AI 助手连续执行复杂任务，无需人工干预。用户可以根据任务性质和风险承受能力选择合适的执行模式。
安装完成后，MaxClaw 会作为系统服务在后台运行。在 Linux 系统上，通过 systemd 管理两个核心服务：maxclaw-bridge 和 maxclaw-gateway。用户可以使用标准的 systemctl 命令启动、停止、重启服务或查看运行状态。所有服务日志都集中存储在 ~/.maxclaw/logs 目录中，按组件分类记录，便于故障排查和性能监控。
用户可以通过多种方式与 MaxClaw 交互。最直接的是通过命令行界面，使用 maxclaw 命令配合各种子命令和参数。对于偏好图形界面的用户，桌面应用提供了完整的可视化操作环境，包括会话管理、设置调整、文件预览和终端集成。Web 界面则允许通过浏览器远程访问，特别适合在服务器部署时进行管理。所有界面都共享相同的后端服务，确保体验一致性。
每次与 AI 助手的交互都在特定的会话上下文中进行。用户可以创建多个独立会话，分别处理不同的任务或项目。系统支持会话的持久化存储和恢复，即使重启服务也不会丢失对话历史。通过 /new 命令可以清空当前会话并开始新的对话，同时系统会自动将之前的对话内容摘要归档到历史文件中。这种设计既保持了上下文的连贯性，又避免了无限增长的会话负担。
MaxClaw 的强大功能通过丰富的工具集实现。用户可以通过自然语言描述任务需求，AI 助手会自动选择合适的工具并执行相应操作。例如，当用户请求"搜索最新的 AI 新闻"时，助手会调用网页搜索工具；当需要"整理当前目录下的文档"时，则会使用文件操作工具。对于复杂任务，助手能够将目标分解为多个步骤，依次调用不同工具，最终完成整体目标。
浏览器自动化是 MaxClaw 的特色功能之一，特别适合处理需要网页交互的任务。典型的使用流程包括：首先通过 browser login 命令在受管浏览器配置文件中完成网站登录；然后在对话中指示 AI 助手使用浏览器工具执行具体操作。助手可以导航到指定页面、抓取页面内容和可交互元素、执行点击、输入等操作，并在需要时保存截图作为执行证据。整个过程完全自动化，无需人工干预。
通过 MaxClaw 的定时任务系统，用户可以创建各种自动化工作流。任务支持三种触发方式：Cron 表达式提供最大的灵活性，可以定义复杂的执行时间表；一次性任务适合临时性的自动化需求；周期性任务则按固定间隔重复执行。每个任务都可以关联特定的技能和工作区，确保执行环境的一致性。系统提供完整的任务历史记录和状态监控，用户可以随时查看执行结果和错误信息。
技能是 MaxClaw 中封装特定能力的可重用模块。用户可以通过 GitHub 仓库安装社区共享的技能，也可以创建自定义技能满足特定需求。技能安装后，只需在对话中使用 @技能名 语法即可激活相应能力。例如，安装 React 最佳实践技能后，当讨论前端开发时，AI 助手会自动加载相关知识和代码模式。技能系统极大地扩展了 MaxClaw 的适用领域，使其能够适应各种专业场景。
MaxClaw 可以同时处理来自多个通信渠道的消息，为用户提供统一的 AI 助手体验。无论用户通过 Telegram 发送指令、在 Discord 中提问，还是通过 WebSocket 接口集成到自定义应用中，AI 助手都能以一致的方式响应。每个渠道都可以独立配置允许的消息来源、代理设置和其他参数。这种设计使得 MaxClaw 能够无缝融入用户现有的工作流和通信习惯。
对于有特殊需求的用户，MaxClaw 提供了丰富的定制选项。通过 MCP 协议，可以集成外部工具和服务，扩展 AI 助手的能力范围。通过环境变量和配置文件，可以调整各种运行时参数，优化性能和资源使用。通过自定义技能和工作区模板，可以创建针对特定场景的优化配置。项目还提供了完整的 API 接口，支持与其他系统的深度集成。
场景描述：一位学术研究人员每天需要阅读大量论文、技术文档和行业报告，并从中提取关键信息、建立知识关联、生成研究笔记。传统方法需要手动复制粘贴、整理格式、建立索引，过程耗时且容易遗漏重要信息。研究人员希望有一个智能助手能够自动化处理这些重复性工作，同时确保所有研究数据都保留在本地，保护知识产权和隐私。
解决方案：研究人员部署 MaxClaw 作为个人知识管理助手，配置了专门的研究工作区。每天开始工作时，助手会自动扫描预定义的学术资源网站，抓取最新发表的论文摘要和行业动态。通过浏览器自动化功能，助手能够登录需要订阅的学术数据库，下载相关文献的 PDF 版本。使用文件操作工具，助手将下载的文档按照预设分类体系整理到本地目录中。对于每篇重要文献，助手会自动提取核心观点、研究方法、关键数据和参考文献，生成结构化的阅读笔记。所有处理过程都在本地完成，原始文献和生成笔记都存储在研究人员控制的设备上。
实施效果：研究效率提升显著，文献收集和初步整理时间从每天 2-3 小时减少到 30 分钟以内。知识发现能力增强，助手能够识别不同文献间的潜在联系，提示可能的研究方向。数据安全性得到保障，敏感研究数据完全在本地处理，无需担心云服务的数据泄露风险。长期使用后，助手逐渐学习研究人员的兴趣偏好和写作风格，提供的建议和总结越来越精准。
场景描述：一家小型电商企业每天需要处理订单确认、库存同步、客户咨询和社交媒体更新等重复性任务。企业团队规模有限，无法雇佣专门的运营人员处理这些事务，创始人需要亲自处理大量琐碎工作，严重影响了业务拓展和战略思考时间。企业希望建立一个自动化系统，能够处理日常运营任务，同时保持灵活性和可控性。
解决方案：企业采用 MaxClaw 构建自动化运营工作流。系统配置了专门的工作区，集成了电商平台 API、库存管理系统和社交媒体账号。每天早晨，助手自动登录电商后台，下载前一天的订单数据，生成销售报告发送到团队聊天群。库存监控任务每小时运行一次，当关键商品库存低于阈值时，自动向采购负责人发送提醒。客户服务方面，助手监控电商平台的咨询消息，对于常见问题（如发货时间、退货政策）自动回复标准答案，复杂问题则转交人工处理。社交媒体管理方面，助手根据预设的内容日历，自动发布产品更新和促销信息。
实施效果：日常运营工作量减少 70%，创始人每天节省出 3-4 小时用于业务发展和客户关系维护。客户响应时间从平均 2 小时缩短到 15 分钟，客户满意度显著提升。库存周转效率改善，缺货情况减少 40%。系统运行成本极低，仅需一台普通服务器，无需订阅昂贵的 SaaS 服务。随着业务增长，企业可以轻松扩展自动化规则，适应新的运营需求。
场景描述：一位全栈开发者需要同时维护多个项目，处理代码开发、文档编写、依赖更新、测试部署等任务。开发过程中经常需要查找 API 文档、调试代码问题、管理项目任务，这些上下文切换严重影响了开发效率。开发者希望有一个智能助手能够理解开发上下文，协助处理技术任务，同时保护代码知识产权。
解决方案：开发者在工作电脑上部署 MaxClaw，配置了专门的项目工作区。助手深度集成到开发工作流中：在代码编写时，助手可以快速查找相关文档和示例代码；遇到错误时，助手能够搜索解决方案并解释根本原因；需要更新依赖时，助手可以分析变更日志和兼容性影响。通过浏览器自动化，助手能够登录各种开发平台（GitHub、GitLab、Docker Hub 等）执行例行操作。定时任务系统用于自动运行代码检查、依赖扫描和安全审计。所有开发相关的数据和对话历史都保存在本地，确保代码安全。
实施效果：开发效率提升明显，常见技术问题的解决时间从平均 30 分钟减少到 5 分钟。代码质量改善，通过自动化的代码审查和安全检查，潜在问题在早期就被发现和修复。知识积累系统化，技术解决方案和经验教训被自动整理到知识库中，便于后续参考。工作流更加流畅，减少了在不同工具和网站间的频繁切换，开发者可以更专注于核心编码任务。
场景描述：一个科技爱好者家庭拥有多种智能设备，包括灯光、温控、安防、娱乐系统等，这些设备来自不同厂商，使用不同的控制应用和协议。家庭成员希望有一个统一的智能控制中心，能够理解自然语言指令，自动化日常家居场景，同时确保家庭隐私数据不被泄露到云端。
解决方案：家庭使用 MaxClaw 搭建本地智能家居控制中心。系统部署在家用服务器上，通过 MCP 协议集成了各种智能设备的本地控制接口。家庭成员可以通过 Telegram 或家庭内部的 Web 界面与助手交互，使用自然语言控制家居设备。助手能够理解复杂的场景指令，如"晚上睡觉前模式"会自动调暗灯光、调整恒温器、启动安防监控。定时任务用于自动化日常作息，如早晨自动打开窗帘、播放新闻简报。浏览器自动化功能用于监控家庭能源使用情况，从电力公司网站获取实时数据并进行分析优化。
实施效果：家居控制变得更加直观便捷，家庭成员无需学习多个应用的操作方法。能源使用效率提升，通过智能调度和优化，每月电费减少 15%。家庭安全性增强，所有控制数据和监控记录都存储在本地，避免了云服务的隐私风险。系统可靠性高，即使互联网中断，本地自动化场景仍能正常工作。随着家庭需求变化，可以轻松添加新的智能设备和自动化规则。
场景描述：一所培训机构需要为数百名学生提供个性化的学习支持，包括作业辅导、学习进度跟踪、资源推荐等。传统的人工辅导模式无法规模化，而通用的在线学习平台又缺乏个性化。机构希望建立一个智能学习助手，能够理解每个学生的学习情况，提供定制化的指导，同时保护学生的隐私数据。
解决方案：教育机构部署 MaxClaw 作为个性化学习平台的核心。每个学生分配独立的工作区，存储个人的学习记录、作业成果和进步轨迹。助手通过多渠道集成，支持学生通过喜欢的通信工具（如微信、QQ）提问和提交作业。对于常见问题，助手能够自动解答并推荐相关学习资源；对于复杂问题，助手会收集必要信息后转交教师处理。定时任务系统用于跟踪学习进度，定期生成学习报告发送给学生和家长。所有学生数据都存储在机构自有的服务器上，完全符合教育数据隐私保护要求。
实施效果：教学效率大幅提升，教师能够专注于高价值的个性化指导，常规答疑工作减少 60%。学生学习体验改善，获得即时反馈和针对性资源推荐，学习动力增强。机构运营成本降低，相比商业学习平台，自建系统的长期成本仅为三分之一。数据安全得到保障，敏感的学生信息完全在机构控制范围内。系统可扩展性强，随着学生数量增长，可以通过增加服务器资源轻松扩展。
项目关键信息：
核心资源：
社区支持：
技术特色：
安装选项：
项目愿景：MaxClaw 致力于成为最实用、最隐私友好的本地 AI 助手平台，让每个人都能在完全控制数据的前提下享受 AI 自动化的便利。项目不仅提供了开箱即用的解决方案，更建立了一个可扩展的生态系统，用户可以根据自己的需求定制和扩展功能。随着 AI 技术的普及和隐私意识的增强，MaxClaw 的本地优先理念将越来越受到重视，为个人和小团队提供企业级 AI 能力的同时，确保数据的完全自主权。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
