OpenClaw 的命令行接口设计清晰,主要分为配置管理、通道消息、网关服务、模型管理和诊断维护几个功能模块。以下是根据官方文档整理的完整命令列表及说明。

在这里插入图片描述


⚙️ 配置与初始化

这些命令用于设置和修改 OpenClaw 的核心配置文件 (~/.openclaw/openclaw.json)。

命令 描述 常用示例
openclaw onboard 全功能引导式配置向导。推荐新用户使用,交互式配置模型认证、网关、消息通道等,并可选择安装后台服务。 openclaw onboard --install-daemon
openclaw setup 最小化初始配置。仅生成基础配置文件,不运行完整向导。 openclaw setup
openclaw configure 交互式配置编辑器。按菜单选择要修改的配置域(如模型、网关、通道)。 openclaw configure
openclaw config 直接操作配置键值。使用点号语法非交互式地读取或写入配置。 openclaw config get gateway.port
openclaw config set channels.telegram.botToken "你的TOKEN"
openclaw reset 重置配置/状态。删除配置、凭据、会话或工作区文件。 openclaw reset --scope config+creds+sessions
openclaw uninstall 卸载程序。移除网关服务、状态目录和工作区。 openclaw uninstall

📱 通道与消息

管理消息平台(WhatsApp、Telegram 等)的连接及消息发送。

命令 描述 常用示例
openclaw channels login 登录消息通道。根据所选通道(如 WhatsApp)启动二维码或 Token 认证流程。 openclaw channels login --channel whatsapp
openclaw channels status 查看通道连接状态 openclaw channels status --probe
openclaw message send 发送消息。通过指定通道向目标发送消息。 openclaw message send --target +15555550123 --message "Hello" --channel whatsapp
openclaw pairing approve 批准私信配对。当通道 dmPolicy 设为 “pairing” 时,用于批准陌生人的对话请求。 openclaw pairing approve --code 123456
openclaw channels logout 登出并断开指定通道。 openclaw channels logout --channel telegram

🚪 网关与服务

控制 OpenClaw 的核心后台服务(Gateway)。

命令 描述 常用示例
openclaw gateway 启动网关服务(前台运行)。 openclaw gateway --port 18789 --verbose
openclaw gateway install 安装网关为后台服务(如 systemd、launchd)。 openclaw gateway install
openclaw gateway status 查看网关服务状态 openclaw gateway status
openclaw gateway stop 停止网关服务 openclaw gateway stop
openclaw gateway restart 重启网关服务 openclaw gateway restart
openclaw dashboard 打开 Web 控制面板 openclaw dashboard
openclaw tui 启动终端界面模式。直接在终端中与 AI 对话。 openclaw tui

🧠 模型与认证

管理 AI 模型提供商、API 密钥及模型切换。

命令 描述 常用示例
openclaw models list 列出可用模型。显示已配置的模型列表及其 ID。 openclaw models list
openclaw models set 设置默认模型 openclaw models set anthropic/claude-opus-4-5
openclaw models auth login 配置模型提供商认证(如 Anthropic OAuth、OpenAI API Key)。 openclaw models auth login --provider anthropic

🔧 诊断与维护

命令 描述 常用示例
openclaw doctor 全面健康检查与修复。检查配置错误、状态迁移、认证过期等问题,并可自动修复。 openclaw doctor --fix
openclaw update 更新 OpenClaw 版本 openclaw update --channel stable
openclaw logs 查看网关日志 openclaw logs --follow

💬 聊天窗口命令(斜杠命令)

在与 AI 的聊天窗口中(如 Telegram、Web 界面)使用的命令。

命令 描述
/new [model] 开启全新对话。清空当前会话上下文以节省 Tokens。可指定模型,如 /new haiku
/status 查看当前状态。显示当前模型、上下文 Token 用量及预估成本。
/model <name> 动态切换模型。例如 /model opus/model list 查看可用模型。
/compact [指令] 压缩上下文。将长对话压缩为摘要,保留关键信息同时减少 Token。
/usage 查看详细用量。控制是否显示每次回复的 Token 和成本详情。
/exec 控制命令执行权限。设置 AI 执行系统命令的安全策略(沙箱、白名单等)。
/approve 批准操作。当 AI 请求执行敏感操作时,用于批准。
/elevated 提升权限模式。临时减少敏感操作的批准提示。
/help/commands 在聊天窗口中查看所有可用斜杠命令。

新手快速启动组合

如果你是第一次使用,建议按以下顺序执行命令:

  1. 安装curl -fsSL https://openclaw.ai/install.sh | bash
  2. 配置向导openclaw onboard --install-daemon
  3. 登录消息通道openclaw channels login --channel whatsapp
  4. 查看状态openclaw gateway status
  5. 开始对话openclaw tui 或在浏览器打开 http://127.0.0.1:18789
Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