PythonAI
JiuwenClaw AI 智能体安装部署与核心功能详解
介绍基于 Python 开发的 AI 智能体工具 JiuwenClaw 的安装部署与核心功能。通过一行命令即可完成环境搭建与启动。文章详细演示了其任务规划能力，支持动态打断与任务追加，并展示了上下文自动瘦身机制以优化 Token 消耗。此外，还涵盖了飞书集成配置及分层持久化记忆系统的使用，旨在帮助用户构建自主演进、懂用户习惯的本地 AI 助理。
介绍基于 Python 开发的 AI 智能体工具 JiuwenClaw 的安装部署与核心功能。通过一行命令即可完成环境搭建与启动。文章详细演示了其任务规划能力，支持动态打断与任务追加，并展示了上下文自动瘦身机制以优化 Token 消耗。此外，还涵盖了飞书集成配置及分层持久化记忆系统的使用，旨在帮助用户构建自主演进、懂用户习惯的本地 AI 助理。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
AI Agent（智能体）的概念目前非常流行，但许多产品要么部署复杂，要么使用体验僵化。本文介绍基于 Python 开发的'JiuwenClaw'工具，旨在展示其如何帮助用户构建自主演进、懂用户习惯的本地 AI 助理。
安装过程非常简单，无需繁琐配置。在终端执行以下命令即可完成从环境创建到启动的全过程：
# 创建名为 JiuwenClaw 的虚拟环境
python -m venv jiuwenclaw
# 激活 JiuwenClaw 虚拟环境（Windows）
jiuwenclaw\Scripts\activate
# 激活 JiuwenClaw 虚拟环境（MacOS/Linux）
source jiuwenclaw/bin/activate
# 安装 JiuwenClaw
pip install jiuwenclaw
# 初始化 JiuwenClaw（首次启动）
jiuwenclaw-init
# 启动 JiuwenClaw
jiuwenclaw-start
启动后，一个简洁的本地 Web 界面将出现在浏览器中。接下来需要在配置页面或配置文件中填写 模型 ID、基础服务地址、API 密钥，完成配置后即可使用。
JiuwenClaw 的核心特性之一是'任务规划'。它可以将用户模糊或复杂的请求自动解析为可执行的子任务，并通过内置的待办工具进行系统性记录。
例如，输入'帮我收集竞品苹果和三星公司这周发布的新功能、市场活动，并整理成对比表格'，系统会自动拆解为记录日志、创建待办、搜索信息、整理表格等步骤。
系统支持动态打断与任务追加。在任务执行过程中，用户可以随时插入新需求或调整优先级，智能体会实时刷新待办列表并重新编排任务队列。
JiuwenClaw 提供了一套完整的待办工具包：
借助这套工具，有效解决了智能体在处理长周期、多步骤任务时的目标丢失与执行断层问题。
在长对话场景下，Token 消耗容易失控。JiuwenClaw 具备'上下文瘦身'功能，当上下文长度超过阈值时，系统会自动触发卸载机制，将冗长的网页正文压缩归档，仅保留关键摘要和来源链接，后续需要时可按需加载原文。
核心配置参数包括：
| 参数 | 说明 |
|---|---|
| 触发条件 | 消息数量超过 messages_threshold 或累计 Token 数超出 tokens_threshold |
| 识别超长消息 | 通过 large_message_threshold 界定大消息 |
| 选择性归档 | 利用 offload_message_type 指定压缩角色 |
| 压缩方式 | 采样或摘要提取关键信息，插入索引标记 |
| 保护近期重要对话 | 设置 messages_to_keep 强制保留最近消息 |
通过这一动态上下文管理机制，既保障关键信息不丢失，也排除冗余数据干扰，确保长对话高效连贯。
JiuwenClaw 支持绑定飞书应用，实现移动端远程调用。
im:message 相关权限及 contact:user.employee_id:readonly 权限。
im.message.receive_v1 接收消息事件，可选配置加密策略。
至此，即可在飞书内调用 JiuwenClaw 智能体进行工作。
JiuwenClaw 搭载分层持久化记忆系统，以结构化文件体系为核心载体，实现身份、场景、操作轨迹的全维度长效存储。
系统采用文件分层存储设计：
例如，初始设定角色为'市场运营总监'，系统会自动检索并更新 USER.md，记录用户偏好。随着使用次数增加，智能体会记住之前的内容格式与习惯，实现'越用越懂你'的体验。
JiuwenClaw 是一款基于 Python 开发的本地 AI 智能体工具。它提供了一键安装的顺滑起步、可视化的动态任务管理、基于反馈的自主演进、精打细算的上下文控制以及持久的记忆能力。目前已实现飞书 Channel 等渠道的无缝接入，适合用于复杂代码编写、技术支持、日程与信息流管理等场景，帮助用户构建始终在线、数据自主的专属 AI 助理。