技能
实用工具 官方

Customize — 自定义

添加新功能或修改 NanoClaw 的行为。一个交互式技能,根据你的描述进行构建。

功能特性

  • 交互式技能,询问你想构建什么
  • 添加新的消息频道、触发器或集成
  • 修改路由器、助手行为或部署配置
  • 理解 NanoClaw 的架构并安全地进行修改
  • 遵循现有的代码模式和规范

前置条件

  • 已安装并运行 NanoClaw

安装

/customize

工作原理

/customize 技能是 NanoClaw 内置的自我修改方式。你不需要手动编辑源文件,只需用自然语言描述你的需求,Claude Code 就会找出需要修改的文件及修改方式。

该技能遵循四步工作流程:理解你的需求、规划变更、实施修改、测试确保一切正常。在每一步中,它都会解释正在做什么,并在做出更改前征求你的确认。

你可以自定义什么

该技能理解 NanoClaw 的架构,知道哪些文件负责什么功能。以下是最常见的自定义类型:

添加新的输入频道。 如果你想连接一个尚无专用技能的消息平台,/customize 可以从零构建频道适配器。它遵循 src/types.ts 中的 Channel 接口,并将新频道接入轮询循环。

添加 MCP 集成。 NanoClaw 代理在容器内运行,可以使用 MCP(Model Context Protocol)服务器来访问工具。如果你希望代理能够访问新工具——数据库、文件系统、API——该技能会配置 MCP 服务器并将其挂载到容器中。

更改助手行为。 NanoClaw 中每个群组都有自己的 CLAUDE.md 记忆文件,用于塑造代理的行为方式。该技能可以修改这些指令、更改系统提示词、调整路由器如何决定响应哪些消息,或改变代理的个性。

添加新命令。 如果你希望 NanoClaw 对特定的触发词或模式做出与普通消息不同的响应,该技能可以向路由器添加命令处理器。

更改部署方式。 该技能可以修改 NanoClaw 的运行方式——更改服务配置、调整并发限制、修改容器设置或更新环境变量。

关键文件

该技能了解 NanoClaw 代码库中每个文件的用途。最常被修改的文件包括:

  • src/index.ts — 主编排器,负责轮询消息和启动容器。
  • src/channels/ — 各个频道适配器(WhatsApp、Telegram、Slack、Discord)。
  • src/router.ts — 决定哪些消息应该触发代理。
  • src/config.ts — 环境变量和配置。
  • src/ipc.ts — 处理容器与宿主机之间的通信。
  • groups/CLAUDE.md — 代理的记忆和行为指令。

自定义完成后

完成修改后,该技能会重新构建 NanoClaw 并重启后台服务,使更改立即生效。如果构建失败,它会回滚并解释问题原因。

使用技巧

  • 描述需求时要具体。“让代理用西班牙语回复”比”更改语言”效果更好。
  • 该技能会保留现有功能。如果你要求添加 Telegram,不会影响你已有的 WhatsApp 配置。
  • 你可以连续进行多次自定义。多次运行 /customize 来逐步构建你想要的行为。
  • 对于常见的频道添加,专用技能(如 /add-telegram/add-slack 等)更加全面。对于没有专用技能的需求,请使用 /customize