PyClaw v0.6.4.4.2 · Beta

一个 Agent,
走遍天下

PyClaw 是跨平台 AI 助手框架——桌面、Web、命令行,一套配置随处跑。多 Agent 架构 + 8 个预装插件 + 42 个工具(6 内置 + 36 扩展),SQLite 长期记忆,数据留在本地,能力握在自己手里。

查看 GitHub 快速开始 
$
Agent = LLM + Skills + Tools

让 Agent 在真实场景中持续工作

LLM 是大脑,Skills 是本领,Tools 是手脚。PyClaw 把它们组装成一个能理解、会思考、能动手的 Agent。

LLM 驱动

LLM-Powered

模型是 Agent 的灵魂。LLM 负责理解意图、推理判断、生成回复,是决策的头脑,也是对话的入口。

deepseekOpenAI 兼容多提供商

Skills 即插即用

Skills as Plugins

8 个预装插件、36 个扩展工具 + 6 个内置工具,用 Markdown 声明式或 Python 类就能扩展。装了就有的用,不装也不碍事。

LK-CutPPTWeatherBilibili+4

Tools 动手干活

Tools in Action

Exec、File、Search、Browser 各司其职,子 Agent 按权限分工执行;SQLite 长期记忆沉淀每一次会话。

execfilesearchbrowserSQLite
Three Modes, One Agent

一次对话,三种形态

同一套配置、同一份记忆,桌面、网页、命令行随时切换。想怎么用,就怎么开。

桌面模式

pyclaw start → desktop
  • pywebview + Edge WebView2 原生窗口
  • 快捷键、后台常驻、独立应用体验
  • Windows / Linux / macOS 全平台

网页模式

pyclaw start → web
  • FastAPI + Uvicorn + WebSocket
  • 浏览器、手机、局域网随时访问
  • WebSocket 流式输出,打字机体验

命令行模式

pyclaw chat "你好"
  • 一句话问答,零界面负担,适合脚本与管道
  • pyclaw shell 进入 Codex 风格 TUI,rich 渲染、思考过程与工具调用卡片
  • Ctrl+P 命令面板 · /new /sessions /compact /exit,直接管理会话
8 Plugins · 42 Tools

装了就有的用,不装也不碍事

视频剪辑、PPT 生成、天气查询、B 站发布……预装 8 个插件,开箱即用。插件用 Markdown 或 Python 写,扩展没有门槛。

LK-Cut

13 种工具

视频剪辑:裁剪、合并、加 BGM、片尾一条龙。

PPT

10 种版式

纯 Python 生成 PPTX,一句话出稿。

Weather

全球

全球天气查询,出门前先问一句。

Bilibili

4 种工具

B 站视频发布,做完即传。

System Info

系统监控

系统信息 & 进程管理,一眼看穿机器。

Memory

长期记忆

记忆管理与回顾,越用越懂你。

Desktop Path

路径辅助

Linux 中文桌面路径自动适配。

Skill Manager

插件管理

插件安装 / 卸载 / 热加载,一键搞定。

PyClaw Lite · Rewritten Core

想要更轻,但内核更强? 试试 PyClaw Lite

PyClaw Lite 是 PyClaw 内核的重写版——独立仓库、独立节奏,一把 exec 走天下。2854 行 Python、12 个模块、只有一个内置工具,但权限分级、上下文压缩、会话落盘、MCP、12 个钩子事件、20+ 供应商表,完整版里没有的它全有。完整版厚在插件与桌面交付,两边的活不一样。

只有一个工具:exec想读文件? cat。想装包? pip。想爬网页? curl。AI 自己动手,什么都能切;能力写在 skills/ 里,不写在框架里。
依赖克制运行时三个包:openai 管接口,prompt_toolkit + rich 管 TUI;只跑 --plain 甚至可以不要后两个。要求 Python 3.10+。
文件式长期记忆memory/ 下的文本文件全文注入 system prompt——写进去下次就记得,比 SQLite 少一层。
TUI + 朴素 CLI 双模式python main.py 进 Codex 风 TUI(含 /effort 思考强度滑杆),--plain 走逐行 CLI;--continue 续上次会话。WebUI 已砍,少一层服务端。
前往 PyClaw Lite 官网 → 2854 行 v0.0.1-beta.2 GPL v3.0
前往 PyClaw Lite 官网 Lite · GitHub 
$ git clone https://github.com/LK-BLOG/pyclaw-lite$ cd pyclaw-lite && ./install.sh$ cp pyclaw.json.example pyclaw.json   # 填 KEY$ python main.py# --plain 极简 CLI · --continue 续上次 · --session 指定会话
How It Works

各司其职,协作无间

PyClaw 不是单线程的聊天机器人。主 Agent 像项目经理一样拆解任务,把脏活累活分给专职的子 Agent,自己只做判断和决策。

01
统一入口CLI / Web / 桌面三路进,都通向同一个主 Agent。
02
delegate_to 委派主 Agent 按权限把任务派给子 Agent,互不越权。
03
记忆沉淀每一次会话都写入 SQLite,长期记忆随叫随到。
用户
主 Agent · 理解意图 / 调度 / 决策
delegate_to
Exec执行命令
File读写文件
Search搜索抓取
Browser搜索抓取
App执行命令
Skills插件能力
ListDir FileRead Exec Time SQLite 记忆
Get Started

一行命令,从零到跑

一条 Bash 命令搞定安装,Windows 的 Git Bash 同样兼容;开发者也可以从源码构建。整个框架核心代码约 1MB,常驻内存约 70MB(主要是 Python 解释器与依赖),轻得不像是带插件系统的。

setuppyclaw setup — 配置向导
startpyclaw start — 桌面 / Web / 后台
chatpyclaw chat "你好" — 一句话问答
shellpyclaw shell — 交互式对话
statuspyclaw status / stop — 状态与停止
configpyclaw config / version — 配置与版本
$ curl -fsSL https://raw.githubusercontent.com/LK-BLOG/PyClaw/main/install.sh | bash# 或源码安装:$ git clone https://github.com/LK-BLOG/PyClaw.git && cd PyClaw && pip install -e . && pyclaw setup