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 版本大于 24Git 版本无所谓。官方提供了一键安装脚本会自动检测你本地有没有 Node 和 Git没有就自动下载再装 OpenClaw。如果你已经自己装好了脚本检测到就直接跳过不会重复装。用 npm 方式或源码编译方式的话就必须自己先把 Git 和 Node 装好。Node 和 Git 的安装基本一路下一步这里不赘述重点讲模型通道怎么接。OpenClaw 默认带的几个免费模型能用但限速做正经任务会卡。所以第一步建议先把模型通道换成稳定的付费通道。这里用 TaoToken 统一 Key 接入好处是一个 Key 走通多家模型不用在 OpenClaw 里为每个厂商单独配一套凭证。TaoToken 的官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 注意 API 地址不带 UTM 参数。接入前你需要拿到两样东西Base URL 和 API Key。Base URL 就是https://taotoken.net/apiKey 在控制台的 API Keys 页面创建。创建入口在这里https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。拿到 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 youexample.com npm config set registry https://registry.npmmirror.com npm install -g openclawlatest 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/apiKey 都是同一个Model ID 按你实际要用的填。这三件套Base URL Key Model ID在飞书 Skills 和后续任何渠道里都是一致的别在不同地方填不同值否则会出现“网页能用、飞书不能用”的怪现象。4. 飞书 Skills 配置与端到端验证请求飞书这块分两步先在飞书开放平台建应用配机器人再在 OpenClaw 里装飞书插件并配对。配完发一条消息触发 Skills验证端到端通。飞书端配置。打开 https://open.feishu.cn/ 用企业飞书账号登录开发者后台创建“企业自建应用”填名称描述图标。然后在左侧“应用功能 → 机器人”里添加机器人能力。权限管理里搜索并勾选三个必须的im:message收发消息、im:chat会话信息、contact:user.employee:readonly用户信息。文档、日历、多维表格按需开。凭证与基础信息里复制 AppIDcli_ 开头和 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 listchannels list里应该显示feishu: running。到这一步飞书通道就通了。接下来装 Skills 并验证。先装技能商店和几个基础技能npm i -g clawhub clawhub install skill-vetter clawhub install agent-memory clawhub install summarize openclaw gateway restartskill-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_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 适合长期编码和自动化任务。想先验证模型效果可以直接用模型对话入口 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 试一条。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 配置细节以文档为准。Claude Code 相关的接入参考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。最后说个我踩过的坑飞书配对码有时效发消息拿到码之后尽快执行openclaw pairing approve放太久会失效重新发消息拿新码就行。还有openclaw gateway restart之后飞书渠道需要几秒重新连上别刚重启就发消息等channels list显示 running 再测。