OpenClaw 命令大全以及使用指南
基于 OpenClaw 2026.2.25 版本整理，涵盖 40+ 顶级命令、聊天斜杠命令及常见问题排查。
一、OpenClaw 简介
OpenClaw 是一款开源的个人 AI 助手框架，2026 年初开源后迅速成为最受关注的 AI Agent 框架之一。与依赖 Web 界面或桌面应用的同类工具不同，OpenClaw 从设计之初就以 CLI（命令行）为主要入口，天然适合与 DevOps 工具链、Shell 脚本和自动化调度集成。
核心特性：
- 40+ 顶级命令，覆盖 Gateway、模型、频道、Skills、Hooks、Plugins 等
- 20+ 通信频道：Telegram、Discord、Slack、WhatsApp、Signal、飞书等
- 100+ 子命令，完整的终端操作能力
- 内置浏览器自动化、定时任务、语义记忆搜索
二、安装与初始化
2.1 安装
bash
# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex
# Windows CMD
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd2.2 验证安装
bash
# 查看版本（注意：没有 openclaw version 命令，必须用 --version）
openclaw --version
# 输出: 2026.2.25
# 查看所有命令帮助
openclaw --help2.3 首次初始化
bash
# 交互式配置向导（推荐新手使用）
openclaw configure
# 健康检查，确认环境就绪
openclaw doctor2.4 更新与卸载
bash
# 更新到最新稳定版
openclaw update
# 切换更新频道（stable/beta/dev）
openclaw update --channel beta
# 预览更新内容（不实际执行）
openclaw update --dry-run
# 更新后不自动重启 Gateway
openclaw update --no-restart
# 卸载 Gateway 服务和本地数据（CLI 保留）
openclaw uninstall
# 完全卸载（含配置、状态、工作空间）
openclaw uninstall --all --yes
# 重置本地配置（保留 CLI）
openclaw reset三、全局标志（Global Flags）
任何命令都可以附加以下全局标志：
| 标志 | 说明 |
|---|---|
--help / -h |
显示帮助信息 |
--version / -V |
显示版本号 |
--log-level <level> |
全局日志级别：silent/fatal/error/warn/info/debug/trace |
--no-color |
禁用 ANSI 颜色（适合 CI 管道） |
--dev |
使用开发环境，隔离状态到 ~/.openclaw-dev |
--profile <name> |
使用命名配置文件，隔离状态 |
四、Gateway 管理（核心服务）
Gateway 是 OpenClaw 的心脏，是一个 WebSocket 服务，负责接收消息、调度 Agent、管理会话。默认监听 ws://127.0.0.1:18789。
4.1 启动与运行
bash
# 前台运行（Ctrl+C 停止，适合调试）
openclaw gateway
# 指定端口
openclaw gateway --port 18790
# 绑定模式
openclaw gateway --bind loopback # 仅本机（默认，最安全）
openclaw gateway --bind lan # 局域网可访问
openclaw gateway --bind tailnet # Tailscale 网络
# 强制启动（杀掉占用端口的进程）
openclaw gateway --force
# 设置认证模式
openclaw gateway --auth token --token "your-secret-token"
openclaw gateway --auth password --password "your-password"
# Tailscale 暴露
openclaw gateway --tailscale serve # 内网暴露
openclaw gateway --tailscale funnel # 公网暴露
# 详细日志模式
openclaw gateway --verbose4.2 服务管理（持久化）
bash
# 安装为系统服务（launchd/systemd/schtasks）
openclaw gateway install
# 启动 / 停止 / 重启
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
# 卸载系统服务
openclaw gateway uninstall
# 查看服务状态
openclaw gateway statusWindows 注意：
openclaw gateway install需要管理员权限（底层使用 schtasks），非管理员环境请用前台模式。
4.3 状态查询与日志
bash
# 查看完整状态
openclaw gateway status
# 健康检查
openclaw gateway health
# 探测 Gateway 可达性
openclaw gateway probe
# 发现局域网/广域网上的 Gateway
openclaw gateway discover
# 调用 Gateway RPC 方法
openclaw gateway call health
# 查看用量成本
openclaw gateway usage-cost
# 查看日志
openclaw logs
openclaw logs --follow # 实时跟踪
openclaw logs --limit 100 # 限制行数
openclaw logs --json # JSON 格式五、配置管理
配置文件位于 ~/.openclaw/openclaw.json，使用 JSON5 格式（支持注释和尾逗号）。
bash
# 获取配置值（点路径语法）
openclaw config get gateway.port
# 输出: 18789
# 设置配置值
openclaw config set gateway.port 18790
openclaw config set gateway.bind loopback
# 删除配置项
openclaw config unset gateway.tailscale
# 交互式配置向导
openclaw configure
openclaw configure --section model # 仅配置模型部分
openclaw configure --section web # 仅配置 Web 部分六、模型管理
6.1 查看与设置模型
bash
# 列出已配置的模型
openclaw models list
# 查看当前模型状态
openclaw models status
openclaw models status --json # JSON 格式
# 设置默认模型
openclaw models set qwen-portal/coder-model
openclaw models set qwen # 使用别名
# 设置图像模型
openclaw models set-image qwen-portal/vision-model6.2 模型认证
bash
# 交互式认证向导（引导完成 OAuth 或 Token 设置）
openclaw models auth add
# 手动粘贴 Token
openclaw models auth paste-token
# 通过 CLI 设置 Token
openclaw models auth setup-token
# 管理认证顺序
openclaw models auth order6.3 别名与回退
bash
# 管理模型别名
openclaw models aliases
# 管理回退链（主模型不可用时自动切换）
openclaw models fallbacks
# 管理图像模型回退
openclaw models image-fallbacks
# 扫描 OpenRouter 免费模型
openclaw models scan支持的模型提供商：OpenAI、Anthropic（Claude）、Google（Gemini）、OpenRouter、DeepSeek、Mistral、Groq 等。
七、频道管理（Channels）
OpenClaw 支持 20+ 通信频道：Telegram、WhatsApp、Discord、Slack、Signal、iMessage、IRC、飞书、LINE 等。
7.1 添加频道
bash
# 添加 Telegram Bot
openclaw channels add --channel telegram --token "123456:ABC..."
# 添加 Discord Bot
openclaw channels add --channel discord --token "MTIz..."
# 添加 Slack App
openclaw channels add --channel slack --bot-token "xoxb-..." --app-token "xapp-..."
# 添加 WhatsApp（需要扫码登录）
openclaw channels login --channel whatsapp
# 添加 Matrix
openclaw channels add --channel matrix --homeserver "https://matrix.org" --user-id "@user:matrix.org" --access-token "..."
# 添加 Signal
openclaw channels add --channel signal --signal-number "+886..."
# 添加多账号（指定 account ID）
openclaw channels add --channel telegram --account work --token "..."7.2 管理频道
bash
# 列出所有频道
openclaw channels list
# 查看频道连接状态（含 Gateway 探测）
openclaw channels status
openclaw channels status --probe
# 查看频道日志
openclaw channels logs
# 查看频道支持的功能
openclaw channels capabilities
# 移除频道
openclaw channels remove --channel telegram
# 登出频道
openclaw channels logout --channel whatsapp7.3 DM 配对
bash
# 查看待配对请求
openclaw pairing
# 批准配对
openclaw pairing approve telegram WR8XRQQA八、Skills（技能插件）
Skills 是 OpenClaw 的功能扩展机制，每个 Skill 定义 AI Agent 可以执行的特定能力。
bash
# 列出所有 Skills
openclaw skills list
# 检查 Skills 就绪状态
openclaw skills check
# 查看某个 Skill 详情
openclaw skills info coding-agent常用内置 Skills：
| Skill | 说明 | 依赖 |
|---|---|---|
| weather | 天气查询 | curl |
| github | GitHub 仓库操作 | gh CLI |
| coding-agent | 代码辅助 | 无 |
| himalaya | 邮件收发 | himalaya CLI + IMAP |
| openai-whisper-api | 语音转文字 | OPENAI_API_KEY |
| session-logs | 搜索历史对话 | jq + rg |
| summarize | 网页/视频摘要 | summarize CLI |
九、Hooks（事件钩子）
Hooks 是 OpenClaw 的事件驱动自动化机制，特定事件触发时自动执行预定义操作。
bash
# 列出所有 Hooks
openclaw hooks list
# 查看某个 Hook 详情
openclaw hooks info session-memory
# 检查 Hooks 就绪状态
openclaw hooks check
# 启用 / 禁用 Hook
openclaw hooks enable session-memory
openclaw hooks disable command-logger
# 安装 Hook 包
openclaw hooks install ./my-hook-pack
openclaw hooks install some-npm-hook-package
# 更新已安装的 Hooks
openclaw hooks update内置 Hooks：boot-md（启动时运行 BOOT.md）、session-memory（/new 或 /reset 时保存上下文）、command-logger（记录所有命令事件）。
十、Plugins（插件管理）
bash
# 列出所有插件
openclaw plugins list
# 查看插件详情
openclaw plugins info some-plugin
# 安装插件
openclaw plugins install ./my-plugin
openclaw plugins install some-npm-plugin
# 启用 / 禁用插件
openclaw plugins enable some-plugin
openclaw plugins disable some-plugin
# 诊断插件加载问题
openclaw plugins doctor十一、Agents（代理管理）
Agents 是 OpenClaw 的隔离执行单元，每个 Agent 有独立的工作空间、认证配置和路由规则。
bash
# 列出所有 Agent
openclaw agents list
# 添加隔离 Agent
openclaw agents add work
# 设置 Agent 身份
openclaw agents set-identity work --name "Work Bot"
# 删除 Agent
openclaw agents delete work终端直接对话
bash
# 基础对话
openclaw agent --agent main --message "今天天气怎么样？"
# 指定会话 ID 继续对话
openclaw agent --session-id 1234 --message "继续上次的话题"
# 指定思考级别
openclaw agent --message "分析代码性能" --thinking medium
# 对话结果发送到 Telegram
openclaw agent --message "生成周报" --deliver --channel telegram --reply-to "@mychat"十二、会话管理（Sessions）
bash
# 列出所有会话
openclaw sessions
# 只看最近 2 小时活跃的会话
openclaw sessions --active 120
# 聚合所有 Agent 的会话
openclaw sessions --all-agents
# JSON 格式输出
openclaw sessions --json十三、记忆系统（Memory）
OpenClaw 内置语义记忆搜索，可以从历史对话和笔记中检索信息。
bash
# 查看记忆索引状态
openclaw memory status
# 重建索引
openclaw memory index
openclaw memory index --force
# 语义搜索
openclaw memory search --query "服务器配置"记忆文件结构：
MEMORY.md--- 长期记忆（手动维护）memory/YYYY-MM-DD.md--- 每日笔记（自动/手动）
十四、定时任务（Cron）
让 AI 助手定时执行任务。
bash
# 查看调度器状态
openclaw cron status
# 列出所有定时任务
openclaw cron list
# 添加定时任务（交互式）
openclaw cron add
# 手动触发任务
openclaw cron run <job-id>
# 启用 / 禁用任务
openclaw cron enable <job-id>
openclaw cron disable <job-id>
# 编辑任务
openclaw cron edit <job-id>
# 查看运行历史
openclaw cron runs <job-id>常见用例：每天 9 点播报天气、每小时检查新邮件、每周一生成周报。
十五、浏览器自动化（Browser）
OpenClaw 可以控制无头浏览器，实现网页自动化操作。
bash
# 查看状态 / 启动
openclaw browser status
openclaw browser start
# 打开网页
openclaw browser open https://example.com
# 列出标签页
openclaw browser tabs
# 截图
openclaw browser screenshot
openclaw browser screenshot --full-page
# 获取页面快照（AI 可读的结构化格式）
openclaw browser snapshot
# 点击元素（通过 ref 编号）
openclaw browser click 12
# 输入文字
openclaw browser type 23 "hello" --submit
# 按键
openclaw browser press Enter
# 导航
openclaw browser navigate https://google.com十六、多设备联动（Nodes）
bash
# 查看已配对设备
openclaw nodes status
# 查看节点能力
openclaw nodes describe <node-id>
# 发送通知
openclaw nodes notify --node mac --body "任务完成！"
# 远程拍照
openclaw nodes camera --node iphone --facing back
# 获取设备位置
openclaw nodes location --node iphone
# 远程执行命令
openclaw nodes run --node mac -- "ls -la ~/Desktop"十七、诊断与排查
17.1 openclaw doctor（最重要的诊断命令）
bash
# 运行环境诊断
openclaw doctor
# 自动修复
openclaw doctor --fix
# 深度扫描（含系统服务）
openclaw doctor --deep
# 生成 Gateway Token
openclaw doctor --generate-gateway-token
# 非交互模式
openclaw doctor --non-interactive17.2 安全审计
bash
# 本地安全审计
openclaw security audit
# 深度审计（含 Gateway 探测）
openclaw security audit --deep
# 自动修复安全问题
openclaw security audit --fix17.3 其他实用命令
bash
# 查看整体状态
openclaw status
openclaw status --all
openclaw status --deep
# 打开 Web 控制台
openclaw dashboard
openclaw dashboard --no-open
# 打开终端 TUI
openclaw tui十八、聊天斜杠命令
在聊天窗口（Telegram、Discord、Slack、WhatsApp 等）中使用的命令。
18.1 基础命令
| 命令 | 说明 | 示例 |
|---|---|---|
/new |
重置会话，清空历史 | /new |
/new <model> |
重置并切换模型 | /new claude-sonnet-4-20250514 |
/status |
查看会话状态、Token、成本 | /status |
/help |
查看所有斜杠命令 | /help |
/commands |
查看可用命令列表 | /commands |
18.2 模型与上下文管理
bash
# 切换模型
/model deepseek/deepseek-chat
# 列出可用模型
/models
# 查看当前模型状态
/model-status
# 压缩上下文（减少 Token 消耗）
/compact
/compact 保留代码相关的讨论，其他可以简化
# 查看用量
/usage off # 关闭显示
/usage tokens # 仅显示 Token 数
/usage full # 显示完整用量
/usage cost # 显示成本统计
# 查看上下文详情
/context
/context list # 列出上下文组件
/context detail # 详细 Token 分布
/context json # JSON 格式18.3 执行控制与安全
bash
# 查看当前执行设置
/exec
# 设置安全策略
/exec host=sandbox security=allowlist ask=always
# 批准待执行操作
/approve <操作ID> allow-once # 仅允许本次
/approve <操作ID> allow-always # 永久允许
/approve <操作ID> deny # 拒绝
# 权限模式总开关
/elevated on # 开启提升权限
/elevated off # 关闭提升权限/exec 参数说明：
| 参数 | 选项 | 说明 |
|---|---|---|
host |
sandbox |
Docker 沙箱执行（推荐） |
gateway |
网关主机执行 | |
node |
配对节点执行 | |
security |
deny |
拒绝所有命令 |
allowlist |
仅允许白名单命令 | |
full |
允许所有命令（谨慎） | |
ask |
off |
不询问，按策略执行 |
on-miss |
不在白名单时询问 | |
always |
每次都询问 |
18.4 语音控制（TTS）
bash
/tts off # 关闭语音
/tts always # 所有回复语音播报
/tts inbound # 仅语音输入时回复语音
/tts tagged # 仅标记内容的语音播报
/tts status # 查看当前状态
/tts provider # 查看或切换 TTS 提供商支持的 TTS 提供商：Edge TTS（免费默认）、OpenAI TTS、ElevenLabs。
18.5 子代理管理
bash
/subagents list # 列出所有子代理
/subagents stop <id> # 停止子代理
/subagents log <id> # 查看日志
/subagents info <id> # 查看详情
/subagents send <id> <message> # 发送消息十九、常见问题排查
19.1 命令名称错误
OpenClaw 的命名规范：顶级名词用复数形式（models、channels、skills、hooks、agents），少数核心命令用单数（gateway、doctor、config）。
bash
# 错误写法
openclaw version # ✗ 不存在
openclaw model list # ✗ 不存在（提示 Did you mean models?）
openclaw channel list # ✗ 不存在
openclaw skill list # ✗ 不存在
# 正确写法
openclaw --version # ✓ 使用标志
openclaw models list # ✓ 复数形式
openclaw channels list # ✓ 复数形式
openclaw skills list # ✓ 复数形式19.2 Gateway 端口被占用
bash
# 方式一：强制启动
openclaw gateway --force
# 方式二：更换端口
openclaw gateway --port 18790
openclaw config set gateway.port 18790
# 方式三：查看占用进程
lsof -i :18789 # macOS/Linux
netstat -ano | findstr :18789 # Windows19.3 配置文件位置速查
| 文件 | 路径 |
|---|---|
| 主配置文件 | ~/.openclaw/openclaw.json |
| Agent 工作空间 | ~/.openclaw/agents/main/ |
| 认证配置 | ~/.openclaw/agents/main/agent/auth-profiles.json |
| Gateway 日志 | /tmp/openclaw/openclaw-YYYY-MM-DD.log |
19.4 遇到问题时
bash
# 完整诊断
openclaw doctor --deep
# 查看版本
openclaw --version
# 查看 Gateway 状态
openclaw gateway status
# 查看健康状态
openclaw gateway health二十、每日核心命令速查表
日常使用掌握以下命令即可满足大部分需求：
bash
# 1. 启动 Gateway
openclaw gateway start
# 2. 查看整体状态
openclaw status
# 3. 管理 Channel
openclaw channels status
# 4. 管理模型
openclaw models status
openclaw models set <model-name>
# 5. 查看 Skills
openclaw skills check
# 6. 定期健康检查
openclaw doctor
# 7. 查看日志
openclaw logs --follow
# 8. 更新 OpenClaw
openclaw update