在飞书群里让 AI 自动写代码：OpenClaw ACP + Feishu 踩坑实录

在飞书群发一条消息，十分钟后 GitHub 上出现了一个可以玩的游戏。中间没有人动一行代码。

这篇文章记录了我如何把 OpenClaw ACP 和 Feishu 打通，让 AI Agent 在群聊里收到需求后，自动调起 Copilot CLI 去写代码，建仓库、推 GitHub——以及这条路上踩过的每一个坑。

一、目标：群里喊一声，代码自己写好

最终实现效果：

1. 我在飞书编程群发消息：做一个贪吃蛇游戏
2. Phoenix（群里的 AI 技术负责人）收到消息，分析需求
3. Phoenix 调用 sessions_spawn 把任务委托给 Copilot CLI
4. Copilot CLI 在本地工作区写好代码，初始化 git，推到 GitHub
5. Phoenix 把仓库 URL 发回群里

整个过程无需人工干预，Phoenix 是协调者，Copilot CLI 是执行者。

二、环境说明

组件	作用
OpenClaw	AI Agent 网关，管理 agent 会话、路由消息、调用 LLM
acpx 插件	OpenClaw 插件，本地运行 Copilot CLI，桥接 ACP 协议
Feishu channel	OpenClaw 的消息通道，通过 WebSocket 长连接接收飞书消息
Phoenix (coding agent)	LLM mode 的 agent，绑定在编程群，负责分析需求并委托 Copilot CLI
Copilot CLI	实际写代码的执行者，由 acpx 在本地进程中运行

关键 openclaw.json 配置骨架：

{
  "acp": {
    "enabled": true,
    "backend": "acpx"
  },
  "plugins": {
    "entries": {
      "acpx": {
        "enabled": true,
        "config": {
          "permissionMode": "approve-all"
        }
      }
    }
  },
  "agents": {
    "list": [
      {
        "id": "coding",
        "model": "copilot",
        "tools": { "profile": "full" }
      }
    ]
  },
  "bindings": [
    {
      "agentId": "coding",
      "match": {
        "channel": "feishu",
        "peer": {
          "kind": "group",
          "id": "oc_你的群ID"
        }
      }
    }
  ]
}

注意 coding agent 没有 runtime 字段，这意味着它运行在 LLM mode——Phoenix 用 LLM 接收消息、做决策，再通过 sessions_spawn 工具把任务派发给 Copilot CLI。

三、基础配置：把群聊消息路由到 agent

1. 获取飞书群 ID

群 ID 格式为 oc_xxx。在网关运行后 @mention 机器人，然后：

openclaw logs --follow | grep chat_id

2. 配置 binding

在 openclaw.json 的 bindings 数组里加入上面的配置，peer.id 填入群 ID。

注意：bindings 和 agents.list 是热重载的，修改后无需重启网关。但 plugins.entries 和顶层 acp 字段需要完整重启：

openclaw daemon restart

3. 配置 SOUL.md（关键！）

Phoenix 的行为完全由 SOUL.md 定义。要让 Phoenix 在群里收到编程任务时调用 Copilot CLI，需要在 SOUL.md 里明确写死规则：

## Hybrid ACP Workflow

你可以通过 sessions_spawn 把编程任务委托给 Copilot CLI：

1. **Plan first** — 分析需求，确定技术方案
2. **Spawn ACP** — 使用 `sessions_spawn({ runtime: "acpx", agentId: "copilot", cwd: "~/workspace-phoenix" })` 启动 Copilot 会话
3. **Monitor** — 通过 session 工具跟踪进度
4. **Report** — 把结果和仓库 URL 发回飞书群

**Rule: 在飞书群里，任何写代码的任务都必须通过 Copilot CLI 完成，禁止直接在聊天里输出代码。**

四、坑一：/acp 斜杠命令在普通群里静默失败

现象

在飞书群里发送 /acp 做一个贪吃蛇游戏，机器人没有任何响应。

查看网关日志：

dispatch complete (queuedFinal=false, replies=0)

整条消息在 200ms 内被处理完，replies=0，说明网关连 LLM 都没有调用，直接丢弃了这条消息。

诊断

日志时序是关键诊断信号：

现象	含义
replies=0，耗时 < 200ms	斜杠命令被网关拦截，未传递给 LLM
replies=1，耗时 15–90s	LLM 正常处理
replies=1，耗时 2–5min	LLM 做了繁重工作（如 ACP spawn + 等待）

根因

官方文档明确说明（docs.openclaw.ai/channels/feishu#acp-sessions）：

v1 does not target generic non-topic group chats.

/acp 系列斜杠命令在 v1 版本中只支持：

• 私聊（DM）
• 飞书话题帖（topic thread）

普通群聊里的 /acp 消息会被网关直接吞掉，永远不会到达 LLM。

解法

放弃 /acp 斜杠命令，改用普通消息触发 LLM，由 LLM 自己决定调用 sessions_spawn。

五、坑二：runtime: “acp” + thread: true 报错

现象

改用普通消息后，Phoenix（LLM）能正常收到消息了。在 SOUL.md 里加上 ACP 委托规则后，Phoenix 确实尝试调用了 sessions_spawn，但返回了报错：

{
  "status": "error",
  "error": "Could not resolve a feishu conversation for ACP thread spawn."
}

