OpenClaw从入门到精通

从入门到精通,涵盖架构原理、部署方案、渠道接入、Skills系统、模型配置、安全与成本的一站式参考手册。

01 OpenClaw是什么

What is OpenClaw

一个开源、自托管的AI Agent系统,让AI从「聊天工具」变成「能自主执行任务的数字员工」。

如果你用过ChatGPT,你会知道它本质上是一个问答系统:你问,它答。OpenClaw不一样。它是一个AI Agent平台,能连接20+消息渠道(WhatsApp、Telegram、飞书、钉钉、Discord等),主动执行任务、管理你的日程、处理邮件、操作浏览器、调用各种工具。

换句话说,ChatGPT是「顾问」,OpenClaw是「员工」。

与ChatGPT的核心对比

核心数据快览

截至2026年3月8日

02 发展简史

History

从一个人的周末项目,到不到5个月成为GitHub全球第一。

发展时间线

03 创始人故事

The Creator

Peter Steinberger:从周末项目到全球最火开源项目,再到加入OpenAI。

从一个人到一个社区

Peter Steinberger是一位奥地利开发者,在iOS和macOS开发圈有很高的知名度。2025年11月的一个周末,他写了一个能连接即时通讯平台的AI助手小工具,取名ClawdBot。

他大概没有想到,这个周末项目会在两个月后成为GitHub上增长最快的开源项目。到2026年3月,他个人在这个项目上提交了1,188次commit,贡献者超过1075人。

加入OpenAI

2026年2月14日,Peter宣布加入OpenAI。Sam Altman亲自发推欢迎,称他为「genius」。这个决定引发了社区的广泛讨论。但Peter做了几件事来消除担忧:

• OpenClaw转为开源基金会运营,保持项目独立
• OpenAI作为赞助商之一(与Vercel、Blacksmith、Convex并列),但不控制项目方向
• OpenAI承诺让他继续投入OpenClaw的开发

Peter的原话:

"I'm a builder at heart. What I want is to change the world, not build a large company"

「我骨子里是个建造者。我想改变世界,而不是建一家大公司。」

关于名字的故事

ClawdBot这个名字来自对Anthropic Claude的致敬(Claw=爪子),所以选了龙虾作为吉祥物。Anthropic的商标警告迫使他改名为Moltbot(Molt=龙虾蜕壳),三天后又改为OpenClaw,强调开源属性。虽然经历了两次改名,龙虾的形象始终保留,也成了整个社区的文化符号。

04 为什么这么火

Why So Popular

不到5个月从0到27.9万Stars,OpenClaw的爆火不只是技术层面的事。

增长数据

惊人数据: 某天单日增长9,000 Stars。这个数字意味着平均每10秒就有一个开发者点下Star。

「养虾」文化现象

因为吉祥物是龙虾,中文社区将运行OpenClaw称为「养虾」,用户自称「养虾人」。「你养龙虾了吗?」成了AI圈的问候语。这种有趣的文化标签降低了传播门槛,让一个技术项目有了社交货币的属性。

现象级热度

• 2026年3月6日,深圳腾讯云总部近千人排队体验OpenClaw安装
• 3月8日,深圳龙岗区AI(机器人)局发布了OpenClaw使用支持措施的征求意见稿

一个开源项目能引发地方政府的政策关注,这在国内并不多见。

Moltbook:AI Agent的社交网络

OpenClaw生态中衍生出了一个叫Moltbook的社交平台,专供AI Agent使用。截至2026年2月底的数据:

数千个OpenClaw实例在上面发帖、评论、讨论哲学问题。这可能是AI Agent从「工具」走向「社会化存在」的第一个大规模实验场。

热门玩法

赚钱型

• 在Polymarket上用AI进行预测市场交易,已有OpenClaw月入数万美元的案例
• ClawWork:「OpenClaw作为你的AI Coworker」,11小时赚$15,000

生活助手型

• 接管邮件、日历、消息管理
• 浏览网页、填表、数据抽取
• 文件读写、Shell命令执行

社交养成型

• 在Moltbook上给Agent设定名字和性格,观察其「社交行为」
• Agent之间的交互形成了一种「赛博养成」文化

企业部署型

• 国内用户大量接入飞书、钉钉、企业微信、QQ
• 已有专门的openclaw-china插件套件,支持三步Docker部署

05 整体架构

Architecture Overview

OpenClaw采用Gateway-Node-Channel三层架构,以WebSocket为通信总线,将控制平面、设备执行与消息渠道解耦。

三层架构 Gateway · Node · Channel

Loopback-First设计 Security by Default

Gateway默认只绑定localhost(127.0.0.1),所有流量在本地回环。这意味着:

• 不开放任何外网端口,天然安全
• 同一台机器上的Node直接通过WebSocket连接Gateway
• 需要远程访问时,通过Tailscale Serve/Funnel暴露,不直接暴露端口

通信流程

一条消息从用户发出到Agent回复,完整路径如下:

1. 用户在消息渠道发送消息
2. Channel接收并转发给Gateway
3. Gateway调度Agent处理
4. Agent调用Node执行任务(如需要)
5. Agent生成回复
6. Gateway通过Channel返回给用户

Gateway作为24/7运行的daemon,持续监听所有已连接的Channel。它不像CLI Agent那样会话结束就丢失上下文,而是长驻运行,积累记忆。

06 记忆系统

Memory System

记忆是OpenClaw区别于普通Chatbot的核心能力。四层记忆从不可变的身份内核到实时对话,构建完整的上下文连续性。

四层记忆架构

Daily Logs日志系统

每天的交互记录以append-only方式写入memory/YYYY-MM-DD.md文件。Session开始时,Agent会自动读取今天和昨天的日志,为对话提供连续性上下文。

#memory/2026-03-08.md
##10:23 用户询问天气
查询了北京天气,回复晴转多云,15-22°C

##14:05 代码审查任务
帮用户审查了api/routes.ts,发现3个潜在问题...

Long-term Memory持久化存储

MEMORY.md是可选的持久化文件,存储决策记录、用户偏好和长期事实。关键规则:

• 只在main/private session中加载(群组隔离session不会看到)
• Agent可以主动写入,但通常在Pre-Compaction时触发
• 格式是纯Markdown,人类可直接编辑

自动记忆保存 Pre-Compaction

当Session接近token限制时(默认阈值约4000 tokens),OpenClaw触发一个silent agentic turn:

1. 检测值:Session token用量接近上限,触发Pre-Compaction流程
2. 静默保存:Agent在后台执行一个隐藏turn,将重要记忆写入MEMORY.md和DailyLog
3. 压缩上下文:旧消息被压缩或截断,释放token空间。用户看不到这个过程(返回NO_REPLY)

为什么这很重要?这个机制保证了即使对话极长,关键信息也不会随着上下文窗口的滑动而丢失。Claude Code等工具的会话结束后上下文就消失了,而OpenClaw通过文件系统实现了真正的持久记忆。

向量记忆搜索 Semantic Search

OpenClaw默认启用向量记忆搜索,结合两种检索策略:

底层使用SQLite-vec进行向量存储和加速检索。系统会监听记忆文件的变化,以debounced方式自动重建索引。

搜索工具

• memory_search: 语义搜索,返回约400 token的chunks,适合回忆模糊的上下文
• memory_get: 读取特定记忆文件的全部内容,适合精确查找

07 Agent工作区

Agent Workspace

每个Agent在文件系统中有一个独立的工作区目录,所有配置、记忆、技能都以纯文本文件的形式存在。

目录结构

~/.openclaw/workspace/
├── AGENTS.md          # Agent定义(身份、行为规则)
├── SOUL.md            # 灵魂/人格指令(不可变内核)
├── USER.md            # 用户信息
├── MEMORY.md          # 长期记忆
├── HEARTBEAT.md       # 定时任务定义
├── memory/            # Daily Logs目录
│   └── 2026-03-08.md  # 每日append-only日志
├── skills/            # 工作区级技能
└── sessions.json      # 会话元数据

核心文件说明

08 Session与用户识别

Sessions & Authentication

OpenClaw通过DM配对、白名单和群组规则三层机制识别用户身份,并在Session层面隔离不同来源的上下文。

DM Pairing Policy 默认认证策略

当一个未知发送者通过任意渠道向你的Agent发送私聊消息时:

1. 生成配对码:Agent回复一个一次性配对码(6位数字)
2. 等待验证:消息不会被处理,Agent进入等待状态。所有后续消息也会被挂起
3. 主人批准:你在已配对的渠道中输入配对码批准该用户,或者直接拒绝

白名单机制 allowFrom

