OpenClaw 实操全记录:从安装配置到接入飞书/企业微信,再到浏览器自动化批量运营

本文由 莫潇羽@无忆研习社（www.wuyi.wiki）撰写，转载请注明出处。

快速摘要

OpenClaw（原名 ClawdBot / Moltbot，圈里习惯叫它"龙虾"）是一个开源、可自托管的个人 AI 智能体。它不是普通聊天机器人，而是一个能真正动手干活的"行动者"——读写文件、跑命令、操控浏览器、调度定时任务，全都能干。它的整套玩法可以拆成四步:第一步装好 Node.js 22 以上的环境并安装本体；第二步用 onboard 向导接入一个大模型当"大脑"(我自己折腾下来推荐国产模型,便宜、稳、合规);第三步把"网关"(Gateway)跑起来,它就是 24 小时常驻的控制中枢,默认监听 127.0.0.1:18789,顺带提供网页控制台；第四步把它接到你常用的聊天工具——飞书、企业微信、微信——之后,你在手机上发条消息,它就能在你电脑上执行任务,甚至自己打开浏览器去操作豆包生图、往小红书发帖。 这套东西最值钱的地方,不是某个单点功能,而是它把"我已有的聊天软件"和"我电脑上的工具链"焊在了一起,变成一个全程在线、越用越懂你的数字助手。

这篇我会把整条链路从头到尾走一遍,每一步该敲什么命令、哪里容易卡住、我自己踩过哪些坑,都写清楚。想看完整拆解,往下翻。

一、先搞清楚 OpenClaw 到底是个什么东西

很多人第一次听说 OpenClaw,会下意识把它归到"又一个聊天机器人"那一类。这个理解偏得有点远。我刚上手那会儿也这么想,结果用了两天才反应过来:它和你平时在网页上跟 AI 对话,根本不是一个物种。

它不是来陪你聊天的,是来替你干活的

普通的对话式 AI,你问它一个问题,它给你一段文字,仅此而已。OpenClaw 不一样,它是部署在你自己机器上的一个智能体运行时,坐在你的消息软件和工具链中间。你给它下一句指令,它能去读你本地的文件、整理你的邮件、运行一段代码、打开浏览器自己点点点,甚至按你设定的时间表自动执行任务。

换句话说,前者是"嘴",后者是"手脚加大脑"。我自己最直观的感受是:以前我跟 AI 说"帮我把这个目录下所有日志文件列出来",它只会教我怎么写命令；换成 OpenClaw,我说同样一句话,它直接就把结果摆我面前了。这个差别,用过一次就回不去了。

四个核心模块,记住这张图就够了

OpenClaw 的架构不复杂,拆开就是四块,理解了这四块,后面所有配置你都能想明白为什么要那么干。莫潇羽建议你把下面这张图记在脑子里:

graph LR
    A[你的手机/电脑<br/>飞书·企业微信·微信] -->|发消息| B[网关 Gateway<br/>常驻控制中枢]
    B -->|调用| C[大模型<br/>智谱·通义·DeepSeek]
    B -->|授权| D[工具 Tools<br/>浏览器·文件·Shell·定时]
    B -->|加载| E[技能 Skills<br/>SKILL.md + 脚本]
    C -->|思考结果| B
    D -->|执行结果| B
    B -->|回复| A

逐个说一下:

• 网关(Gateway):整套系统的心脏。它始终在后台运行,负责管理会话、把不同渠道来的消息路由到正确的地方、调度各种工具。默认监听本机的 127.0.0.1:18789,同时对外提供网页控制台和网页聊天界面。你发的每一条消息,都是先到网关,网关再决定怎么处理。
• 渠道(Channels):连接各类聊天软件的"接口层"。它支持的渠道相当多,飞书、企业微信、微信、钉钉这些国内常用的都在列。配置渠道,本质就是让你能用自己熟悉的聊天软件去指挥这个智能体。
• 工具(Tools):智能体的"手脚",决定了它能不能做某件事。浏览器自动化、文件读写、Shell 命令执行、定时任务,这些底层能力都属于工具。
• 技能(Skills):由一个 SKILL.md 加上配套脚本组成的能力包,相当于"教材",教智能体怎么把若干个工具组合起来完成一个具体任务。这里有个关键点新手常搞混:工具是"能不能做",技能是"怎么做";没有工具授权,技能写得再花哨也跑不起来。

