跳转至

配置 — 聊天命令

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