← 返回列表

PersonalClaw:自托管的个人 AI 智能体与自动化操作系统

PersonalClaw/PersonalClaw · Your self-hosted personal AI agent — an agentic OS for one person: chat, autonomous goal loops, memory, knowledge base, skills, automation, MCP in both directions, and a permission-gated app platform. Local-first, provider-agnostic, MIT.

GitHub原文发布 未知首次收录 2026-09-19上架 2026-09-19 07:02

☆ 收藏查看项目 ↗

ELI5:它是什么,解决什么问题

PersonalClaw 是一个本地优先、自托管的个人 AI 智能体系统,以单一网关进程和 Web 仪表盘整合智能体对话、自主目标循环、长期记忆、知识库、技能、定时自动化、MCP 双向集成以及权限门控的应用平台。所有状态保存在本机 ~/.personalclaw 目录下,模型提供商、搜索、语音、通道与智能体运行时均以可移除应用形式接入,可优雅降级为纯本地运行。项目采用 MIT 许可,目前处于 v0.1.3 预 1.0 阶段,预计会有破坏性更新且暂不提供自动数据迁移。

核心能力与快速开始

★ 5 · Python

能做什么
提供智能体对话(多会话、工具调用与审批控制、会话分叉/撤销、答案变体、临时/隐身记忆模式);目标循环(自行分类与规划目标,在确定性监督下循环执行,可暂停、微调或停止);分层语义+情景+过程记忆,支持主动召回、回合后学习、事实提升以及可选的 Obsidian 兼容 Markdown 库;知识库可摄取 PDF/DOCX/PPTX/HTML、网页与媒体,提供实体抽取、知识图谱与语义搜索并接入对话上下文;技能以 SKILL.md 复用并带市场与供应链扫描;权限门控的 Store 支持模型提供商、搜索、语音、本地模型、通道与完整后端+UI 应用按隔离→扫描→同意流程安装;定时/间隔/Webhook 触发、后台子智能体、收件箱起草回复与自动匹配的工作流 SOP;安全方面提供工具审批模式、shell 命令拒绝列表、带允许/拒绝主机策略的出站防护、HMAC 防篡改安全事件日志与应用级令牌;MCP 双向支持,可连接外部 MCP 服务器并对外暴露六个只读工具。
适用场景
适合希望在自己机器上运行单用户 AI 智能体、并自主掌控数据与模型供应商的个人用户;用于搭建带长期记忆和知识库检索的个人助理;用目标循环让智能体自主推进长期任务;通过定时/Webhook 触发实现个人自动化工作流;将本地文档与网页接入对话上下文进行知识检索;在编辑器中通过 MCP 复用 PersonalClaw 的只读工具;在私有网络中结合 Ollama 等本地模型运行对话而无需 API Key。
项目形态
可直接使用的工具
部署方式
支持本地进程、Docker Compose 与 systemd/launchd 服务方式运行;另有 macOS 专用 Electron 桌面外壳但标记为实验性,未由 CI 构建、签名或发布。仪表盘默认监听 http://localhost:10000。远程访问需借助隧道加密码与 TOTP 双因素认证。
主要依赖
需要 Python 3.12+;推荐通过 uv tool 安装(uv 自带 Python 3.12),也支持 pipx、pip 与 Docker Compose。Linux x86-64/arm64、macOS Apple 芯片为一等支持;macOS Intel 为社区尽力支持;Windows 通过 WSL2 或 Docker Desktop 支持,Windows 原生不支持。语义向量检索需绑定嵌入提供商应用,媒体(图像 OCR/视觉、音视频转写)为模型门控,MCP 出站客户端需可选扩展 personalclaw[mcp]。
使用限制
项目处于 v0.1.3 预 1.0 阶段,后续 0.x 小版本可能引入无自动数据迁移的破坏性变更,官方建议更新前备份并暂不将其作为唯一记录系统。按设计不提供 SSO/SAML/OIDC 登录(单用户自托管),api_key 与 oauth2 为半实现状态且无法通过配置启用。默认不捆绑任何搜索提供商,需自行绑定;向量检索依赖嵌入提供商应用,未绑定时仅支持关键词检索。更新检查默认每 12 小时请求一次 GitHub(可关闭),会将 IP 暴露给 GitHub。具体硬件要求、API 成本与商用授权条件未说明。
许可证
MIT
最近推送
2026-09-19 05:35

资料检查:2026-09-19 07:00 · 卡片整理:2026-09-19 07:00
卡片由 AI 根据仓库资料整理,未进行安装或运行验证 · 本次更新未完成,保留上次成功内容

这是基于来源内容整理的摘要。原文链接失效后,本页摘要和讨论仍会保留。

讨论 0

登录后参与讨论,阅读资讯无需注册。

还没有评论,来分享第一个看法。