Home

深色模式

OpenClaw 使用说明 ​

概述 ​

当 OpenClaw 安装并初始化完成后，真正的日常使用通常会围绕这几件事展开：

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

如果你把这条主线跑顺了，OpenClaw 基本就能稳定进入日常使用阶段。

第一步：确认 Gateway 正在运行 ​

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

bash
openclaw gateway status

如果你只是想快速看整体状态，也可以直接：

bash
openclaw health
openclaw status

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

第二步：打开本地控制台 ​

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

bash
openclaw dashboard

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

text
http://127.0.0.1:18789/

这个界面的好处是：

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

如果你只是想尽快确认 OpenClaw 是否已经能聊天，优先用这个入口最省时间。

第三步：按需要接入聊天渠道 ​

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

常见入口命令有：

bash
openclaw channels login
openclaw channels list
openclaw channels status

这一步的目标很明确：

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

如果你的主要使用场景在 Telegram、WhatsApp 或 Discord，通常接好一个主渠道之后，OpenClaw 的使用频率就会明显高很多。

第四步：发送消息和开始对话 ​

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

如果你已经接好了某个支持发送的渠道，可以直接尝试：

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

这类命令更适合：

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

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

第五步：管理模型 ​

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

常见命令包括：

bash
openclaw models status
openclaw models list
openclaw models

如果你需要调整默认模型，可以结合配置或模型相关命令完成。日常使用时，建议重点关注两件事：

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

如果你主要做编码或复杂推理，通常会倾向使用更强的主模型；如果你更看重成本和响应速度，则可以把高性能模型留给关键场景。

第六步：按场景拆分 agent ​

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

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

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

如果你需要新增 agent，可以使用：

bash
openclaw agents add work

这样做的价值在于：

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

常见日常命令 ​

如果你已经完成安装和基础配置，下面这些命令的使用频率通常会比较高：

bash
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 表现异常，我更建议按顺序排查，而不是一开始就重装。

场景一：控制台打不开 ​

先检查：

bash
openclaw gateway status
openclaw health

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

bash
openclaw logs --follow

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

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

bash
openclaw doctor

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

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

建议按这个顺序确认：

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

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

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

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

bash
openclaw gateway --port 18789

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

一个适合新手的使用路径 ​

如果你刚安装好 OpenClaw，比较推荐的日常使用路径是：

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

这样做的优点是，你始终能明确当前的主要问题到底出在哪一层。

使用 OpenClaw 的关键思路 ​

日常使用 OpenClaw 时，最值得记住的一点是：不要把它只当成“一个命令行工具”，而要把它看成“一个持续运行的助手系统”。

一旦你接受这个视角，很多操作就会自然很多：

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

理解到这里，OpenClaw 的使用方式就会比单纯背命令更清楚。

参考 ​