夜雨聆风OpenClaw 入门到精通 · 第 2 章 / 共 7 章
第二章：基础配置与频道接入
🔧 手把手接入飞书：让 AI 助理开口说话
01 / 先选对 AI 大脑
在配置飞书之前，先确定要用哪个 AI 模型。2025年主流选择和各自特点：
Claude Sonnet 4.6（Anthropic，2025年2月发布）——强烈推荐
目前最强的推理模型之一。最大亮点是"扩展思考"模式（Extended Thinking）——遇到复杂问题时，模型会先进行深度推理，再给出答案，类似人类的"先想清楚再开口"。写作能力顶级，长文理解和生成都很出色，价格适中。如果只选一个，选这个。
Claude Haiku 4.5——性价比之王
速度比 3.7 快，对话流畅，日常使用首选。如果你主要用于快速问答和轻量写作，3.5 Sonnet 性价比更高，响应速度更快。
GPT-4.1（OpenAI）——工具调用首选
在处理结构化任务（代码、数据分析、API 调用）方面最强。如果你主要用助理来帮你写代码、处理数据、调用各种工具，GPT-4.1 的可靠性最好，响应速度也快。
o3-mini / o1（OpenAI）——数学/代码推理专用
适合复杂数学和代码推理场景。普通对话和写作不需要用这个，会慢且贵。只有你在做复杂算法题或者需要严格推理时才值得用。
Gemini 2.5 Flash（Google）——高频使用省钱首选
速度极快，免费配额很大（每天可以免费调用很多次）。如果你需要高频使用助理，Gemini 2.5 Flash 是成本最低的选择。多模态能力也很强，支持图片、视频理解。
DeepSeek-R1（通过 Ollama 本地运行）——国产之光
推理能力媲美 OpenAI o1，完全免费，数据不出境（因为模型跑在你本地）。适合对隐私要求极高、或者不想付 API 费用的用户。需要先安装 Ollama，配置稍复杂，但一次配好后完全离线运行。
GitHub Copilot——有订阅就用它
如果你有 GitHub Copilot 订阅（月付10美元），直接选！它包含 Claude Sonnet 4.6 和 GPT-4.1，零额外 AI 成本。很多程序员已经在为 Copilot 付费了，通过 OpenClaw 接入完全没有额外花费。
选择建议：
新手 / 有 Copilot 订阅 → GitHub Copilot（零成本，直接开始）
追求最强对话和写作体验 → Claude Sonnet 4.6
代码 / 工具调用为主 → GPT-4.1
高频使用、想省钱 → Gemini 2.5 Flash
完全离线 / 极致隐私 → DeepSeek-R1 via Ollama
02 / 创建飞书机器人应用
接下来是最核心的配置步骤。看起来步骤不少，但每步都有原因，理解了就不会乱。
步骤一：进入飞书开放平台
为什么要去开放平台？因为在飞书里，想要一个"能发消息、能接收消息的机器人"，必须先创建一个"应用"——这个应用就是你的机器人的官方身份证，飞书只允许通过正规应用来发消息，不然任何人都能随便发机器人消息了。
打开浏览器，访问 https://open.feishu.cn，用你的飞书账号登录。点击右上角「开发者后台」，进入后点「创建企业自建应用」。填写应用名称（随便取，比如"我的AI助理"）和应用描述（随便写一句话即可）。
创建完成后，你会看到一个应用详情页，里面有两个关键信息：App ID 和 App Secret。这两个值相当于机器人的"用户名"和"密码"，后面填入 OpenClaw 时要用。现在先复制保存好。
步骤二：开通机器人能力
在左侧菜单找到「添加应用能力」，选择「机器人」，点击「开通」。这一步是在告诉飞书："这个应用需要有在聊天中发送和接收消息的能力"。不开通这个能力，你的应用连发消息都做不到——就像手机不开通通话功能，SIM 卡是摆设。
步骤三：配置消息权限
在左侧菜单找到「权限管理」→「添加权限」。权限是飞书的安全机制：每个应用只能做它被授权做的事。以下权限是必须开通的：
im:message — 允许应用发送和接收消息（最基础的权限）
im:message.receive_v1 — 允许应用接收消息推送事件
以下权限按需开通（不用全开，用到什么才开什么）：
drive:drive — 读写飞书云盘（想让助理帮你管文件时开）
wiki:wiki — 读写知识库（用飞书知识库时开）
docx:document — 读写飞书云文档（想让助理帮你写文档时开）
步骤四：配置长连接接收消息
在左侧菜单「事件与回调」→「事件配置」中，选择「使用长连接接收事件」（WebSocket 长连接）。为什么选长连接而不是 Webhook？因为 Webhook 需要你的机器有公网 IP，而长连接不需要——OpenClaw 主动向飞书建立一个持久连接，飞书通过这个连接推送消息。对于大多数人在家或公司内网运行 OpenClaw 来说，长连接是唯一可行的方案。
然后点「添加事件」，搜索 im.message.receive_v1，添加它。这一步是在告诉飞书："当有人给我的机器人发消息时，请通过长连接通知我"。没有这个事件订阅，飞书收到消息也不会告诉 OpenClaw，助理就会永远沉默。
步骤五：发布版本（最容易忘！）
在左侧菜单「版本管理与发布」→「创建版本」，填写版本号（随便写如 1.0.0），然后「申请发布」。这是大家最常踩的坑：你改了权限、开了能力，但没有发布版本，所有修改都不会生效。飞书的机制是：只有发布的版本才是"线上版本"，未发布的修改只是"草稿"。
步骤六：填入 OpenClaw
回到你的终端，运行配置向导：
openclaw configure
在向导中选择「飞书」频道，填入你之前保存的 App ID 和 App Secret，连接方式选择「WebSocket 长连接」。保存配置，这部分就完成了。
03 / 启动验证
飞书配置完成后，启动 OpenClaw 网关：
openclaw gateway start
然后去飞书，在搜索栏搜索你的应用名称（比如"我的AI助理"），找到机器人，点击打开对话框，发一条"你好"。
等待3-5秒。如果收到回复，🎉 大功告成！你的 AI 助理正式接入飞书了。
如果没有收到回复，按以下顺序排查：
检查权限和事件是否发布了版本（80% 的问题在这里）
检查 App ID 和 App Secret 是否填写正确，注意不要有多余空格
运行 openclaw gateway status 确认网关正在运行
查看网关日志：openclaw gateway logs，看有没有报错信息
04 / 其他平台简介（可选）
除了飞书，OpenClaw 还支持 Telegram 和 Discord 等平台。Telegram 接入需要通过 BotFather 创建机器人获取 Token，然后在 openclaw configure 中选择 Telegram 频道填入即可，配置比飞书更简单。Discord 同样通过 Developer Portal 创建应用获取 Bot Token 接入。
如果你有多平台需求，可以同时配置多个频道，所有平台的助理都共享同一份记忆和性格设定。详细的 Telegram/Discord 接入文档请参考 OpenClaw 官方文档。
🇨🇳 中国用户特别推荐
国内用户访问海外 AI 服务有时不稳定，以下是经过实测的中文友好方案：
DeepSeek-R1（深度求索）——性价比之王
推理能力媲美 Claude Sonnet，价格仅为其 1/10。完全支持中文，对中文语境理解极佳。API 接入：platform.deepseek.com，国内直连无需代理。
Qwen3（阿里云通义千问）——中文写作首选
阿里最新旗舰模型，中文写作、文案润色能力出色。API 接入：dashscope.aliyuncs.com，国内直连，有免费额度。
豆包（字节跳动）——日常对话高频使用
响应速度快，中文对话自然流畅，价格极低。适合高频日常对话场景。API 接入：ark.cn-beijing.volces.com
以上模型均可在 OpenClaw 的 openclaw.json 中配置为默认模型，详见第二章。
小结
步骤一：飞书开放平台创建应用，获取 App ID 和 App Secret
步骤二：开通机器人能力，让应用能发消息
步骤三：配置必要权限，按需开通
步骤四：选择长连接接收事件，订阅消息事件
步骤五：发布版本——这步最容易忘，最重要！
步骤六：填入 OpenClaw，启动验证
下一章，我们深入了解 OpenClaw 的核心功能——记忆系统、工具调用、多会话管理，让助理真正帮你干活，而不只是聊天。
飞书接入有遇到什么问题？欢迎评论区留言，我会尽快回复。
— OpenClaw 系列 | 第二章，共七章
📚 OpenClaw 入门到精通系列 · 第 2 章 共 7 章
公众号：码上驰骋 | 转载请注明出处