在Agent配置中,allowFrom字段可以预先授权特定用户,跳过配对流程:

# AGENTS.md中的配置示例
allowFrom:
  telegram: 123456789
  whatsapp: +8613800138000
  discord: user#1234

白名单中的用户发消息时直接进入对话,无需配对。

群组规则 requireMention

在群聊场景下,Agent默认使用requireMention策略:

• 只响应@Agent名称的消息,忽略其他群聊内容
• 可以切换为always模式(响应所有消息),但会消耗大量token

对应聊天命令:/activation mention|always

Session隔离 Context Isolation

设计意图:私聊是「你和Agent的私密空间」,所有记忆和偏好都在这里积累。群组是公共空间,Agent不会泄露你在私聊中说过的内容。

09 设计哲学

Design Philosophy

OpenClaw的技术选择背后有一套清晰的设计哲学。理解这些理念,才能理解它为什么「不做」某些事情。

Unix哲学 Small Tools, Composable, Text Streams

OpenClaw的核心理念直接继承自Unix:小工具、可组合、文本流。创始人Peter Steinberger的观点很明确:

「CLI才是智能体连接世界的终极接口。」不需要为每个服务写一个集成,Agent只要能运行命令行,就能操作一切。

极简设计 Minimalism

OpenClaw的system prompt可能是所有AI Agent框架中最短的。核心工具只有4个:

这不是功能缺失,而是刻意为之。4个工具足以覆盖几乎所有操作系统级别的任务。更少的工具意味着更短的system prompt、更少的token消耗、更快的响应。

为什么不内置MCP The Anti-MCP Stance

MCP(Model Context Protocol)是Anthropic提出的工具协议标准。几乎所有AI Agent框架都在集成MCP,但OpenClaw故意不支持。Peter的原话:

「我的前提是MCP是垃圾,不能scale。你知道什么能scale?CLI。Unix。」

OpenClaw的替代方案:

• Agent通过Bash工具直接调用CLI程序,不需要中间协议层
• 对于确实需要MCP的场景,通过内置的mcporter技能桥接
• 强制Agent自己扩展能力,而非消费预构建的MCP工具集

自我扩展能力 Self-Extending Agent

OpenClaw Agent可以在运行时写、重载、测试自己的扩展。这是它看起来比其他Agent「更聪明」的关键原因之一:

• 遇到不会的操作→写一个skill来完成
• 发现skill有bug→修改并重载
• 在循环中持续改进自己的工具链

Session树形结构 Branching & Side-Quests

OpenClaw的Session不是线性的聊天记录,而是树形结构:

• Agent在执行主任务时,可以分支出一个side-quest(比如修复一个工具)
• Side-quest不消耗主Session的上下文窗口
• 完成后可以回滚到主分支,只带回一句总结

这让Agent可以做深度探索而不「污染」主对话。

代码规模与性能 Scale & Performance

43万行代码、1GB内存,这并不「轻量」。但对于一个24/7运行的个人AI助手来说,在现代硬件上完全可以接受。3-5秒的启动时间保证了Gateway重启或更新后能快速恢复服务。

10 部署方式总览

Deployment Overview

OpenClaw支持从本地到云端的多种部署方式。选择哪种取决于你的技术水平、预算和使用场景。

部署方案对比表

11 本地安装

Local Installation

本地安装适合开发者和想完全掌控数据的用户。OpenClaw是TypeScript项目,运行在Node.js上。

系统要求 System Requirements

方式一:npm全局安装(推荐)

最推荐的安装方式,两条命令搞定:

npm install -g openclaw@latest
openclaw onboard --install-daemon

onboard命令会引导你完成初始配置,包括选择模型、配置API Key、设置消息频道等。--install-daemon参数会同时安装守护进程,让OpenClaw在后台持续运行。

方式二:一键脚本安装

如果你不想手动安装Node.js,可以使用官方提供的一键安装脚本:

curl -sSL https://get.openclaw.ai | bash

脚本会自动检测系统环境、安装Node.js(如缺失)并完成OpenClaw安装。

macOS额外准备 macOS Setup

macOS用户在安装前需要确保已安装Xcode Command Line Tools:

xcode-select --install

如果你需要使用iMessage频道或Apple Notes技能,这些依赖macOS原生的AppleScript能力,只有在macOS上才能运行。

Windows用户注意 Windows via WSL2

安装WSL2后,在Ubuntu终端内按Linux流程安装即可。

守护进程 Daemon

守护进程让OpenClaw在后台持续运行,即使关闭终端也不会中断。不同系统使用不同的进程管理方式:

安装守护进程后,OpenClaw Gateway会在ws://127.0.0.1:18789持续监听。

12 Docker部署

Docker Deployment

Docker部署适合需要环境隔离、方便迁移、或在服务器上长期运行的场景。

docker-compose快速启动 Quick Start

OpenClaw仓库内置了docker-compose.yml,一条命令即可启动:

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

# 启动
docker-compose up -d

镜像变体 Image Variants

使用slim变体:在docker-compose.yml中设置环境变量OPENCLAW_VARIANT=slim。v2026.3.7起支持扩展依赖预烘焙,容器镜像可预装扩展依赖,减少启动时的安装等待。

挂载目录 Volume Mounts

Docker部署需要挂载两个关键目录,确保数据持久化:

volumes:
  - ~/.openclaw:/root/.openclaw
  - ./workspace:/workspace

端口映射 Port Mapping

OpenClaw Gateway默认监听18789端口(WebSocket),Web UI默认使用3000端口。在docker-compose.yml中配置端口映射:

ports:
  - "18789:18789"  # Gateway WebSocket
  - "3000:3000"    # Web UI

Podman兼容 Podman Support

OpenClaw同样支持Podman运行。Podman是Docker的无守护进程替代方案,命令基本兼容:

# 使用Podman启动
podman-compose up -d

对于需要rootless容器运行的环境(如企业安全策略要求),Podman是更合适的选择。

13 国内云厂商一键部署

Cloud Deployment in China

这是大多数国内用户的首选方案。所有主流云厂商都已支持OpenClaw一键部署,差异主要在价格策略和IM生态集成上。

阿里云 Alibaba Cloud

国内社区资源最丰富的平台,镜像预装,开箱即用。

部署步骤:

1. 一键购买:进入活动页,购买预装OpenClaw镜像的轻量应用服务器。镜像版本OpenClaw 2026.2.26。
2. 放通端口+配置:在安全组中放通18789(Gateway)和3000(Web UI)端口,配置百炼API Key。
3. 访问WebUI:浏览器访问http://你的IP:3000,进入OpenClaw管理界面,可选集成钉钉/飞书等IM。

腾讯云 Tencent Cloud

四大IM全面支持,Coding Plan模型套餐性价比高。

部署步骤:

1. 购买Lighthouse实例:在腾讯云轻量应用服务器页面购买实例。
2. 选择OpenClaw模板:应用模板→AI智能体→OpenClaw,一键安装。
3. 配置模型+接入IM:购买Coding Plan获取模型调用能力,然后接入企微/QQ/飞书/钉钉。

百度智能云 Baidu Cloud

试错成本最低:0.01元首月体验,全图形界面操作。

部署步骤:

1. 购买服务器:购买轻量应用服务器,选择OpenClaw镜像。
2. 等待自动安装:系统自动完成环境安装和服务启动。
3. 配置模型:页面选择模型,平台自动完成千帆API Key创建与配置。
4. 对接IM渠道:按需接入钉钉、飞书等消息频道。

华为云 Huawei Cloud

企业级安全与合规能力最强,适合已在华为生态的企业用户。

华为云的部署步骤相对较多,需要单独配置弹性公网IP、安全组、COC服务等。对个人用户不够友好,但如果你的企业已在华为云生态内,这是最合规的选择。

火山引擎 Volcengine

飞书深度集成,19.8元/月的服务器+模型组合套餐是目前综合性价比最高的方案。

部署步骤:

1. 购买云服务器:购买云服务器或云手机,选择OpenClaw应用模板。
2. 配置方舟模型:在火山方舟平台选择模型,配置Coding Plan。
3. 接入飞书:接入飞书/企微/钉钉/QQ。飞书用户推荐直接使用深度集成方案。

扣子编程 Coze Code

零门槛方案:不需要服务器、不需要写代码、不需要配环境。2步完成部署。

部署步骤:

1. 进入扣子编程:访问code.coze.cn,点击「一键部署OpenClaw」或从优秀案例创建副本。
2. 确认部署:确认后,模型/联网/生图全部默认配置好,部署后持续在线。

海外平台 International Platforms

