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

本文由 莫潇羽@源码七号站（www.fuyuan7.com）撰写，转载请注明出处。

快速摘要

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 怎么申请

有新手到这