成功安装了 OpenClaw，接下来就要真正开始驾驭它了。OpenClaw 的强大不仅在于它的 Web 控制台，更在于背后那套功能清晰的命令行工具和聊天指令。

这份操作手册将为你梳理从日常维护到高效使用的常用命令、核心方法与实用技巧，帮助你从单纯的“使用者”进阶为能够自如操控 AI 助手的“架构师”。

---

第一部分：核心服务与状态诊断 (Gateway & Health)

如果把 OpenClaw 看作一个生命体，网关（Gateway）就是它的心脏，而 doctor 命令则是它的私人医生。掌握这组命令，是保障一切稳定运行的基石。

1.1 gateway 命令：系统的脉搏

gateway 是一个持续运行的后台服务，负责处理所有客户端连接和任务路由。

• openclaw gateway start：启动网关服务。

  • 生产环境部署：建议加上 -d 或 --detach 参数，以守护进程模式在后台运行，关闭终端后服务也不会中断。
  • 临时调试：不加 -d 直接运行，所有实时日志会直接打印在当前窗口，非常适合快速定位错误。
  • 自定义端口：使用 --port <端口号> 参数，例如 openclaw gateway start --port 18800。

• openclaw gateway stop：停止网关服务。

• openclaw gateway restart：重启网关服务。当你修改了配置或机器人状态异常时，首选此命令。

• openclaw gateway status：查看网关的运行状态、进程ID（PID）和运行时长。

• openclaw gateway logs：查看网关日志。

  • openclaw logs follow：强力推荐。实时跟踪日志输出，是排查问题的黄金手段，尤其在配置新功能或遇到 Bug 时，基本都靠它定位。

1.2 doctor 命令：AI的私人医生

doctor 会自动扫描配置文件、检查环境依赖和潜在安全风险。

• openclaw doctor：运行一次全面的健康检查，输出详细的“体检报告”，包含 [OK]、[WARNING] 和 [ERROR] 等状态。
• openclaw doctor --fix：核心技巧。尝试自动修复发现的大多数常见问题（如配置缺失、路径错误等）。遇到奇怪的问题时，先运行这个命令往往能解决一半以上的麻烦。

1.3 维护与升级

• openclaw update：升级 OpenClaw 核心程序到最新版本。
• curl -fsSL https://openclaw.ai/install.sh | bash (macOS/Linux) 或重新运行安装脚本：由于 OpenClaw 更新频繁，重新运行安装脚本是跟上最新功能最简单直接的方式，且不会破坏你已有的配置。
• openclaw reset --scope <范围>：重置配置或状态。可选范围如 config（仅配置）、config+creds+sessions（配置+凭证+会话）等。操作前建议使用 --dry-run 参数预览会删除的内容。

第二部分：配置管理与模型操作 (Configuration & Models)

手动编辑 JSON 配置文件容易出错。CLI 命令提供了一个安全、精准的方式来读写系统的“DNA”。

2.1 config 命令：精准编辑DNA

• openclaw config get <键路径>：获取配置项的值。键路径使用点 . 分隔层级，例如：openclaw config get channels.telegram.enabled。
• openclaw config set <键路径> <值>：设置配置项的值，命令会自动处理数据类型。例如：openclaw config set gateway.port 18790。
• openclaw config path：显示当前配置文件的绝对路径。当你同时管理多个实例或忘记配置位置时，这个命令非常实用。

2.2 models 命令：灵活切换大脑

很多人觉得在 Web 界面添加和切换模型比较繁琐，命令行是更高效的替代方案。

• openclaw models：列出所有当前可用的模型列表。
• openclaw models set <模型标识符>：设置默认使用的模型。例如 openclaw models set openrouter/auto 或 openclaw models set claude-sonnet-4-5。

第三部分：智能体交互与设备管理 (Agent & Devices)

这部分命令涉及与智能体的直接交互以及管理外部设备的连接。

• openclaw tui：启动终端用户界面（TUI）。当你在升级维护、或者浏览器打不开时，可以直接在终端里与你的 AI 助手进行对话，完成配置或测试。
• openclaw message send --to <收件人> --message "<消息内容>"：通过命令行直接向指定联系人发送消息，适合集成到自动化脚本中。
• openclaw agent --message "<指令>" --thinking high：直接向智能体下达指令，并可指定思考强度。
• 设备配对与管理：
  • openclaw devices list：列出所有请求连接到此网关的设备及其状态。
  • openclaw devices approve <requestId> / reject <requestId>：批准或拒绝设备的配对请求。
  • openclaw pairing approve <channel> <code>：在飞书、Telegram 等频道上，用此命令批准来自未知联系人的配对请求。

第四部分：聊天中的“斜杠命令”实战技巧

这是在使用 Telegram、飞书、Discord 等客户端时，与 AI 实时交互最常用到的命令。熟练掌握它们，可以极大提升沟通效率和成本控制能力。

命令	核心用途	实战技巧与场景	示例
/new	开启全新对话	省Token利器。当感觉对话变慢、或准备开始一个全新的独立任务时使用，可以清空历史上下文，大幅减少Token消耗。	/new 或 /new haiku (新建对话并立即切换模型)
/status	查看当前状态	成本监控器。快速了解当前使用的模型、已消耗的Token数量和预估成本。如果上下文使用量超过50%，就该考虑/new了。	/status
/model	动态切换模型	性能/成本平衡器。日常聊天用Haiku省钱，复杂代码用Sonnet，深度推理用Opus，一切都在对话中即时切换。	/model list (列出可用模型)；/model sonnet
/compact	压缩对话历史	长对话救星。当一个对话很长但你又不想完全丢失上下文时使用。AI会将旧内容总结成摘要，既保留了关键信息，又大大减少了Token消耗。	/compact 保留代码部分的讨论
/usage	详细用量监控	精细化管理。可以控制是否显示Token消耗和成本。/usage full会在每次回复后附上详细的Token和费用报告。	/usage full；/usage off
/exec	控制系统命令执行	安全控制阀。控制AI能否在你的系统上执行命令。新手建议设置security=allowlist ask=always，每次执行都询问并只允许安全的命令。	/exec host=sandbox security=allowlist
/approve	批准待定操作	授权确认。当AI请求执行需要批准的操作（如读写文件、执行命令）时，用此命令响应。可以单次允许或永久允许。	/approve abc123 allow-once

第五部分：扩展能力：Skills (技能) 管理

Skills 是赋予 OpenClaw “执行能力”的关键，相当于给聪明的大脑装上了灵活的双手。

• openclaw skills list：查看当前已安装和可用的所有技能。
• openclaw plugins install <插件名>：安装一个技能插件。例如 openclaw plugins install @m1heng-clawd/feishu 来安装飞书集成插件。
• ClawHub 集成：OpenClaw 拥有庞大的技能生态（截至2026年2月已有1700+社区技能）。启用 ClawHub 后，你可以直接在聊天中让 AI 帮你搜索并安装新技能。例如，直接对机器人说“我需要一个能搜索网页的技能”，AI 可能会引导你安装 tavily-search。

第六部分：高阶技巧与安全策略

1. 安全第一：永远在沙箱或隔离环境中运行
   OpenClaw 能执行真实的系统命令，这既是强大之处也是风险所在。强烈建议在虚拟机、Docker 容器或专门的 VPS 中运行，避免直接在你的工作电脑（尤其是存有重要资料的电脑）上运行。同时，始终以一个非特权用户的身份运行 OpenClaw，限制其文件访问权限。

2. 调试哲学：遇到问题先开“前台模式”
   当 Web UI 无响应或消息发送失败时，先停止后台服务 (openclaw gateway stop)，然后在终端前台运行 openclaw gateway start（不带 -d）。接着复现问题，观察终端打印的实时日志。这是最快定位问题是出在网络、配置还是插件上的方法。

3. 远程访问：利用 Tailscale 安全暴露服务
   如果你想让手机或外部网络访问家中的 OpenClaw 网关，可以利用其内置的 Tailscale 集成。配置 gateway.tailscale.mode 为 serve（仅限 tailnet 内网）或 funnel（公网，需密码验证），这样可以在不直接暴露不安全端口的情况下实现安全远程访问。

4. 配置即代码：用脚本自动化部署
   当你需要部署第二个 OpenClaw 实例时，不要再手动点来点去了。将配置命令写成脚本：

   #!/bin/bash
   openclaw config set gateway.port 18789
   openclaw config set channels.telegram.enabled true
   openclaw config set channels.telegram.botToken "你的:BOT_TOKEN"
   openclaw models set claude-haiku-4-5
   openclaw gateway restart
   

   这就是“基础设施即代码”的实践。

---

这份操作手册能帮助你更好地驾驭 OpenClaw。从这些常用命令和技巧开始，你将能更安全、高效地发挥这个强大 AI 助手的全部潜力。