根因

Phoenix 调用 sessions_spawn 时，默认使用了 runtime: "acp" 加 thread: true：

{
  "task": "...",
  "runtime": "acp",
  "agentId": "copilot",
  "thread": true
}

runtime: "acp" + thread: true 的组合会让网关尝试在当前飞书会话里创建一个话题帖（topic thread），然后把 ACP 会话绑定到这个帖子。问题是：

• 飞书 ACP 的 thread 模式需要 topic 类型的会话
• 普通群聊不支持通过这个路径创建话题

结果：”Could not resolve a feishu conversation”

解法

使用 runtime: "acpx" 替代 runtime: "acp"，并且不传 thread: true。

acpx 是本地进程模式：Copilot CLI 在本地运行，结果通过工具调用返回给 Phoenix，完全不需要飞书的话题帖功能。

在 SOUL.md 里明确写死：

使用 `sessions_spawn({ runtime: "acpx", agentId: "copilot", cwd: "~/workspace-phoenix" })` 启动 Copilot 会话。

**禁止使用 `runtime: "acp"` 或 `thread: true`——普通飞书群不支持话题帖式的 ACP 线程绑定。**

六、正确配置总结

最终跑通的完整配置：

openclaw.json（关键部分）

{
  "acp": {
    "enabled": true,
    "backend": "acpx"
  },
  "plugins": {
    "entries": {
      "acpx": {
        "enabled": true,
        "config": {
          "permissionMode": "approve-all"
        }
      }
    }
  },
  "agents": {
    "list": [
      {
        "id": "coding",
        "model": "copilot",
        "tools": { "profile": "full" }
      }
    ]
  },
  "bindings": [
    {
      "agentId": "coding",
      "match": {
        "channel": "feishu",
        "peer": {
          "kind": "group",
          "id": "oc_你的群ID"
        }
      }
    }
  ]
}

SOUL.md 中 ACP 规则的关键行

sessions_spawn({ runtime: "acpx", agentId: "copilot", cwd: "~/workspace-phoenix" })
# 不能用 runtime: "acp"，不能用 thread: true

两条必须遵守的规则

1. 不要用 /acp 斜杠命令——v1 不支持普通群聊
2. sessions_spawn 用 runtime: "acpx"——不要用 runtime: "acp" 或带 thread: true

七、验证：如何确认是 Copilot CLI 在写代码

跑通之后，我想确认活儿确实是 Copilot CLI 干的，而不是 Phoenix 偷偷直接把代码输出到群里了。以下是完整的证据链：

① sessions_spawn 调用记录

在 Phoenix 的 session 文件（~/.openclaw/agents/coding/sessions/<uuid>.jsonl）里，可以找到 toolCall 类型的记录：

{
  "type": "toolCall",
  "name": "sessions_spawn",
  "arguments": {
    "runtime": "acpx",
    "agentId": "copilot",
    "task": "Create a browser-based Tic-Tac-Toe project..."
  }
}

工具返回值：

{
  "status": "accepted",
  "childSessionKey": "agent:copilot:acp:52b8f9ad-...",
  "runId": "47c8404e-...",
  "mode": "run"
}

② acpx 后端日志

gateway.err.log 里可以看到 acpx 在初始化 Copilot CLI 会话：

[plugins] acpx ensureSession repairing dead named session by resuming backend session: session=agent:copilot:acp:52b8f9ad-... cwd=/Users/phoobobo/workspace-phoenix

③ agent.wait 响应

gateway.log 里可以看到 OpenClaw 等待 Copilot CLI 完成的 WebSocket 调用：

⇄ res ✓ agent.wait 112062ms

等了整整 112 秒——这是 Copilot CLI 真正在写代码和推 git 的时间。

④ 独立的 Copilot CLI session 文件

~/.openclaw/agents/copilot/sessions/ 下出现了新的 session 文件，内容是 Copilot CLI 收到任务、逐个创建文件、初始化 git 仓库的完整过程。

⑤ 文件时间戳与 git commit

$ ls -la ~/workspace-phoenix/tic-tac-toe/
# 所有文件时间戳：4月 6 23:47（正好在 session 窗口内）

$ git -C ~/workspace-phoenix/tic-tac-toe log --oneline
7ccd90e (HEAD -> main, tag: v0.1.0, origin/main) Initial commit: add tic-tac-toe game
# commit 时间：2026-04-06 23:47:57 +0800

⑥ GitHub 仓库

https://github.com/Phoobobo/tic-tac-toe — 公开仓库，包含 index.html、style.css、app.js，打开即可玩。

八、小结

问题	原因	解法
/acp 命令无响应	v1 不支持普通群聊斜杠命令	改用普通消息，让 LLM 决策
sessions_spawn 报 “Could not resolve”	runtime: “acp” 需要飞书话题帖	改用 runtime: “acpx”
Phoenix 直接输出代码而不委托	SOUL.md 里没有明确禁止规则	在 SOUL.md 里写死强制规则

核心教训：把规则写进 SOUL.md 时要足够具体。”可以用 sessions_spawn” 不够，要写成 “必须用 sessions_spawn，用 acpx，禁止用 acp，禁止 thread: true，禁止直接输出代码”。LLM 的默认行为总是走最省力的路——不堵死，它就会抄近道。