1. 为什么大家都在装 OpenClaw它到底能干什么OpenClaw 是一个可以跑在你本地电脑上的 AI 助手框架你可以把它理解成一个「能接微信/飞书/Telegram 的私人 AI 管家」。它本身不绑定某一家大模型而是通过 API Key 的方式接入各家模型服务然后把对话能力挂到你日常用的聊天工具上。适合谁适合想在自己电脑上跑一个 AI 助手、又不想折腾服务器的小白用户尤其是 Mac 用户。我身边不少朋友最近都在问同一个问题怎么在本地把 OpenClaw 装起来并且让飞书机器人能收发消息。说实话整个流程涉及 Node.js、Git、Homebrew、飞书开放平台配置、API Key 创建、回调设置步骤确实不少。但只要按顺序走一遍3 分钟内跑通核心链路是完全可行的。这篇教程面向零基础用户以 macOS 为例Windows 流程类似命令换成对应版本即可。我会把每一步的命令、配置参数、飞书后台操作都写清楚你直接复制粘贴就能用。核心链路是环境准备 → 安装 OpenClaw → 配置模型 API → 接入飞书机器人 → 验证消息收发。先明确一个概念OpenClaw 本身是一个「壳」它负责调度和转发消息真正干活的是背后的大模型。所以你需要一个模型 API Key。这里我用 TaoToken 作为模型接入层来演示因为它同时支持多家模型配置方式统一对小白比较友好。TaoToken 的官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。整个安装过程分两大块本地环境 飞书配置。本地环境负责让 OpenClaw 跑起来飞书配置负责让消息通道打通。两块都完成后你就能在手机飞书上直接指挥本地电脑上的 AI 干活了。2. 前置准备Node.js、Git、Homebrew 环境检查与安装在装 OpenClaw 之前你需要确认三样东西Node.js 20、Git、Homebrew。这三个是基础依赖缺一个后面都会报错。Mac 用户先打开「终端」Terminal按 Command 空格输入 Terminal 回车即可。第一步检查 Homebrew 是否已安装。在终端输入brew --version如果显示版本号说明已经装好了跳到下一步。如果提示 command not found执行官方安装命令/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)安装过程中会提示你输入电脑密码输入时屏幕不显示字符是正常的输完回车即可。安装完成后按照终端提示把 brew 加入 PATHM 系列芯片和 Intel 芯片路径不同终端会直接告诉你复制哪两行命令。第二步安装 Node.js 和 Gitbrew install node brew install git装完后验证版本node -v git --versionNode.js 版本需要 20 以上如果低于 20用brew upgrade node升级。Git 版本一般无所谓能正常输出即可。这里有个坑要注意如果你之前用其他方式装过 Node.js比如官网 pkg 安装包可能会出现 brew 版本和系统版本冲突导致node -v显示的版本和brew list里的不一致。解决办法是先卸载旧的再重新用 brew 装。检查命令which node如果输出不是/opt/homebrew/bin/nodeM 系列或/usr/local/bin/nodeIntel说明路径有问题建议清理后重装。第三步确认系统版本。OpenClaw 要求 macOS 12 及以上。查看命令sw_vers输出里的 ProductVersion 就是你的系统版本。低于 12 的话建议先升级系统否则后续安装脚本可能跑不起来。环境检查清单对照表依赖项最低要求检查命令常见问题macOS12sw_vers版本过低脚本报错Node.js20node -v版本冲突、路径不对Git任意稳定版git --version未安装导致 clone 失败Homebrew最新版brew --versionPATH 未配置这三样都确认没问题后就可以进入 OpenClaw 的安装了。建议把终端窗口留着后面每一步都在这里执行。3. 安装 OpenClaw 并配置模型 API含可复制配置片段环境准备好后执行官方安装脚本curl -fsSL https://openclaw.ai/install.sh | bash脚本会问你「是否继续」输入Y回车。接着选择安装模式默认选「快速安装」Quick Install直接回车。接下来会提示你选择使用哪个大模型。这里有两种思路一是直接选列表里已有的模型服务商二是选「Skip for now」先跳过后面手动配置。我建议选 Skip for now因为手动配置更灵活也方便你接入 TaoToken 这样的统一接入层。跳过模型选择后OpenClaw 会继续安装核心组件。安装完成后你需要手动配置模型接入。OpenClaw 的配置文件通常位于~/.openclaw/config.json不同版本路径可能略有差异以安装完成后的提示为准。用编辑器打开nano ~/.openclaw/config.json如果你使用 TaoToken 作为模型接入层配置片段如下JSON 格式路径与原文一致{ models: { default: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的_TaoToken_API_Key, modelId: claude-sonnet-4-20250514 } } }三个关键字段说明Base URL 填https://taotoken.net/apiAPI Key 填你在 TaoToken 控制台创建的 KeyModel ID 填你要用的模型标识。如果你用的是 Claude Code 或 Cline 这类工具配置逻辑是一样的都是 Base URL Key Model ID 三件套。保存退出nano 里按 Ctrl O 回车保存Ctrl X 退出。然后重启 OpenClaw 让配置生效openclaw restart如果你不想手动改配置文件也可以在安装脚本的模型选择环节直接选 TaoToken如果列表里有的话然后按提示输入 API Key。两种方式效果一样手动改配置文件的好处是后续换模型方便。配置完成后验证模型是否可用openclaw test-model如果返回模型响应内容说明 API 配置成功。如果报 401检查 API Key 是否复制完整如果报连接超时检查 Base URL 是否写对。4. 接入飞书机器人权限配置与回调设置模型配好后接下来把飞书机器人接进来。这一步是整个流程里操作最多的部分但都是点鼠标不难。首先登录飞书开放平台 https://open.feishu.cn/ 进入开发者后台创建一个企业自建应用。创建完成后在左侧目录树选择「应用能力 添加应用能力」在「按能力添加」页签里找到「机器人」点击添加。然后配置权限。在左侧目录树选择「开发配置 权限管理」点击「批量导入/导出权限」在「导入」页签中粘贴以下权限 JSON这是 OpenClaw 官方推荐的权限集{ scopes: { tenant: [ contact:contact.base:readonly, docx:document:readonly, im:chat:read, im:chat:update, im:message.group_at_msg:readonly, im:message.p2p_msg:readonly, im:message.pins:read, im:message.pins:write_only, im:message.reactions:read, im:message.reactions:write_only, im:message:readonly, im:message:recall, im:message:send_as_bot, im:message:send_multi_users, im:message:send_sys_msg, im:message:update, im:resource, application:application:self_manage, cardkit:card:write, cardkit:card:read ], user: [ contact:user.employee_id:readonly, offline_access, base:app:copy, base:field:create, base:field:delete, base:field:read, base:field:update, base:record:create, base:record:delete, base:record:retrieve, base:record:update, base:table:create, base:table:delete, base:table:read, base:table:update, base:view:read, base:view:write_only, base:app:create, base:app:update, base:app:read, board:whiteboard:node:create, board:whiteboard:node:read, calendar:calendar:read, calendar:calendar.event:create, calendar:calendar.event:delete, calendar:calendar.event:read, calendar:calendar.event:reply, calendar:calendar.event:update, calendar:calendar.free_busy:read, contact:contact.base:readonly, contact:user.base:readonly, contact:user:search, docs:document.comment:create, docs:document.comment:read, docs:document.comment:update, docs:document.media:download, docs:document:copy, docx:document:create, docx:document:readonly, docx:document:write_only, drive:drive.metadata:readonly, drive:file:download, drive:file:upload, im:chat.members:read, im:chat:read, im:message, im:message.group_msg:get_as_user, im:message.p2p_msg:get_as_user, im:message.send_as_user, im:message:readonly, search:docs:read, search:message, space:document:delete, space:document:move, space:document:retrieve, task:comment:read, task:comment:write, task:task:read, task:task:write, task:task:writeonly, task:tasklist:read, task:tasklist:write, wiki:node:copy, wiki:node:create, wiki:node:move, wiki:node:read, wiki:node:retrieve, wiki:space:read, wiki:space:retrieve, wiki:space:write_only ] } }粘贴后点击「下一步确认新增权限」再点「申请开通」。权限开通后点击顶部「创建版本」填写版本号和说明保存并「确认发布」。发布后在左侧目录树选择「基础信息 凭证与基础信息」记录下 App ID 和 App Secret。这两个参数后面要填到 OpenClaw 里。回到终端继续 OpenClaw 的配置流程。当提示选择接入的社交软件时选择「飞书」然后输入刚才记录的 App ID 和 App Secret。接着 OpenClaw 会提示你安装插件按提示确认即可。最后配置飞书回调。在飞书开放平台左侧菜单点击「事件与回调」在「事件配置」中设置订阅方式为「使用长连接」。然后点击「添加事件」添加「接收消息」事件。保存后再次发布版本。到这里飞书侧的配置就完成了。你可以在飞书上搜索你创建的机器人发一条消息测试。5. 常见报错排查401、pairing approve、rate limit 怎么处理装的过程中大概率会遇到几个报错我把最常见的几个和解决办法列出来。第一个API rate limit reached. Please try again later.这个提示是说请求 API 的次数达到上限或者账户余额不足。先检查你的模型 API 账户余额如果余额正常可能是短时间内请求太频繁等几分钟再试。如果你用的是 TaoToken可以在控制台查看用量和余额。第二个OpenClaw: access not configured.完整报错通常长这样Your Feishu user id: ou_16xxx Pairing code: 7Jxxx Ask the bot owner to approve with: openclaw pairing approve feishu 7xLxxx这说明 OpenClaw 已经成功连上飞书了但你的飞书账号还没有被授权。这是 OpenClaw 的安全机制防止随便谁加了机器人都能调用你的 AI 算力。解决办法是在终端执行openclaw pairing approve feishu 7xLxxx把7xLxxx换成你实际收到的 pairing code执行后你的飞书账号就授权成功了。第三个401 Unauthorized。这个一般是 API Key 配置错误。检查~/.openclaw/config.json里的apiKey字段是否完整有没有多余空格。如果你用的是 TaoToken确认 Key 是在控制台创建的、且没有过期。Base URL 要填https://taotoken.net/api不要多加斜杠或路径。第四个local proxy failed或连接超时。检查你的网络是否能正常访问配置的 Base URL。可以在终端用 curl 测试curl -I https://taotoken.net/api如果返回 200 或 401 都说明网络通返回超时则是网络问题。第五个reading choices相关报错。这通常是模型返回格式和 OpenClaw 预期不一致导致的。检查 Model ID 是否填写正确有些模型标识需要带版本号。如果用的是 OpenAI 兼容接口确认 provider 字段填的是openai-compatible。第六个OAuth 相关报错。如果你在配置过程中选了需要 OAuth 的模型服务商但回调地址没配好会报 OAuth 错误。建议直接用 API Key 方式接入避免 OAuth 流程。排查顺序建议先看 API Key 和 Base URL → 再看网络连通性 → 最后看飞书权限和回调配置。大部分问题都出在前两步。6. 验证消息收发与后续玩法配置全部完成后做一次完整的消息收发验证。在飞书上找到你创建的机器人发一条消息比如「你好」。如果 OpenClaw 正常运行机器人会回复你。同时你可以在终端看到请求日志。如果机器人没回复按这个顺序检查飞书应用是否已发布 → 事件订阅是否选了长连接 → 是否添加了接收消息事件 → OpenClaw 是否在运行openclaw status→ 模型 API 是否可用。验证通过后你就能在手机飞书上直接指挥本地电脑上的 AI 干活了。比如让它帮你总结文档、写代码片段、查资料。OpenClaw 还支持安装 Skills 扩展能力安装时按空格选择你需要的 Skill回车确认。常见的如 GitHub 相关 Skill可以让你直接通过飞书操作仓库。如果你后续想换模型只需要改~/.openclaw/config.json里的modelId字段然后openclaw restart即可。TaoToken 支持多家模型你可以在控制台查看可用模型列表按需切换。对于长期编码或 Agent 场景可以考虑 TaoToken 的 Coding Plan适合需要稳定调用、高频使用的用户。如果你只是想先验证模型效果可以直接用模型对话功能测试。接入文档在 https://taotoken.net/api 页面可以找到详细说明。最后提醒一点OpenClaw 目前还在快速迭代版本更新可能带来配置格式变化。遇到问题时先看终端报错信息大部分都能从报错里找到线索。把这篇教程存下来装的时候对照着走基本不会卡住。