Clawdbot自定义指令需按五步实现：一、通过JSON文件配置trigger（关键词或正则）；二、用response字段写响应，支持{{}}变量插值与\n换行；三、logic字段写JS布尔表达式控制执行条件；四、用patterns数组支持多触发模式；五、启用--debug并发送/reload commands热重载调试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望在Clawdbot中创建自定义指令，但对基础语法和逻辑结构不熟悉，则可能是由于未掌握触发条件、响应格式与变量调用的基本规则。以下是实现自定义指令的步骤：
一、理解指令触发机制
Clawdbot通过匹配用户输入的文本前缀或正则表达式来触发指令，需明确区分关键词匹配与模糊匹配的适用场景。指令生效依赖于配置文件中trigger字段的准确书写，且不区分大小写的默认行为可能影响匹配精度。
1、打开Clawdbot安装目录下的commands/子文件夹。
2、新建一个以.json为扩展名的文件，例如hello.json。
3、在文件中写入标准JSON结构，确保trigger字段为字符串类型，值为纯文本关键词或带^开头锚点的正则表达式。
二、编写基础响应语法
响应内容由response字段定义，支持纯文本、内联变量插值及多行字符串。变量必须使用{{}}包裹，且仅限于Clawdbot预置上下文变量（如{{user.name}}），自定义变量需通过逻辑块注入。
1、在response字段中输入普通文本，例如"你好，{{user.name}}！"。
2、若需换行，使用\n转义符而非回车键，例如"第一行\n第二行"。
3、避免在response中直接写入JavaScript代码，所有动态逻辑必须交由logic字段处理。
三、设置简单条件逻辑
Clawdbot允许通过logic字段嵌入简化的JavaScript表达式，用于判断用户输入、权限等级或时间状态。该字段返回布尔值，决定是否执行response内容，其运行环境为沙箱上下文，禁止访问全局对象如window或document。
1、在指令文件中添加"logic": "user.level >= 5"字段。
2、使用三元运算符构造分支响应，例如"response": "{{user.level >= 5 ? '管理员通道已开启' : '权限不足' }}"。
3、调用内置函数contains()检测关键词，例如"logic": "contains(input, '紧急')"。
四、配置多级响应链
当单一指令需响应不同输入变体时，可利用patterns数组定义多个触发模式，每个元素包含独立的trigger、response与logic，系统按数组顺序逐项匹配，首个通过逻辑校验的项即被采用。
1、将trigger字段替换为patterns数组，数组内每个对象为完整指令单元。
2、为每个数组项指定唯一id字段，便于调试日志追踪。
3、确保各trigger值无交集，否则可能出现非预期的优先级覆盖。
五、启用调试与热重载
Clawdbot支持运行时加载新指令，无需重启服务进程，但需满足文件语法合法且路径注册正确。调试模式下，控制台会输出每次匹配的触发项ID与逻辑计算结果，有助于定位空响应或误匹配问题。
1、启动Clawdbot时添加--debug参数启用详细日志。
2、修改指令文件后，向Bot发送/reload commands指令触发热重载。
3、检查控制台输出中是否出现"Loaded X commands from Y files"确认加载成功。
