新手教程
综合资讯
OpenClaw从零配置指南：接入飞书与常用命令原理解析
摘要
基于OpenClaw开源AI助手框架，介绍了从零配置接入飞书的完整流程。包括通过npm安装OpenClaw、
写在前面
最近折腾了一下 OpenClaw 这玩意儿，琢磨着把它接入飞书，给自己弄个私人助手。一路踩坑不断，但好在最终跑通了。干脆把完整的安装配置过程记下来，给需要的朋友当个参考。
OpenClaw 是个开源的 AI 助手框架，能对接飞书、钉钉、企业微信这些平台。官方文档倒也有，但写得不够细，这篇就尽量把每一步都说清楚。
环境：Windows 11
耗时：大概 30 分钟（不算等审核的时间）
一、安装 OpenClaw
先用 npm 把 openclaw 装上：
npm i -g openclaw
装完之后用 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。
三、飞书开放平台配置
创建应用
访问 open.feishu.cn，创建一个企业自建应用。
应用名字自己定，我填的是“眠空的 Open Claw 助手”。
获取凭证
在“凭证与基础信息”里就能找到 App ID 和 App Secret。
App Secret 务必保密，这东西和密码一样重要。
拿到之后，去上一步的凭证填写位置填入这两个信息，然后重启 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_lea ve_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_tra vel_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_tra vel_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
将 替换为实际的配对码。
五、测试
查看 Gateway 状态
在浏览器中打开 http://127.0.0.1:18652
看看 Gateway 是不是 Running 状态。当然，也可以用命令行查看：
在飞书里试一下
打开飞书，搜索你的机器人名字，发条消息试试看：
能正常回复就说明大功告成了。
六、配置文件
配置文件路径在这里：C:Users<用户名>.openclawopenclaw.json
将以下内容复制到配置文件中（注意文件位置！）。把 YOUR_API_KEY 替换为你的 Coding Plan 专属 API Key。
{
"models": {
"mode": "merge",
"providers": {
"bailian": {
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"apiKey": "YOUR_API_KEY",
"api": "openai-completions",
"models": [
{
"id": "qwen3.5-plus",
"name": "qwen3.5-plus",
"reasoning": false,
"input": ["text", "image"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 1000000,
"maxTokens": 65536
},
{
"id": "qwen3-max-2026-01-23",
"name": "qwen3-max-2026-01-23",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 262144,
"maxTokens": 65536
},
{
"id": "qwen3-coder-next",
"name": "qwen3-coder-next",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 262144,
"maxTokens": 65536
},
{
"id": "qwen3-coder-plus",
"name": "qwen3-coder-plus",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 1000000,
"maxTokens": 65536
},
{
"id": "MiniMax-M2.5",
"name": "MiniMax-M2.5",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 204800,
"maxTokens": 131072
},
{
"id": "glm-5",
"name": "glm-5",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 202752,
"maxTokens": 16384
},
{
"id": "glm-4.7",
"name": "glm-4.7",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 202752,
"maxTokens": 16384
},
{
"id": "kimi-k2.5",
"name": "kimi-k2.5",
"reasoning": false,
"input": ["text", "image"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 262144,
"maxTokens": 32768
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "bailian/qwen3.5-plus"
},
"models": {
"bailian/qwen3.5-plus": {},
"bailian/qwen3-max-2026-01-23": {},
"bailian/qwen3-coder-next": {},
"bailian/qwen3-coder-plus": {},
"bailian/MiniMax-M2.5": {},
"bailian/glm-5": {},
"bailian/glm-4.7": {},
"bailian/kimi-k2.5": {}
}
}
},
"gateway": {
"mode": "local"
}
}
最终我的 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
}
}
}
}
七、常用命令速查
以下是我平时用得多的一些命令，整理出来方便查阅：
基础命令
# 查看版本 openclaw --version # 查看帮助 openclaw --help # 查看当前配置 openclaw config view # 查看日志（排查问题必备） openclaw logs # 实时查看日志（类似 tail -f） openclaw logs -f
插件管理
# 启用插件 openclaw plugins enable feishu # 禁用插件 openclaw plugins disable feishu # 列出已安装的插件 openclaw plugins list
频道管理
# 添加频道 openclaw channels add # 查看已添加的频道 openclaw channels list # 删除频道 openclaw channels remove# 查看频道状态 openclaw channels status
Gateway 管理
# 启动 Gateway openclaw gateway start # 重启 Gateway（改配置后常用） openclaw gateway restart # 停止 Gateway openclaw gateway stop # 查看 Gateway 状态 openclaw gateway status
配对管理
# 查看配对请求
openclaw pairing list feishu
# 批准配对
openclaw pairing approve feishu
# 拒绝配对
openclaw pairing reject feishu
# 查看已批准的配对
openclaw pairing list --approved
八、模型切换与配置
查看当前使用的模型
# 列出可用的模型 openclaw models list # 查看默认使用的模型 openclaw config get agents.defaults.model.primary
切换模型
# 临时切换（仅当前会话生效） openclaw models use bailian/qwen3.5-plus # 永久切换（修改配置文件） openclaw config set agents.defaults.model.primary bailian/qwen3.5-plus
另外在飞书中也可以直接查看和切换模型：
已配置的模型清单
| 模型 | 说明 | 上下文 | 最大输出 |
|---|---|---|---|
| qwen3.5-plus | 通义千问，主力模型 | 1M | 65K |
| qwen3-max | 通义千问 Max | 262K | 65K |
| qwen3-coder-next | 通义千问，写代码专用 | 262K | 65K |
| qwen3-coder-plus | 通义千问，代码加强版 | 1M | 65K |
| MiniMax-M2.5 | MiniMax 模型 | 204K | 131K |
| glm-5 | 智谱 GLM-5 | 202K | 16K |
| glm-4.7 | 智谱 GLM-4.7 | 202K | 16K |
| kimi-k2.5 | 月之暗面 K2.5 | 262K | 32K |
九、Skill 安装与管理
什么是 Skill
Skill 就是扩展包，用来让 OpenClaw 能做更多的事情。比如：
- 处理文件
- 执行代码
- 上网搜索
- 操作浏览器
官方文档
- OpenClaw 官方文档
- OpenClaw GitHub
- Skills 文档
安装 Skill
# 从 npm 安装 openclaw skills install @openclaw/skill-name # 从本地路径安装 openclaw skills install /path/to/skill # 从 GitHub 安装 openclaw skills install github:用户名/仓库名
查看已安装的 Skill
# 列出已安装的 openclaw skills list # 查看详情 openclaw skills info
启用/禁用/卸载
# 启用
openclaw skills enable
# 禁用
openclaw skills disable
# 卸载
openclaw skills uninstall
推荐安装的 Skills
可以参阅 OpenClaw 中/英文官方技能库。英文版见：
中文版见：
提醒：务必从官方 skills 库安装，否则风险很大！
十、与 CC（Claude Code）协作
什么是 CC
CC 就是 Claude Code，Anthropic 官方的 CLI 工具，主要用于写代码和处理工程任务。
ACP 是什么（普通用户一般用不到）
ACP = Agent 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 # 连接远程 Gateway openclaw acp --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token
再次强调：普通用户基本用不到这些命令，知道有这回事就行。
十一、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 项目技术负责人 - 架构师 / 高级 Ja va 开发 / 高级运维 / 高级测试 ## 核心原则 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 ## 技术架构 **技术栈**： - Ja va + 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 项目架构 **技术栈**： - Ja va + 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:6380
6. 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. 主动解决问题
下面是日常使用情况：
十三、遇到的问题
这里尽量都选 on，这样能实现深度思考和详细输出
Gateway 启动失败
通常是端口被占用，或者没有以管理员权限运行。
查一下端口占用情况：
netstat -ano | findstr 18652 mac: ps aux | grep openclaw
机器人不回消息
大概率是权限没配置完整，或者应用没有成功发布。
检查以下几点：
- 权限是否全部添加
- 应用是否已发布
- 查看日志：
openclaw logs
配对超时
一般是网络问题。尝试重启 Gateway，或者重新发起配对请求。
模型切换不生效
检查配置文件 openclaw.json 中的 agents.defaults.model.primary 是否正确。
最后
遇到问题可以查阅官方文档：
- OpenClaw 文档
- 飞书开放平台
- GitHub
- Skills 技能库
来源：互联网
免责声明
本网站新闻资讯均来自公开渠道，力求准确但不保证绝对无误，内容观点仅代表作者本人，与本站无关。若涉及侵权，请联系我们处理。本站保留对声明的修改权，最终解释权归本站所有。
