一、什么是 OpenClaw？

1.1 核心定位

1.2 与其他 AI 工具的核心差异

• 🔒 隐私：所有对话数据经过 OpenAI/Anthropic 服务器，OpenClaw 的对话只走你的设备→模型 API

• 📱 随时随地：无需打开网页，直接在你常用的 IM 里发消息

• 🔧 可定制：自定义人设、记忆、工作流、Skills

• 🤖 多智能体：同时运行多个 AI 角色（写作专家、代码助手、交易顾问）

• 💾 持久记忆：AI 真的记住你，跨会话保持上下文

1.3 适合哪些人？

• 内容创作者：让 AI 助手帮你管理选题、写作、发布全流程

• 程序员：本地代码 AI，私密安全，工具链完整

• 副业从业者：批量部署 AI 服务，接单变现

• 企业用户：内网部署，员工共用一个企业智能体

• AI 爱好者：折腾各种自动化场景，探索 AI 边界

二、核心架构与工作原理

2.1 架构全景

你的消息
    ↓
[IM 渠道] 飞书 / Telegram / WhatsApp / Discord...
    ↓
[Gateway 网关] ← 运行在你的 Mac / Linux / VPS
    ↓           ↙         ↘          ↘
[AI Agent]  [Web UI]  [Mobile Node]  [CLI]
    ↓
[AI 模型 API] Claude / GPT / Gemini...

2.2 核心组件详解

① Gateway（网关）

• OpenClaw 的核心服务

• 负责接收所有渠道消息、路由给 AI、返回结果

• 本质是一个 Node.js 进程，以系统服务形式常驻后台

• 默认监听 127.0.0.1:18789

② Agent（智能体）

• 执行 AI 对话和工具调用的运行时

• 支持多智能体：不同场景用不同 Agent

• 工作目录（Workspace）存储：AGENTS.md / SOUL.md / MEMORY.md 等配置文件

③ Skills（技能）

• 可插拔的能力扩展包

• 从 ClawHub 市场一键安装

• 例如：天气查询、飞书文档操作、股票数据、浏览器控制

④ Nodes（节点）

• 配对的 iOS / Android 设备

• 支持：摄像头、屏幕录制、位置、语音、Canvas 画布

⑤ Web Control UI（控制界面）

• 浏览器打开 http://127.0.0.1:18789/

• 可视化管理：会话、配置、节点、Skills

2.3 会话与记忆机制

• MEMORY.md → 长期记忆，跨会话保持

• memory/YYYY-MM-DD.md → 每日日志，自动写入

• 向量搜索 + 全文检索，让 AI 真正"记住你"

• 会话即将压缩时，自动触发记忆写入，永不遗忘重要信息

三、安装教程（全平台）

3.1 系统要求

⚠️ Windows 用户强烈建议使用 WSL2，原生 Windows 支持有限。

3.2 方法一：一键安装脚本（推荐）

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

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

1. 检测并安装 Node.js 22+

2. 全局安装 openclaw CLI

3. 启动交互式引导向导（onboard wizard）

3.3 方法二：npm / pnpm 手动安装

# 使用 npm
npm install -g openclaw@latest
openclaw onboard --install-daemon

# 使用 pnpm
pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

💡 --install-daemon 参数会将 Gateway 注册为系统服务（macOS launchd / Linux systemd），开机自动启动，无需手动维护。

3.4 引导向导（Onboarding Wizard）详解

? 选择 AI 提供商
  ❯ Anthropic (Claude)
    OpenAI (GPT)
    Google (Gemini)
    自定义

? 选择要连接的消息频道
  ❯ 飞书（推荐，官方API稳定 + 文档/表格天然打通）
    Telegram（配置简单，海外用户首选）
    WhatsApp
    Discord
    更多...

💡 为什么推荐飞书？ 飞书使用官方 Bot API + WebSocket 长连接，稳定性极佳、零封号风险。而且飞书的文档、多维表格、审批等能力可以直接被 AI 调用，天然适合搭建自动化工作流。

# 向导完成后自动安装服务
openclaw gateway status   # 查看状态
openclaw dashboard        # 打开 Web 控制界面

3.5 方法三：Docker 部署

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 一键启动（包含镜像构建+引导）
./docker-setup.sh

# 使用远程镜像（更快）
OPENCLAW_IMAGE=ghcr.io/openclaw/openclaw:latest ./docker-setup.sh

# 启用沙盒隔离
OPENCLAW_SANDBOX=1 ./docker-setup.sh

3.6 方法四：VPS 云端部署

# 1. SSH 连接服务器
ssh root@your-vps-ip

# 2. 安装 OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# 3. 配置远程访问（Tailscale 推荐）
openclaw gateway --port 18789

# 4. 低配 VPS 优化（可选）
echo 'export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' >> ~/.bashrc
echo 'export OPENCLAW_NO_RESPAWN=1' >> ~/.bashrc
source ~/.bashrc

• Gateway 默认只监听 loopback（127.0.0.1），不暴露公网

• 通过 SSH 隧道或 Tailscale 访问

• 必须开启 gateway.auth.token 认证

3.7 验证安装

# 检查版本
openclaw --version

# 检查 Gateway 状态
openclaw gateway status

# 打开控制界面
openclaw dashboard

# 运行健康检查
openclaw doctor

四、配置频道

4.1 飞书（⭐ 推荐首选）

• ✅ 官方 Bot API：零封号风险，企业级稳定

• ✅ WebSocket 长连接：不需要公网域名，穿透内网，延迟低

• ✅ 生态打通：飞书文档、多维表格、审批流可以直接被 AI 读写操作

• ✅ 适合国内用户：无需翻墙，访问速度快

• ✅ 免费额度大：个人开发者足够用

1. 打开 飞书开放平台，注册/登录

2. 点击「创建企业自建应用」

3. 填写应用名称（如 "我的AI助手"）和描述

4. 记下 App ID 和 App Secret

• im:message — 读取和发送消息（必须）

• im:message:send_as_bot — 以机器人身份发送消息（必须）

• im:chat — 获取群组信息（推荐）

• docx:document — 读写飞书文档（推荐，解锁文档能力）

• bitable:app — 读写多维表格（推荐，解锁表格能力）

• wiki:wiki — 读写知识库（可选）

1. 应用管理后台 → 事件与回调

2. 订阅方式选择 WebSocket（推荐，无需公网IP）

3. 添加事件：im.message.receive_v1（接收消息）

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxxxxxxx",
      "appSecret": "你的AppSecret",
      "connectionMode": "websocket",
      "domain": "feishu"
    }
  }
}

1. 在飞书开放平台点击「创建版本」→「申请发布」

2. 企业管理员审批通过

3. 在飞书中搜索你的机器人名称，发消息即可对话

💡 企业内自用：如果你是企业管理员，审批可以秒过。个人开发者也可以创建测试企业。

💡 飞书 vs Lark：如果用的是国际版 Lark，把 domain 改为 "lark" 即可。

4.2 Telegram（海外用户推荐）

1. 在 Telegram 搜索 @BotFather，发送 /newbot

2. 按提示设置 bot 名称和用户名

3. 获得 Bot Token（格式：1234567890:AAExxxxx）

4. 在 OpenClaw 配置文件写入：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的BotToken",
      "dmPolicy": "pairing",
      "streaming": "partial"
    }
  }
}

5. 重启 Gateway，给你的 Bot 发消息即可对话

4.3 WhatsApp

⚠️ WhatsApp 使用 Baileys 库实现，需要扫码登录个人账号。建议使用备用手机号。

# 引导配置
openclaw onboard
# 选择 WhatsApp → 扫描二维码

• 使用备用手机号/备用账号（主账号有封号风险）

• 二维码有效期约 20 秒，扫码后状态持久保存

• 支持：文字、图片、语音、文档

4.4 Discord

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "你的Bot Token"
    }
  }
}

4.5 多渠道同时运行

{
  "channels": {
    "feishu": { "enabled": true, "appId": "...", "appSecret": "..." },
    "telegram": { "enabled": true, "botToken": "..." },
    "whatsapp": { "enabled": true },
    "discord": { "enabled": true, "token": "..." }
  }
}

💡 不同渠道可以绑定不同 Agent（智能体），实现一个 Gateway 多角色服务。

五、技能系统（Skills）

5.1 什么是 Skills？

5.2 Skills 加载路径（优先级）

工作区 Skills    (workspace/skills/)     ← 最高优先级
     ↓
本地安装 Skills  (~/.openclaw/skills/)
     ↓
内置 Skills     (openclaw 内置)          ← 最低优先级

5.3 从 ClawHub 安装技能

# 安装 clawhub CLI
npm i -g clawhub

# 搜索技能
clawhub search "weather"
clawhub search "postgres"
clawhub search "github"

# 安装技能
clawhub install weather
clawhub install <作者>/<技能名>

# 更新所有技能
clawhub update --all

5.4 内置核心技能

5.5 自创 Skills

---
name: my-skill
description: 当用户问关于XXX时激活
---

# 我的自定义技能

## 触发条件
用户提到 "XXX" 时

## 执行步骤
1. 步骤一
2. 步骤二
3. 返回结果

六、高级功能

6.1 多智能体路由

{
  "agents": {
    "list": [
      {
        "id": "writer",
        "workspace": "~/.openclaw/workspace-writer"
      },
      {
        "id": "coder",
        "workspace": "~/.openclaw/workspace-coder"
      },
      {
        "id": "trader",
        "workspace": "~/.openclaw/workspace-trader"
      }
    ]
  },
  "bindings": [
    { "agentId": "writer", "match": { "channel": "feishu" } },
    { "agentId": "coder", "match": { "channel": "discord" } }
  ]
}

6.2 工作区文件系统

6.3 浏览器控制（Browser Use）

用户："帮我在京东搜索 iPhone 16，找最低价"
  → AI 打开浏览器
  → 搜索商品
  → 截图分析
  → 返回最低价链接

6.4 移动节点（Mobile Nodes）

• 📸 调用手机摄像头拍照

• 🖥️ 截取手机屏幕

• 📍 获取当前位置

• 🎙️ 语音输入输出

• 📱 控制 Canvas 画布展示

6.5 语音功能（TTS / 语音转文字）

tts:
  enabled: true
  provider: openai  # 或其他支持的 TTS 服务

6.6 模型切换与故障转移

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6",
        "fallbacks": [
          "anthropic/claude-sonnet-4-5",
          "openai/gpt-4o"
        ]
      }
    }
  }
}

/model list           # 查看可用模型
/model openai/gpt-4o  # 切换到 GPT-4o

七、变现思路与商业模式

7.1 变现模式一：AI 助手服务接单

• 部署专属 AI 客服（接入飞书 / 企微 / WhatsApp）

• 每月维护费：¥500-2000/客户

• 客制化功能开发：¥3000-10000/项目

1. 本地部署一套 OpenClaw，测试跑通

2. 在 VPS 上部署（成本约 ¥30-80/月/客户）

3. 接入客户的 IM 账号

4. 定制 SOUL.md、AGENTS.md（人设 + 工作流）

5. 交付使用，按月收维护费

• 10个客户 × ¥1000/月 = ¥10,000/月

• 成本：VPS ¥500 + 模型 API 费用 ¥1000 = ¥1500

• 净利润：¥8500/月

7.2 变现模式二：自媒体内容生产线

热点监控(选题专家) 
    → 飞书选题库
    → 审批
    → 笔尖专家写作
    → 发布专家推送
    → 公众号/小红书/抖音

• 广告分成：公众号/小红书流量变现

• 知识付费：课程、训练营

• 接稿：品牌内容合作 ¥2000-10000/篇

7.3 变现模式三：Skills 开发与销售

• 开发垂直行业 Skill（法律、医疗、电商）

• 开发工具集成 Skill（CRM、ERP、电商平台）

• 收费模式：买断 / 订阅 / 使用量计费

• 简单 Skill：一个 SKILL.md 文件

• 复杂 Skill：SKILL.md + 几个 Python/Shell 脚本

7.4 变现模式四：企业 AI 内网部署

• 在企业内网服务器部署 OpenClaw

• 接入飞书/企微/钉钉

• 配置企业知识库（连接内部文档）

• 配置各部门专属 AI 角色

• 基础部署：¥20,000-50,000（一次性）

• 年度维护：¥10,000-30,000/年

• 知识库定制：¥5,000-20,000

7.5 变现模式五：教学与培训

• 录制 OpenClaw 系列课程（B站/知识星球）

• 开设训练营：¥499-2999/人

• 1v1 咨询：¥299-599/小时

• 出版教程文档（本文就是起点）

• OpenClaw 从零搭建（入门）

• AI 自动化工作流实战（进阶）

• 企业 AI 转型方案（高端）

7.6 变现模式六：AI 副业平台搭建

• OpenClaw 配置模板

• 预置 Skills 包

• 工作流 SOP 文档

• 一对一部署支持

7.7 变现成本核算

八、常见问题 FAQ

Q1：OpenClaw 完全免费吗？

Q2：会不会封号？

• 飞书：官方 Bot API，零风险 ✅

• Telegram Bot：官方支持，零风险 ✅

• Discord：官方 Bot API，零风险 ✅

• WhatsApp：使

Q3：数据安全吗？

Q4：支持哪些 AI 模型？

• Anthropic：Claude Opus / Sonnet / Haiku

• OpenAI：GPT-4o / o3 / o4-mini

• Google：Gemini 2.0 / 1.5 Pro

• 本地模型：通过 Ollama 接入（开发中）

• 自定义 API：兼容 OpenAI 协议的任何服务

Q5：一台服务器能服务多少用户？

Q6：如何更新 OpenClaw？

openclaw update                    # 更新到最新稳定版
openclaw update --channel beta     # 更新到 beta 版

Q7：Windows 支持好吗？

Q8：飞书和 Telegram 该选哪个？

九、社区与资源

9.1 官方资源

9.2 快速命令参考

# 安装
npm install -g openclaw@latest

# 引导向导
openclaw onboard --install-daemon

# 常用命令
openclaw gateway status     # 查看 Gateway 状态
openclaw gateway start      # 启动 Gateway
openclaw gateway stop       # 停止 Gateway
openclaw dashboard          # 打开 Web 控制界面
openclaw doctor             # 健康检查
openclaw update             # 更新版本
openclaw status             # 查看完整状态

9.3 进阶学习路径

• 配置多智能体路由（写作、编程、交易各司其职）

• 接入浏览器控制，解锁网页自动化

• 配对手机节点，随时随地拍照/定位/语音

• 自创第一个 Skill 并发布到 ClawHub

🦞 最后一句话： OpenClaw 的上限取决于你的想象力。它是工具，也是平台，更是你的 AI 副业基础设施。装上它，开始折腾吧。