一、安装与启动
JiuwenClaw 是一款基于 Python 开发的 AI 智能体工具，支持本地部署。安装过程简单，无需复杂配置。
- 创建虚拟环境
python -m venv jiuwenclaw
- 激活虚拟环境（Windows）
jiuwenclaw\Scripts\activate
- 激活虚拟环境（MacOS/Linux）
source jiuwenclaw/bin/activate
- 安装 JiuwenClaw
pip install jiuwenclaw
- 初始化并启动
jiuwenclaw-init
jiuwenclaw-start
启动后，本地 Web 界面将自动打开。在配置页面填写模型 ID、基础服务地址及 API 密钥即可开始使用。
二、任务规划与管理
JiuwenClaw 具备任务拆解与动态规划能力，适合处理多步骤复杂任务。
场景演示： 用户指令：'帮我收集竞品苹果和三星公司这周发布的新功能、市场活动，并整理成对比表格。'
系统自动执行流程：
- 记录任务到 memory 日志。
- 创建待办任务追踪进度。
- 使用搜索工具收集信息。
- 整理输出对比表格。
动态打断与追加： 在执行过程中，用户可实时插入新需求。例如添加'竞品 D'并提高优先级，系统会自动重新编排任务队列。
核心待办工具包：
todo_create：创建新任务todo_remove：删除无效任务todo_insert：插入新任务todo_list：查看全局进度todo_complete：标记完成
该机制解决了长周期任务中的目标丢失问题，确保人机协作流畅。
三、上下文管理与优化
针对长对话 Token 消耗问题，JiuwenClaw 提供上下文瘦身机制。
当累计 Token 数超出阈值（默认 20000）时，系统自动触发压缩归档，仅保留关键摘要和来源链接，后续可按需加载原文。这有效降低了成本并保持了对话流畅度。
核心配置参数：
| 参数 | 说明 |
|---|---|
| 触发条件 | 消息数量或累计 Token 数超过阈值 |
| 识别超长消息 | 通过 large_message_threshold 界定 |
| 选择性归档 | 指定角色消息进行压缩 |
| 压缩方式 | 采样或摘要提取关键信息 |
| 保护近期对话 | 强制保留最近若干条消息 |
四、飞书集成
支持绑定飞书应用，实现移动端远程调用。
- 创建飞书自建应用，获取 App ID 与 App Secret。
- 添加机器人能力，配置事件订阅（如
im.message.receive_v1）。 - 开通必要权限（如
im:message）。 - 在 JiuwenClaw 前端服务中开启'频道 - 飞书'开关并填入凭证。
配置完成后，可通过飞书群聊直接发送指令控制智能体。
五、记忆系统
采用分层持久化记忆系统，数据落地本地文件系统：
- 稳定身份层：存储核心身份、专属称呼。
- 长期背景层：沉淀角色设定、跨会话背景。
- 动态轨迹层：按日记录交互轨迹。
系统主动捕捉关键决策与重要事项，随使用持续迭代，实现'越用越懂你'。
六、总结
JiuwenClaw 通过一键安装、可视化任务管理、上下文优化、多端集成及持久化记忆等特性，提供了自主演进且可控的 AI 助理体验。适用于代码编写、技术支持、日程管理及信息流管理等场景。
