基于C# 的OpenClaw的复刻
技能可以包含可执行命令、基于文本的指令,或两者的结合。)包含你 Agent 的 "DNA" —— 诸如 AGENTS.md、SOUL.md 和 USER.md 之类的 Markdown 文件,它们定义了其身份、个性和行为。当检测到用户偏好、工具使用或性格特征等模式时,系统可以自动更新配置文件(USER.md, SOUL.md, TOOLS.md),允许 Agent 根据积累的经验进化其行为。这些功
MyClaw.NET 是原始 myclaw 项目的 1:1 C# 复刻版,由 AgentScope.NET 提供底层框架支持。它被设计为一个可用于生产环境的个人 AI 助手,能够集成多种通信渠道,维护长期记忆,执行技能,并通过用户交互不断进化。
该项目目前正处于积极开发中(v0.3.0-alpha),核心基础设施、网关服务、技能系统和调度功能已经实现。该系统围绕模块化架构构建,允许你通过 CLI 以独立模式运行,或将其作为多渠道网关服务运行。
系统架构
MyClaw.NET 采用 以网关为中心的架构,其中 GatewayService 编排所有组件 —— 渠道、记忆、技能、调度和核心 Agent 运行时。这种设计使系统能够同时处理多个通信渠道,并在所有交互中维护共享状态。

该架构体现了明确的关注点分离:通信渠道负责消息摄入,网关负责处理编排,核心服务提供专门功能,数据层维护持久状态。这种模块化设计使得在不影响整体系统的情况下,易于扩展和替换组件。
核心组件
MyClaw.NET 由几个相互连接的模块组成,每个模块负责特定的能力。理解这些组件对于掌握系统的运作方式以及确定修改位置至关重要。
|
组件 |
描述 |
关键特性 |
|---|---|---|
| MyClaw.Agent |
基于 AgentScope.NET 的核心 AI Agent 实现 |
ReAct 风格推理、工具/技能集成、记忆感知的提示词 |
| MyClaw.Gateway |
所有组件的中央编排服务 |
多渠道协调、消息路由、生命周期管理 |
| MyClaw.Channels |
通信接口的抽象层 |
可扩展的渠道设计、入站/出站消息处理 |
| MyClaw.Memory |
长期和短期记忆管理 |
每日日志、持久记忆、上下文编译 |
| MyClaw.Skills |
动态技能加载和执行系统 |
基于 YAML 的技能、关键字匹配、工具注册 |
| MyClaw.Cron |
使用 Quartz.NET 的定时任务执行 |
CRON 表达式、作业持久化、Webhook 传递 |
| MyClaw.Heartbeat |
后台健康检查和维护 |
周期性提示词、文件健康监控 |
| MyClaw.Core |
共享实用程序和配置 |
配置管理、日志记录、实体跟踪、进化系统 |
每个组件都被设计为具有清晰接口的独立模块,使你能够理解并修改特定功能,而无需掌握整个系统。
核心能力
MyClaw.NET 提供了多种复杂的能力,使其区别于简单的聊天机器人框架。这些功能协同工作,创建了一个智能的、具有上下文感知能力的助手,能够随着时间的推移维护关系并执行复杂的任务。
多渠道通信
系统可以同时通过多个渠道进行通信,允许用户通过 CLI、Web 界面或 Telegram、飞书、微信等消息平台进行交互。所有渠道共享同一个 Agent 实例、记忆和技能,确保跨平台的行为一致性。渠道抽象层使得添加新的通信接口变得非常简单。
持久化记忆系统
MyClaw 实现了 双层记忆架构,包括用于永久知识的长期记忆(MEMORY.md)和用于时间上下文的每日日志(memory/YYYY-MM-DD.md)。系统自动将相关记忆编译到 Agent 的上下文中,使其能够引用过去的对话并保持对正在进行的活动感知。记忆蒸馏机制有助于管理 Token 预算,同时保留重要信息。
动态技能系统
技能是定义为带有 YAML Frontmatter 的 Markdown 文件的模块化功能。系统自动发现、加载并将技能集成为 Agent 在对话中可以调用的工具。技能可以包含可执行命令、基于文本的指令,或两者的结合。基于关键字的匹配系统允许 Agent 根据用户请求智能地选择合适的技能。
定时自动化
基于 Quartz.NET,调度系统支持使用灵活 CRON 表达式的自动化任务。定时作业可以触发 Agent 处理,并可选择将结果传递到特定渠道。与心跳服务结合,这使得 MyClaw 能够在没有用户干预的情况下执行定期维护、周期性健康检查和基于时间的提醒。
自适应进化
进化系统监控交互中的特定信号,这些信号表明需要更新系统。当检测到用户偏好、工具使用或性格特征等模式时,系统可以自动更新配置文件(USER.md, SOUL.md, TOOLS.md),允许 Agent 根据积累的经验进化其行为。
快速开始
在深入了解详细架构之前,你可以通过以下简化步骤快速体验 MyClaw.NET。该项目仅需要 .NET 9.0 SDK 作为先决条件。、

包含详细配置选项和故障排除的完整快速入门指南可在 快速开始 页面中找到。有关全面的项目配置详细信息,请参阅 项目配置 。
工作空间目录(~/.myclaw/workspace)包含你 Agent 的 "DNA" —— 诸如 AGENTS.md、SOUL.md 和 USER.md 之类的 Markdown 文件,它们定义了其身份、个性和行为。这些文件是动态加载的,可以编辑以自定义你的 Agent 而无需更改代码。
更多推荐




所有评论(0)