为什么大家管它叫"龙虾"

你在各种教程里会看到大家亲切地喊它"龙虾"。这名字来自它的标志(claw 是爪子,联想到龙虾大钳子),用着用着就成了社区黑话。这个昵称背后其实藏着它最厉害的一个特性——持久记忆。它采用分层的记忆架构,用上一段时间之后,你的"龙虾"会慢慢摸清你的作息、沟通习惯、正在推进的项目、你讨厌的那些细节、你常用的工具,甚至能听懂你嘴里那句含糊的"按老样子来"到底指什么。

这种随着持续使用不断积累的"复利效应",是任何用完即走、无状态的 AI 工具复制不了的。我自己用到第二周,明显能感觉到它越来越"上道"——这也是我愿意花时间把它配好的根本原因。

它日常到底能帮你干哪些活

光说概念太虚,我列几个我自己真正在用、或者身边人在用的场景,你感受一下它的能力边界。文件这块,它能读写你本地的文件,比如"把这个目录下所有日志文件列出来""读一下这个配置文件,帮我总结一下里面写了什么"。邮件这块,它能帮你处理收件箱,像"把今天所有促销类邮件标记已读并归档"这种重复劳动,交给它最合适。日程这块,你要是总忘看行程,可以让它"把我明天的日程按时间整理出来发给我"。代码这块,它能跑命令、能审查代码,我见过有人人不在电脑前,掏出手机就让它去看同事最新提交的代码做评审。

往运营和创作上靠,它的想象空间就更大了——生成图片、整理素材、按模板产出内容、定时发布,这些后面章节都会展开讲。核心是你得换个思路:别再把它当成"问答机器",而是当成一个"你能远程指挥的实习生",它有手有脚,你说清楚要什么,它就去做。想明白这一层,你才会真正愿意花心思把它配置好。

下面就进入正题,从最基础的环境准备讲起。

二、动手之前:把环境准备好

工具再强,环境不对也是白搭。我见过太多人卡在第一步,不是软件本身有问题,而是底层环境没铺好。这一节我们先把地基打牢。

系统和硬件,先看自己够不够格

OpenClaw 对操作系统挺包容的,主流三大平台都支持,但各有各的讲究:

硬件这块门槛不高:内存建议 2GB 以上,存储留出 5GB 以上空间。如果你打算把它放在内存只有 2GB 的小服务器上跑,我的经验是顺手再划一块 4GB 左右的 Swap(交换空间)出来,跑起来会稳不少,不然遇上稍微吃内存的任务容易被系统直接掐掉。

这里多提一句:Windows 本身在很多细节上对这类命令行工具不算友好,默认还会限制脚本运行。所以如果你是 Windows 用户又不嫌折腾,我个人更推荐走 WSL2,相当于在 Windows 里跑一个干净的 Linux 子系统,后面少很多莫名其妙的坑。

真正的硬门槛:Node.js 版本

这是整个准备阶段最该重视的一条:OpenClaw 需要 Node.js 22 及以上版本,这是硬性要求,版本太低直接跑不起来。官方目前更推荐用 Node 24,出于兼容性考虑也仍然支持 22 的 LTS 版本(22.16+)。

装之前先检查一下自己机器上的 Node 版本。打开命令行,敲一句:

node -v

如果显示的是 v22.x 或 v24.x 这样的号,恭喜你可以往下走了;要是版本太老,或者干脆提示找不到这个命令,那就得先把 Node 整明白。我自己习惯用 nvm(Node 版本管理器)来装和切换,几条命令搞定:

# 安装 nvm(已装可跳过)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc

# 安装并切到 Node 22
nvm install 22
nvm use 22

# 再确认一次版本
node -v

Windows 用户如果不想用 nvm,直接去 Node.js 官网下载安装包,一路"下一步"傻瓜式装完也行,装完同样用 node -v 验一下。这一步我必须啰嗦一句:别图省事跳过版本检查。我帮人排查过好几次"装好了跑不起来"的问题,十有八九根子就在 Node 版本上,白白浪费半小时。

三种安装路线,对号入座