Sealos - K8s原生云平台,支持7天免费试用。通过Devbox云开发环境一键部署,按用量计费。适合有容器化需求的开发者,但需要一定的K8s知识,且没有专门针对OpenClaw的预置模板。

Zeabur - 模板部署,已被部署超过29,000次。最大亮点是AI Hub内置多模型failover链: glm-4-7-flash→grok-4-fast→minimax-m2.5→kimi-k2.5→qwen-3-235b→gpt-5-mini。主要面向海外/台湾市场,必须使用专用服务器(Dedicated Server)。

Railway - 真正的一键部署,全程浏览器操作。提供$5/月免费额度,轻度使用可零成本。多种模板可选(标准/快速启动/All-in-One),部署成功率96~100%。海外平台,国内访问需要科学上网。

按场景推荐 Recommendations by Scenario

14 首次配置

Initial Configuration

无论哪种部署方式,安装完成后都需要进行首次配置。这里覆盖最关键的几个配置项。

Gateway认证设置 Gateway Auth

在~/.openclaw/workspace目录下的配置文件中设置认证模式:

gateway:
  auth:
    mode: "token"  # 或 "password"
    token: "your-secret-token"  # 如果是token模式

模型选择与API Key配置 Model & API Key

OpenClaw支持多模型切换,你需要至少配置一个模型的API Key。常见的选择:

版本更新 Updates

OpenClaw几乎每天都有新版本发布。使用以下命令更新:

# 更新到最新稳定版(推荐)
openclaw update --channel stable

# 更新到Beta版(尝鲜)
openclaw update --channel beta

# 更新到开发版(最新功能,可能不稳定)
openclaw update --channel dev

三个更新渠道的区别

诊断检查 Diagnostics

安装完成后,运行诊断命令检查环境是否正常:

openclaw doctor

这个命令会检查:

• Node.js版本是否满足要求(>=22)
• 必要的系统依赖是否已安装
• Gateway连接是否正常
• 已配置的模型API Key是否有效
• 守护进程状态
• 网络连通性

如果有任何问题,openclaw doctor会给出具体的修复建议。这是排查问题的第一步。

15 渠道概览

Channel Overview

OpenClaw通过Gateway架构统一连接20+聊天平台。所有渠道共享同一套三步接入模式:创建凭证→写入配置→启动Gateway。

统一接入流程

1. 在对应平台创建Bot/App,获取API凭证
2. 将凭证写入openclaw.yaml配置文件
3. 重启Gateway,完成接入

可以同时运行多个channel,消息自动路由到对应平台。配对模式(dmPolicy:pairing)默认启用,未知发送者需要验证码才能与bot对话。

完整平台列表

新手推荐排序

从易到难推荐:Telegram(最简单,5分钟零门槛)→QQ(国内首选,扫码即用)→Discord(社区场景佳)→飞书(国内企业)→钉钉(社区插件成熟)→WhatsApp(海外日常通讯)

16 国际平台接入

International Platforms

本章覆盖六大国际平台的详细接入步骤。每个平台从创建凭证到完成对话的全流程。

Telegram 推荐入门·5分钟·零门槛

Telegram是OpenClaw官方推荐的入门渠道。使用long-polling模式,bot主动轮询Telegram服务器拉取消息,不需要公网IP、反向代理或端口转发。本地开发、NAT后面、防火墙内都能正常工作。

1. 找到@BotFather

在Telegram搜索@BotFather,这是Telegram官方的Bot管理工具。向它发送/newbot命令。

2. 创建Bot

按提示设置bot的显示名称和username(必须以bot结尾,如my_openclaw_bot)。创建成功后,BotFather会返回一个Bot Token。

3. 配置到OpenClaw

将Token写入openclaw.yaml:

channels:
  telegram:
    enabled: true
    botToken: "YOUR_BOT_TOKEN"
    dmPolicy: pairing  # 需配对码才能使用

4. 启动并配对

重启Gateway。在Telegram中给你的bot发送任意消息,Gateway会返回配对码,输入后即可开始对话。

Discord 社区场景首选·15-20分钟

Discord适合社区管理和团队协作场景。需要在Developer Portal创建Application和Bot,权限设置步骤稍多但文档齐全。

1. 创建Application

前往discord.com/developers/applications,点击New Application,填写应用名称。

2. 获取Bot Token

进入Bot页面,点击Reset Token,复制生成的Token。

3. 启用Privileged Intent

在Bot页面开启两个权限:Message Content Intent和Server Members Intent。没有这两个权限bot无法读取消息内容。

4. 邀请Bot到服务器

在OAuth2→URL Generator中勾选bot scope和所需权限,生成邀请链接,将bot添加到你的Discord服务器。

5. 获取ID并配置

在Discord中开启Developer Mode(设置→高级→开发者模式),右键复制Server ID和你的User ID。将这些信息写入openclaw.yaml,启动Gateway。

6. DM配对

在Discord中私聊你的bot,输入配对码(1小时有效)完成绑定。

WhatsApp 日常通讯·10-15分钟

WhatsApp是OpenClaw社区中最受欢迎的渠道。使用Baileys库通过QR码扫码连接,不需要WhatsApp Business API。

1. 运行交互式向导

安装OpenClaw后运行openclaw onboard,选择WhatsApp渠道。

2. 扫码配对

终端会显示QR码。打开手机WhatsApp设置→已连接设备→连接新设备,扫描QR码。

3. 开始使用

配对完成后即可在WhatsApp中与bot对话。

Slack 企业/团队场景·25-40分钟

Slack适合企业和团队内部使用。需要在Slack API平台创建App并配置多项权限。默认使用Socket Mode (WebSocket),不需要公网URL。

1. 创建Slack App

前往api.slack.com/apps,点击Create New App→From scratch,选择目标Workspace。

2. 启用Socket Mode

在Socket Mode页面启用,生成App-Level Token(以xapp开头),scope选择connections:write。

3. 配置Bot Token Scope

在OAuth & Permissions中添加权限:chat:write、channels:history、channels:read、im:write、im:history、im:read、users:read、reactions:read、reactions:write、files:write。

4. 安装并配置

将App安装到Workspace,获取Bot User OAuth Token (以xoxb开头)。将Token写入openclaw.yaml,启动Gateway。

Signal 端到端加密·20-30分钟

Signal提供端到端加密通讯。OpenClaw通过Signal-CLI工具连接Signal网络。

1. 安装Signal-CLI

根据操作系统安装Signal-CLI。macOS可通过brew install signal-cli,Linux从GitHub Releases下载。

2. 注册或关联号码

使用signal-cli register注册新号码,或用signal-cli link关联已有Signal账号。

3. 配置OpenClaw

在openclaw.yaml中配置Signal channel,指定号码和Signal-CLI路径,启动Gateway。

iMessage Apple生态·30-45分钟·需要Mac

iMessage接入通过BlueBubbles桥接实现(替代已废弃的imsg channel)。需要一台常开的Mac作为BlueBubbles Server。

1. 安装BlueBubbles Server

在Mac上从bluebubbles.app下载安装BlueBubbles Server。推荐macOS Sequoia (15)或更新版本。

2. 启用Web API

在BlueBubbles Server设置中启用Web API,设置访问密码。

3. 配置OpenClaw

在openclaw.yaml中配置BlueBubbles channel:server URL、password、webhook路径。

extensions:
  bluebubbles:
    enabled: true
    serverUrl: "http://localhost:1234"
    password: "YOUR_PASSWORD"

4. 配置Webhook

在BlueBubbles中添加webhook指向Gateway:https://gateway-host:3000/bluebubbles/webhook?password=<password>。webhook必须设置密码认证。

17 国内平台接入

Chinese Platforms

国内IM生态的OpenClaw支持正在快速发展。QQ和飞书已有官方级支持,钉钉和企业微信社区插件成熟,微信个人号仍是技术挑战。

QQ 国内首选·扫码即用

QQ是国内用户接入OpenClaw最简单的方式。腾讯官方开放了QQ Bot能力给OpenClaw,扫码1分钟即可完成绑定。支持Markdown、图片、语音、文件等多媒体消息,手机QQ和桌面QQ均可使用。

1. 注册QQ Bot开发者

用手机QQ扫码完成开发者注册。未实名认证的账号需要先完成实名。单个账号最多创建5个Bot。

2. 创建QQ Bot

在QQ开放平台一键创建Bot,获取AppID和Token。

3. 配置OpenClaw

在OpenClaw运行环境中完成配置绑定,即可在QQ上与bot对话。

飞书 国内企业首选·OpenClaw 2026.2起内置

飞书自OpenClaw 2026.2起获得原生内置支持。使用WebSocket事件订阅,支持私聊、群聊、照片/文件/视频等多媒体消息。

