一、前言
AI Agent（智能体）的概念非常火，但很多产品要么部署复杂，要么用起来像个死板的'工具人'。基于 Python 开发的 JiuwenClaw 宣称能'懂你所想，自主演进'，适合需要本地化部署和任务规划的场景。
二、安装与启动
安装过程非常简单，无需复杂的依赖配置。在终端执行以下命令即可完成从创建虚拟环境到启动的全过程：
# 创建名为 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 密钥（这些信息需根据你使用的 AI 模型平台获取），完成配置后即可使用。
三、任务规划与管理
JiuwenClaw 支持将用户模糊或复杂的请求自动解析为可执行的子任务，并通过内置的待办工具进行系统性记录。执行过程中，智能体每完成一个子任务，都会实时更新状态。
例如，输入'帮我收集竞品苹果和三星公司这周发布的新功能、市场活动，并整理成对比表格'，它会将任务拆解为'记录这个任务到 memory 日志'、'创建 todo 任务来追踪'、'使用搜索工具收集信息'、'整理成对比表格'。
动态打断与任务追加
JiuwenClaw 支持用户动态干预——无论是追加新需求，还是在现有任务序列中插入紧急事项，均可灵活响应。例如在搜索时，突然想起要增加竞品 D，指令刚落，待办列表会实时刷新，竞品 D 的任务被插入到最前，原任务自动后移。
JiuwenClaw 提供了一套完整的待办工具包：
- todo_create：创建新任务，构建初始待办清单
- todo_remove：删除已取消或无效的任务项
- todo_insert：在指定位置插入新任务，适应需求变更
- todo_list：实时查看当前所有待办事项，掌握全局进度
- todo_complete：标记任务完成，推动流程自动前进
借助这套工具，JiuwenClaw 有效解决了智能体在处理长周期、多步骤任务时常见的目标丢失与执行断层问题。
四、上下文管理
在收集大量网页内容时，Token 消耗容易失控。JiuwenClaw 具备'上下文瘦身'功能，当系统检测到 Token 数超出阈值时，会自动触发上下文卸载机制，将冗长的网页正文进行压缩归档，只保留关键摘要和来源链接。
核心配置参数包括：
| 参数 | 说明 |
|---|---|
| 触发条件 | 当消息数量超过 messages_threshold（例如 3 条），或累计 Token 数超出 tokens_threshold（默认 20000）时，系统将自动启动上下文瘦身流程 |
| 识别超长消息 | 通过 large_message_threshold（例如 1000 Token）界定何为'大消息'，系统将优先对这些占用大量资源的消息进行处理 |
| 选择性归档 | 利用 offload_message_type 参数，可指定对某一角色消息进行压缩（例如仅压缩工具返回的冗长数据，保留用户与助手的核心对话） |
| 压缩方式 | 系统将通过采样或摘要的方式提取关键信息，并插入索引标记 [[OFFLOAD:...]]，在压缩内容的同时保留上下文检索能力 |
| 保护近期重要对话 | 可设置 messages_to_keep 强制保留最近若干条消息，或启用 keep_last_round 确保最新一轮的用户 - 助手对话完整保留 |
通过这一动态上下文管理机制，JiuwenClaw 实现了对 AI 上下文的智能调控，既保障关键信息不丢失，也有效排除冗余数据的干扰。
五、多端集成（飞书）
JiuwenClaw 支持绑定飞书，实现远程交互。以下是配置飞书自建应用的基本步骤：
- 创建飞书自建应用：访问飞书开放平台并登录，进入开发者后台，点击创建企业自建应用，填写应用名称、描述并上传图标。
- 添加机器人能力：在应用配置页面，左侧选择添加应用能力，点击机器人下的添加按钮。
- 记录机器人应用凭证：进入飞书机器人管理后台，记录 App ID 与 App Secret 供后续配置使用。
- 配置权限：左侧选择权限管理 -> API 权限，搜索并开通
im:message相关权限及contact:user.employee_id:readonly等关键权限。 - 配置事件订阅：左侧选择事件与回调，添加
im.message.receive_v1（接收消息事件）。如果启用了加密，需要保存 Encrypt Key。 - 发布应用：左侧选择版本管理与发布，点击创建版本，填写版本号并提交审核。
- 在群聊中添加机器人：打开飞书客户端，进入群组，点击群设置 -> 群机器人 -> 添加机器人，搜索应用名称并添加。
- 配置飞书 Channel：启动前端服务后，在'频道 - 飞书'中打开 Enable 开关并配置 App ID 与 App Secret。
完成上述步骤后，即可在飞书里面调用 JiuwenClaw 智能体进行工作。
六、记忆系统
JiuwenClaw 搭载分层持久化记忆系统，以结构化文件体系为核心载体，实现身份、场景、操作轨迹的全维度长效存储与智能检索。
系统采用文件分层存储设计，所有记忆数据落地本地文件系统：
- 稳定身份层：存储核心身份、专属称呼等固定信息；
- 长期背景层：沉淀角色设定、核心关系等跨会话背景；
- 动态轨迹层：按日记录交互轨迹、临时关键信息。
交互过程中，系统会主动捕捉并记录关键决策、专属称呼、重要事项等内容，通过后台周期性维护整理，让记忆随使用持续沉淀、动态迭代。例如设定角色为'市场运营总监'，系统会自动检索并更新 USER.md，记录用户希望以该角色协助他们。
七、总结
JiuwenClaw 是一个具有潜力的智能体工具。从一键安装的顺滑起步，到可视化的动态任务管理，再到基于反馈的自主演进，以及精打细算的上下文控制、懂你的浏览器操控和持久的记忆能力，每一个特性都精准地落在了用户的实际痛点上。目前已实现鸿蒙小艺、飞书 Channel 的无缝接入，并将持续拓展至更多元平台。