环境就绪后,装本体有三条路,适合的人群不一样,先看清楚再选:

我的建议很明确:第一次玩,要么用一键脚本,要么用 npm。源码那条路留给确实要改代码的开发者,而且就算你是开发者,我也劝你先用前两种方式把流程跑通,心里有数了再切源码,不然出了问题你都不知道是配置错了还是构建挂了。具体怎么装、装完怎么验,下一章接着讲。

三、安装 OpenClaw:从下载到第一次跑起来

环境铺好了,这一章我们把本体装上,并让它第一次"喘上气"。我会以最省事的路线为主线讲,顺手把几个验证手段也带上,这样万一出问题你能自己定位。

下载与安装

如果你是 Windows 用户,最直接的方式是去官网下载 Windows 安装程序,下完双击安装,跟普通软件没区别。我那台机器之前装过,所以演示时直接打开命令行就用了——这里提醒一句,装完之后所有操作基本都在命令行里完成,你得先习惯打开终端这件事。

如果你已经有 Node 环境,我更推荐 npm 全局安装,一行命令的事:

npm install -g openclaw

嫌官方源慢的话,也可以用一键脚本,脚本会顺带把 Node 检测和安装都包圆:

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

国内网络环境下,如果官方源下载吃力,社区还维护了带国内镜像源、内置中文界面的版本,装起来会顺一些。这块按你自己的网络情况灵活选,核心目标只有一个:把本体装上去。

加一个守护进程,让它开机自启

装的时候有个参数我强烈建议带上——--install-daemon。它的作用是把网关安装成系统服务(守护进程),这样设备重启之后,网关会自动在后台拉起来,你不用每次开机都手动去敲一遍启动命令。

openclaw onboard --install-daemon

不带这个参数也能用,只是每次重启后你都得手动跑一次 openclaw gateway 才能用,挺烦的。需要注意的是,Windows 不支持系统服务,所以 Windows 用户即便带了这个参数也还是得手动启动网关——这又是一个我推荐 WSL2 的理由。把网关当成一个"永不离线的数字助理",装成守护进程才能真正发挥它 24 小时在线的价值。

装完先体检:doctor 和 status

很多人装完就急吼吼地往下配,结果哪一步错了都不知道。莫潇羽的习惯是:装完先做两件事自检。

第一件,跑 openclaw doctor。这个命令会对你的系统环境和配置文件做一次全面体检,哪里不对它会直接告诉你,还给修复建议。以后只要遇到问题,这应该是你第一个想到的命令。

openclaw doctor          # 全面健康检查
openclaw doctor --deep   # 深度检查,排查更隐蔽的问题

第二件,跑 openclaw status,看网关的实时运行状态——它在不在线、连了哪些聊天会话,一目了然。

openclaw status          # 查看网关运行状态
openclaw gateway status  # 单看网关服务状态

顺便把几个后面会反复用到的命令也记一下,它们是你日常和这只"龙虾"打交道的高频工具:

体检通过、状态正常,就说明本体这一关过了。但现在它还是个"空壳"——有手有脚,没脑子。下一章我们就给它装上大脑。

四、最关键的一步:给它接上一个大模型

这一章是整篇里最要紧的部分,你前面装得再顺,这一步配不对,它就是个不会思考的木偶。我把它单独拎出来重点讲。

先记住一句话:OpenClaw 自己没有脑子

这是新手最容易误会的地方。OpenClaw 本身不包含任何 AI 模型,它只是一个智能体框架——负责接收消息、调度工具、执行动作,但"思考"这件事,得交给一个外部大模型来做。所以你必须给它接入一个大模型的 API,它才能真正活起来。

打个白话比方:OpenClaw 是身体,大模型是脑子,网关是神经中枢。三者凑齐,这个智能体才完整。

跟着 onboard 向导一步步走

接模型最稳的方式,就是用 onboard 向导,它会牵着你的手走完整个流程,大约两三分钟搞定。运行起来之后,它会依次问你几件事,我把关键环节拆给你看:

第一问:配置处理方式。 如果你之前配过,它会检测到已有配置,问你保留、修改还是重置。第一次配直接往下走就行。

第二问:网关模式(Local / Remote)。

Gateway mode:
[1] Local  (在本机运行网关)
[2] Remote (连接到别处的网关)
Choose [1-2] [1]:

第一次用,毫不犹豫选 1(Local,本地模式)。Remote 模式只是把客户端连到别处的网关,并不会在本机装网关,新手别碰。选完它会确认默认端口是 18789,默认绑定 127.0.0.1(本机回环地址),这些保持默认即可。

第三问:接哪个模型、填 API Key。 向导会先检测环境里有没有现成的 API Key,没有就让你填。以接入某个模型平台为例,流程大致是:

Enter your API Key: sk-xxxxxxxxxxxxxxxx
✓ Key saved to ~/.openclaw/.env

Default model selection:
Available models:
[1] xxx-flagship   (recommended)
[2] xxx-turbo
[3] xxx-thinking
Choose default model [1]:

你只要把对应平台控制台里申请到的 API Key 粘进去,再选一个默认模型就行。如果某一步你拿不准填什么,我的土办法是:截个图丢给任意一个 AI 问一句,它会告诉你这一步该选哪个、为什么——这招对新手特别管用,别硬扛。

我为什么一律推荐国产模型

向导走到选模型那一步,选哪个其实大有讲究。我自己的结论很直接:优先选国产模型。原因有三个,排版成表更清楚:

这几家国产模型现在迭代得很快,性能和性价比都在猛涨,完全够日常自动化任务用。我自己跑下来,做内容整理、浏览器操作、消息应答这类活儿,国产模型的表现一点不含糊,关键是花得起、用得稳。

顺便说说 API Key 怎么申请

有新手到这一步会卡住:"API Key 到底从哪儿来?"其实不难,逻辑各家都差不多。你选定一家模型平台后,去它的官网注册账号,进到控制台,找到"API Key 管理"或者"密钥管理"这类入口,点"创建 API Key",系统就会给你生成一串以特定前缀开头的字符串(很多平台是 sk- 打头)。这串就是你的钥匙,复制下来填到 OpenClaw 里即可。

这里有几个我提醒过很多人的注意点。第一,API Key 等于你账户的钱包,千万别泄露、别截图发到群里,更别提交到公开的代码仓库。第二,有的平台除了 Key 还要你记一个 Base URL(接口地址),如果向导里有这一项,记得一并填对,很多"模型连不上"的报错根子就在 Base URL 填错。第三,新注册账号往往有免费额度或体验包,拿来跑通流程、做测试再合适不过,等用顺了再考虑充值。

把 Key 填进去之后,向导会提示已保存(通常存到配置目录下的环境变量文件里),接着就让你选默认模型了。

还有一个进阶玩法值得提一嘴:如果你想随时切换不同供应商、又不想每次都重启网关,可以在中间加一层 AI 网关。配好之后,以后想加新模型、换默认模型,直接跟 OpenClaw 说一句人话就行,比如"帮我把默认模型切换到某某模型",配置热加载即时生效,模型迭代再快也跟得上。这个不是必须,但对追新的人很友好。

把"网关令牌"复制好,妥善保存

向导走到后面,会给你生成一个网关令牌(token)。这个东西非常重要——后面你用网页版连接、或者做某些渠道鉴权,都要用到它。看到它生成出来之后,第一时间复制下来,找个安全的地方存好。

我个人吃过亏:第一次配的时候没当回事,结果后面网页版连接卡住,翻来翻去才想起来令牌没存。所以这里我把它单列出来强调:令牌生成 → 立刻复制 → 妥善保存,这三步一气呵成,别偷懒。存好之后,按提示回车,再用 Ctrl+D 结束配置流程即可。

到这里,身体、脑子、神经中枢都齐了。下一章,我们正式把网关跑起来,完成第一次真正意义上的对话。

五、启动网关,完成第一次对话

配置全部就绪,激动人心的一刻到了——让这只"龙虾"真正开口说话。这一章我会把启动方式、两种交互界面,以及一个特别容易卡住的鉴权坑,都讲透。

把网关跑起来

网关是整个系统的运行核心,先把它启动:

openclaw gateway start          # 启动网关
# 或指定端口
openclaw gateway --port 18789

如果前面装的时候带了 --install-daemon,网关其实会随系统自启,你未必需要手动跑。但 Windows 不支持系统服务,所以 Windows 用户每次都得手动启动,可以让它在后台运行:

# Windows 后台运行
start /b openclaw gateway --port 18789

启动期间,我习惯再开一个新的终端窗口备用——后面接渠道、做测试,经常需要一边让网关常驻、一边在另一个窗口敲命令。等网关初始化完,我们就有两种方式跟它交流了。

两种交互方式:终端 vs 网页

OpenClaw 给了你两个入口,各有各的舒服场景。

第一种,终端命令行对话。 直接在命令行里跟它聊,适合快速测试和敲命令。启动一个命令行对话,发一句最简单的"你好,你是谁?",它会因为刚部署、刚上线,先花一点时间了解自己的情况,然后回你。第一次对话稍微等一下很正常,它在读取上下文、初始化自己。

第二种,网页控制台。 这是我日常用得最多的方式,也最直观。OpenClaw 自带一个功能挺强的网页控制台(官方叫 Dashboard 或 Control UI),直接命令打开:

openclaw dashboard

或者浏览器里访问 http://localhost:18789(如果装在服务器上,把 localhost 换成服务器 IP)。一般情况下我都是用网页版进行交流,界面友好,历史记录、会话状态看得清清楚楚。

一个超常见的坑:网页版连不上,其实是鉴权问题

这里我要重点拎出一个新手几乎必踩的坑。打开网页版的时候,你可能会发现"连接不上、点不进去",一脸懵。其实这不是 bug,是鉴权没配对——它在等你提供凭证。

OpenClaw 的网页连接通常有两种鉴权方式,你得选对一种:

如果你前面老老实实把网关令牌存下来了,这里就选"网关令牌"方式,把那串 token 填进去,连接立刻就通。我自己就是用令牌这一套,填进去之后,网页版瞬间连上,对话框就活了。所以你看,前一章我反复强调"令牌要存好",坑就埋在这儿——存好了,这一步丝滑;没存,这一步抓瞎。

给它起个名字、定个角色

连上之后,别急着丢任务,先花一分钟给它立个"人设"。我一般会先告诉它:你叫什么名字、你的定位是什么。比如我会说"你以后就叫小虾,是我接下来做内容运营学习的 AI 助手"。

它收到之后会开始定义自己——你会看到它认真地规划自己的角色、能力范围,甚至主动问你接下来想让它学什么、做什么。这一步看着像走形式,其实很有用:它的持久记忆会把这个人设记下来,以后的对话都会基于这个定位展开,越往后越顺手。我的经验是,人设定得越清楚,后面它干活越不跑偏。

让网关稳稳常驻,并学会看日志

第一次对话跑通,只能说明此刻是通的。要让它真正成为"全程在线"的助手,你得让网关稳稳地常驻在后台。前面提过守护进程的事,这里再补两个实用动作。

第一个是后台运行。如果你不想让网关占着一个终端窗口,可以让它在后台跑,腾出窗口来干别的:

# 在后台运行网关
start /b openclaw gateway --port 18789   # Windows
# Linux/macOS 可借助系统服务或 nohup 等方式常驻

第二个是看日志。自动化跑起来之后,你不会一直盯着它,但万一某个任务没按预期执行,日志就是你排查问题的第一现场。养成有事先看日志的习惯:

openclaw logs            # 查看运行日志
openclaw gateway status  # 确认网关还活着

我自己的习惯是,凡是"它好像没反应""任务没执行"这类情况,先 logs 看一眼,八成能直接看出是模型调用失败、还是渠道没收到消息、还是任务压根没触发。日志看得懂,你排错的效率会高一大截,不至于干瞪眼瞎猜。

到这里,一个能听懂人话、能干活的 AI 助手就算正式上岗了。接下来两章,先讲讲日常最高频的两个命令,再进入重头戏——把它接到各种聊天软件里。

六、日常最高频的两个命令:切模型与开新会话

把基础玩法摸熟之后,你会发现日常其实就反复用到两个命令。这一章短一点,但都是干货,记住能省你不少事。

-model:随时切换模型

不同任务适合不同模型——有的活儿要快、有的活儿要它多想想。OpenClaw 支持随时切换当前对话用的模型,在输入框里敲:

-model