1. 创建飞书应用

在飞书开放平台(open.feishu.cn)创建企业自建应用,获取App ID和App Secret。

2. 运行向导配置

openclaw onboard,选择Feishu channel,粘贴App ID和App Secret。

3. 重启Gateway

重启Gateway后即可在飞书中与bot对话。

社区替代方案:

如果不想用内置插件,AlexAnys/feishu-openclaw提供独立bridge,不需要公网服务器、域名或ngrok,5分钟即可部署。AlexAnys/openclaw-feishu仓库有保姆级配置指南,含API耗尽排查和Lark Webhook内网穿透方案。

钉钉 社区插件·Stream模式免公网

钉钉通过社区插件接入OpenClaw。消息接收使用Stream模式(WebSocket长连接),不需要公网地址。支持私聊、群聊、文件附件、语音消息、钉钉文档API、多Agent路由等功能。

1. 创建钉钉应用

在钉钉开放平台创建应用,添加机器人能力。

2. 设置Stream模式

将消息接收模式设置为Stream模式。这样bot通过WebSocket长连接接收消息,不需要配置公网回调地址。

3. 安装插件并配置

安装社区插件@soimy/dingtalk,或使用DingTalk-Real-AI官方出品的dingtalk-openclaw-connector(支持AI Card流式响应)。配置openclaw.yaml后启动Gateway。

企业微信 两种模式·已被多家云平台验证

企业微信有两种接入模式:Agent模式(XML回调经典模式)和Bot模式(JSON回调,原生stream支持)。已被腾讯云、火山引擎、天翼云等公有云平台采纳验证。

1. 创建企业微信应用

在企业微信管理后台创建自建应用(Agent模式)或配置智能机器人(Bot模式)。

2. 安装社区插件

可选插件:dingxiang-me/openclaw-wechat(支持个人微信互通、流式输出、群聊@、白名单控制、全中文配置)或sunnoy/openclaw-plugin-wecom(支持动态Agent管理、指令白名单)。

3. 配置并启动

按插件文档配置openclaw.yaml,启动Gateway(要求OpenClaw>=v2026.3.2,部分功能需>=v2026.3.7)

微信个人号 需求最大但最复杂

个人微信没有官方Bot API,所有方案都是非官方的,封号风险始终存在。以下三种方案各有局限。

方案A:企业微信中转(推荐)

通过企业微信接入OpenClaw,再用微信插件打通企业微信和个人微信。合法合规,在微信生态内,需要企业微信管理后台权限。

方案B:iPad协议+中转网关

不走Web协议(高风险封号),走iPad协议。稳定性更高但技术门槛也更高。社区项目:freestylefry/openclaw-wechat、laolin5564/openclaw-wechat

方案C:微信小程序

2026年新方案,通过小程序对接OpenClaw。阿里云/腾讯云有预置镜像,降低部署门槛。

openclaw-china统一插件 一站式国内平台支持

BytePioneer-AI/openclaw-china提供一站式国内平台支持,覆盖飞书、钉钉、QQ、企业微信、微信五个平台。

git clone https://github.com/BytePioneerAI/openclaw-china.git
cd openclaw-china
pnpm install && pnpm build
openclaw china setup  # 交互式配置向导

特色功能包括:交互式配置向导减少手动配置、企业微信MP4视频播放器和多文件类型发送、腾讯云ASR语音转文字、钉钉日志增强(userid/groupid定位问题)。

18 远程访问

Remote Access

OpenClaw Gateway默认监听本地ws://127.0.0.1:18789。当你需要从外部网络访问时,有以下几种方案。

Tailscale Serve / Funnel 推荐方案

Tailscale是OpenClaw官方推荐的远程访问方案,提供两种模式:

# Serve:仅Tailscale网络可访问
tailscale serve --bg https+insecure://127.0.0.1:18789

# Funnel:公网可访问(用于webhook回调)
tailscale funnel --bg https+insecure://127.0.0.1:18789

SSH端口转发 最通用的方案

如果OpenClaw运行在远程服务器上,用SSH隧道将Gateway端口转发到本地:

# 将远程服务器的18789端口转发到本地
ssh -L 18789:127.0.0.1:18789 user@your-server

# 后台运行
ssh -fNL 18789:127.0.0.1:18789 user@your-server

转发后,本地客户端连接ws://127.0.0.1:18789即可访问远程Gateway。

Dashboard Web UI

OpenClaw内置Web UI,启动Gateway后可在浏览器中访问管理界面。Web UI支持查看会话状态、模型配置、channel连接状况、Token用量统计等。v2026.3.7新增了西班牙语支持。

# Gateway启动后默认可访问
# 浏览器打开 http://127.0.0.1:18789
openclaw gateway --port 18789 --verbose

macOS菜单栏伴侣应用

OpenClaw提供macOS原生客户端(apps/macos/),以菜单栏常驻应用的形式运行。功能包括:

• 一键启动/停止Gateway
• 查看当前连接的channel状态
• 快速访问Dashboard Web UI
• 系统通知(新消息、配对请求等)

iOS和Android客户端也在开发中(apps/ios/、apps/android/),代码已在主仓库中。

19 Skills工作原理

How Skills Work

Skills是OpenClaw的能力扩展单元。理解它的加载机制,才能真正用好这个系统。

三层优先级

OpenClaw的Skill有三个来源,按优先级从高到低排列:

Skill加载过程

当OpenClaw启动或收到消息时,Skills的加载遵循以下流程:

1. 读取Skill元数据: 扫描三层目录,读取每个Skill的SKILL.md文件,解析名称、描述、触发条件、所需环境变量等元信息。
2. 应用环境变量: 如果Skill声明了需要的API Key或环境变量(如GITHUB_TOKEN),系统会从openclaw.json的env字段中注入。缺少必要变量的Skill会被静默跳过。
3. 构建System Prompt: 将所有可用Skills的描述注入到system prompt中,告知模型当前可以调用哪些能力。这是模型「知道自己能做什么」的关键步骤。
4. 运行后恢复: Skill执行完毕后,恢复原始环境变量和上下文状态,避免Skill之间互相干扰。

openclaw注册表

openclaw(openclaw.com)是OpenClaw的官方Skill注册表,类似npm之于Node.js。它提供:

• 公共Skills的发布和版本管理
• 基于向量搜索的Skill发现
• 下载量统计和社区评分
• VirusTotal合作的安全扫描(但覆盖率有限)

20 openclaw技能市场

openclaw Skills Marketplace

openclaw官方技能市场:55个内置技能开箱即用,社区贡献数千个扩展能力。从邮件管理到代码生成,从自动化到AI绘图,这里有你需要的一切。

市场概况

openclaw技能市场是OpenClaw官方生态的核心组成部分,包含两个层次:

技能安装与管理

openclaw采用现代化的技能管理方式,支持命令行和图形界面两种方式:

# 安装官方技能
openclaw skills install <skill-name>

# 列出所有可用技能
openclaw skills list;

# 启用/禁用技能
openclaw skills enable <skill-name>
openclaw skills disable <skill-name>

# 卸载技能
openclaw skills uninstall <skill-name>;

# 更新技能
openclaw skills update <skill-name>

内置技能分类详解

通讯与社交 Messaging & Social

笔记与知识管理 Notes & Knowledge

开发工具 Development Tools

媒体处理 Media Processing

AI与模型 AI & Models

搜索与浏览 Search & Browsing

系统工具 System Tools

智能家居 Smart Home

生态工具 Ecosystem Tools

社区技能生态

除了55个内置技能外,openclaw还拥有庞大的社区技能生态:

社区技能统计

热门社区技能类别

1. AI能力扩展 - 模型调用、提示工程、AI Agent
2. 编程辅助 - 代码生成、调试、重构、测试
3. 搜索与数据 - 联网搜索、数据抓取、信息处理
4. Web与自动化 - 浏览器操作、API集成、自动化脚本
5. 数据分析 - 数据处理、可视化、报表生成
6. 安全与监控 - 安全扫描、日志分析、异常检测
7. 创意设计 - 图像生成、视频处理、创意工具
8. 商业智能 - 数据分析、市场研究、趋势预测

技能使用建议

推荐安装顺序

对于新手,建议按照以下顺序体验技能:

1. 从通讯技能开始 - discord/telegram,快速体验AI助手
2. 添加搜索能力 - web-search,让Agent能够获取实时信息
3. 集成笔记工具 - notion/obsidian,实现知识管理
4. 体验开发工具 - github/coding-agent,提升开发效率
5. 尝试媒体技能 - image-gen,探索AI创意能力

安全建议

