快来！OpenClaw保姆级部署攻略！附加如何链接飞书与TaoToken

1. 为什么我要在本地跑 OpenClaw 并接飞书OpenClaw 是一个可以跑在自己机器上的 AI 助手框架它能通过「通道」把大模型接到飞书、Slack、Webhook 这些平台上让 AI 直接在你日常用的聊天工具里干活。适合谁适合想拥有一个私有 AI 助手、又不想把数据全交给第三方平台的开发者尤其是团队已经在用飞书办公的场景。我这次的目标很明确在一台 Windows 机器上从零把 OpenClaw 跑起来然后把它接进飞书机器人最后把模型通道切到 TaoToken这样模型调用走统一入口Key 和 endpoint 都好管理。整个过程踩过几个坑比如 npm 全局安装后命令找不到、飞书事件订阅回调地址填错、模型 Base URL 少写了/v1下面会一个个说清楚。你跟着做之前先确认三件事机器能正常联网、有管理员权限Windows 上启动 gateway 经常需要、飞书那边你有开发者后台的建应用权限。Node.js 版本建议 18 以上LTS 就行别追最新版。整篇教程的命令都可以直接复制路径和参数我会标清楚遇到报错先看第 5 节。先说清楚 OpenClaw 的定位避免误解它不是一个编辑器也不是替代你写代码的工具而是一个「消息进来 → 模型处理 → 结果发回去」的调度中枢。飞书负责收发消息OpenClaw 负责编排TaoToken 负责提供模型能力。三者关系理顺了后面配置就不会乱。我实测下来从装 Node 到飞书里收到第一条 AI 回复顺利的话 40 分钟左右。卡点基本都在配置环节所以第 3 节的配置片段建议逐字对照别凭感觉改。2. 部署前的环境准备与 TaoToken 接入前置这一节把两件事做完Node.js/npm 环境以及 TaoToken 的 Key 和 endpoint。环境是地基Key 是模型通道的通行证缺一个后面都跑不通。2.1 Node.js 与 npm 安装Windows 为例打开 Node.js 官网下载页会看到两个版本LTS长期支持版和 Current最新版。一定选 LTSCurrent 版本有时候 npm 全局包的兼容性会出问题。安装时注意勾选Add to PATH其他一路 Next 就行不需要改安装路径。装完打开 CMD 或 PowerShell 验证node -v npm -v两条命令都能打印出版本号说明环境 OK。如果node -v报「不是内部或外部命令」八成是 PATH 没生效关掉终端重开一次还不行就重启机器。Linux/macOS 用户可以用包管理器装比如sudo apt install nodejs npm或者用 nvm 管理版本逻辑一样验证命令相同。2.2 安装 OpenClaw官方给了一键脚本但我更推荐用 npm 装因为一键脚本装出来的基础版本在后面接飞书时容易提示缺包。用 npm 指定版本安装npm install -g openclaw2026.3.28装完执行初始化openclaw setup如果提示openclaw 不是内部或外部命令说明 npm 全局 bin 目录没进 PATH。用npm config get prefix看下全局路径把它加到系统环境变量里重开终端即可。2.3 拿到 TaoToken 的 Key 与 endpoint模型通道这块我选择把 OpenClaw 的模型请求指向 TaoToken。先去控制台创建 API Key控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite创建完复制 Key形如sk-xxxx只显示一次存好。Base URL 用https://taotoken.net/api注意这个地址后面不加 UTM 参数配置里就写这个。模型 ID 按你实际要用的填比如claude-sonnet-4-5这类具体以文档里的模型列表为准接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite注意Key 不要写进会提交到 Git 的文件里本地配置文件加个.gitignore或者用环境变量注入。到这里环境 Key endpoint 三样齐了可以进配置环节。3. 可复制配置OpenClaw 模型通道与飞书通道这一节是全文核心配置写错基本都卡在这。我按「模型配置 → 网关配置 → 飞书配置」的顺序来每段都给可复制的片段。3.1 模型配置把通道切到 TaoToken执行openclaw configure进入配置界面选 Model 模块。如果你要用自定义 provider选Custom Provider然后填三件套Base URL、API Key、Model ID。Base URLhttps://taotoken.net/apiAPI Key你刚创建的sk-xxxxModel ID按文档填例如claude-sonnet-4-5如果你更习惯直接改配置文件OpenClaw 的配置一般落在用户目录下的配置文件中Windows 通常在%USERPROFILE%\.openclaw\下Linux/macOS 在~/.openclaw/。模型部分可以写成类似这样的 JSON 结构路径和字段名以你本地实际生成的为准{ model: { provider: custom, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, modelId: claude-sonnet-4-5, type: chat } }如果你用的是 TOML 风格的配置等价写法[model] provider custom baseUrl https://taotoken.net/api apiKey sk-你的Key modelId claude-sonnet-4-5 type chattype选chat还是reasonerchat 响应快适合日常问答reasoner 思考更充分适合复杂任务但慢一些、贵一些。新手先用 chat。3.2 网关配置Gateway 是 OpenClaw 的中枢不配它整个系统起不来。在openclaw configure里选 Gateway模式选local。配置过程中会生成一个 Gateway token一定要记下来后面飞书回调验证和本地访问都要用。你也可以在环境变量里配 token然后对应填两个模块。Windows 上用setx OPENCLAW_GATEWAY_TOKEN 你的GatewayToken设置完重开终端生效。Gateway 默认监听127.0.0.1:18789本地访问 Web 端就是http://127.0.0.1:18789/。3.3 飞书应用创建与事件订阅进飞书开发者后台点「创建企业自建应用」填名称和图标。创建完进「权限管理」开通消息相关权限至少要有「获取与发送单聊、群组消息」这类权限具体按你机器人要干的活勾选。然后在「凭证与基础信息」里复制App ID和App Secret填到 OpenClaw 的 Channels 配置里通道类型选飞书。事件订阅这块把请求地址指向你的 OpenClaw 网关回调地址通常是http://你的地址:18789/feishu/callback这类路径具体以 OpenClaw 生成的为准。本地调试如果飞书回调不到本机需要用内网穿透把本地端口暴露出去或者部署到有公网 IP 的机器上。配置完保存回到 OpenClaw 侧确认 Channels 里飞书通道状态是启用。提示飞书事件订阅有个 URL 校验步骤会发一个 challenge 请求OpenClaw 网关必须处于运行状态才能通过校验所以先把网关起起来再点保存。4. 启动、验证请求与成功结果配置写完开始跑。启动网关openclaw gateway startWindows 上如果提示权限不足用管理员身份打开终端再执行。启动成功后浏览器访问http://127.0.0.1:18789/能看到 Web 交互界面就说明网关活了。先别急着接飞书在 Web 端发一条消息验证模型通道通不通。输入「你好介绍一下你自己」如果几秒内返回正常回复说明 TaoToken 的 Base URL、Key、Model ID 三件套都对了。如果报错看第 5 节。模型通了之后启动飞书通道。有的版本需要单独跑openclaw gateway这个命令会前台运行并打印日志方便你看飞书消息进来时的回调。如果卡着不动按几下回车有时候是终端交互没刷新。然后打开飞书找到你刚创建的应用对应的机器人发一条消息比如「在吗」。观察终端日志应该能看到一条消息事件进来接着是模型请求最后是回复发出。飞书里收到 AI 的回复整条链路就打通了。验证成功的标志有三个Web 端能对话、终端日志有飞书事件、飞书里收到回复。三个都满足说明 OpenClaw 飞书 TaoToken 全链路 OK。如果你还想在 Web 端多测几个模型可以走模型对话入口快速验证模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite5. 本篇常见报错排查这一节按真实报错来遇到问题对号入座。401 UnauthorizedKey 错了或者没带上。检查apiKey是不是完整的sk-xxxx有没有多余空格Base URL 是不是https://taotoken.net/api。如果 Key 是在别的项目里复制过来的确认它没被删除或过期。local proxy failed / 连接被拒绝网关没起来或者端口被占用。先确认openclaw gateway start在跑再检查 18789 端口有没有被别的程序占。Windows 上用netstat -ano | findstr 18789看占用情况。reading choices 报错这是模型返回结构不对通常是 Base URL 少了/v1或者多写了路径。TaoToken 的地址就写https://taotoken.net/api不要自己拼/v1/chat/completionsOpenClaw 会自己补。另外确认 Model ID 拼写和文档一致写错模型名也会返回异常结构。OAuth / 授权失败飞书侧权限没开全或者 App ID / App Secret 填错。回飞书开发者后台核对凭证确认事件订阅的 URL 校验已通过。飞书回调不进来本地地址飞书访问不到。要么用内网穿透暴露端口要么部署到公网机器。另外确认事件订阅里勾选了「接收消息」这类事件。openclaw doctor 是你的好朋友任何说不清的问题先跑一遍openclaw doctor它会检查配置完整性、模型可用性、网关状态并给出修复建议。我几次卡住都是靠它定位的。npm 全局命令找不到npm config get prefix看路径加进 PATH重开终端。网关启动要管理员权限Windows 上常见右键终端「以管理员身份运行」再执行启动命令。排查顺序建议先 doctor再看终端日志最后对照配置片段逐项核对。90% 的问题出在 Key、Base URL、Model ID 这三样上。6. 后续怎么用从能跑到好用跑通只是开始。如果你打算长期用这个助手做编码或 Agent 任务建议把模型通道固定到 TaoTokenKey 统一管理换模型只改 Model ID 就行不用动其他配置。长期编码场景可以看下 Coding PlanCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite如果你用的是 Claude Code 这类工具接入方式类似Anthropic 兼容通道的配置可以参考Claude Code 接入https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite几个实用技巧把 Gateway token 和 API Key 都放环境变量别硬编码飞书机器人先在小范围群测试确认稳定再拉大群openclaw doctor定期跑一次配置漂移能早发现。模型 ID 想换就换Base URL 和 Key 不动这是走统一通道最大的好处。最后留一句实在话本地部署的坑大多不在 OpenClaw 本身而在环境变量、路径、回调地址这些边角。配置片段逐字抄报错先 doctor基本都能自己解决。