OpenClaw 对话过程与命令功能总结基于 OpenClaw 官方文档版本 2026-03-08 同步一、对话过程概述1. 会话管理 (Session Management)会话键 (Session Key): 每个对话有唯一标识直接聊天agent:agentId:mainKey默认main群组/频道聊天各自独立的会话键DM 安全模式: 多用户环境下建议启用dmScope: per-channel-peer隔离不同用户的对话上下文会话存储:网关 (Gateway) 是会话状态的唯一来源存储文件~/.openclaw/agents/agentId/sessions/sessions.json对话记录~/.openclaw/agents/agentId/sessions/SessionId.jsonl2. 上下文压缩 (Compaction)自动压缩: 当会话接近模型上下文窗口限制时自动触发手动压缩: 使用/compact命令强制压缩压缩过程: 将较早的对话总结为紧凑摘要保留近期消息内存刷新: 压缩前自动触发静默回合将持久记忆写入磁盘3. 内存系统 (Memory)日常笔记:memory/YYYY-MM-DD.md每日日志追加模式长期记忆:MEMORY.md仅在主会话中加载内存刷新阈值:contextWindow - reserveTokensFloor - softThresholdTokens二、主要命令列表会话管理命令命令别名功能描述/new/reset开始新的会话可选模型提示/compact [instructions]-手动压缩上下文可附加指令/status-显示当前状态包括提供者用量/配额/context [list|detail|json]-查看上下文详情/export-session [path]/export导出当前会话为HTML会话控制命令命令功能描述/stop立即中止当前运行的任务/restart重启默认启用可配置关闭/dock-telegram切换回复到Telegram/dock-discord切换回复到Discord/dock-slack切换回复到Slack模型与推理控制命令别名参数功能描述/think/thinking,/toff|minimal|low|medium|high|xhigh控制思考级别/verbose/von|full|off控制详细输出/reasoning/reasonon|off|stream控制推理显示/elevated/elevon|off|ask|full控制提升权限/model/modelsname或#切换模型/queue-mode加选项控制队列行为系统与配置命令命令功能描述启用要求/help显示帮助信息默认启用/commands列出可用命令默认启用/whoami显示发送者ID别名/id默认启用/bash command运行主机Shell命令commands.bash: true/config show|get|set|unset持久化配置到磁盘commands.config: true/debug show|set|unset|reset运行时配置覆盖commands.debug: true/allowlist管理允许列表commands.config: true子代理管理命令功能描述/subagents list|kill|log|info|send|steer|spawn管理子代理运行/acp spawn|cancel|steer|close|status|...管理ACP运行时会话/agents列出此会话的线程绑定代理/focus target绑定线程到会话/子代理目标/unfocus移除当前线程绑定/kill id|#|all立即中止一个或所有运行中的子代理/steer id|# message立即引导运行中的子代理技能命令命令功能描述/skill name [input]按名称运行技能原生技能命令每个用户可调用技能都有对应的/命令三、命令系统功能1. 命令类型文本命令 (Text Commands)在聊天消息中以/开头适用于所有平台包括不支持原生命令的平台配置项commands.text默认true原生命令 (Native Commands)在支持的平台注册为原生斜杠命令Discord、Telegram、Slack 支持配置项commands.native默认auto指令 (Directives)控制会话设置/think、/verbose、/reasoning、/elevated、/exec、/model、/queue仅在消息只包含指令时持久化到会话授权发送者才能应用内联快捷方式 (Inline Shortcuts)允许在正常消息中嵌入/help、/commands、/status、/whoami触发后立即运行并从消息中剥离剩余文本继续正常流程2. 权限控制授权来源commands.allowFrom按提供者设置允许列表优先commands.useAccessGroups使用访问组默认true通道允许列表/配对未授权处理命令专用消息静默忽略内联/...标记视为纯文本3. 配置示例{ commands: { native: auto, // 自动注册原生命令 nativeSkills: auto, // 自动注册技能命令 text: true, // 启用文本命令 bash: false, // 禁用bash命令 config: false, // 禁用config命令 debug: false, // 禁用debug命令 restart: false, // 禁用restart命令 useAccessGroups: true, // 使用访问组进行授权 }, }4. 平台特定说明Discord原生命令自动注册语音控制/vc join|leave|status线程绑定需要启用session.threadBindings.enabledTelegram原生命令自动注册会话目标telegram:slash:userIdSlack原生命令需要手动为每个命令创建Slack斜杠命令会话前缀可配置channels.slack.slashCommand.sessionPrefix四、重要注意事项安全建议多用户环境启用安全DM模式dmScope: per-channel-peer敏感命令/bash、/config、/debug需谨慎启用群组设置/reasoning和/verbose可能暴露内部推理建议关闭性能优化自动压缩保持对话在上下文窗口内内存刷新在压缩前保存重要记忆会话维护定期清理旧会话openclaw sessions cleanup使用技巧快速路径允许列表发送者的命令专用消息立即处理绕过队列模型群组提及门控命令专用消息绕过提及要求模型选择使用/model交互式选择器技能调用使用/skill name或原生技能命令