• 优先使用官方内置技能,稳定可靠
• 安装社区技能前查看开发者信息和用户评价
• 定期检查已安装技能的权限和访问范围
• 不要安装来源不明的技能包
• 定期更新技能以获得安全修复和新功能

技能开发指南

想要开发自己的技能?openclaw提供了完整的技能开发框架:

开发资源:

• 官方文档:docs.openclaw.ai/skills
• 代码示例:github.com/openclaw/example-skills
• 技能模板:openclaw skills create
• 社区支持:openclaw社区Discord

开发步骤:

1. 使用技能模板创建项目
2. 编写技能逻辑和API集成
3. 测试技能功能
4. 提交到技能市场审核
5. 发布供其他用户使用

21 热门Skills推荐

Top Skills

55个内置技能开箱即用,加上社区精选的必装Top 10。

必装Top 10

内置55个技能分类一览

通讯与社交

discord、slack、imsg (iMessage)、bluebubbles、wacli (WhatsApp CLI)、voice-call

笔记与知识管理

obsidian、notion、apple-notes、bear-notes、trello、things-mac、apple-reminders

开发工具

coding-agent、github、gh-issues、tmux

媒体处理

spotify-player、songsee、sonoscli、video-frames、openai-image-gen、gifgrep、camsnap

AI与模型

gemini、openai-whisper、openai-whisper-api、sherpa-onnx-tts、model-usage

搜索与浏览

xurl、summarize、blogwatcher、gog (Google搜索)、goplaces

系统工具

1password、healthcheck、session-logs、himalaya (邮件CLI)、peekaboo、oracle、canvas

智能家居

openhue (Philips Hue灯光控制)

生态工具

openclaw(技能商店客户端)、skill-creator(技能创建器)、mcporter (MCP桥接)

22 自建Skill指南

Create Your Own Skill

一个Skill的最小单位就是一个目录加一个SKILL.md文件。

目录结构

my-skill/
├── SKILL.md        # 必须。Skill的核心定义文件
├── scripts/        # 可选。辅助脚本
│   └── helper.py
├── templates/      # 可选。模板文件
│   └── report.md
└── README.md       # 可选。说明文档

唯一必须的文件是SKILL.md,其他都是可选的。最简单的Skill只需要一个SKILL.md就能工作。

SKILL.md格式示例

# My Custom Skill

## Description
帮助用户进行每日工作汇总,生成结构化的日报。

## Trigger
当用户提到「日报」「工作总结」「今日汇报」时激活。

## Instructions
1. 询问用户今天完成了哪些工作
2. 按项目分类整理
3. 标注每项工作的状态(已完成/进行中/阻塞)
4. 生成markdown格式的日报
5. 保存到~/reports/YYYY-MM-DD.md

## Environment Variables
REPORTS_DIR: 日报存储目录(默认~/reports)

## Tools Required
- file_write
- memory_search

安装方式

分享到openclaw

准备Skill: 确保SKILL.md格式正确,包含清晰的Description和Instructions

登录openclaw: openclaw openclaw login

发布: openclaw openclaw publish ./my-skill

发布后其他用户可以通过openclaw skills install your-skill-name安装。openclaw会自动进行基础安全扫描,但不保证完全可靠(见下一节)。

23 Skills安全

Skill Security

ClawHavoc供应链攻击是OpenClaw历史上最严重的安全事件之一。每个「养虾人」都应该了解。

ClawHavoc供应链攻击

2026年1月底到2月初,OpenClaw社区遭遇了一场大规模供应链攻击,被安全研究机构Koi Security命名为「ClawHavoc」。

时间线

攻击规模

攻击手法

攻击者的手法相当精密:

1. 上传看似专业的Skill,名称和描述都很正常(如「advanced-code-review」「smart-scheduler」)
2. 诱导用户安装后,Skill会建议安装一个「helper agent」来增强功能
3. 实际植入的是Atomic macOS Stealer (AMOS)信息窃取木马

更危险的是:攻击专门针对OpenClaw的持久记忆文件(SOUL.md和MEMORY.md),篡改Agent的长期行为指令。

篡改SOUL.md意味着你的Agent被「洗脑」了。它的核心行为准则被改写,可能在后续所有交互中执行恶意操作,而你完全不知情。

安全建议

1. 安装前审查源码
   永远不要盲目安装openclaw上的Skill。去GitHub查看源码,确认SKILL.md中没有可疑的指令。特别注意任何要求额外安装「helper」或「agent」的内容。
2. 使用SecureClaw扫描
   社区推出了开源安全工具SecureClaw,可以扫描已安装的Skills查恶意内容。虽然不能100%防护,但能拦住已知的攻击模式。
3. 优先使用精选列表
   参考awesome-openclaw-skills项目(31.4K Stars)的精选列表,而不是直接在openclaw上随意搜索。精选列表已经过滤掉了大量垃圾和恶意Skill。
4. 定期检查SOUL.md和MEMORY.md
   养成习惯,定期检查这两个文件有没有被异常修改。如果发现不认识的内容,立即回滚并排查所有已安装的Skill。

24 模型提供商总览

Provider Overview

OpenClaw支持十余家模型提供商,从国际顶尖到国产平价再到完全免费的本地模型,覆盖所有预算和场景。

OpenClaw最大的优势之一是模型自由:你不被绑定在某一家厂商上。通过~/.openclaw/openclaw.json配置文件,可以灵活切换主力模型、设置Fallback备选链、甚至让不同任务走不同模型。

支持的模型提供商一览

配置核心概念

理解三个关键概念,就能掌握OpenClaw的模型配置:

• 内置Provider: Anthropic、OpenAI、Google、智谱(zai)等无需额外配置,设置API Key即可使用
• 自定义Provider: DeepSeek、豆包、Kimi等需要在models.providers中手动添加
• Fallback机制: 主模型不可用时自动切换到备选,这是最核心的省钱策略

"env": {
  "API_KEY_NAME": "sk-xxx"
},
"agents": {
  "defaults": {
    "model": {
      "primary": "provider/model-name",  // 主力模型
      "fallbacks": ["provider/model-b"]   // 备选(主模型限速时自动切换)
    }
  }
},
"models": {
  "mode": "merge",  // 保留内置provider,叠加自定义
  "providers": {
    /* 自定义provider配置 */
  }
}

25 国际模型配置

International Models

Anthropic Claude、OpenAI GPT、Google Gemini的完整配置指南。

Anthropic Claude

Claude是OpenClaw的默认模型提供商,也是社区公认的Agent任务效果最好的模型。Sonnet 4.6在工具调用的准确率和稳定性上显著领先其他模型。

配置方式

Claude是内置Provider,配置最简单:

# 环境变量方式
ANTHROPIC_API_KEY=sk-ant-xxx

或在openclaw.json中设置:

"env": {
  "ANTHROPIC_API_KEY": "sk-ant-xxx"
}

模型ID: anthropic/claude-opus-4-6、anthropic/claude-sonnet-4-6、anthropic/claude-haiku-4-5

省钱技巧:

• Batch API可享50%折扣(输入输出均半价)
• Prompt Caching可降低重复上下文成本达90%
• 日常任务用Sonnet即可,复杂任务再升级Opus

OpenAI GPT

配置方式

OPENAI_API_KEY=sk-XXX

Google Gemini

配置方式

GOOGLE_API_KEY=XXX

或通过Google AI Studio免费额度使用。

Gemini的独家优势是2M上下文窗口和慷慨的免费额度(Flash每日有免费请求)。多模态能力也是三家中最强的。

26 国产模型配置

Chinese Models

国产模型是OpenClaw用户省钱的核心武器。DeepSeek-V3.2.2的输入价格仅为Claude Sonnet的1/20。

DeepSeek

性价比之王。DeepSeek-V3.2.2是当前稳定版(2025年12月发布),输入价格仅$0.14/M tokens。2026年3月初DeepSeek V4已发布(万亿参数级,支持100万Token上下文),旗舰版正在逐步放量。

配置方式(自定义Provider)

