☰
【2026爆火 小白也会】OpenClaw 龙虾安装部署卸载 + 飞书 Skills 配置详细教程|TaoToken 统一 Key 接入
2026/10/1 7:16:51 网站建设 项目流程

1. OpenClaw 龙虾到底是什么,为什么 2026 突然爆火

OpenClaw(社区里习惯叫它“龙虾”)是一个开源、本地优先、可自托管的 AI 智能体执行网关。它本身不是大模型,而是大模型的“手脚”和“桥梁”:一端接 ChatGPT、Claude、Gemini、通义千问、智谱 GLM 等云端或本地模型,另一端接你的电脑——文件系统、Shell、浏览器、桌面 UI。你用自然语言下目标,它自己拆步骤、调工具、操作系统,最后把结果反馈给你。核心口号很直白:The AI that actually does things,真正能做事的 AI。

它适合谁?三类人最明显。第一类是办公党,想让 AI 自动整理文件夹、发飞书消息、做周报、管日程;第二类是开发者,想让它跑脚本、调 API、部署服务、管理服务器;第三类是折腾智能家居和自媒体的玩家,想用一句话切歌、控灯、采集热点、自动发文。所有数据、记忆、日志都存在你自己的设备或私有云,隐私可控,这是它和纯云端 Agent 最大的区别。

2026 年它爆火的原因,我实测下来主要是三点。一是 Skills 生态起来了,ClawHub 上官方加社区技能已经过万,像装 App 一样扩展能力;二是多渠道交互打通了飞书、钉钉这类 IM,机器人直接在你日常聊天窗口里干活;三是本地优先的定位踩中了大家对隐私和可控性的需求。但小白第一次装,最容易卡在三个地方:npm 依赖装不上、网关起不来、飞书 Skills 配完不响应。这篇就按“从零安装 → 部署 → 卸载 → 飞书 Skills 配置 → 端到端验证”的顺序,把可复制的命令和配置片段都给全,模型通道统一走 TaoToken 的 Key,省得你到处找各家 API。

先明确一个概念,避免后面混淆。OpenClaw 的“网关”(gateway)是它的核心进程,负责接收消息、调度模型、执行技能。网页 UI 和飞书对话都依赖网关在跑。所以你会看到很多操作最后都要openclaw gateway restart,重启电脑后也必须先启动网关,网页和飞书才能用。这一点记住,后面排障会反复用到。

2. 安装前的环境准备与 TaoToken 统一 Key 接入

装 OpenClaw 之前,环境只有两个硬要求:Node.js 版本大于 24,Git 版本无所谓。官方提供了一键安装脚本,会自动检测你本地有没有 Node 和 Git,没有就自动下载再装 OpenClaw。如果你已经自己装好了,脚本检测到就直接跳过,不会重复装。用 npm 方式或源码编译方式的话,就必须自己先把 Git 和 Node 装好。Node 和 Git 的安装基本一路下一步,这里不赘述,重点讲模型通道怎么接。

OpenClaw 默认带的几个免费模型能用,但限速,做正经任务会卡。所以第一步建议先把模型通道换成稳定的付费通道。这里用 TaoToken 统一 Key 接入,好处是一个 Key 走通多家模型,不用在 OpenClaw 里为每个厂商单独配一套凭证。TaoToken 的官网是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,API 入口是 https://taotoken.net/api ,注意 API 地址不带 UTM 参数。

接入前你需要拿到两样东西:Base URL 和 API Key。Base URL 就是https://taotoken.net/api,Key 在控制台的 API Keys 页面创建。创建入口在这里:https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。拿到 Key 后先别急着填,我们先把 OpenClaw 装起来,再统一改配置。

环境准备清单,你可以对照检查:

项目要求说明
Node.js> 24一键脚本会自动装,npm/源码方式需自装
Git任意版本同上
包管理器npm 或 pnpm源码方式推荐 pnpm
模型通道TaoToken Base URL + Key统一接入,避免多厂商配置
飞书账号企业/团队组织用于创建自建应用和机器人

如果你打算用一键脚本,先以管理员身份打开 PowerShell。第一次用 PowerShell 的话,先执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser放开脚本执行权限,然后跑官方脚本。脚本会去拉一些文件,网络要求高一点,耐心等它跑完。中途如果哪一步不小心退出了,不用重装,直接敲openclaw onboard --flow quickstart继续引导就行。

这里插一句安全提醒,官方自己也标了:OpenClaw 目前仍是测试阶段,默认是面向单一可信任操作者的个人智能体。一旦开启工具权限,机器人可以读文件、执行操作,恶意提示词可能诱导它做不安全的事。它默认不是多用户高隔离的安全边界。如果你不熟悉权限控制,别急着把工具权限全开或暴露到公网。这个提醒不是吓人,是让你心里有数,后面配飞书和 Skills 时我会告诉你哪些权限是必须的、哪些可以缓开。

