配置 — 聊天命令
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对普通具有写入范围的 operator 客户端仍可用。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
- 记忆 Dreaming:Dreaming
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw