OpenClaw 开源的智能助手平台

OpenClaw介绍

OpenClaw 是一个开源的智能助手平台，它运行在您的计算机上，并可与您常用的聊天应用配合使用。无论您身在何处，WhatsApp、Telegram、Discord、Slack 还是 Teams，您的 AI 助手都会伴您左右。

项目诞生历程

两个月前，我利用周末时间拼凑了一个项目。这个最初名为“WhatsApp Relay”的项目，如今在 GitHub 上已经获得了超过 10 万颗星，并在短短一周内吸引了 200 万访客。

Clawd 诞生于 2025 年 11 月——这是“Claude”加上“爪子”的巧妙双关。一切都完美无缺，直到 Anthropic 的法务团队礼貌地要求我们重新考虑。好吧，这很合理。

Moltbot 这个名字是接下来诞生的，它是在凌晨 5 点与社区成员在 Discord 上进行一场混乱的头脑风暴后选定的。蜕皮象征着成长——龙虾脱壳蜕皮，最终长成更大的生物。这个名字寓意深刻，但念起来却不太顺口。

OpenClaw 就是我们的最终归宿。这一次，我们做了充分的准备：商标检索结果清晰无误，域名已购买，迁移代码也已编写完成。这个名字恰如其分地概括了这个项目如今的面貌：

核心亮点

聊天软件对接，数十款IM软件对接，支持自定义
智能体桥接，旧版 Claude/Codex/Gemini/Opencode 路径已移除；Pi 是唯一的编程智能体路径。
大模型桥接，兼容OpenAI协议，基本上所有大模型都可以对接

架构

WhatsApp / Telegram / Discord / iMessage (+ plugins)
        │
        ▼
  ┌───────────────────────────┐
  │          Gateway          │  ws://127.0.0.1:18789 (loopback-only)
  │     (single source)       │
  │                           │  http://<gateway-host>:18793
  │                           │    /__openclaw__/canvas/ (Canvas host)
  └───────────┬───────────────┘
              │
              ├─ Pi agent (RPC)
              ├─ CLI (openclaw …)
              ├─ Chat UI (SwiftUI)
              ├─ macOS app (OpenClaw.app)
              ├─ iOS node via Gateway WS + pairing
              └─ Android node via Gateway WS + pairing

openclaw

组件

单个长期运行的 Gateway 网关拥有所有消息平台（通过 Baileys 的 WhatsApp、通过 grammY 的 Telegram、Slack、Discord、Signal、iMessage、WebChat）。
控制平面客户端（macOS 应用、CLI、Web 界面、自动化）通过配置的绑定主机（默认 127.0.0.1:18789）上的 WebSocket 连接到 Gateway 网关。
节点（macOS/iOS/Android/无头设备）也通过 WebSocket 连接，但声明 role: node 并带有明确的能力/命令。
canvas 主机（默认 18793）提供智能体可编辑的 HTML 和 A2UI。

运行机制

uml diagram

安装

# 推荐：全局安装（npm/pnpm）
npm install -g openclaw@latest
# 或：pnpm add -g openclaw@latest

# 新手引导 + 安装服务（launchd/systemd 用户服务）
openclaw onboard --install-daemon

# 配对 WhatsApp Web（显示二维码）
openclaw channels login

# 新手引导后 Gateway 网关通过服务运行；手动运行仍然可行：
openclaw gateway --port 18789

代码构建

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 首次运行时自动安装 UI 依赖
pnpm build
openclaw onboard --install-daemon

docker构建

export OPENCLAW_HOME_VOLUME="openclaw_home"

# 自动化脚本
./docker-setup.sh

# 手工流程
docker build -t openclaw:local -f Dockerfile .
docker compose run --rm openclaw-cli onboard
docker compose up -d openclaw-gateway

配置目录 .openclaw/

.
./exec-approvals.json
./openclaw.json
./identity
./identity/device.json
./identity/device-auth.json
./openclaw.json.bak
./workspace
./workspace/memory
./workspace/memory/2026-02-05.md
./workspace/.clawhub
./workspace/.clawhub/lock.json
./workspace/IDENTITY.md
./workspace/HEARTBEAT.md
./workspace/BOOTSTRAP.md
./workspace/baidu_search.js
./workspace/USER.md
./workspace/SOUL.md
./workspace/skills
./workspace/skills/playwright-cli
./workspace/skills/weather
./workspace/AGENTS.md
./workspace/TOOLS.md
./openclaw.json.bak.4
./workspace-wecom-dm-huangyansheng
./workspace-wecom-dm-huangyansheng/IDENTITY.md
./workspace-wecom-dm-huangyansheng/HEARTBEAT.md
./workspace-wecom-dm-huangyansheng/BOOTSTRAP.md
./workspace-wecom-dm-huangyansheng/USER.md
./workspace-wecom-dm-huangyansheng/SOUL.md
./workspace-wecom-dm-huangyansheng/AGENTS.md
./workspace-wecom-dm-huangyansheng/TOOLS.md
./openclaw.json.bak.3
./agents
./agents/wecom-dm-huangyansheng
./agents/wecom-dm-huangyansheng/agent
./agents/wecom-dm-huangyansheng/sessions
./agents/main
./agents/main/agent
./agents/main/sessions
./openclaw.json.bak.2
./canvas
./canvas/index.html
./extensions
./extensions/openclaw-plugin-wecom
./browser
./browser/openclaw
./browser/openclaw/user-data
./browser/chrome-extension
./browser/chrome-extension/background.js
./browser/chrome-extension/options.js
./browser/chrome-extension/README.md
./browser/chrome-extension/icons
./browser/chrome-extension/manifest.json
./browser/chrome-extension/options.html
./logs
./logs/gateway.log
./logs/gateway.err.log
./.env
./update-check.json
./node.json
./cron
./cron/jobs.json.bak
./cron/jobs.json
./openclaw.json.bak.1
./devices
./devices/paired.json
./devices/pending.json
./credentials
./credentials/whatsapp
./credentials/whatsapp/default

