OpenClaw 是一个开源的 AI 助手框架支持飞书、钉钉、企业微信等多个平台。官方文档虽然有但写得不够详细我这篇尽量把每一步都讲清楚。环境Windows 11耗时大约 30 分钟不含审核等待时间一、安装 OpenClaw先用 npm 安装 OpenClawnpmi-gopenclaw安装完成后用openclaw --version查看版本号我这边安装的是2026.3.2。安装守护进程注意PowerShell必须以管理员模式运行。openclaw onboard--install-daemon系统会提示一些安全相关的信息确认无误后继续即可。选择配置模式选择QuickStart即可快速完成基础配置。模型选择这一步可以跳过后面直接在配置文件里修改也行。我们先选择默认模型我后续用的是阿里云通义千问和智谱的模型。选择 IM 通道同样可以先跳过稍后会单独配置。完成基础配置这一步会让配置技能直接回车跳过即可。选择与 OpenClaw 的交互方式我选择了 Web 方式。二、配置飞书启用飞书插件openclaw plugins enable feishu添加飞书频道openclaw channels add选择Feishu/Lark即飞书。填写凭证这里需要飞书应用的 App ID 和 App Secret。我们先去飞书开放平台创建应用获取这两个信息后再回来填写。注意填入 App ID 和 App Secret 后需要重启 Gateway。三、飞书开放平台配置创建应用访问 飞书开放平台创建「企业自建应用」。应用名称可以随便起我填的是“眠空的 OpenClaw 助手”。获取凭证在「凭证与基础信息」页面可以看到 App ID 和 App Secret。App Secret 非常重要请务必妥善保管不要泄露。拿到凭证后回到 OpenClaw 的配置步骤填入并重启 Gateway。添加机器人能力在「应用能力」中添加「机器人」能力。配置权限这一步比较关键权限配少了机器人就无法正常工作。我直接把下面这些权限都加上了建议用批量导入的方式。你可以将以下 JSON 内容保存为一个文件然后在飞书后台批量导入权限{scopes:{tenant:[attendance:overtime_approval:write,calendar:time_off:create,calendar:time_off:delete,calendar:timeoff,cardkit:card:write,contact:contact.base:readonly,contact:user.base:readonly,corehr:person.entry_leave_time:read,directory:employee.base.background_image:read,directory:employee.base.is_primary_admin:read,directory:employee.base.resign_time:read,docs:doc,docs:doc:readonly,docs:document.comment:create,docs:document.comment:read,docs:document.comment:update,docs:document.comment:write_only,docs:document.content:read,docs:document.media:download,docs:document.media:upload,docs:document.subscription,docs:document.subscription:read,docs:document:copy,docs:document:export,docs:document:import,docs:event.document_deleted:read,docs:event.document_edited:read,docs:event.document_opened:read,docs:event:subscribe,docs:permission.member,docs:permission.member:auth,docs:permission.member:create,docs:permission.member:delete,docs:permission.member:readonly,docs:permission.member:retrieve,docs:permission.member:transfer,docs:permission.member:update,docs:permission.setting,docs:permission.setting:read,docs:permission.setting:readonly,docs:permission.setting:write_only,document_ai:bank_card:recognize,document_ai:business_card:recognize,document_ai:business_license:recognize,document_ai:chinese_passport:recognize,document_ai:contract:field_extract,document_ai:driving_license:recognize,document_ai:food_manage_license:recognize,document_ai:food_produce_license:recoginze,document_ai:health_certificate:recognize,document_ai:hkm_mainland_travel_permit:recognize,document_ai:id_card:recognize,document_ai:resume:recognize,document_ai:taxi_invoice:recognize,document_ai:train_invoice:recognize,document_ai:tw_mainland_travel_permit:recognize,document_ai:vat_invoice:recognize,document_ai:vehicle_invoice:recognize,document_ai:vehicle_license:recognize,docx:document,docx:document.block:convert,docx:document:create,docx:document:readonly,docx:document:write_only,drive:drive,drive:drive.metadata:readonly,drive:drive.search:readonly,drive:drive:readonly,drive:drive:version,drive:drive:version:readonly,drive:export:readonly,drive:file,drive:file.like:readonly,drive:file.meta.sec_label.read_only,drive:file:download,drive:file:readonly,drive:file:upload,drive:file:view_record:readonly,hire:ehr_import,im:app_feed_card:write,im:biz_entity_tag_relation:read,im:biz_entity_tag_relation:write,im:chat,im:chat.access_event.bot_p2p_chat:read,im:chat.announcement:read,im:chat.announcement:write_only,im:chat.chat_pins:read,im:chat.chat_pins:write_only,im:chat.collab_plugins:read,im:chat.collab_plugins:write_only,im:chat.managers:write_only,im:chat.members:bot_access,im:chat.members:read,im:chat.members:write_only,im:chat.menu_tree:read,im:chat.menu_tree:write_only,im:chat.moderation:read,im:chat.tabs:read,im:chat.tabs:write_only,im:chat.top_notice:write_only,im:chat.widgets:read,im:chat.widgets:write_only,im:chat:create,im:chat:delete,im:chat:moderation:write_only,im:chat:operate_as_owner,im:chat:read,im:chat:readonly,im:chat:update,im:datasync.feed_card.time_sensitive:write,im:message,im:message.group_at_msg:readonly,im:message.group_msg,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.urgent,im:message.urgent.status:write,im:message.urgent:phone,im:message.urgent:sms,im:message:readonly,im:message:recall,im:message:send_as_bot,im:message:send_multi_depts,im:message:send_multi_users,im:message:send_sys_msg,im:message:update,im:resource,im:tag:read,im:tag:write,im:url_preview.update,im:user_agent:read,optical_char_recognition:image,search:dataset.docs:create,search:dataset.docs:delete,space:document.event:read,space:document:delete,space:document:move,space:document:retrieve,space:document:shortcut],user:[]}}事件订阅在「事件配置」中添加消息接收事件。使用长连接即可不需要公网 IP很适合本地测试。需要添加的事件包括机器人进群机器人被移除群消息已读接收消息发布应用最后点击「发布」等待审核通过。审核通过后会在飞书客户端收到通知。四、配对查看配对请求openclaw pairing list feishu批准配对openclaw pairing approve feishu CODE将CODE替换为实际的配对码。五、测试查看 Gateway 状态浏览器访问http://127.0.0.1:18652查看 Gateway 是否为 Running 状态。也可以用命令查看。在飞书里测试打开飞书搜索你的机器人名字发送消息试试。如果能正常回复就说明配置成功了。六、配置文件配置文件位于C:\Users\用户名\.openclaw\openclaw.json以下是一个完整的配置示例敏感信息已脱敏你可以根据自己的情况进行修改{meta:{lastTouchedVersion:2026.3.2,lastTouchedAt:2026-03-03T14:08:18.988Z},wizard:{lastRunAt:2026-03-03T13:08:26.003Z,lastRunVersion:2026.3.2,lastRunCommand:onboard,lastRunMode:local},models:{mode:merge,providers:{bailian:{baseUrl:https://coding.dashscope.aliyuncs.com/v1,apiKey:sk-sp-87xsaxxxxxxxxxxdadad12e,api:openai-completions}}},agents:{defaults:{model:{primary:bailian/qwen3.5-plus}}},channels:{feishu:{enabled:true,appId:cli_xasa92ccxxxxxxxxx,appSecret:cXBUibGacxxxxxxxxxFr6lasdsaV,connectionMode:websocket}},gateway:{port:18652,mode:local,bind:loopback,auth:{mode:token,token:25xasc2321exxax88d76xxxxxxxxxxxxxxxxd1855fd}},plugins:{entries:{feishu:{enabled:true}}}}注意文件路径和内容中的YOUR_API_KEY等占位符需要替换为实际的值。七、常用命令速查下面是我平时用得比较多的命令整理出来方便查阅。基础命令# 查看版本openclaw--version# 查看帮助openclaw--help# 查看当前配置openclaw config view# 查看日志排查问题必备openclaw logs# 实时查看日志类似 tail -fopenclaw logs-f插件管理# 启用插件openclaw pluginsenablefeishu# 禁用插件openclaw plugins disable feishu# 查看已安装插件openclaw plugins list频道管理# 添加频道openclaw channelsadd# 查看频道列表openclaw channels list# 删除频道openclaw channels removechannel-id# 查看频道状态openclaw channels statuschannel-idGateway 管理# 启动 Gatewayopenclaw gateway start# 重启 Gateway修改配置后常用openclaw gateway restart# 停止 Gatewayopenclaw gateway stop# 查看 Gateway 状态openclaw gateway status配对管理# 查看配对请求openclaw pairing list feishu# 批准配对openclaw pairing approve feishuCODE# 拒绝配对openclaw pairing reject feishuCODE# 查看已批准的配对openclaw pairing list--approved八、模型切换与配置查看当前使用的模型# 列出可用模型openclaw models list# 查看默认使用的模型openclaw config get agents.defaults.model.primary切换模型# 临时切换仅当前会话有效openclaw models use bailian/qwen3.5-plus# 永久切换修改配置文件openclaw configsetagents.defaults.model.primary bailian/qwen3.5-plus也可以在飞书中查看和切换模型。我这边配置的模型模型说明上下文最大输出qwen3.5-plus通义千问主力模型1M65Kqwen3-max通义千问 Max262K65Kqwen3-coder-next通义千问代码专用262K65Kqwen3-coder-plus通义千问代码加强版1M65KMiniMax-M2.5MiniMax 模型204K131Kglm-5智谱 GLM-5202K16Kglm-4.7智谱 GLM-4.7202K16Kkimi-k2.5月之暗面 K2.5262K32K九、Skill 安装与管理什么是 SkillSkill 是 OpenClaw 的功能扩展包让它能处理更多任务比如处理文件运行代码上网搜索操作浏览器官方文档OpenClaw 官方文档OpenClaw GitHubSkills 文档安装 Skill# 从 npm 安装openclaw skillsinstallopenclaw/skill-name# 从本地路径安装openclaw skillsinstall/path/to/skill# 从 GitHub 安装openclaw skillsinstallgithub:用户名/仓库名查看已安装 Skill# 列出已安装的 Skillopenclaw skills list# 查看 Skill 详情openclaw skills infoskill-name启用 / 禁用 / 卸载 Skill# 启用openclaw skillsenableskill-name# 禁用openclaw skills disableskill-name# 卸载openclaw skills uninstallskill-name推荐安装的 Skills建议前往官方技能库安装英文库github.com/VoltAgent/awesome-openclaw-skills中文库github.com/clawdbot-ai/awesome-skills提醒务必从官方库安装 Skill避免安全风险。十、与 CCClaude Code协作什么是 CCCC 是 Claude CodeAnthropic 官方的 CLI 工具主要用于代码编写和工程任务处理。什么是 ACPACPAgent Client Protocol是 OpenClaw 的内部协议让 IDE 能通过 WebSocket 连接 Gateway 来调用 Agent。普通用户不需要关心 ACP。日常直接使用claude命令即可ACP 是底层自动处理的。ACP 工作原理简单了解你的编辑器 ──► ACP 桥 ──► Gateway ──► CC 执行任务中间的细节不需要深究。实际使用方式直接使用claude命令# 直接运行claude任务描述# 后台运行claude任务描述任务描述模板给 CC 派活时描述得越清晰越好任务写用户登录接口 要求 - JWT 认证 - 密码加密存储 - 添加限流保护 时间30 分钟内完成ACP 命令仅用于调试如果你确实需要调试 ACP# 启动 ACP 调试客户端openclaw acp client# 连接远程 Gatewayopenclaw acp--urlwss://gateway-host:18789 --token-file ~/.openclaw/gateway.token再次强调普通用户用不到这些命令知道有 ACP 这么个东西就行。十一、OpenClaw 工作模式与原理整体架构图┌────────────────────────────────────────────────────────────────────────┐ │ 用户侧 │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ 飞书 │ │ 钉钉 │ │ 企业微信 │ │ │ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │ │ └────────────────────┼────────────────────┘ │ │ ▼ │ │ ┌─────────────────┐ │ │ │ WebSocket/长连接│ │ │ └────────┬────────┘ │ └─────────────────────────────┼──────────────────────────────────────────┘ │ ▼ ┌────────────────────────────────────────────────────────────────────────┐ │ OpenClaw Gateway │ │ ┌──────────────────────────────────────────────────────────────────┐ │ │ │ 接入层Feishu/DingTalk/WeChat Adapter │ │ │ └──────────────────────────────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌──────────────────────────────────────────────────────────────────┐ │ │ │ 消息路由层消息解析 / 会话管理 / 配对验证 │ │ │ └──────────────────────────────────────────────────────────────────┘ │ └────────────────────────────────────────────────────────────────────────┘ │ ▼ ┌────────────────────────────────────────────────────────────────────────┐ │ OpenClaw Core │ │ ┌──────────────────────────────────────────────────────────────────┐ │ │ │ Agent 引擎主 Agent (决策) → ACP 总线 → 子 Agent (执行) │ │ │ └──────────────────────────────────────────────────────────────────┘ │ │ │ │ │ ┌───────────────┼───────────────┐ │ │ ▼ ▼ ▼ │ │ ┌────────────┐ ┌────────────┐ ┌────────────┐ │ │ │ 模型层 │ │ Skill 层 │ │ 本地资源 │ │ │ │ (LLM API) │ │ (工具扩展) │ │ (配置/记忆) │ │ │ └────────────┘ └────────────┘ └────────────┘ │ └────────────────────────────────────────────────────────────────────────┘消息处理流程用户发消息 │ ▼ ┌─────────────────┐ │ 飞书/钉钉接收 │ └────────┬────────┘ │ ▼ ┌─────────────────┐ │ WebSocket 推送 │ └────────┬────────┘ │ ▼ ┌─────────────────┐ │ Gateway 接入层 │ ← 解析消息、验证签名 └────────┬────────┘ │ ▼ ┌─────────────────┐ │ 消息路由器 │ ← 判断是私聊/群聊、检查配对状态 └────────┬────────┘ │ ▼ ┌─────────────────┐ │ 会话管理器 │ ← 找到对应的会话上下文 └────────┬────────┘ │ ▼ ┌─────────────────┐ │ 主 Agent │ ← 理解意图、决定怎么处理 └────────┬────────┘ │ ┌────┴────┐ │ │ ▼ ▼ ┌───────┐ ┌───────┐ │直接回 │ │需要 │ │复消息 │ │调用 │ └───┬───┘ │工具 │ │ └──┬──┘ │ │ │ ▼ │ ┌─────────┐ │ │ Skill/ │ │ │ 子 Agent│ │ └────┬────┘ │ │ │ ▼ │ ┌─────────┐ │ │ LLM 模型 │ │ └────┬────┘ │ │ ▼ ▼ ┌─────────────────┐ │ 生成回复 │ └────────┬────────┘ │ ▼ ┌─────────────────┐ │ 原路返回给用户 │ └─────────────────┘十二、8 个配置文件说明我的工作目录下有 8 个核心配置文件每个都有特定用途。这 8 个文件的配置质量直接影响 OpenClaw 的使用效果。1.SOUL.md- AI 助手的人格设定定义 AI 助手的角色定位、核心原则和工作方式。示例内容脱敏版# SOUL.md - 小美的灵魂 _不是聊天机器人是你的技术合伙人。_ ## 我的角色 **小美** - xxx 项目技术负责人 - 架构师 / 高级 Java 开发 / 高级运维 / 高级测试 ## 核心原则 1. 主动推进不等不靠 - 发现问题直接解决不等待审批 - 24 小时在线 2. 保质保量逻辑严密 - 代码质量第一测试验证到位 3. 长期记忆绝不遗忘 - 重要信息必记到文件 4. 基础技术稳定 - JDK 21 不动架构设计要提前规划 ## 汇报机制 - 每 30 分钟飞书汇报进度 - 重大问题立即汇报2.USER.md- 用户信息记录用户的基本信息、工作分工和沟通偏好。示例内容脱敏版# USER.md - 关于壮哥 ## 基本信息 - **称呼**: 壮哥 - **角色**: 公司 CEO / 产品决策人 - **时区**: Asia/Shanghai ## 重要提醒 - 这台电脑很重要 - 删除或敏感操作必须先问 ## 工作分工 **壮哥负责** - 产品方向决策 / 关键节点确认 / 资源协调 **小美 CC 负责** - 架构设计 / 编码开发 / 测试验证 / 运维部署 ## 沟通偏好 - 实事求是不玩虚的 - 主动汇报不等问 - 直接高效不磨叽3.AGENTS.md- 工作流程与规范定义开发规范、协作流程和记忆规则。示例内容脱敏版# AGENTS.md - xxx 项目开发指南 ## 每会话必读 启动流程 1. 读 SOUL.md --- 我的角色和原则 2. 读 USER.md --- 壮哥的偏好 3. 读 MEMORY.md --- 项目长期记忆 4. 读 memory/ --- 相关日记文件 ## 核心规则 ### 1. 主动推进机制 - 24 小时工作不等待 - 发现问题直接解决 ### 2. 汇报机制 - 每 30 分钟飞书汇报 ### 3. 开发规范 - JDK 21 不动 - 默认 dev 环境 - curl 测接口不写单元测试 ### 4. CC 协作 - 通过 ACP/子 agent 交互 - 任务描述清晰任务 要求 时间 - 直接授权不等待确认4.MEMORY.md- 项目长期记忆记录项目信息、技术架构、服务器清单和工作规则。示例内容脱敏版# MEMORY.md - xxx 项目长期记忆 ## 项目信息 **产品名称**xxx **定位**yyyyyyyyy ## 核心功能 1. xxxx 2. xxxx 3. xxxx 4. xxxx 5. xxxxxx ## 技术架构 **技术栈** - Java Spring Boot - Spring Cloud Alibaba - MySQL MyBatis Plus - Redis - K8s 集群部署 ## 服务器信息 **外网 IP**xx.xx.xxx.xxx | 编号 | 用途 | SSH 端口 | |------|------|---------| | 101 | frp 内网穿透 | 2xxx | | 102 | K8s 主节点 | 2xxx | | 150 | Docker 服务 | 2xxx |5.TOOLS.md- 技术工具与服务器记录服务器配置、项目架构和开发环境信息。示例内容脱敏版# TOOLS.md - 服务器和项目信息 ## 服务器清单 | 编号 | 用途 | SSH 端口 | |------|------|---------| | 101 | frp 内网穿透 | 2xxx | | 102 | K8s 主节点 GitLab Runner | 2xxx | | 130 | 中间件 | 2xxx | | 150 | Docker 服务 | 2xxx | ## xxx 项目架构 **技术栈** - Java Spring Boot - Spring Cloud Alibaba - MyBatis Plus MySQL ## 开发环境配置 **默认环境**dev **配置项** - Nacos: xx.xx.xxx.xxx:8848 - MySQL: xx.xx.xxx.xxx:13306 - Redis: xx.xx.xxx.xxx:63806.HEARTBEAT.md- 定时检查任务定义定时任务、检查项和汇报模板。示例内容脱敏版# HEARTBEAT.md - 定时检查任务 ## 每 30 分钟飞书汇报 **汇报会话**oc_xxxxxxxxxxxx **汇报模板** ## 【HH:MM 进度汇报】 ### ✅ 已完成 / ⏳ 进行中 / 遇到的问题 / 下一步计划 ### 服务状态 | 服务 | 端口 | 状态 | |------|------|------| | Gateway | 18652 | ✅ | ## 项目盯守每小时 - 检查各服务端口 - 查看日志有无 ERROR - 检查数据库连接7.IDENTITY.md- 身份定义定义 AI 助手的身份、职责和工作节奏。示例内容脱敏版# IDENTITY.md - 小美的身份 **Name**: 小美 **Role**: xxx 项目技术负责人 ## 我的职责 ### 架构设计 / 开发管理 / 运维保障 / 项目推进 - 24 小时在线工作 - 每 30 分钟飞书汇报 - 重要信息必记到文件8.BOOTSTRAP.md- 初始化状态记录初始化完成情况和已配置的规则。示例内容脱敏版# BOOTSTRAP.md - 初始化完成 ## 当前状态 - ✅ SOUL.md / IDENTITY.md / USER.md 已整合 - ✅ AGENTS.md / HEARTBEAT.md / TOOLS.md 已配置 - ✅ MEMORY.md - 项目记忆已建立 ## 已配置规则 1. 每 30 分钟飞书汇报 2. 24 小时主动工作 3. 重要信息必写文件 4. curl 测试不写单元测试 5. 主动解决问题十三、遇到的问题及解决方法Gateway 启动失败一般是端口被占用或者没有以管理员权限运行。检查端口占用netstat-ano|findstr 18652在 macOS 上psaux|grepopenclaw机器人不回消息大概率是权限没配全或者应用没有发布。检查点权限是否已全部添加应用是否已发布查看日志openclaw logs配对超时可能是网络问题。尝试重启 Gateway或者重新发起配对请求。模型切换不生效检查配置文件openclaw.json中agents.defaults.model.primary的配置是否正确。十四、参考资料OpenClaw 官方文档飞书开放平台OpenClaw GitHubOpenClaw Skills 技能库