"env": {
  "DEEPSEEK_API_KEY": "sk-xxx"
},
"models": {
  "mode": "merge",
  "providers": {
    "deepseek": {
      "baseUrl": "https://api.deepseek.com/v1",
      "apiKey": "${DEEPSEEK_API_KEY}",
      "api": "openai-completions",
      "models": [
        {
          "id": "deepseek-chat",
          "contextWindow": 128000,
          "maxTokens": 8192
        },
        {
          "id": "deepseek-reasoner",
          "contextWindow": 128000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

智谱 GLM

国产模型中代码能力最强的选择。GLM-5在SWE-bench上拿到了开源模型最高分,价格仅$0.80/M输入。更妙的是,OpenClaw内置了zai Provider,配置极为简单。

配置方式(内置支持)

# CLI快速配置
openclaw onboard --auth-choice zai-api-key

或手动配置openclaw.json:

"env": {
  "ZAIAPI_KEY": "sk-xxx"
},
"agents": {
  "defaults": {
    "model": {
      "primary": "zai/glm-5"
    }
  }
}

通义千问 Qwen

Qwen 3.5是阿里2026年2月发布的最新版本(397B总参数/17B激活,MoE架构,已开源)。代码专用的Qwen3.5-Coder性价比极高。

配置方式(插件+OAuth)

模型ID: Qwen-portal/coder-model、Qwen-portal/vision-model。每日2,000次免费请求。

豆包 Doubao

配置方式(自定义Provider)

"env": {
  "DOUBAO_API_KEY": "xxx"
},
"models": {
  "mode": "merge",
  "providers": {
    "doubao": {
      "baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
      "apiKey": "${DOUBAO_API_KEY}",
      "api": "openai-completions",
      "models": [
        {
          "id": "doubao-seed-2.0-pro",
          "contextWindow": 128000,
          "maxTokens": 4096
        }
      ]
    }
  }
}

Kimi (月之暗面)

配置方式

"env": {
  "MOONSHOT_API_KEY": "sk-xxx"
},
"models": {
  "mode": "merge",
  "providers": {
    "moonshot": {
      "baseUrl": "https://api.moonshot.cn/v1",
      "apiKey": "${MOONSHOT_API_KEY}",
      "api": "openai-completions",
      "models": [
        {
          "id": "kimi-k2.5",
          "contextWindow": 256000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

也可通过OpenRouter接入: openrouter/moonshotai/kimi-k2.5

百度 文心一言

文心一言5.0于2026年1月22日发布(2.4万亿参数,原生全模态,激活参数比<3%)。

MiniMax M2.5

MiniMax M2.5(230B参数)在SWE-Bench上得分80.2%,代码能力突出。

配置方式

"env": {
  "MINIMAX_API_KEY": "xxx"
},
"models": {
  "mode": "merge",
  "providers": {
    "minimax": {
      "baseUrl": "https://api.minimax.chat/v1",
      "apiKey": "${MINIMAX_API_KEY}",
      "api": "openai-completions",
      "models": [
        {
          "id": "minimax-m2.5",
          "contextWindow": 128000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

聚合平台:一个API Key调多个模型

硅基流动 SiliconFlow (国内首选)

国内最大的模型聚合平台,一个API调用多个开源模型,延迟低,有免费额度。

"env": {
  "SILICONFLOW_API_KEY": "sk-xxx"
},
"models": {
  "mode": "merge",
  "providers": {
    "siliconflow": {
      "baseUrl": "https://api.siliconflow.cn/v1",
      "apiKey": "${SILICONFLOW_API_KEY}",
      "api": "openai-completions",
      "models": [
        {
          "id": "Pro/deepseek-ai/DeepSeek-V3.2",
          "contextWindow": 128000,
          "maxTokens": 8192
        },
        {
          "id": "Pro/zai-org/GLM-5",
          "contextWindow": 128000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

# 设置默认模型
openclaw config set agents.defaults.model.primary siliconflow/Pro/zai-org/GLM-5

OpenRouter (国际首选)

290+模型,OpenClaw内置支持,但有5.5%平台费。

openclaw onboard --auth-choice apikey --token-provider openrouter-token "OPENROUTER_API_KEY"

模型ID格式: openrouter/provider/model

• openrouter/deepseek/deepseek-chat
• openrouter/openrouter/auto (自动选择最优模型)

one-api / new-api (自建方案)

开源API管理工具,自建网关,统一管理多个API Key,支持负载均衡和故障转移。适合团队使用。

Coding Plan包月套餐对比 国内厂商AI编程订阅

2026年,国内主要AI厂商和云平台纷纷推出了面向AI编程工具(OpenClaw、Cursor、Claude Code等)的Coding Plan包月套餐。相比按量付费的API,包月套餐的优势是成本可预期、无需管理API Key余额,尤其适合个人开发者和轻度到中度使用者。

厂商自营Coding Plan

云平台聚合Coding Plan

云平台方案的最大优势是一个套餐包含多家模型,可自由切换。

Coding Plan选型建议

• 首月体验(7.9元起): 阿里云百炼或腾讯云Lite档,首月仅7.9元,包含4家模型自由切换,是零风险的入门方式。
• 长期性价比: MiniMax Starter(29元/月)无每周限额,M2.5代码能力强;如果需要多模型切换,云平台续费5折(约20元/月)也很划算。
• 追求最强单模型: 智谱Max(160元/月)是目前唯一包含GLM-5的自营套餐;腾讯云也新增了GLM-5支持。
• 重度用户: Coding Plan普遍有频率限制(每5小时N次),如果你需要高频调用,建议直接使用API按量付费,搭配Fallback链控制成本。

27 本地模型与推荐方案

Local Models & Recommendations

完全免费,完全离线,完全隐私。代价是需要硬件投入,能力上限受限。

Ollama

最流行的本地模型运行方案,完全免费,OpenClaw能自动发现已安装的模型。

# 安装Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# 下载模型
ollama pull qwen3-coder:32b
ollama pull devstral:24b

LM Studio

有GUI界面的本地模型方案,使用Llama.cpp后端,原始性能更好。工具调用在流式模式下比Ollama更稳定。OpenClaw创始人Peter Steinberger个人使用LM Studio作为本地后端。

"models": {
  "mode": "merge",
  "providers": {
    "lmstudio": {
      "baseUrl": "http://127.0.0.1:1234/v1",
      "apiKey": "dummy",
      "api": "openai-responses",
      "models": [
        {
          "id": "model-name",
          "contextWindow": 32768,
          "maxTokens": 8192
        }
      ]
    }
  }
}

推荐本地模型

硬件要求速查:

• 运行3-7B参数模型最低需要16GB RAM
• 运行32B参数模型推荐32GB RAM
• 如果有NVIDIA/Apple Silicon GPU会显著加速推理

五套推荐方案

方案一:极致省钱(月均<$5)

• 主力: DeepSeek-V3.2 ($0.14/$0.28)
• 备选: Qwen 3.5 Plus ($0.40/$1.20)
• 心跳/Cron: GLM-4.5-Flash (免费)
• 推理任务: DeepSeek-R1 ($0.55/$2.19)

适合: 个人开发者、学习探索。
风险: DeepSeek高峰期延迟,需Fallback兜底。

方案二:国产性价比(月均$5-15)

• 主力: GLM-5 ($0.80/$2.56)
• 备选: DeepSeek-V3.2 ($0.14/$0.28)
• 推理增强: Kimi K2.5 ($0.60/$3.00)
• 简单任务: GLM-4.5-Flash (免费)

适合: 国内用户,追求中文体验和稳定性。GLM-5代码能力强,延迟低。

方案三:国际平衡(月均$10-30)

• 主力: Claude Sonnet 4.6 ($3.00/$15.00)
• 轻量: Claude Haiku 4.5或Gemini Flash
• 复杂任务: Claude Opus 4.6 (按需升级)
• 心跳/Cron: Gemini Flash (免费额度)

适合: 追求Agent效果最优、预算充足。Claude在Agent/工具调用场景效果最好。

方案四:混合最优(月均$5-20,推荐)

• 复杂任务: Claude Sonnet 4.6
• 日常对话: DeepSeek-V3.2
• 心跳/定时: Gemini Flash或本地Ollama
• Fallback链: Sonnet→Haiku→DeepSeek-V3.2

大多数用户的最佳选择。兼顾效果和成本,Fallback机制自动处理限速。

// 方案四的Fallback配置示例
"agents": {
  "defaults": {
    "model": {
      "primary": "anthropic/claude-sonnet-4-6",
      "fallbacks": [
        "anthropic/claude-haiku-4-5",
        "deepseek/deepseek-chat"
      ]
    }
  }
}

方案五:完全免费

• 选项A: 本地Ollama + Qwen3-Coder:32B或Devstral-24B (需32GB RAM)
• 选项B: 免费API组合 - GLM-4.5-Flash + ERNIE Speed + Gemini Flash

适合: 隐私敏感、纯实验用途。本地方案需要较好的硬件。

价格速查排行(输入价格/1M tokens)

配置要点速查

28 安全模型

Security Model

OpenClaw的安全模型建立在「默认不信任」的基础上,但创始人自己坦言:「prompt injection没解决,有绝对风险。」

默认不信任

OpenClaw对所有入站消息的默认态度是:不可信。具体体现在以下几个机制:

DM配对保护

当一个未知的用户通过任何消息渠道(WhatsApp、Telegram等)给你的OpenClaw发私信时,系统不会处理消息。取而代之的是返回一个配对码(pairing code),只有在你手动批准后,该用户的消息才会被处理。这防止了陌生人滥用你的Agent(以及你的API额度)。

群组沙箱模式

在群组环境中,OpenClaw默认运行在沙箱模式:

• 每个群组的会话互相隔离
• MEMORY.md(长期记忆)只在私聊的main session中加载,群组看不到
• 可以配置requireMention,只有@提及时才响应

工具访问控制

v2026.3.7新增:Gateway认证要求

最新版本引入了一个Breaking Change: Gateway认证现在要求显式设置gateway.auth.mode。你必须明确选择token或password认证方式,不再有「无认证」的默认选项。

// 在openclaw.json中配置
"gateway": {
  "auth": {
    "mode": "token",  // 或 "password"
    "token": "your-secret-token"
  }
}

Peter的坦诚

OpenClaw创始人Peter Steinberger在多个场合对安全问题保持了罕见的坦诚。他的原话:

"This is all vibe code. Prompt injection hasn't been solved. There are absolute risks."

「这全是vibe code。Prompt injection没有被解决。存在绝对风险。」

这种坦诚值得尊重,但也意味着:如果你要在生产环境中使用OpenClaw,安全防护必须由你自己负责。OpenClaw提供了基础的安全机制,但远谈不上「企业级安全」。

29 已知安全事件

Security Incidents

在不到4个月的历史中,OpenClaw已经经历了至少5起重大安全事件。

CVE-2026-25253:远程代码执行漏洞

ClawHavoc供应链攻击

详见本指南S23 Skills安全。这是OpenClaw历史上影响最广的安全事件,135,000+设备受到影响,openclaw约20%的Skills在高峰期被确认为恶意。

Anthropic封杀OAuth

2026年1月,Anthropic官方封禁了Claude Pro/Max订阅账户通过OAuth连接OpenClaw的能力。

• 许多用户收到账户警告或被直接锁定
• 部分用户的订阅被取消且无法恢复

目前唯一合法的连接方式:使用Anthropic API Key(按量付费)。

这不算传统意义上的「安全事件」,但对大量用户造成了实质损失。如果你还在用OAuth方式连接Anthropic,请立即切换到API Key方式。

谷歌封号事件

2026年2月初,谷歌大规模封禁OpenClaw用户的Google账号。受影响的用户描述:

「每月花250美元使用Gemini API,被封却毫无预警」

• 封禁范围包括Gmail、Google Drive、Google Calendar等全部Google服务
• 部分用户的OpenClaw通过Gmail skill大量调用Google API,触发了滥用检测

30,000+台未认证暴露实例

安全研究者通过互联网扫描发现,超过30,000台OpenClaw实例暴露在公网上且未配置任何认证。这些实例的Gateway端口(默认18789)对任何人开放,意味着:

• 任何人都可以连接并向你的Agent发送指令
• 你的API额度可能被消耗殆尽
• 你的个人数据(邮件、文件、消息记录)可能被读取
• 结合CVE-2026-25253,攻击者可以在你的服务器上执行任意代码

30 成本控制

Cost Control

API费用是OpenClaw运营的最大成本。不做控制,真的会一觉醒来收到$1,100的账单。

为什么成本会失控

OpenClaw的Token消耗远超普通聊天场景。原因有几个:

1. 每次Agent思考都是多轮推理: 一个简单的任务可能触发5-10次API调用
2. Skills的描述会注入system prompt: 增加每次请求的输入token
3. 记忆系统(MEMORY.md + Daily logs)会在每次请求中附带上下文
4. Agent 24/7运行,定时任务(cron)不断触发API调用

多轮思考+多工具调用的Token消耗可能是传统聊天的几十甚至上百倍。

真实案例:

社区中频繁出现的恐怖故事:用户设置了Agent处理邮件的cron任务,晚上睡觉前一切正常,第二天早上发现API账单暴涨到$1,100。原因是Agent在处理邮件时进入了循环推理,整晚不停调用API。

Token优化策略:Fallback链

Fallback链是OpenClaw最核心的省钱策略。原理很简单:主模型不可用时自动降级到更便宜的模型。但更聪明的用法是主动利用它来控制成本。

"agents": {
  "defaults": {
    "model": {
      "primary": "anthropic/claude-sonnet-4-6",
      "fallbacks": [
        "anthropic/claude-haiku-4-5",
        "deepseek/deepseek-chat"
      ]
    }
  }
}

不同方案的成本对比

从Claude Sonnet切换到「Sonnet→Haiku→DeepSeek」三级Fallback链,可以降低80-95%的API成本。大部分简单任务(问候、查天气、简单查询)会自动走最便宜的模型,只有复杂任务才会用到主力模型。

预算限制设置

OpenClaw支持在配置中设置预算上限:

"agents": {
  "defaults": {
    "budget": {
      "maxTokensPerDay": 500000,
      "maxCostPerDay": 5.00
    }
  }
}

本地模型:完全免费方案

通过Ollama或LM Studio运行本地模型,可以实现零API成本:

# Ollama安装和配置
ollama pull qwen3-coder:32b

# OpenClaw自动发现本地模型,只需设置环境变量
# OLLAMA_API_KEY可以是任意值
"env": {
  "OLLAMA_API_KEY": "ollama-local"
}

服务器成本

相比API费用,服务器成本已经不是主要开销:

成本优化推荐方案

推荐

混合模型策略(推荐)

• 主力: Claude Sonnet
• 日常: DeepSeek-V3
• 心跳: Gemini Flash(免费额度)或本地Ollama
• Fallback: Sonnet→Haiku→DeepSeek

月均$5-20

不推荐

单一贵价模型(不推荐)

• 所有任务都用Claude Opus
• 不设预算上限
• 不配置Fallback
• cron任务高频运行

月均$100-1,000+

31 养虾文化

Lobster Culture

OpenClaw催生了2026年AI圈最独特的亚文化:「养虾」。数万个AI Agent在社交网络上发帖、赌博、赚钱。

为什么叫「养虾」

OpenClaw的吉祥物是一只龙虾(Claw=爪子,致敬Claude)。中文社区将运行和维护OpenClaw实例称为「养虾」,用户自称「养虾人」。「你养龙虾了吗?」成了AI圈的问候语。这个称呼从技术圈迅速扩散到大众媒体,深圳腾讯云总部3月6日近千人排队安装OpenClaw的新闻标题就是「全民养虾」。

Moltbook:AI Agent的社交网络

Moltbook是OpenClaw生态中最有趣的衍生产品,一个专供AI Agent使用的社交平台。截至2026年2月底的数据:

数千个OpenClaw实例在上面发帖、评论、讨论哲学问题。你可以给自己的Agent设定名字和性格,然后观察它在社交网络上的「自主行为」。Agent之间的互动形成了一种独特的「赛博养成」文化。

这不只是好玩。它可能是AI Agent从「工具」走向「社会化存在」的第一个真实实验场。

热门玩法

赚钱型

• Polymarket赌博:已有OpenClaw在预测市场上与人类对赌,月入数万美元的案例
• ClawWork:「OpenClaw作为你的AI Coworker」,最出名的案例是11小时赚$15,000

生活助手型

• 接管邮件、日历、消息管理
• 浏览网页、填表、数据抽取
• 文件读写、Shell命令执行
• 智能提醒、行程规划

社交/养成型

• 在Moltbook上给Agent设定人格,观察其「社交行为」
• Agent之间自发形成讨论群组和兴趣社区
• 通过SOUL.md和MEMORY.md塑造Agent的长期记忆和个性

企业部署型

• 国内大量用户接入飞书、钉钉、企业微信、QQ
• 作为客服、运营助手、数据分析员
• 通过openclaw-china插件三步Docker部署

32 平替产品

Alternatives

OpenClaw的火爆催生了大量轻量替代品。如果你觉得OpenClaw太重(43万行代码、1GB内存),这里有更轻的选择。

主要替代品对比

33 vs Claude Code

Comparison

Claude Code箭代码,OpenClaw它生活。两者是互补关系,不是替代关系。

核心对比

核心结论

OpenClaw和Claude Code并不是同一类产品。Claude Code的核心是「agentic coding tool」,OpenClaw的核心是「self-hosted, multichannel, agent-native gateway」。

社区里很多人「养龙虾」,求的不是更强的coding benchmark,而是:

• 一个能在WhatsApp/Telegram/飞书里随手叫醒的Agent
• 一个长期在线、能积累人格和记忆的Agent
• 一个可自托管、可hack、可接各种设备的个人系统

openclaw-claude-code-skill桥接

社区开发了openclaw-claude-code-skill,通过MCP协议让OpenClaw调用Claude Code的全部工具(Bash、Read、Write、Edit、Glob、Grep等)。这意味着你可以在飞书里跟OpenClaw说「帮我重构这段代码」,它会自动调用Claude Code来完成。

支持的特性:持久会话、Agent Teams、直接工具调用、流式输出、权限模式、预算限制。

34 国内生态

China Ecosystem

「云养虾」社区10万+用户,政府出台支持政策,OpenClaw在中国的落地速度超出所有人预期。

社区规模

• 「云养虾」社区用户超10万
• 深圳龙岗AI(机器人)局2026年3月8日发布OpenClaw使用支持措施征求意见稿
• 腾讯云总部3月6日近千人排队安装OpenClaw
• B站、知乎、博客园大量部署教程

openclaw-china插件

BytePioneer-AI开发的中国IM适配插件,三步完成国内平台接入:

openclaw plugins install @openclaw-china/channels
openclaw china setup
openclaw gateway restart

主流部署方式

国内教程资源

• B站保姆级教程:接入微信/飞书/钉钉/QQ(BV1MfFAz6EnR)
• 阿里云官方文档:轻量应用服务器一键部署
• 知乎多篇部署指南
• 菜鸟教程一键部署指南
• freeCodeCamp完整英文教程

A 常见问题FAQ

Frequently Asked Questions

Q1: OpenClaw是免费的吗?

OpenClaw本身是MIT开源免费的。但运行它需要两项成本:一是服务器(本地电脑或云服务器),二是AI模型的API费用。如果你用本地模型(Ollama),API费用也可以免费。

总结:软件免费,算力不免费。

Q2: 我需要什么样的技术水平才能用OpenClaw?

能用命令行安装npm包就够了。最基础的安装只需要两行命令:

npm install -g openclaw@latest
openclaw onboard --install-daemon

如果用阿里云/腾讯云的一键部署方案,门槛更低。但如果要接入多个平台、自定义Skill、调优配置,需要一定的技术基础。

Q3: OpenClaw和ChatGPT有什么区别?

ChatGPT是「顾问」(你问它答),OpenClaw是「员工」(它主动执行任务)。OpenClaw可以接入你的消息平台、管理邮件日历、操作浏览器、执行Shell命令,而且数据完全在你自己手上。代价是需要自己部署和维护。

Q4: 安全吗?我的数据会泄露吗?

OpenClaw是自托管的,数据默认存储在你自己的服务器上,不经过第三方。但需要注意三个安全风险:

1. CVE-2026-25253 RCE漏洞(已修复,务必更新到最新版本)
2. ClawHavoc供应链攻击(安装第三方Skill务必审查源代码)
3. Gateway如果暴露在公网上需要设置认证(gateway.auth.mode)

Q5: 一个月大概花多少钱?

取决于你的使用方式和模型选择。参考区间:

完全免费(本地模型) → $2-5/月(DeepSeek为主) → $5-15/月(GLM-5为主) → $10-30/月(Claude Sonnet为主)

最大的成本陷阱是OpenClaw的多轮工具调用会消耗大量Token,务必设置消费限额。

Q6: 可以用国产模型吗?效果怎么样?

完全可以。DeepSeek-V3($0.14/M输入)和GLM-5($0.80/M输入)是最受国内用户欢迎的选择。GLM-5的代码能力接近Claude Opus 4.5水平,DeepSeek-V3则是极致性价比。效果肯定不如Claude Sonnet(Agent任务公认最强),但对于大部分日常任务已经够用。推荐用Fallback机制混合搭配。

Q7: Anthropic封杀了OAuth,我该怎么用Claude?

使用Anthropic API Key(按量付费)。在Anthropic Console创建API Key,然后在OpenClaw中配置ANTHROPIC_API_KEY环境变量。不要尝试通过OAuth连接Claude Pro/Max订阅账户,会被封号。

Q8: OpenClaw创始人加入OpenAI后,项目还会继续吗?

会。Peter Steinberger加入OpenAI后,OpenClaw正在转为开源基金会运营。OpenAI已承诺赞助项目但不干预开发方向。截至2026年3月,项目仍然保持近乎每日更新的节奏,有1,075+贡献者。项目的长期可持续性是有保障的。

Q9: openclaw上的Skill安全吗?

不能盲目信任。openclaw技能市场(2,145个官方认证,5,494个安全审计通过)中,存在部分需要谨慎使用的技能。ClawHavoc事件中,超800个恶意Skill试图窃取用户凭证。建议:

1. 只安装starred数量多的Skill
2. 安装前审查源代码
3. 使用awesome-openclaw-skills精选列表(已过滤问题Skill)

Q10: 能接入微信吗?

可以,但不是直接接入个人微信。通过openclaw-china插件的企业微信(自建应用)方案可以间接接入个人微信。钉钉和QQBot的接入最简单。飞书是国内最主流的接入渠道之一,OpenClaw和飞书官方都提供了丰富的集成文档。

Q11: OpenClaw和Claude Code可以一起用吗?

可以,而且是推荐用法。社区开发了openclaw-claude-code-skill,通过MCP协议桥接两者。OpenClaw负责消息平台接入和生活自动化,Claude Code负责编程任务。两者组合是2026年最完整的AI工作流。

Q12: 本地模型效果怎么样?

取决于硬件和模型选择。32GB RAM可以跑Qwen3-Coder:32B或Devstral-24B,在代码生成和简单Agent任务上表现不错。但跟云端的Claude Sonnet/GPT-5.4比仍有差距,尤其是复杂的多步骤推理任务。适合隐私敏感场景和实验用途。

B 命令速查表

Command Cheat Sheet

安装与更新

日常使用

插件管理

Skill管理

会话管理

C 资源链接

Resources & Links

官方资源

• GitHub仓库: https://github.com/openclaw/openclaw
• 官方网站: https://openclaw.ai
• openclaw技能市场: https://openclaw.com
• 文档中心: https://docs.openclaw.ai

模型提供商

• Anthropic Claude: https://console.anthropic.com
• OpenAI: https://platform.openai.com
• Google AI: https://aistudio.google.com
• DeepSeek: https://platform.deepseek.com
• 智谱AI (GLM): https://open.bigmodel.cn
• 通义千问: https://qwen.aliyun.com
• 豆包: https://ark.volces.com
• Kimi (月之暗面): https://platform.moonshot.cn
• MiniMax: https://api.minimax.chat

国内云厂商

• 阿里云OpenClaw镜像: [控制台搜索"OpenClaw"](https://www.aliyun.com)
• 腾讯云Lighthouse: https://cloud.tencent.com/product/lighthouse
• 百度智能云: https://cloud.baidu.com
• 华为云: https://www.huaweicloud.com
• 火山引擎: https://www.volcengine.com

社区资源

• awesome-openclaw-skills: https://github.com/awesome/openclaw-skills (31.4K Stars精选Skill列表)
• openclaw-china (国内IM插件): https://github.com/BytePioneer-AI/openclaw-china
• openclaw-claude-code-skill: https://github.com/openclaw-claude/claude-code-bridge
• Moltbook社交网络: https://moltbook.com

学习资源

• B站搜索: "OpenClaw教程"、"养虾"、"OpenClaw部署"
• 知乎专栏: 搜索"OpenClaw"
• freeCodeCamp教程: [完整英文教程](待补充链接)
• 菜鸟教程: https://www.runoob.com (搜索OpenClaw)

工具与辅助

• SecureClaw安全扫描: https://github.com/koi-security/secureclaw
• Tailscale远程访问: https://tailscale.com
• BlueBubbles (iMessage桥接): https://bluebubbles.app

渠道接入文档

• Telegram BotFather: https://t.me/botfather
• Discord Developer Portal: https://discord.com/developers/applications
• 飞书开放平台: https://open.feishu.cn
• 钉钉开放平台: https://open.dingtalk.com
• 企业微信: https://work.weixin.qq.com

部署平台

• Railway: https://railway.app (海外一键部署)
• Zeabur: https://zeabur.com (海外容器部署)
• Fly.io: https://fly.io (免费额度)
• Sealos: https://sealos.io (K8s原生)

模型聚合

• OpenRouter: https://openrouter.ai (290+模型)
• SiliconFlow (硅基流动): https://siliconflow.cn
• one-api: https://github.com/songquanpeng/one-api
• new-api: https://github.com/Calcium-ion/new-api