工作区目录 ~/.openclaw/workspace

AGENTS.md — 操作指令 + “记忆”
SOUL.md — 人设、边界、语气
TOOLS.md — 用户维护的工具说明（例如 imsg、sag、约定）
BOOTSTRAP.md — 一次性首次运行仪式（完成后删除）
IDENTITY.md — 智能体名称/风格/表情
USER.md — 用户档案 + 偏好称呼

Skills

内置（随安装包提供）
托管/本地：~/.openclaw/skills
工作区：/skills

ClawHub

ClawHub 是 OpenClaw 的公共 Skills 注册中心。它是一项免费服务：所有 Skills 都是公开的、开放的，所有人都可以查看、共享和复用。Skills 就是一个包含 SKILL.md 文件（以及辅助文本文件）的文件夹。你可以在网页应用中浏览 Skills，也可以使用 CLI 来搜索、安装、更新和发布 Skills。

clawhub安装技能

pnpm add -g clawhub

clawhub search "calendar"

clawhub install playwright-cli

#less /Users/seveniruby/.openclaw/workspace/skills/playwright-cli/SKILL.md

大模型配置

  "models": {
    "providers": {
    "qwen-portal": {
        "baseUrl": "https://portal.qwen.ai/v1",
        "apiKey": "qwen-oauth",
        "api": "openai-completions",
        "models": [
          {
            "id": "coder-model",
            "name": "Qwen Coder",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          },
          {
            "id": "vision-model",
            "name": "Qwen Vision",
            "reasoning": false,
            "input": [
              "text",
              "image"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      },
      "ollama": {
        "baseUrl": "http://127.0.0.1:8001/local/v1",
        "apiKey": "ollama",
        "models": []
      },

默认大模型

插件体系

插件命令

openclaw plugins list
openclaw plugins info <id>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins doctor
openclaw plugins update <id>
openclaw plugins update --all

安装插件

# 企业微信插件
openclaw plugins install openclaw-plugin-wecom

# 飞书插件
openclaw plugins install @openclaw/feishu

对话通道 Channel

支持主流IM渠道

WhatsApp — 最受欢迎；使用 Baileys，需要二维码配对。
Telegram — 通过 grammY 使用 Bot API；支持群组。
Discord — Discord Bot API + Gateway；支持服务器、频道和私信。
Slack — Bolt SDK；工作区应用。- 飞书 — 飞书（Lark）机器人（插件，需单独安装）。
Google Chat — 通过 HTTP webhook 的 Google Chat API 应用。
Mattermost — Bot API + WebSocket；频道、群组、私信（插件，需单独安装）。
Signal — signal-cli；注重隐私。
BlueBubbles — 推荐用于 iMessage；使用 BlueBubbles macOS 服务器 REST API，功能完整（- 编辑、撤回、特效、回应、群组管理——编辑功能在 macOS 26 Tahoe 上目前不可用）。
iMessage（旧版） — 通过 imsg CLI 的旧版 macOS 集成（已弃用，新设置请使用 BlueBubbles）。
Microsoft Teams — Bot Framework；企业支持（插件，需单独安装）。
LINE — LINE Messaging API 机器人（插件，需单独安装）。
Nextcloud Talk — 通过 Nextcloud Talk 的自托管聊天（插件，需单独安装）。
Matrix — Matrix 协议（插件，需单独安装）。
Nostr — 通过 NIP-04 的去中心化私信（插件，需单独安装）。
Tlon — 基于 Urbit 的消息应用（插件，需单独安装）。
Twitch — 通过 IRC 连接的 Twitch 聊天（插件，需单独安装）。
Zalo — Zalo Bot API；越南流行的消息应用（插件，需单独安装）。
Zalo Personal — 通过二维码登录的 Zalo 个人账号（插件，需单独安装）。
WebChat — 基于 WebSocket 的 Gateway 网关 WebChat 界面。

{.!text-xs}

国内聊天渠道

企业微信对接

安装插件
添加机器人
配置对接

配置详情

{
  "plugins": {
    "entries": {
      "wecom": { "enabled": true }
    }
  },
  "channels": {
    "wecom": {
      "enabled": true,
      "token": "Your Token",
      "encodingAesKey": "Your EncodingAESKey"
    }
  }
}

节点 Nodes

节点是一个伴随设备（macOS/iOS/Android/无头设备），它以 role: "node" 连接到网关 WebSocket （与操作员使用相同的端口），并通过 node.invoke 公开命令表面（例如 canvas. 、 camera. 、 system.* ）

设备配对

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>

节点申请配对

openclaw node run --host <gateway-host> --port 18789 --display-name "Build Node"

# Terminal B: export the gateway token and connect through the tunnel
export OPENCLAW_GATEWAY_TOKEN="<gateway-token>"
openclaw node run --host 127.0.0.1 --port 18790 --display-name "Build Node"

# 在gateway上进行批准
openclaw devices approve <requestId>