本页内容

本页内容

网关

配置——聊天命令

commands.* 块:注册了哪些聊天命令界面以及谁可以使用它们。

Commands(聊天命令处理)

json5
{  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"],    },  },}
命令详情
  • 此区块用于配置命令入口。有关当前内置命令和捆绑命令的目录,请参阅 Slash Commands。
  • 此页面是配置密钥参考,而不是完整的命令目录。 Channel/plugin-owned 命令,例如 QQ Bot /bot-ping /bot-help /bot-logs、LINE /card、设备对 /pair、内存 /dreaming 和 Talk /voice 记录在其 channel/plugin 页面以及 Slash Commands 中。
  • 文本命令必须是带有前导 / 的独立消息。
  • 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 bot 菜单项。
  • bash: true 会为主机 shell 启用 ! <cmd>。需要启用 tools.elevated.enabled,且发送者必须位于 tools.elevated.allowFrom.<channel> 中。
  • config: true 启用 /config (reads/writes openclaw.json)。对于网关chat.send客户端,持久/config set|unset写入也需要operator.admin;只读 /config show 对普通写范围操作员客户端仍然可用。
  • mcp: true 为 mcp.servers 下的 OpenClaw- 托管 MCP 服务器配置启用 /mcp。
  • plugins: true 启用 /plugins 进行插件发现、安装和 enable/disable 控制。
  • 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 是每个提供商的。设置后,它是命令和指令的 only 授权源。
  • 未设置 allowFrom 时,命令授权遵循频道允许列表和配对状态。频道允许列表中的访问组条目会自动解析。
  • 命令文档映射:
  • 内置命令和捆绑命令目录:Slash Commands
  • 频道专属命令入口:Channels
  • QQ Bot 命令:QQ Bot
  • 配对命令:Pairing
  • LINE 卡片命令:LINE
  • 记忆梦想:Dreaming
本页有帮助吗?