OpenClaw 联合 Claude Code 与飞书 Bot 操作完全指南

一、OpenClaw 与 Claude Code 的关系

1.1 各自定位

1.2 协作模式：OpenClaw → Claude Code

通过手机/电脑上的 Telegram 或 飞书，向 OpenClaw 发送指令。

OpenClaw 收到后，可以启动真正的 Claude Code CLI 作为子进程（通过 ACP 协议），让 Claude 在 Mac 上执行大型编程任务，完成后把结果返回到聊天窗口。

二、架构简图

[你] → Telegram / 飞书
          ↓
    [OpenClaw Gateway] ← 本地运行 (127.0.0.1:18789)
          ↓
    ┌─────┴─────┐
    │           │
  飞书操作    ACP 子进程
    │           │
  lark-cli   [Claude Code]
    │           │
  文档/Base   代码/Shell/Git

三、在 Telegram / 飞书中指挥 Claude Code

3.1 绑定当前聊天到 Claude

发送以下命令：

/acp spawn claude --bind here

效果：

• 在当前聊天中创建一个 Claude ACP 会话
• 之后你发的每条消息都会直接传给 Claude Code 处理
• Claude 在 ~/.openclaw/workspace-claude 下工作

3.2 创建持久话题（大型任务推荐）

在支持话题/线程的渠道（如飞书群、Discord）：

/acp spawn claude --mode persistent --thread auto

效果：

• 自动开一个话题/线程
• Claude 的回复和中间过程都在这个线程里
• 不污染主聊天

3.3 只执行一次性任务

/acp spawn claude --mode oneshot

效果：

• 执行一个任务就结束
• 适合"帮我 review 这个 PR"、"生成一份报告"等短任务

3.4 常用 ACP 控制命令

四、通过 Claude 完成飞书操作（双重能力）

4.1 关键原理

当 Claude 被 OpenClaw 通过 ACP 启动后，Claude 并不直接拥有飞书 tools。飞书操作由 OpenClaw 的 main agent 或内置 skills 执行。

但你可以这样配合：

1. 用 OpenClaw 直接发送飞书消息、创建文档
2. 用 ACP 的 Claude 处理代码、生成内容
3. 再把结果交给 OpenClaw 写入飞书

4.2 实战：让 Claude 生成日报，OpenClaw 发到飞书

步骤 1：在 Telegram 里绑定 Claude

/acp spawn claude --bind here

步骤 2：给 Claude 派活

帮我写一份今天的研发进度日报，包含：
- 已完成：修复了登录 bug
- 进行中：重构订单模块
- 阻塞项：等待设计稿

Claude 生成内容后返回给你。

步骤 3：把内容发给 OpenClaw 的 main agent

把下面这份日报发到飞书群 [已脱敏]：
[粘贴 Claude 生成的内容]

OpenClaw（main agent）会调用飞书工具完成发送。

五、Bot 身份详解

5.1 什么是 Bot 身份？

OpenClaw 连接的飞书应用是 Clawdbot（appId: [已脱敏]）。所有通过 OpenClaw 或 lark-cli 执行的飞书操作，默认都以这个 Bot 的租户身份进行。

5.2 Bot 身份的优势

• ✅ 无需人工登录：没有 user 会话过期问题
• ✅ 24小时在线：可以自动跑定时任务
• ✅ 操作权限稳定：已配置好 scopes，可读写文档、Base、IM

5.3 身份验证结果

{
  "appId": "[已脱敏]",
  "brand": "feishu",
  "defaultAs": "bot",
  "identity": "bot"
}

测试命令结果：

lark-cli im +chat-search --query test --as bot --page-size 1
# -> { "ok": true, "identity": "bot" }

六、Bot 身份下可执行的飞书操作类别

6.1 即时通讯（IM）

6.2 云文档（Docs）

6.3 多维表格（Base）

6.4 日历与任务

七、三种典型工作流

工作流 A：纯 OpenClaw（快速操作）

适合：发消息、查日程、改 Base 记录

[你] -> Telegram message
           ↓
      OpenClaw main agent
           ↓
      lark-cli --as bot
           ↓
         飞书 API

工作流 B：纯 ACP Claude（编程任务）

适合：写代码、debug、跑测试

[你] -> /acp spawn claude --bind here
           ↓
      Claude Code CLI
           ↓
      本地代码仓库

工作流 C：Claude + OpenClaw 组合（复杂自动化）

适合：Claude 生成内容 -> OpenClaw 写入飞书

[你] -> /acp spawn claude --bind here
           ↓
      Claude 生成报告 / 分析数据 / 写脚本
           ↓
      [你@OpenClaw] 把结果发到飞书
           ↓
      OpenClaw main agent -> lark-cli bot -> 飞书

八、命令速查表

启动 Claude ACP

/acp spawn claude --bind here
/acp spawn claude --mode persistent --thread auto
/acp spawn claude --mode oneshot

ACP 管理

/acp status
/acp cancel
/acp close
/acp doctor

直接调用 lark-cli（Bot 身份）

lark-cli im +chat-search --query 关键词 --as bot
lark-cli im +messages-send --chat-id [已脱敏] --content "hello"
lark-cli docs +search --query 关键词 --as bot
lark-cli base +list-bases --as bot
lark-cli calendar +agenda --as bot
lark-cli task +get-my-tasks --as bot

九、注意事项

1. Bot 身份不能执行所有 user-only 操作。例如某些通讯录搜索命令仅限 user 身份。
2. WebChat（Control UI）不支持 thread binding，所以 /acp spawn claude --thread auto 在 Web 控制台里会失败。

十、状态确认（2026-04-10）