它会列出可选的模型清单,你上下选中想要的那个,空格确认、回车切换即可。无论是终端还是网页,这个操作都通用。比如我想从默认模型切到某个国产模型,敲一下 -model,选中它,发送,它就告诉你已经切好了。

如果你是在浏览器里的对话框里操作,也是同样的逻辑:输入 -model,发送出去,它列出可选项,你挑一个,再发送确认。整个过程不用改配置文件,即时生效,非常适合"这个任务我想换个脑子试试"的场景。

new:开一个新会话

第二个高频命令是开新会话。用着用着你会发现,有时候它回复变得越来越慢。这通常不是它卡了,而是当前对话的上下文堆得太长了——它每次回复前都要把前面所有的对话内容读一遍,内容越多,读得越久。

这时候,开一个全新的会话就能立竿见影:

new

发一条 new 指令,它会开一个干净的新对话,上下文清空,响应速度马上回来。我的做法是:一个任务告一段落、要切到不相关的新任务时,就顺手 new 一下,既快又不会让前一个任务的上下文干扰后面的判断。

把这两个命令配合着用:-model 负责"换脑子",new 负责"清记忆负担",日常体验会顺畅很多。基础部分到这儿就齐活了,下面正式进入这套工具最有价值的环节——多渠道接入和自动化运营。

七、把 AI 装进飞书:自建应用 + 长连接接入

从这一章开始,进入真正能改变你工作方式的部分——把这只"龙虾"接到你天天用的聊天软件里。这样一来,你人不在电脑前,掏出手机发条消息,它就在你电脑或服务器上帮你把活干了。我先讲飞书,因为它在国内的接入体验是我试下来最顺的一个。

为什么先讲飞书

飞书天然支持长连接(WebSocket)模式,这意味着你不需要公网 IP、不需要域名、不用做端口映射或反向代理,你的 OpenClaw 哪怕跑在家里的电脑、公司内网甚至 NAS 上,都能稳稳接入。对绝大多数个人用户来说,这一点太友好了——省掉了一堆网络配置的麻烦。

第一步:在飞书开放平台创建自建应用

打开飞书开放平台,登录账号后,点击"创建企业自建应用"。这里有个小提醒:建议用个人账号登录,如果是企业账号,后续某些步骤可能需要企业管理员审核,会多一道手续。

创建时,应用名称和描述都得填,但内容不重要,你随意起一个能认出来的名字就行,比如"我的 OpenClaw 助手"。建好之后会自动跳到应用详情页。

接着做两件事:

1. 在"添加应用能力"区域,找到"机器人"卡片,点击"添加",把机器人能力开起来。
2. 到左侧"凭证与基础信息"页面,把 App ID 和 App Secret 这两个参数复制下来,先存到记事本里。这两串东西后面配置时要用,务必保存好,而且别关掉飞书后台页面,后面配权限还得回来。

第二步:把凭证配置到 OpenClaw

如果你前面 onboard 时跳过了渠道配置,现在可以单独把飞书插件装上并配置。先确认插件状态:

openclaw plugins list    # loaded 是已启用,disabled 是禁用
# 没装的话装一下
openclaw plugins install @openclaw/feishu

然后把刚才拿到的两串凭证写进配置:

openclaw config set channels.feishu.appId "你的App ID"
openclaw config set channels.feishu.appSecret "你的App Secret"
# 配完重启网关让它生效
openclaw gateway restart

也可以走 openclaw configure 的交互向导,在渠道里选飞书,把 App ID 和 App Secret 填进去,一路默认回车到完成。两种方式都行,我个人更喜欢直接用命令设置,清爽。

第三步:配置事件回调——这一步最关键

这是整个飞书接入里最容易出错、也最关键的一步,跟着我一步步来,别跳。

回到飞书开放平台,进入你的应用 →"事件与回调"→"事件配置"。订阅方式这里,一定要选"使用长连接接收事件"(WebSocket),不要选 Webhook。选完保存。

这里有个顺序上的坑我必须强调:要先把 OpenClaw 的网关启动好,再来飞书后台配长连接。如果你网关还没跑起来就配,这一步大概率会提示"未建立长连接"。遇到这个报错,先别怀疑人生,检查两件事:一是网关到底起没起来,二是 App ID 和 App Secret 有没有配对、配错。

长连接配好后