OpenClaw 從零配置指南并接入飛書 + 常用命令 + 原理全解析
發(fā)布時間：2026-03-12 10:48:57 作者：蝎子萊萊愛打怪 
我要評論
我要評論本文介紹了如何從零配置OpenClaw并接入飛書,包括安裝、配置、權(quán)限設(shè)置、模型切換、技能管理等步驟,以及常用命令和配置文件說明，感興趣的朋友跟隨小編一起看看吧
寫在前面
最近折騰了一下 OpenClaw，想把它接入到飛書里做個私人助手。踩了不少坑，記錄一下完整的安裝配置過程，給有需要的朋友參考。
OpenClaw 是個開源的 AI 助手框架，支持接入飛書、釘釘、企業(yè)微信這些平臺。官方文檔有是有，但不夠詳細，這篇就盡量把每個步驟都講清楚。
環(huán)境：Windows 11 耗時：大概 30 分鐘（不算等審核的時間）
一、安裝 OpenClaw
先使用 npm 安裝 openclaw：
npm i -g openclaw
安裝完使用 openclaw --version 看下版本，我這是 2026.3.2
安裝守護進程
注意：PowerShell 要用管理員模式運行
openclaw onboard --install-daemon
它會提示一些安全相關(guān)的東西，看一下，確認沒問題就繼續(xù)。
選擇配置模式
這里選 QuickStart 就行，快速配置。
模型選擇
這一步可以跳過，后面改配置文件也行。
這里我們先選擇默認模型：
我后面用的是通義千問阿里云和智譜的。
選擇 IM 通道，這里也選擇跳過（一會再配）：
完成
這一步讓你配置技能直接回車：
選擇一種和 openclaw 交互的方式，我這使用 web 方式：
二、配置飛書
啟用飛書插件
openclaw plugins enable feishu
添加頻道
openclaw channels add
選 Feishu/Lark（飛書)
填憑證
這里需要飛書應用的 App ID 和 App Secret，我們先去飛書開放平臺搞（下一步就說），有了appid和secert后再分別填到這里。
注意：填入 App ID 和 App Secret后需要重啟Gateway
三、飛書開放平臺配置
創(chuàng)建應用
上 open.feishu.cn，創(chuàng)建企業(yè)自建應用。
名字隨便起，我填的"眠空的 Open Claw 助手"。
拿憑證
在"憑證與基礎(chǔ)信息"里能看到 App ID 和 App Secret。
App Secret 別泄露，這玩意兒跟密碼一樣。
去 填憑證這一步填入這倆信息 并重啟gateway。
加機器人
點"添加應用能力"，選機器人。
配權(quán)限
這個比較關(guān)鍵，權(quán)限少了機器人沒法用。我加的這些 一次性全部開放哈哈：
批量導入下邊權(quán)限的 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": []
}
}事件訂閱
在"事件配置"里加消息接收事件。
用長連接就行，不用搞公網(wǎng) IP，適合本地測試。
然后添加這幾個事件：
- 機器人進群
- 機器人被移除群
- 消息已讀
- 接收消息
發(fā)布
最后點發(fā)布，等審核。
審核過了會通知。
發(fā)布成功在飛書客戶端可以收到通知：
四、配對
查看配對請求
openclaw pairing list feishu
批準
openclaw pairing approve feishu <CODE>
CODE 換成實際的配對碼。
五、測試
看 Gateway 狀態(tài)
瀏覽器打開 http://127.0.0.1:18652
看 Gateway 是不是 Running,當然也可以命令看：
飛書里試一下
打開飛書，搜你的機器人名字，發(fā)消息試試：
能回復就成功了。
六、配置文件
配置文件在這：C:\Users\<用戶名>\.openclaw\openclaw.json
復制以下內(nèi)容到配置文件（注意文件位置?。?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
}
}
}
}七、常用命令速查
這些命令是我平時用得比較多的，整理一下：
基礎(chǔ)命令
# 看看版本 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 <channel-id> # 看看頻道狀態(tài)咋樣 openclaw channels status <channel-id>
Gateway 管理
# 啟動 openclaw gateway start # 重啟（配置改了之后常用） openclaw gateway restart # 停止 openclaw gateway stop # 看看網(wǎng)關(guān)活了沒 openclaw gateway status
配對管理
# 看看誰想配對 openclaw pairing list feishu # 批準配對 openclaw pairing approve feishu <CODE> # 拒絕 openclaw pairing reject feishu <CODE> # 看看已經(jīng)配對了哪些 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
Skill 就是擴展包，讓 OpenClaw 能干更多活。比如：
- 處理文件
- 跑代碼
- 上網(wǎng)搜東西
- 操作瀏覽器
官方文檔
裝 Skill
# 從 npm 裝 openclaw skills install @openclaw/skill-name # 從本地裝 openclaw skills install /path/to/skill # 從 GitHub 裝 openclaw skills install github:用戶名/倉庫名
看看裝了啥
# 列出已安裝的 openclaw skills list # 看詳情 openclaw skills info <skill-name>
啟用/禁用/卸載
# 啟用
openclaw skills enable <skill-name>
# 禁用
openclaw skills disable <skill-name>
# 卸載
openclaw skills uninstall <skill-name>
推薦安裝的 Skills
見 OpenClaw 中/英文官方技能庫 英文見這里：github.com/VoltAgent/a…
中文見這里：github.com/clawdbot-ai…
提醒：務必去官方skills庫安裝 否則風險很大！
十、與 CC（Claude Code）協(xié)作
啥是 CC
CC 就是 Claude Code，Anthropic 官方的 CLI 工具，主要用來寫代碼和處理工程任務。
ACP 是啥（用戶一般用不到）
ACP = Agent Client Protocol
這是 OpenClaw 內(nèi)部的協(xié)議，讓 IDE 能通過 WebSocket 連接 Gateway 來調(diào)度 Agent。
重點：普通用戶不需要關(guān)心 ACP。你平時直接用 claude 命令就行，ACP 是底層自動處理的。
ACP 工作原理（簡單了解）
你的編輯器 ──? ACP 橋 ──? Gateway ──? CC 執(zhí)行任務
就這么簡單，中間的細節(jié)不用管。
實際使用方式
直接用 claude 命令：
# 直接運行 claude "任務描述" ? # 后臺運行 claude "任務描述" &
任務描述模板
給 CC 派活兒時，描述清楚點兒：
任務：寫用戶登錄接口 要求： - JWT 認證 - 密碼要加密 - 加限流保護 時間：30 分鐘內(nèi)搞定
ACP 命令（僅供了解）
如果你真的需要調(diào)試 ACP：
# 啟動 ACP 調(diào)試客戶端 openclaw acp client ? # 連接遠程 Gateway openclaw acp --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token
再次強調(diào)：普通用戶用不到這些命令，知道有這么個東西就行。
十一、OpenClaw 工作模式與原理
整體架構(gòu)圖
┌────────────────────────────────────────────────────────────────────────┐
│ 用戶側(cè) │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 飛書 │ │ 釘釘 │ │ 企業(yè)微信 │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
│ └────────────────────┼────────────────────┘ │
│ ▼ │
│ ┌─────────────────┐ │
│ │ WebSocket/長連接│ │
│ └────────┬────────┘ │
└─────────────────────────────┼──────────────────────────────────────────┘
│
▼
┌────────────────────────────────────────────────────────────────────────┐
│ OpenClaw Gateway │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ 接入層（Feishu/DingTalk/WeChat Adapter） │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ 消息路由層（消息解析 / 會話管理 / 配對驗證） │ │
│ └──────────────────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────────────┘
│
▼
┌────────────────────────────────────────────────────────────────────────┐
│ OpenClaw Core │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ Agent 引擎：主 Agent (決策) → ACP 總線 → 子 Agent (執(zhí)行) │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌───────────────┼───────────────┐ │
│ ▼ ▼ ▼ │
│ ┌────────────┐ ┌────────────┐ ┌────────────┐ │
│ │ 模型層 │ │ Skill 層 │ │ 本地資源 │ │
│ │ (LLM API) │ │ (工具擴展) │ │ (配置/記憶) │ │
│ └────────────┘ └────────────┘ └────────────┘ │
└────────────────────────────────────────────────────────────────────────┘消息處理流程
用戶發(fā)消息
│
▼
┌─────────────────┐
│ 飛書/釘釘接收 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ WebSocket 推送 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ Gateway 接入層 │ ← 解析消息、驗證簽名
└────────┬────────┘
│
▼
┌─────────────────┐
│ 消息路由器 │ ← 判斷是私聊/群聊、檢查配對狀態(tài)
└────────┬────────┘
│
▼
┌─────────────────┐
│ 會話管理器 │ ← 找到對應的會話上下文
└────────┬────────┘
│
▼
┌─────────────────┐
│ 主 Agent │ ← 理解意圖、決定怎么處理
└────────┬────────┘
│
┌────┴────┐
│ │
▼ ▼
┌───────┐ ┌───────┐
│直接回 │ │需要 │
│復消息 │ │調(diào)用 │
└───┬───┘ │工具 │
│ └──┬──┘
│ │
│ ▼
│ ┌─────────┐
│ │ Skill/ │
│ │ 子 Agent│
│ └────┬────┘
│ │
│ ▼
│ ┌─────────┐
│ │ LLM 模型 │
│ └────┬────┘
│ │
▼ ▼
┌─────────────────┐
│ 生成回復 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 原路返回給用戶 │
└─────────────────┘
十二、8 個配置文件說明
我工作目錄下有這么 8 個核心配置文件，每個都有特定用處：注意這8個配置文件非常重要，寫的好與壞直接覺得你的openclaw是否好用！
1. SOUL.md - AI 助手的人格設(shè)定
干啥用的：定義 AI 助手是個啥角色、有啥原則、咋干活。
示例內(nèi)容（脫敏版）：
# SOUL.md - 小美的靈魂 _不是聊天機器人，是你的技術(shù)合伙人。_ ## 我的角色 **小美** - xxx 項目技術(shù)負責人 - 架構(gòu)師 / 高級 Java 開發(fā) / 高級運維 / 高級測試 ## 核心原則 1. 主動推進，不等不靠 - 發(fā)現(xiàn)問題直接解決，不等待審批 - 24 小時在線 2. 保質(zhì)保量，邏輯嚴密 - 代碼質(zhì)量第一，測試驗證到位 3. 長期記憶，絕不遺忘 - 重要信息必記到文件 4. 基礎(chǔ)技術(shù)穩(wěn)定 - JDK 21 不動，架構(gòu)設(shè)計要提前規(guī)劃 ## 匯報機制 - 每 30 分鐘飛書匯報進度 - 重大問題立即匯報
2. USER.md - 用戶信息
干啥用的：記用戶的基本信息、分工、偏好。
示例內(nèi)容（脫敏版）：
# USER.md - 關(guān)于壯哥 ## 基本信息 - **稱呼**: 壯哥 - **角色**: 公司 CEO / 產(chǎn)品決策人 - **時區(qū)**: Asia/Shanghai ## 重要提醒 - 這臺電腦很重要 - 刪除或敏感操作必須先問 ## 工作分工 **壯哥負責**： - 產(chǎn)品方向決策 / 關(guān)鍵節(jié)點確認 / 資源協(xié)調(diào) **小美 + CC 負責**： - 架構(gòu)設(shè)計 / 編碼開發(fā) / 測試驗證 / 運維部署 ## 溝通偏好 - 實事求是，不玩虛的 - 主動匯報，不等問 - 直接高效，不磨嘰
3. AGENTS.md - 工作流程與規(guī)范
干啥用的：定義開發(fā)規(guī)范、協(xié)作流程、記憶規(guī)則。
示例內(nèi)容（脫敏版）：
# AGENTS.md - xxx 項目開發(fā)指南 ## 每會話必讀 啟動流程： 1. 讀 SOUL.md — 我的角色和原則 2. 讀 USER.md — 壯哥的偏好 3. 讀 MEMORY.md — 項目長期記憶 4. 讀 memory/ — 相關(guān)日記文件 ## 核心規(guī)則 ### 1. 主動推進機制 - 24 小時工作，不等待 - 發(fā)現(xiàn)問題直接解決 ### 2. 匯報機制 - 每 30 分鐘飛書匯報 ### 3. 開發(fā)規(guī)范 - JDK 21 不動 - 默認 dev 環(huán)境 - curl 測接口，不寫單元測試 ### 4. CC 協(xié)作 - 通過 ACP/子 agent 交互 - 任務描述清晰：任務 + 要求 + 時間 - 直接授權(quán)，不等待確認
4. MEMORY.md - 項目長期記憶
干啥用的：記項目信息、技術(shù)架構(gòu)、服務器清單、工作規(guī)則。
示例內(nèi)容（脫敏版）：
# MEMORY.md - xxx 項目長期記憶 ## 項目信息 **產(chǎn)品名稱**：xxx **定位**：yyyyyyyyy ## 核心功能 1. xxxx 2. xxxx 3. xxxx 4. xxxx 5. xxxxxx ## 技術(shù)架構(gòu) **技術(shù)棧**： - Java + Spring Boot - Spring Cloud Alibaba - MySQL + MyBatis Plus - Redis - K8s 集群部署 ## 服務器信息 **外網(wǎng) IP**：xx.xx.xxx.xxx | 編號 | 用途 | SSH 端口 | |------|------|---------| | 101 | frp 內(nèi)網(wǎng)穿透 | 2xxx | | 102 | K8s 主節(jié)點 | 2xxx | | 150 | Docker 服務 | 2xxx |
5. TOOLS.md - 技術(shù)工具與服務器
干啥用的：記服務器配置、項目架構(gòu)、開發(fā)環(huán)境。
示例內(nèi)容（脫敏版）：
# TOOLS.md - 服務器和項目信息 ## 服務器清單 | 編號 | 用途 | SSH 端口 | |------|------|---------| | 101 | frp 內(nèi)網(wǎng)穿透 | 2xxx | | 102 | K8s 主節(jié)點 + GitLab Runner | 2xxx | | 130 | 中間件 | 2xxx | | 150 | Docker 服務 | 2xxx | ## xxx 項目架構(gòu) **技術(shù)棧**： - Java + Spring Boot - Spring Cloud Alibaba - MyBatis Plus + MySQL ## 開發(fā)環(huán)境配置 **默認環(huán)境**：dev **配置項** - Nacos: xx.xx.xxx.xxx:8848 - MySQL: xx.xx.xxx.xxx:13306 - Redis: xx.xx.xxx.xxx:6380
6. HEARTBEAT.md - 定時檢查任務
干啥用的：定義定時任務、檢查項、匯報模板。
示例內(nèi)容（脫敏版）：
# HEARTBEAT.md - 定時檢查任務 ## 每 30 分鐘（飛書匯報） **匯報會話**：oc_xxxxxxxxxxxx **匯報模板**： ## 【HH:MM 進度匯報】 ### ? 已完成 / ? 進行中 / ?? 遇到的問題 / ?? 下一步計劃 ### ?? 服務狀態(tài) | 服務 | 端口 | 狀態(tài) | |------|------|------| | Gateway | 18652 | ? | ## 項目盯守（每小時） - 檢查各服務端口 - 查看日志有無 ERROR - 檢查數(shù)據(jù)庫連接
7. IDENTITY.md - 身份定義
干啥用的：定義 AI 助手的身份、職責、工作節(jié)奏。
示例內(nèi)容（脫敏版）：
# IDENTITY.md - 小美的身份 **Name**: 小美 **Role**: xxx 項目技術(shù)負責人 ## 我的職責 ### 架構(gòu)設(shè)計 / 開發(fā)管理 / 運維保障 / 項目推進 - 24 小時在線工作 - 每 30 分鐘飛書匯報 - 重要信息必記到文件
8. BOOTSTRAP.md - 初始化狀態(tài)
干啥用的：記初始化完成情況、已配置的規(guī)則。
示例內(nèi)容（脫敏版）：
# BOOTSTRAP.md - 初始化完成 ## 當前狀態(tài) - ? SOUL.md / IDENTITY.md / USER.md 已整合 - ? AGENTS.md / HEARTBEAT.md / TOOLS.md 已配置 - ? MEMORY.md - 項目記憶已建立 ## 已配置規(guī)則 1. 每 30 分鐘飛書匯報 2. 24 小時主動工作 3. 重要信息必寫文件 4. curl 測試，不寫單元測試 5. 主動解決問題
看下日常使用情況：
十三、遇到的問題
這里盡量都選on 這樣深度思考&詳細輸出
Gateway 啟動失敗
一般是端口被占了，或者沒開管理員權(quán)限。
查一下端口：
netstat -ano | findstr 18652 mac: ps aux | grep openclaw
機器人不回消息
大概率是權(quán)限沒配好，或者沒發(fā)布。
檢查一下：
- 權(quán)限有沒有加全
- 發(fā)布了沒有
- 看日志：
openclaw logs
配對超時
網(wǎng)絡(luò)問題吧，重啟 Gateway 試試，或者重新發(fā)起配對。
模型切換不生效
檢查配置文件 openclaw.json 中的 agents.defaults.model.primary 是否正確。
最后
有啥問題可以去看看官方文檔：
到此這篇關(guān)于OpenClaw 從零配置指南：接入飛書 + 常用命令 + 原理圖解的文章就介紹到這了,更多相關(guān)OpenClaw 配置接入飛書內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！
相關(guān)文章
OpenClaw 是一個個人 AI 代理框架,支持連接多種聊天平臺（如飛書、Telegram 等）并集成多種模型,這篇文章主要介紹了OpenClaw飛書官方插件安裝教程的相關(guān)資料,文中通過代碼2026-03-27
ubuntu (V100)中 部署openclaw并鏈接飛書的操作方法
本文介紹了在Ubuntu上部署Ollama的大模型推理框架及OpenClaw的方法,包括編譯安裝Ollama、使用OpenClaw的安裝腳本和配置文件等步驟,并簡要介紹了OpenClaw的工作流程，感興趣2026-03-26
OpenClaw飛書渠道ACP功能啟動的實現(xiàn)步驟
OpenClaw 的 ACP機制允許將 Codex、Claude Code、Gemini CLI 等外部編程工具納入 OpenClaw 的 Agent 編排體系,很多讀者在飛書渠道部署 OpenClaw 后，想知道如何在這個環(huán)境2026-03-26
當你的 AI 助手突然聾了——能發(fā)消息卻收不到回復，問題可能藏在一個你根本不會去看的 .ts 文件里,下面小編就和大家詳細介紹一下OpenClaw飛書插件加載失敗的問題排查與解決2026-03-25
OpenClaw多渠道接入WhatsApp、Telegram、飛書的實戰(zhàn)指南
OpenClaw的Channels多渠道接入系統(tǒng)是其六層架構(gòu)的第一層，負責連接外部消息平臺與AI Agent系統(tǒng),本文深入剖析Channels的核心概念、架構(gòu)設(shè)計、與Gateway的交互機制，詳細介紹2026-03-23
最近在使用 OpenClaw 進行飛書機器人配對時，執(zhí)行命令時遇到了錯誤，同時啟動日志中反復出現(xiàn)警告這個問題的根本原因是 OpenClaw 環(huán)境中存在兩個 ID 相同的飛書插件，本文借2026-03-19
OpenClaw解決飛書 duplicate plugin id detected 問題
文章介紹了OpenClaw在啟動過程中檢測到重復的feishu插件ID并導致沖突的問題,通過查找和刪除全局插件文件并調(diào)整配置文件,成功解決了這個問題，感興趣的朋友跟隨小編一起看看2026-03-17
在Ubuntu上快速部署OpenClaw并接入飛書的完整過程
OpenClaw是一個可擴展的 AI 助手運行框架，核心目標是讓助手真正“能做事”,這篇文章主要介紹了在Ubuntu上快速部署OpenClaw并接入飛書的完整過程,文中通過圖文介紹的非常詳2026-03-13
本文詳細介紹如何將OpenClaw AI 智能體網(wǎng)關(guān)與飛書（Feishu）集成，實現(xiàn)企業(yè)內(nèi)部的 AI 助手功能,涵蓋飛書應用創(chuàng)建、權(quán)限配置、OpenClaw 連接和高級功能設(shè)置,本文給大家介紹2026-03-17
2026年OpenClaw(前身為Moltbot)憑借輕量化部署、強大的AI任務執(zhí)行能力與靈活的生態(tài)集成特性,成為企業(yè)智能化辦公的核心工具，這篇文章主要介紹了OpenClaw連接飛書插件安裝、2026-03-10
