跳转至

配置 — 聊天命令

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