OpenClaw - 完整文档

概述

OpenClaw 是一个适用于任何操作系统的 AI 智能体 Gateway 网关，支持 WhatsApp、Telegram、Discord、iMessage 等多种聊天渠道。通过单个 Gateway 网关进程将聊天应用连接到编程智能体。

核心架构

Chat apps + plugins → Gateway → 智能体/CLI/Web UI/macOS/iOS/Android

Gateway 网关是会话、路由和渠道连接的唯一事实来源。

核心功能

多渠道 Gateway 网关

• 通过单个 Gateway 进程连接多个聊天应用
• 支持同时运行多个渠道

插件渠道

• 通过扩展包添加 Mattermost 等更多渠道
• 支持自定义渠道开发

多智能体路由

• 按智能体、工作区或发送者隔离会话
• 支持多智能体并行运行

媒体支持

• 发送和接收图片、音频、文档
• 支持 Canvas 和媒体理解

Web 控制界面

• 浏览器仪表板管理聊天、配置和会话
• 实时监控和调试

移动节点

• 配对 iOS 和 Android 节点
• 支持 Canvas 远程显示

快速开始

1. 安装 OpenClaw

npm install -g openclaw@latest

2. 新手引导并安装服务

openclaw onboard --install-daemon

3. 配对渠道并启动 Gateway

openclaw channels login
openclaw gateway --port 18789

访问 Web 控制界面

• 本地：http://127.0.0.1:18789/
• 远程：通过 Tailscale 或 SSH 访问

配置文件

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

基本配置示例

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true }
      },
    },
  },
  messages: {
    groupChat: {
      mentionPatterns: ["@openclaw"]
    }
  },
}

配置说明

• 不做任何修改：使用内置 Pi 二进制文件，按发送者创建独立会话
• allowFrom：限制允许访问的电话号码
• requireMention：群聊中需要 @ 提及才会响应
• mentionPatterns：自定义提及模式

支持的渠道

官方内置渠道

• WhatsApp - 最常用的渠道
• Telegram - 功能强大的机器人平台
• Discord - 游戏和社区平台
• iMessage - Apple 设备
• Signal - 注重隐私的通讯
• Slack - 工作场所协作
• Google Chat - Google Workspace 集成
• Matrix - 去中心化通讯

插件扩展渠道

• Mattermost - 企业协作
• Microsoft Teams - 微软团队协作
• IRC - 互联网中继聊天
• Feishu - 飞书
• LINE - LINE 通讯
• Twitch - 直播平台

CLI 命令参考

核心命令

# 状态检查
openclaw status

# Gateway 管理
openclaw gateway --port 18789
openclaw gateway start
openclaw gateway stop
openclaw gateway restart

# 渠道管理
openclaw channels login
openclaw channels list
openclaw channels connect

# 配置管理
openclaw config get <key>
openclaw config set <key> <value>
openclaw configure

# 日志查看
openclaw logs
openclaw logs --follow

# 技能管理
openclaw skills list
openclaw skills install <skill>
openclaw skills uninstall <skill>

# 会话管理
openclaw sessions list
openclaw sessions info <id>
openclaw sessions clear <id>

# 节点管理
openclaw nodes list
openclaw nodes pair
openclaw nodes status

# 更新
openclaw update

向导命令

# 新手引导
openclaw onboard --install-daemon

# 诊断
openclaw doctor

# 重置
openclaw reset

节点功能

配对移动设备

openclaw nodes pair

支持的设备：

• iOS - 需要 OpenClaw iOS App
• Android - 需要 OpenClaw Android App

节点功能

• Camera Capture - 远程拍照
• Location - 获取设备位置
• Audio/Voice - 录音和语音笔记
• Canvas - 远程显示和控制
• Talk Mode - 语音交互

自动化功能

Cron Jobs

定期执行任务：

openclaw cron create "0 9 * * *" "早上好"

Heartbeat

心跳检查，适合定期检查状态：

• 检查邮件
• 检查日历
• 检查通知
• 维护内存

Webhooks

接收外部事件触发。

Hooks

在特定事件时执行脚本。

安全

访问控制