AN

aisht669/netclaw

部署与 DevOps

本页由 AI 翻译,技术细节请以原文为准。 查看原文

20 stars 质量 43 趋势 10

一款基于 .NET 构建的轻量级 AI 助手,灵感来源于 OpenClaw / PicoClaw / ZeroClaw。

概览

一款基于 .NET 构建的轻量级 AI 助手,灵感来源于 OpenClaw / PicoClaw / ZeroClaw。 - 🪶 : AOT 编译,单文件部署,快速启动 - 🔌 : 云 API + 本地模型(Ollama、vLLM 等) - 🛠️ : 文件读写、目录列表、shell 执行 - 💾 : 身份、个性、长期记忆、用户信息分离 - 🔧 : SKILL.md 格式支持 YAML 前置 - 📢 : QQ、DingTalk、Feishu 消息集成 - 🔒 : 危险命令自动过滤 存储配置、内存、技能等,完全独立于工作目录: 代理实际运行文件的目录。可以在板上设置,也可以临时指定为 -w 参数: 配置文件位于 ~/.netclaw/config.json - 危险命令自动阻塞(rm -rf、格式化、关闭等)- 命令执行超时限制(默认30秒,最多5分钟)

概述(AI 翻译)

中文文档 |英语

一款基于 .NET 构建的轻量级 AI 助手,灵感来源于 OpenClaw / PicoClaw / ZeroClaw。

特色

  • 🪶 轻量级:AOT编译,单文件部署,快速启动
  • 🔌 多LLM支持:云API + 本地模型(Ollama、vLLM等)
  • 🛠️ 内置工具:文件读写、目录列表、shell执行
  • 💾 记忆系统:身份、个性、长期记忆、用户信息分离
  • 🔧 技能系统:支持YAML前置件的 SKILL.md 格式
  • 📢 多渠道:QQ、DingTalk、非书消息集成
  • 🔒 沙盒:危险命令自动过滤

快速启动

要求

  • .NET 10 SDK

安装与运行

命令

指挥 描述
onboard 初始化配置,设置API密钥或本地模型
agent 与AI聊天
status 显示当前配置状态
clear 清晰的对话记录
skill 技能管理
memory 内存管理
gateway 启动消息网关服务器
channel 信道配置管理

特工选项

技能管理

内存管理

消息网关

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

NetClaw

中文文档 | English

A lightweight AI assistant built on .NET, inspired by OpenClaw / PicoClaw / ZeroClaw.

Features

  • 🪶 Lightweight: AOT compiled, single-file deployment, fast startup
  • 🔌 Multi-LLM Support: Cloud APIs + Local models (Ollama, vLLM, etc.)
  • 🛠️ Built-in Tools: File read/write, directory listing, shell execution
  • 💾 Memory System: Identity, personality, long-term memory, user info separated
  • 🔧 Skill System: SKILL.md format with YAML frontmatter support
  • 📢 Multi-Channel: QQ, DingTalk, Feishu message integration
  • 🔒 Sandbox: Dangerous commands auto-filtered

Quick Start

Requirements

  • .NET 10 SDK

Installation & Run

# Initialize configuration
dotnet run --project src/NetClaw -- onboard

# Send a single message
dotnet run --project src/NetClaw -- agent -m "Hello"

# Interactive mode
dotnet run --project src/NetClaw -- agent

Commands

Command Description
onboard Initialize configuration, set API key or local model
agent Chat with AI
status Show current configuration status
clear Clear conversation history
skill Skill management
memory Memory management
gateway Start message gateway server
channel Channel configuration management

Agent Options

-m, --message    Send a single message
-p, --provider   Specify LLM provider (override default)
--model          Specify model (override default)
-w, --workdir    Specify working directory (override default)
-s, --session    Specify session ID

Skill Management

# List all skills
netclaw skill list

# Add a skill
netclaw skill add -n "translate" -d "Translate text"

# Delete a skill
netclaw skill delete -n "translate"

Memory Management

# Show memory content
netclaw memory show -t user      # User info
netclaw memory show -t identity  # Identity settings
netclaw memory show -t soul      # Personality settings
netclaw memory show -t memory    # Long-term memory

# Edit memory content
netclaw memory edit -t user

Message Gateway

# Start gateway (listen on port 8080)
netclaw gateway

# Specify port
netclaw gateway -p 9090

# View channel configuration
netclaw channel list

# Enable a channel
netclaw channel enable -n dingtalk

# Configure channel parameters
netclaw channel config -n dingtalk -k webhook_url -v "https://oapi.dingtalk.com/robot/send?access_token=xxx"

Channel Integration

Supports three messaging platforms:

Channel Protocol Description
QQ OneBot Compatible with NapCat, Lagrange, etc.
DingTalk Webhook Custom bot + Enterprise internal bot
Feishu Webhook Custom bot + Enterprise self-built app

QQ Configuration

# Enable QQ channel
netclaw channel enable -n qq

# Configure OneBot API address
在 GitHub 查看完整 README

推荐工具

换一个关键词,或者移除筛选条件。

安装

npx skillfish add aisht669/netclaw
新手?先看 mcpskill.org 教程 →