3. 三种安装方式与网关配置片段(可复制)

安装方式有三种,按你的熟练度选。小白直接上一键脚本,想控制依赖的用 npm,想改源码的用源码编译。三种方式装完后,模型配置和网关启动是共通的,所以我把配置片段单独拎出来讲。

方式一,一键安装。管理员 PowerShell 里执行:

iwr -useb https://openclaw.ai/install.ps1 | iex

它会自动检测并安装 Node 和 Git,然后装 OpenClaw。装完进入引导,按提示走。中途退出就openclaw onboard --flow quickstart。

方式二,npm 安装。先配好 Git 身份和国内镜像,再全局装:

git config --global user.name "yourname" git config --global user.email "you@example.com" npm config set registry https://registry.npmmirror.com npm install -g openclaw@latest openclaw onboard --install-daemon

方式三,源码编译。适合想跟进最新代码的人:

npm install -g pnpm git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm ui:build pnpm build pnpm setup pnpm link --global openclaw onboard --install-daemon

装完后,模型配置在C:\Users\你的用户名\.openclaw\openclaw.json。这个文件是 OpenClaw 的主配置,模型通道、网关端口、渠道都在这里。把模型部分改成 TaoToken 的统一通道,配置片段如下,注意 JSON 格式别写错逗号:

{ "models": { "default": "taotoken-claude", "providers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "models": [ { "id": "claude-sonnet-4-5", "name": "taotoken-claude" } ] } } }, "gateway": { "port": 18789, "host": "127.0.0.1" } }

如果你更习惯用 TOML 风格管理,OpenClaw 也支持在项目目录放openclaw.toml做覆盖,片段如下:

[models] default = "taotoken-claude" [models.providers.taotoken] baseUrl = "https://taotoken.net/api" apiKey = "sk-你的TaoToken密钥" [[models.providers.taotoken.models]] id = "claude-sonnet-4-5" name = "taotoken-claude" [gateway] port = 18789 host = "127.0.0.1"

改完配置必须重启网关才生效:

openclaw gateway restart

然后浏览器访问http://127.0.0.1:18789,能看到 Web UI 就说明网关起来了。这里有个关键点:无论你用哪种安装方式,模型通道的 Base URL 都是https://taotoken.net/api,Key 都是同一个,Model ID 按你实际要用的填。这三件套(Base URL + Key + Model ID)在飞书 Skills 和后续任何渠道里都是一致的,别在不同地方填不同值,否则会出现“网页能用、飞书不能用”的怪现象。

4. 飞书 Skills 配置与端到端验证请求

飞书这块分两步:先在飞书开放平台建应用配机器人,再在 OpenClaw 里装飞书插件并配对。配完发一条消息触发 Skills,验证端到端通。

飞书端配置。打开 https://open.feishu.cn/ ,用企业飞书账号登录开发者后台,创建“企业自建应用”,填名称描述图标。然后在左侧“应用功能 → 机器人”里添加机器人能力。权限管理里搜索并勾选三个必须的:im:message(收发消息)、im:chat(会话信息)、contact:user.employee:readonly(用户信息)。文档、日历、多维表格按需开。凭证与基础信息里复制 AppID(cli_ 开头)和 AppSecret,这两个后面要用。

事件与回调是重点。左侧“事件与回调 → 事件配置 → 编辑”,添加事件im.message.receive_v1(接收消息,必须)。订阅方式一定选“使用长连接接收事件(WebSocket 模式)”,不要选 Webhook。保存后点“启用事件配置”。最后去“版本管理与发布”创建版本并发布,企业自建应用通常自动通过。

OpenClaw 端配置。先装飞书渠道插件:

npm install -g @openclaw/feishu

然后启动渠道配置向导:

openclaw channels add

按提示选 Feishu/Lark,粘贴 AppID 和 AppSecret,订阅方式选 websocket,域名选 Feishu (feishu.cn) - China 国内版。群聊策略推荐 Open(需 @ 机器人),私聊策略推荐 pairing(需配对)。配完重启网关:

openclaw gateway restart

配对环节。手机或桌面飞书登录后,给机器人发一条消息,它会返回一个配对码。然后执行:

openclaw pairing approve feishu 你的配对码 --notify

验证状态:

openclaw gateway status openclaw channels list

channels list里应该显示feishu: running。到这一步,飞书通道就通了。

接下来装 Skills 并验证。先装技能商店和几个基础技能:

npm i -g clawhub clawhub install skill-vetter clawhub install agent-memory clawhub install summarize openclaw gateway restart

skill-vetter建议必装,ClawHub 上曾查出过恶意技能,装任何技能前先让它扫一遍。装完重启网关,然后在飞书里给机器人发一条消息触发 Skills,比如:

帮我总结一下今天的工作重点,并记住我偏好简洁的回复

如果机器人正常回复,并且agent-memory记住了你的偏好,说明模型通道、网关、飞书渠道、Skills 四层全部打通。你也可以用clawhub list查看已装技能。实测下来,第一次配对最容易卡在事件订阅方式选错,选成 Webhook 就会一直收不到消息,改回 WebSocket 长连接即可。

5. 常见报错排查:401、local proxy failed、reading choices、OAuth

配 OpenClaw 和飞书 Skills 时,报错基本集中在四类。我按真实遇到的顺序列出来,对照着查。

第一类,401 Unauthorized。这个几乎都是 Key 或 Base URL 的问题。先确认openclaw.json里baseUrl是https://taotoken.net/api,注意结尾不要多加/v1或斜杠,不同客户端对路径拼接处理不一样。再确认apiKey是完整的sk-开头字符串,没有多余空格或换行。如果网页能用、飞书不能用,检查飞书渠道配置里是不是又填了一套旧的 Key。统一用 TaoToken 的同一个 Key,别混用。改完openclaw gateway restart。

第二类,local proxy failed。这个报错通常出现在网关启动阶段,意思是本地代理或端口绑定失败。先看 18789 端口是不是被别的进程占了:

netstat -ano | findstr 18789

如果被占,要么杀掉占用进程,要么在openclaw.json的gateway.port改成别的端口,比如 18790,然后重启网关。另外检查gateway.host是不是127.0.0.1,如果你之前改成过0.0.0.0又没配好防火墙,也可能起不来。本地自用保持127.0.0.1最稳。

第三类,reading choices 相关报错。这类一般是模型返回结构不符合预期,常见原因是 Model ID 填错,或者通道返回的不是标准 OpenAI 兼容格式。先确认你填的 Model ID 在 TaoToken 通道里是真实存在的,别自己编。然后确认 Base URL 没写错。如果换了模型还是报,把openclaw.json里models.default指向的模型名和providers里的name对齐,两者不一致会导致解析失败。

第四类,OAuth 相关报错。飞书渠道如果报 OAuth 或授权失败,先检查 AppID 和 AppSecret 是否复制完整,有没有把 AppID 和 AppSecret 填反。再检查飞书开放平台里应用是否已经发布并通过审核,未发布的应用拿不到有效凭证。事件订阅方式必须是 WebSocket 长连接,选 Webhook 会走到 OAuth 回调那套逻辑,容易报错。如果之前配过旧版本,建议openclaw channels remove feishu再重新openclaw channels add,避免残留配置干扰。

排查通用顺序:先openclaw gateway status看网关活没活,再openclaw channels list看渠道状态,然后看日志。日志一般在.openclaw目录下,报错原文比猜有用。重启电脑后记得先openclaw gateway start,网关不启动,网页和飞书都不会响应,这不是 bug,是设计如此。

6. 卸载清理与长期使用建议

卸载分两层:先卸 OpenClaw 本体和全局包,再清配置和缓存目录。如果你只是想把飞书渠道去掉,不用卸整个 OpenClaw,执行openclaw channels remove feishu再重启网关即可。

完整卸载。npm 方式装的:

npm uninstall -g openclaw npm uninstall -g @openclaw/feishu npm uninstall -g clawhub

源码方式装的,先解除全局链接再删目录:

pnpm unlink --global openclaw

然后手动删掉克隆下来的openclaw源码目录。配置和记忆数据在C:\Users\你的用户名\.openclaw\,这个目录不会随卸载自动删,里面存着你的模型配置、配对信息、记忆数据。确认不需要了再手动删,删之前建议备份openclaw.json,下次重装能直接复用。

长期使用有几个建议。第一,模型通道统一走 TaoToken,一个 Key 管所有渠道,换模型只改 Model ID,不用动渠道配置。第二,Skills 装之前先跑skill-vetter扫一遍,尤其是来源不明的技能。第三,网关别暴露到公网,本地自用保持127.0.0.1。第四,重启电脑后养成先openclaw gateway start的习惯,或者用openclaw onboard --install-daemon装成守护进程,开机自启省心。第五,飞书机器人的权限按最小必要开,im:message、im:chat、contact:user.employee:readonly三个够日常用,文档和日历用到再加。

如果你后面想深入玩 Coding 和 Agent 场景,可以了解下 TaoToken 的 Coding Plan,入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ,适合长期编码和自动化任务。想先验证模型效果,可以直接用模型对话入口 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 试一条。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ,配置细节以文档为准。Claude Code 相关的接入参考 https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claudecode&utm_campaign=rewrite 。

最后说个我踩过的坑:飞书配对码有时效,发消息拿到码之后尽快执行openclaw pairing approve,放太久会失效,重新发消息拿新码就行。还有,openclaw gateway restart之后飞书渠道需要几秒重新连上,别刚重启就发消息,等channels list显示 running 再测。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询