第一部分：入门
什么是 OpenClaw
OpenClaw 是一个强大的 AI Agent 平台（前身为 ClawdBot、MoltBot），它让你能够：
统一多个消息渠道：在一个平台上管理 WhatsApp、Telegram、Discord、Slack、Signal、iMessage 等
构建 AI Agent：创建具有独立人格和记忆的智能助手
自动化工作流：通过 cron 任务和 webhook 实现自动化
扩展能力：通过技能（Skills）和插件无限扩展功能
为什么选择 OpenClaw？
| 传统聊天机器人 | OpenClaw |
|---|---|
| 单一平台 | 多渠道统一 |
| 无状态对话 | 持久化记忆 |
| 固定功能 | 技能扩展 |
| 被动响应 | 主动自动化 |
| 单一 Agent | 多 Agent 协作 |
最好的教程是OpenClaw的官方文档，强烈建议先看一下：
OpenClaw - OpenClaw
核心概念
- 架构概览
┌─────────────────────────────────────────────────────────────┐
│ OpenClaw 架构 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌─────────────────────────┐ │
│ │ 消息渠道 │◄────────┤ Gateway (网关) │ │
│ │ │ │ WebSocket Server │ │
│ │ • WhatsApp │ │ 端口: 18789 │ │
│ │ • Telegram │ └───────────┬─────────────┘ │
│ │ • Discord │ │ │
│ │ • Slack │ ▼ │
│ │ • Signal │ ┌─────────────────────────┐ │
│ │ • iMessage │ │ Agent Runtime │ │
│ └──────────────┘ │ (pi-mono 内嵌) │ │
│ └───────────┬─────────────┘ │
│ │ │
│ ┌───────────▼─────────────┐ │
│ │ Workspace (工作区) │ │
│ │ • AGENTS.md │ │
│ │ • SOUL.md │ │
│ │ • memory/ │ │
│ │ • skills/ │ │
│ └─────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
- Gateway（网关）
Gateway 是 OpenClaw 的核心组件：
职责：管理所有消息渠道连接，处理 WebSocket 通信
端口：默认 18789
启动：openclaw gateway run
管理：通过 macOS app、CLI 或 Web UI 控制 - Agent（智能体）
Agent 是具有独立人格和记忆的 AI 助手：
Session：每次对话会话
Workspace：Agent 的工作区和记忆存储
Bootstrap 文件：定义 Agent 的行为和人格 - Skills（技能）
技能是扩展 Agent 能力的模块：
Bundled Skills：内置技能
Managed Skills：用户安装的技能（~/.openclaw/skills）
Workspace Skills：工作区专属技能（/skills）
安装与配置
腾讯云服务器官方教程（如果想通过云服务器部署，建议看一下这个，多个聊天软件配置方式都有）：
🔥🔥🔥玩转OpenClaw｜云上OpenClaw最全教程合辑-腾讯云开发者社区-腾讯云
如果想部署在自己的电脑，可以看这个：
卡兹克的文章（Windows系统+飞书）：https://mp.weixin.qq.com/s/gRCZdwyK3xoD3VLrvxdDjQ
这个是我根据OpenClaw官方文档整理的：
OpenClaw 本地部署教程（Windows / Linux / Mac）
下面这些知识也可以了解一下：
方式一：快速安装（推荐）
# 使用 npm 安装
npm install -g openclaw
# 运行初始化向导
openclaw onboard
向导会引导你完成：
配置 Gateway（端口、绑定地址）
设置 AI 模型（Anthropic Claude、OpenAI 等）
连接消息渠道
创建工作区
方式二：手动配置
# 1. 初始化配置
openclaw setup --workspace ~/.openclaw/workspace
# 2. 配置 AI 模型
openclaw models auth setup-token --provider anthropic
# 3. 启动 Gateway
openclaw gateway run
配置文件位置
配置：~/.openclaw/openclaw.json
凭证：~/.openclaw/credentials/
会话：~/.openclaw/agents//sessions/
工作区：~/.openclaw/workspace（可自定义）
最小配置示例
// ~/.openclaw/openclaw.json
{
gateway: {
mode: "local",
port: 18789,
bind: "loopback",
},
agents: {
defaults: {
workspace: "~/.openclaw/workspace",
model: {
primary: "anthropic/claude-sonnet-4-20250514",
},
},
},
channels: {
whatsapp: {
allowFrom: ["+861xxxxxxxxx"], // 你的电话号码
},
},
}
第一次对话
通过 CLI 对话
# 启动对话
openclaw agent --message "你好，请介绍一下你自己"
# 指定思考级别（仅 GPT-5.2 和 Codex 模型支持）
openclaw agent --message "分析这个问题" --thinking high
# 详细模式
openclaw agent --message "解释详细过程" --verbose full
通过 Telegram 对话
配置 Telegram Bot
# 创建 Telegram Bot（与 @BotFather 对话后获取 Token）
openclaw channels add \
--channel telegram \
--account default \
--name "My Bot" \
--token $TELEGRAM_BOT_TOKEN
在 Telegram 中开始对话
找到你的 Bot
发送 /start 开始对话
直接发送消息即可
通过 WhatsApp 对话
启动 Gateway
openclaw gateway run
扫码登录
# macOS app：点击 WhatsApp 登录
# 或 CLI：
openclaw channels login --channel whatsapp
发送消息
扫描二维码后，给联系人 “Yourself” 发送消息即可开始对话。
相关文章：