OpenClaw 龙虾上手实操全记录：从零搭好本地 AI 智能体，把微信、飞书、小红书全打通

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

快速摘要

OpenClaw（社区里都叫它"小龙虾"或"龙虾"）是一款开源的本地 AI 智能体框架，核心特点就一句话：你负责发指令，它负责在你自己的电脑上动手把活儿干完。 它不是又一个聊天框，而是一套"住在你设备里的 AI 大脑 + 你现成的聊天软件当遥控器"的基础设施。装好之后，一个常驻后台的网关（Gateway）会替你接住来自微信、飞书等渠道的消息，再调度浏览器自动化、文件读写、命令执行、定时任务这些底层能力去执行。本文我自己从零跑了一遍完整链路，把环境搭建、模型配置、命令行与网页两种用法，以及接入企业微信、个人微信、飞书三条渠道、再到操控浏览器发小红书、配定时任务的全过程都拆开讲清楚了。

读这篇文章你能拿到的：一套可复制的安装初始化流程、三条主流 IM 渠道的接入要点和踩坑提醒、一个"让 AI 自己开浏览器干活"的真实案例，以及一份安全避坑清单。新手照着走，大概一两个小时就能把自己的第一只龙虾养起来。想看完整拆解，往下翻。

一、先把"龙虾"这只工具说清楚

我刚接触 OpenClaw 的时候，最大的误区是把它当成"另一个 ChatGPT 套壳"。折腾下来才发现完全不是一个东西。普通的 AI 对话工具，你问它一句它答你一句，它给的是"建议"；而 OpenClaw 给的是"结果"——它真的会去你的电脑上打开浏览器、读写文件、敲命令行，把任务执行到落地为止。

打个我自己常用的比方：传统 AI 工具像一把好用的螺丝刀，单一功能、用完就放下；OpenClaw 更像一整间工具房，里面缺什么工具，它自己找，找不到就自己现造一个。这种"给它一台电脑加完整的本机访问权限，让它自主解决问题"的思路，是它和别的产品最本质的区别。

1.1 它由哪几块拼起来

理解 OpenClaw，记住四个名词就够入门了，我用大白话各解释一句：

Tools 和 Skills 的关系很多人会绕晕，我自己是这么记的：Tools 是"手脚"，Skills 是"教材"。没有手脚，教材教得再好也执行不了；没有教材，手脚也不知道按什么章法去配合。两者缺一不可。

1.2 它凭什么"全场景落地"

OpenClaw 之所以能在三个月里被全网热捧，靠的是几个挺扎实的能力：

• 能动手：给 AI 配一台电脑，它通过聊天软件接收指令并自动完成任务，做到"指令发出、结果落地"。
• 有记忆：能记住你的偏好和历史，越用越懂你，慢慢变成专属于你的助手。
• 会进化：背后有一个开源技能社区（ClawHub），上面已经有数千个技能可以一键安装，让龙虾持续解锁新本领。
• 能主动：配上定时任务和心跳机制后，它可以 7×24 小时按节奏自己干活、主动汇报，而不是傻等你发话。

它支持的消息渠道相当多，微信、飞书、Telegram、Discord、Slack 等都能接，而且所有数据都在你本地运行，不经过第三方服务器，这一点对在意隐私的人很关键。

莫潇羽@源码七号站 多说一句：正因为它权限大、能动手，所以"安全"这件事必须从第一天就放在心上。本文最后专门留了一章讲避坑，建议别跳着看。

1.3 它的来历，顺带说清楚

你在网上查资料时，可能会看到几个名字混着出现，这里给你理一下，免得搞晕：这只虾早期叫过 Clawdbot，中间还过渡用过 Moltbot 这个名字，现在统一叫 OpenClaw。改名的背后有商标层面的原因，对我们用户来说不影响使用，知道它们指的是同一个东西就行。一些旧版本的命令（比如带 clawdbot 前缀的）通常仍然作为别名保留，能继续用。

它是个开源项目，这点很关键——意味着它的能力不是某家公司定死的，而是靠一个活跃的社区在持续往里加技能、修问题。你能装到的几千个技能、能看到的大量保姆级教程，都是这套开放生态的产物。对新手来说，这是上手的好时机：文档完善、社区热闹、生态正在快速成熟，遇到问题大概率有人踩过坑、写过解法。也正因为开放，它对"安全审查"的要求比封闭产品更高，这条线后面会反复提。

二、动手之前：环境、Node 与版本检查

很多人卡在第一步，往往不是因为 OpenClaw 难装，而是基础环境没铺好。这一章我把开工前要确认的几件事过一遍，照着做能省掉后面一大半报错。

