配置 — 聊天命令
The commands.* 块:注册了哪些聊天命令界面,以及谁可以使用它们。
命令(聊天命令处理)¶
{
commands: {
native: "auto", // register native commands when supported
nativeSkills: "auto", // register native skill commands when supported
text: true, // parse /commands in chat messages
bash: false, // allow ! (alias: /bash)
bashForegroundMs: 2000,
config: false, // allow /config
mcp: false, // allow /mcp
plugins: false, // allow /plugins
debug: false, // allow /debug
restart: true, // allow /restart + external SIGUSR2 restart requests
ownerAllowFrom: ["discord:123456789012345678"],
allowFrom: {
"*": ["user1"],
discord: ["user:123"],
},
},
}
命令详情
- 此块配置命令界面。当前内置 + 捆绑命令目录,请参阅 斜杠命令。
- 此页面是配置键参考,而非完整命令目录。频道/插件拥有的命令,例如 QQ Bot 的
/bot-ping/bot-help/bot-logs、LINE 的/card、设备配对的/pair、记忆的/dreaming以及 Talk 的/voice,均记录在其频道/插件页面以及 斜杠命令 中。 - 文本命令必须是带有前导
/的独立消息。 native: "auto"为 Discord/Telegram 启用原生命令,Slack 保持关闭。nativeSkills: "auto"为 Discord/Telegram 启用原生技能命令,Slack 保持关闭。- 按频道覆盖:
channels.discord.commands.native(布尔值或"auto")。对于 Discord,false会在启动期间跳过原生命令注册和清理。 - 使用
channels.<provider>.commands.nativeSkills按频道覆盖原生技能注册。 channels.telegram.customCommands添加额外的 Telegram 机器人菜单条目。bash: true为主机 shell 启用! <cmd>。需要tools.elevated.enabled,并且发送者位于tools.elevated.allowFrom.<channel>中。config: true启用/config(读取/写入openclaw.json)。对于网关chat.send客户端,持久化的/config set|unset写入还需要operator.admin;只读的/config show对普通具有写作用域的操作员客户端仍然可用。mcp: true启用/mcp,用于mcp.servers下由 OpenClaw 管理的 MCP 服务器配置。plugins: true启用/plugins,用于插件发现、安装以及启用/禁用控制。channels.<provider>.configWrites按频道控制配置变更(默认:true)。- 对于多账号频道,
channels.<provider>.accounts.<id>.configWrites还会控制针对该账号的写入(例如/allowlist --config --account <id>或/config set channels.<provider>.accounts.<id>...)。 restart: false禁用/restart和外部SIGUSR2重启请求。默认:true。ownerAllowFrom是仅限所有者的命令和所有者门控频道操作的显式所有者允许列表。它与allowFrom相互独立。allowFrom按提供商设置。设置后,它是命令和指令的唯一授权来源。- 当
allowFrom未设置时,命令授权遵循频道允许列表和配对状态。频道允许列表中的访问组条目会自动解析。 - 命令文档映射:
- 内置 + 捆绑目录:斜杠命令
- 特定频道的命令界面:频道
- QQ Bot 命令:QQ Bot
- 配对命令:配对
- LINE 卡片命令:LINE
- 记忆做梦:做梦
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw