Home

深色模式

OpenClaw 使用说明 ​

概述 ​

OpenClaw 的日常使用基本围绕这几件事：

  • 启动或确认 Gateway 正常运行
  • 打开本地控制台进行交互
  • 接入一个或多个聊天渠道
  • 调整默认模型和工作方式
  • 查看日志、状态和健康检查结果

这条主线跑顺以后，日常使用就差不多了。

确认 Gateway 状态 ​

OpenClaw 的很多能力都建立在 Gateway 之上，所以每天开始使用前，最先确认的应该是服务状态：

sh
openclaw gateway status

要快速看整体状态，可以直接：

sh
openclaw health
openclaw status

通常这三条命令就足够判断系统是不是处于可用状态。

打开本地控制台 ​

对于第一次正式使用，最推荐的入口仍然是本地控制台：

sh
openclaw dashboard

默认情况下，它会打开本地网页界面。你也可以直接访问：

text
http://127.0.0.1:18789/

这个界面的好处很直接：

  • 不需要先配置消息渠道
  • 适合验证模型和网关是否已经可用
  • 可以用来做基础配置查看和调试

先确认能不能聊天，这个入口最快。

接入聊天渠道 ​

当本地控制台没问题后，就可以进入渠道接入阶段。

常见入口命令有：

sh
openclaw channels login
openclaw channels list
openclaw channels status

这一步的目标很明确：

  • 确认当前有哪些渠道已经配置
  • 完成渠道登录或授权
  • 检查渠道是否在线

主要在 Telegram、WhatsApp 或 Discord 里用时，接好一个主渠道以后，使用频率通常就会上来。

发送消息和开始对话 ​

当 Gateway 和渠道都正常后，就可以正式开始消息交互。

某个支持发送的渠道已经接好时，可以直接试：

sh
openclaw message send --target +15555550123 --message "Hello from OpenClaw"

这类命令更适合：

  • 验证渠道是否真的能收发消息
  • 自动化脚本调用
  • 排查“控制台能用，但外部渠道没反应”的问题

对于大多数日常场景，你仍然会直接在控制台或聊天平台里与 OpenClaw 对话，而不是频繁手写 message send。

管理模型 ​

只要你接入了多个模型提供方，模型管理就会成为高频操作。

常见命令包括：

sh
openclaw models status
openclaw models list
openclaw models

调整默认模型时，可以结合配置或模型相关命令完成。日常主要看两件事：

  • 当前默认模型是否满足你的任务类型
  • 是否配置了回退模型，避免单点故障

编码和复杂推理更适合强一点的主模型；更看重成本和速度时，可以把高性能模型留给关键场景。

拆分 agent ​

OpenClaw 的一个优势，是你不必把所有事情都塞给同一个助手。

随着使用深入，你可以逐步拆分出不同 agent，例如：

  • 日常聊天 agent
  • 工作沟通 agent
  • 编码 agent

新增 agent 时，可以使用：

sh
openclaw agents add work

这样做的价值在于：

  • 会话更干净
  • 模型配置更清晰
  • 各自的工作区和行为边界更明确

常见日常命令 ​

完成安装和基础配置后，下面这些命令的使用频率通常比较高：

sh
openclaw dashboard
openclaw gateway status
openclaw health
openclaw status
openclaw channels status
openclaw models status
openclaw logs --follow

可以把它们理解成一组最小日常运维命令。

改完配置先做什么 ​

模型、渠道或网关参数一变，最好马上做一轮校验：

  1. 改完配置先跑 openclaw doctor
  2. 再看 openclaw health
  3. 必要时追 openclaw logs --follow
  4. 最后再回到控制台或渠道里验证实际效果

这样排查更快，也更容易区分问题是在配置层还是运行层。

出问题时怎么排查 ​

OpenClaw 表现异常时，先按顺序排查，不用急着重装。

场景一：控制台打不开 ​

先检查：

sh
openclaw gateway status
openclaw health

如果都不正常，再看日志：

sh
openclaw logs --follow

场景二：配置改完后失效 ​

优先怀疑配置不合法，先执行：

sh
openclaw doctor

OpenClaw 对配置校验比较严格，很多问题都能在这里直接看出来。

场景三：渠道无法收发消息 ​

建议按这个顺序确认：

  1. openclaw channels list
  2. openclaw channels status
  3. openclaw logs --follow

最近刚改过渠道 Token 或权限配置时，问题往往就在这里。

场景四：服务明明装好了，但状态不对 ​

这时可以直接以前台方式运行 Gateway，看终端输出：

sh
openclaw gateway --port 18789

前台运行通常最适合定位启动时错误。

推荐使用顺序 ​

刚安装好 OpenClaw 时，可以按这个顺序用：

  1. 先通过 openclaw dashboard 在本地控制台验证基本聊天
  2. 再接入一个最常用的外部渠道
  3. 再补充模型和 agent 的细化配置
  4. 最后再考虑技能、插件和自动化扩展

这样每一步的问题都比较好定位。

运行视角 ​

OpenClaw 更接近一个持续运行的助手系统，范围比单个命令行工具大得多。

按这个视角看，很多操作会更好理解：

  • Gateway 是运行时
  • 渠道是交互入口
  • 配置是系统约束
  • agent 是角色分工
  • logs 和 health 是日常运维工具

把这几个角色分清，使用方式会比背命令清楚得多。

参考 ​