2.1 它跑在什么环境上

OpenClaw 本质是个基于 Node.js 的命令行程序，所以它对运行环境的要求集中在两点：一个能跑 Node 的系统，一个顺手的终端。

• 操作系统：Linux（含云服务器）、macOS 都很顺；Windows 建议走 WSL2 子系统，原生 PowerShell 偶尔不太稳。
• Node.js 版本：建议直接上较新的 LTS（比如 Node 24）。版本太老会在安装预编译二进制时各种翻车。

在 Ubuntu 上装 Node 24 的命令我贴一份，照抄即可：

# 安装 Node.js 24 LTS
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证版本，应显示 v24.x.x
node -v

macOS 用户如果在安装过程中碰到类似 sharp: Please add node-gyp 的报错，可以在安装命令前加一个环境变量绕过，后面安装那一章我会再提。

2.2 先把"有没有装好"检查清楚

无论你是要全新安装还是已经装过，第一件事都是确认环境到位。我的习惯是先查 Node：

node -v    # 看 Node 在不在、版本够不够新
npm -v     # 看 npm 包管理器是否可用

如果这两条命令都能正常吐出版本号（不是 "command not found"），说明基础环境 OK，可以进下一步。这里要提醒一句：转写口语里常把命令听岔，比如把 npm -v 说成别的，实际敲的时候一定以官方命令为准——版本检查就是 node -v 和 npm -v 这两条，别记混。

2.3 拿资源、准备文档

正式开装前，我一般会把这几样东西先备齐，免得装到一半来回切窗口：

1. 去官方渠道把安装资源和文档准备好。OpenClaw 的安装方式不止一种，官网/官方文档会给出最新的命令和注意事项，先看一眼能避免用到过期教程。
2. 准备好要喂给它的素材文档。如果你打算让龙虾帮你处理几份文件（比如读几篇资料再整理成一篇内容），提前把这些文档放到一个固定目录，后面让它读起来更省事。
3. 确认网络环境通畅。安装时要从软件源拉包，网络不稳会让下载卡住；卡住了就 Ctrl+C 中断重来，别死等。

2.4 Windows 用户的卸载/重装小提示

如果你之前装过旧版本、或者用的是 Windows 安装程序版本，想换个干净的环境，可以先把旧的卸载掉再重新安装。我电脑上因为早就装过，所以演示时直接打开终端用就行——这里给新手提个醒：卸载和重装不是必需步骤，只有在旧版本出问题时才需要折腾，环境干净的话直接装最新版即可。

到这一步，环境就算备齐了。下一章我们正式进入安装与初始化，把这只龙虾真正"养"起来。

最后再唠叨一句心态上的事：第一次搭可能会被各种小报错卡住，这很正常，我自己第一遍也是磕磕绊绊。OpenClaw 的好处是社区足够大，几乎你遇到的每一个报错，都能搜到别人写过的解法。所以别一遇到红字就放弃，把报错信息复制出来搜一搜，大概率十分钟内就有答案。把第一只龙虾养活，后面再加渠道、加技能就都是顺水推舟的事了。

三、从零安装与初始化：onboard 向导一步到位

这一章是整套流程里最关键的一步。OpenClaw 的安装设计得挺人性化，全程一个向导带着你走，但里头有几个选项新手特别容易选错，我把踩过的坑都标出来。

3.1 全局安装

国内用户我推荐直接用 npm 全局安装，命令很短：

# 全局安装最新版
npm install -g openclaw@latest

# 如果提示权限不足，在前面加 sudo
sudo npm install -g openclaw@latest

装完之后，先验证一下版本，确认它真的装上了：

openclaw --version    # 显示版本号，例如 v2026.3.x

能正常打印出类似 2026.03.xx 这样的版本号，就说明本体已经就位了。安装耗时通常三到十分钟，取决于网络，期间在下载预编译二进制时可能会卡一下，卡太久就 Ctrl+C 断开重来，别中途强行关窗口。

3.2 跑 onboard 向导：配置模型 + 渠道 + 技能

本体装好后，运行初始化向导，它会交互式地把模型、渠道、技能、网关服务一条龙配置完：

openclaw onboard --install-daemon

向导会按顺序问你几件事，我按出现的先后讲：

第一步，安全警告。 它会很认真地提醒你"这只龙虾能力很强、风险也很大"，让你确认是否继续。读一遍，选 Yes 继续（选 No 就不装了）。

第二步，选启动方式。 推荐选 QuickStart（快速启动），它会自动把网关端口设为 18789、绑定地址设为 127.0.0.1 这些默认值，省得你手动填。

第三步，配模型（最重要）