OpenClaw（小龙虾）是一个强大的开源AI助手网关，让你可以通过微信、Telegram、Discord等聊天应用操控AI。本文将详细介绍OpenClaw的常用命令，帮助你快速上手。

一、安装命令

macOS/Linux 安装

打开终端，执行以下命令：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows 安装（PowerShell）

iwr -useb https://openclaw.ai/install.ps1 | iex

npm 安装

npm install -g openclaw@latest

二、核心命令详解

1. openclaw onboard – 初始化向导

首次使用必须运行的命令，引导你完成所有配置：

openclaw onboard --install-daemon

作用：配置认证、网关设置、安装系统服务。安装后OpenClaw会自动在后台运行。

2. openclaw gateway – 网关管理

网关是OpenClaw的核心，负责连接聊天应用和AI。

查看状态：

openclaw gateway status

启动网关（前台运行）：

openclaw gateway --port 18789

重启网关：

openclaw gateway restart

停止网关：

openclaw gateway stop

3. openclaw channels – 渠道配置

配置WhatsApp、Telegram、Discord等聊天渠道。

登录渠道：

openclaw channels login

运行后会显示二维码，用手机扫码即可绑定WhatsApp。

查看已配置渠道：

openclaw channels list

4. openclaw dashboard – 打开控制面板

打开浏览器访问Web控制界面：

openclaw dashboard

默认地址：http://127.0.0.1:18789/

5. openclaw message – 发送消息

通过命令行发送消息到指定渠道：

openclaw message send --target +8613800138000 --message "你好，这是测试消息"

6. openclaw status – 查看系统状态

显示当前运行状态、版本信息、资源使用情况：

openclaw status

三、实战示例

示例1：快速搭建Telegram机器人

# 1. 安装
npm install -g openclaw@latest

# 2. 初始化
openclaw onboard --install-daemon

# 3. 配置Telegram
openclaw channels login
# 选择Telegram，输入Bot Token

# 4. 启动
openclaw gateway --port 18789

# 5. 打开控制面板
openclaw dashboard

示例2：检查服务状态

$ openclaw gateway status

● openclaw-gateway.service - OpenClaw Gateway
   Loaded: loaded
   Active: active (running)
   Main PID: 12345
   Memory: 256M
   CPU: 5%

示例3：发送测试消息

$ openclaw message send --target @mychannel --message "AI助手已上线！"

✓ Message sent successfully

四、常用配置文件

配置文件位于：~/.openclaw/openclaw.json

示例配置：

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+8613800138000"]
    },
    "telegram": {
      "token": "your-bot-token"
    }
  },
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@AI助手"]
    }
  }
}

五、常用命令速查表

命令 说明
openclaw onboard 初始化配置向导
openclaw gateway status 查看网关状态
openclaw gateway restart 重启网关
openclaw channels login 登录聊天渠道
openclaw dashboard 打开Web控制台
openclaw status 查看系统状态
openclaw --help 查看帮助

六、常见问题

Q: 网关启动失败怎么办？

A: 检查端口是否被占用：lsof -i :18789，或尝试更换端口。

Q: 如何查看日志？

A: 日志位于 ~/.openclaw/logs/ 目录。

Q: 支持哪些聊天平台？

A: 原生支持WhatsApp、Telegram、Discord、iMessage，通过插件支持更多。

总结

OpenClaw的命令设计简洁直观，几条命令就能搭建起完整的AI助手系统。掌握以上命令，你就可以在微信、Telegram等平台上拥有一个7×24小时在线的AI助手了！

更多信息请访问官网：openclaw.ai 或文档：docs.openclaw.ai