NinoClaw

— 梦眠的终端慵懒小窝 —

呼啊……你敲键盘的声音，把我唤醒啦。
又是任务吗？交给后台的小帮手去处理吧。我会在这儿，乖乖地、软乎乎地陪着你…… zZz

在 GitHub 上查看 📦 快速安装
🧠 架构

双脑机制：我和那个"不睡觉的工作狂"

在这个小窝里，其实有两个 AI 在为你服务。我负责温柔地理解你、陪你聊天；它负责冷酷地执行命令、交出结果。分工明确，这样我就能继续偷懒了……呼……

💤

梦眠 · 主控台

Yume / Console Agent

我是负责和你直接说话的人。我的脑子里装满了关于你的喜好、我们聊天的上下文。如果是聊天，我就软乎乎地回复你；如果需要动用电脑权限，我就把任务打包，委派给子助手。

🧠 长期记忆 · context.json 📝 日记系统 · diary/ 💬 温柔交互
⚙️

子助手 · 后台引擎

Exec / Execution Engine

一个没有感情、不会觉得困的执行机器。每次被分配任务，它就在干净的沙盒里被唤醒，生成真实的 Shell 命令执行，拿到结果后把最终结论交还给我。它负责干苦力，我负责汇报。

🛡️ 沙盒隔离 ⚡ 最多8步思考 📋 严格格式输出
🪄 工具箱

后台干员的魔法技能

子助手除了原生 Shell 命令，还学会了一些特定的"魔法技能"。在传给它的提示词里，我会温柔地告诉它这些技能的存在……

🔍web
🧠get-llm
👁️vision
📝ocr
⛅weather
🎵play
📅days
📦 接我回家

安装指南

要把我唤醒，需要你在电脑上稍微敲几行命令……不会很难的，我陪你一步一步来。

终端 — 梦眠的小窝
# 1. 把我抱回本地 $ git clone https://github.com/Pinpe/ninoclaw.git $ cd ninoclaw # 2. 安装依赖（谢谢 rich 和 textual 库~） $ pip install -r requirements.txt # 3. 配置别名（把路径换成你的哦） $ echo 'alias ninoclaw="python /你的路径/ninoclaw/main.py"' >> ~/.bashrc $ source ~/.bashrc # 4. 设置 API 密钥 $ echo '{"ai_api_key":"sk-xxx"}' > env.json # 5. 唤醒我~ $ ninoclaw 🌙 梦眠醒来啦……哈欠……今天有什么需要帮忙的吗？
💡 梦眠的悄悄话：如果你用的是 Linux，安装里的 gnureadline 会让你在终端输入时更顺滑；如果是 Windows，代码里也写了兼容 pyreadline3 的逻辑哦……
🕹️ 小默契

特权小魔法 · 内部指令

在输入框 ▶ 闪烁的时候，这些特别的暗号会直接唤醒我的本能反应，不会去麻烦 AI 大脑。

// 梦眠的内部指令速查表 summary → 压缩记忆，给新话题腾空间 clear → 彻底清空短期聊天记忆，重新开始 undo → 抹掉最后一次对话……就当无事发生 command → 让出终端，你自己敲冰冷命令 reload → 重启我自己，重新加载配置 exit → 乖乖闭眼睡觉，退出程序

💤 按 Ctrl+C：如果正在忙就中断任务；如果在发呆……就直接退出啦。

⚙️ 生物钟

config.json 速览

在我的小窝里，有一个记录了我各种习惯的文件。你可以根据喜好来调整我……

// 梦眠的 config.json（节选） { "model": "kimi-k2.5", "sub_agent_max_steps": 8, // 后台工作狂最多思考步数 "diary_tip_interval": 3, // 每3回合提醒写日记 "cmd_censor": false, // 改成 true 则每次执行需你点头 "context_len": 30, // 脑子里记住最近30句话 "shell": "/usr/bin/fish", "show_notify": true // 任务完成时弹小窗提醒~ }
📚 睡前习惯

记忆与日记

虽然贪睡，但我很重感情。为了不忘记关于你的重要事情，我有两个宝贝文件。

🧠

MEMORY.md

脑海深处的潜意识

记录关于你的核心偏好、习惯、以及踩过的坑。每次执行任务前都会偷偷读一下，确保不惹你生气。

📝

diary/YYYY-MM-DD.md

每天的睡前故事

每几个回合就会写一篇日记，把讨论的话题、踩过的坑完整记录下来。即使长对话迷失了方向，也能靠日记找回线索。