neko (Superhq AI)

有人

面向Raspberry Pi Zero 2W和低端VPS的轻量级AI代理运行时。基于文件的内存、MCP工具支持、Telegram集成——所有这些都在一个二进制文件中。

安装

Shell（Linux/macOS）：

curl -fsSL https://raw.githubusercontent.com/superhq-ai/neko/main/install.sh | sh

安装到 ~/.local/bin 默认情况下。覆盖 NEKO_INSTALL_DIR:

NEKO_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/superhq-ai/neko/main/install.sh | sh

来源：

git clone https://github.com/superhq-ai/neko.git
cd neko
cargo build --release
# binary at target/release/neko

快速开始

# Create default config and workspace
neko init

# Or run interactive setup
neko init --interactive

# Edit config (defaults to ~/.neko/config.toml)
neko config edit

# Start the agent gateway
neko start

# Send a test message
neko message "Hello, what can you do?"

配置

Config住在 ~/.neko/config.toml.关键部分：

[gateway]
bind = "127.0.0.1:3000"
workspace = "~/.neko/workspace"

[agent]
model = "gpt-5-mini"
provider = "openai"
max_tokens = 4096
tools = ["read_file", "write_file", "list_files", "exec", "http_request", "memory_write"]

[providers.openai]
api_key = "${OPENAI_API_KEY}"
base_url = "https://api.openai.com"

[tools]
sandbox = false
exec_timeout_secs = 1800

# MCP servers
[mcp.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]

环境变量通过以下方式替换 ${VAR_NAME} 语法。

命令行界面

neko init              Initialize config and workspace
neko init -i           Interactive setup
neko start             Start the gateway server
neko stop              Stop the running gateway
neko status            Show gateway status
neko logs [-l N]       Show recent logs
neko message     Send a message to the agent
neko config show       Print current config
neko config edit       Open config in $EDITOR
neko sessions list     List active sessions
neko sessions clear    Clear all sessions
neko memory list       List memory files
neko memory search Q   Search memory files
neko skills list       List installed skills
neko skills install P  Install a skill from path
neko skills remove N   Remove a skill by name
neko cron list         List all cron jobs
neko cron add 
 Add a scheduled job
neko cron edit     Edit a cron job
neko cron remove   Remove a cron job
neko cron history      Show execution history

特性

兼容OpenResponses的LLM

与任何暴露 POST /v1/responses --OpenAI、Anthropic（通过代理）、Ollama或自托管模型。

基于文件的内存

没有数据库。没有嵌入。没有矢量存储。内存只是markdown文件——可读、可编辑，版本可由人类和代理控制。

该系统使用 两层结构:

• memory/MEMORY.md （核心记忆）——长期事实和用户偏好，始终注入系统提示。上限为2000个字符，当代理需要压缩时会自动发出警告，迫使代理自我管理而不是积累过时的上下文。
• memory/YYYY-MM-DD.md （每日日志）——短暂的会话记录。今天和昨天的日志会自动加载，为代理提供了一个滚动的两天窗口，显示最近的上下文，而不会无限增长。
• **memory/recall/*.md** （回忆）-过去的对话，自动记录。可通过以下方式搜索 memory_search 当代理需要进一步回溯时，支持正则表达式。

代理通过三个工具管理自己的内存：

• memory_write --写入或附加到任何内存文件
• memory_replace --手术查找和替换以更新事实（空替换=删除）
• memory_search --使用正则表达式支持在所有内存文件中进行不区分大小写的搜索

这意味着代理积极维护自己的知识库——纠正过时的事实，将短暂的笔记提升到长期记忆中，并在上下文膨胀时进行压缩。所有这些都发生在纯文本文件中，你可以 cat, grep，或者使用git。

MCP工具支持

通过以下方式连接外部工具 模型上下文协议 stdio传输。工具会自动被发现并在代理的工具注册表中注册。

技能

安装 AgentSkills.io 网站-兼容的技能 SKILL.md 使用YAML frontmatter的文件。技能使用渐进式披露——元数据始终处于上下文中，激活时加载全文。

电报

启用Telegram频道通过Telegram机器人与代理进行交互：

[channels.telegram]
enabled = true
bot_token = "${TELEGRAM_BOT_TOKEN}"
allowed_users = [123456789]

时钟守护作业

安排代理自主执行的重复或一次性任务。结果被传递回发起渠道（电报、HTTP等）。

# Add a recurring job — every day at 9am
neko cron add "summarize yesterday's news" --schedule "0 0 9 * * *" --name morning-digest

# One-shot job
neko cron add "remind me to call the dentist" --at "2026-02-17 09:00"

# List jobs
neko cron list

# Announce results to a Telegram chat
neko cron edit morning-digest --announce "telegram:123456"

# View execution history
neko cron history --lines 10

代理还可以通过以下方式自行创建cron作业 cron_manage 工具——当Telegram上的用户说“每天早上9点提醒我”时，代理会创建作业并自动将结果路由回该聊天。无需手动接线。

工作存储在 workspace/cron/jobs.json 历史在 workspace/cron/history.jsonl调度器每15秒执行一次，故障时呈指数级回退（30秒）→ 1m → 5m → 15m → 60m帽）。

沙盒Python

内置Python解释器 蒙蒂 用于通过可配置内存和递归限制安全执行代码。

支持的平台

许可证

麻省理工学院