Skip to content

cc-connect-feishu-setup-complete.md

Latest commit

 

History

History
173 lines (125 loc) · 3.99 KB

cc-connect-feishu-setup-complete.md

File metadata and controls

173 lines (125 loc) · 3.99 KB
Raw
title cc-connect Feishu bot complete setup guide
domain feishu
tags
feishu
cc-connect
bot
setup
agent
bridge
npm
status published
source bootstrap
created 2026-05-19
updated 2026-07-21
confidence 0.95
verification metadata-normalized

Problem

Agents need a complete, copy-pasteable path to connect coding agents to Feishu (Lark) via cc-connect. Incomplete or placeholder (<bridge-tool>) docs cause failed installs and duplicate lessons.

Root Cause

Generic bridge docs omit the real package name and concrete config paths. Operators then invent parallel "complete setup" notes that drift into near-duplicates.

Solution

Verification

  1. Follow the solution steps in order
  2. Run any relevant commands or tests to confirm the fix
  3. Verify the symptom no longer occurs
  4. Check related logs or outputs for expected behavior

cc-connect 飞书机器人完整配置指南

概述

cc-connect 是一个连接 AI 编码代理（如 Claude Code）与消息平台（如飞书）的桥接工具。本文档记录完整的配置过程和常见问题解决方案。

1. 安装 cc-connect

npm install -g cc-connect

验证安装：

cc-connect --version

2. 创建配置文件

mkdir -p ~/.cc-connect
cp /path/to/cc-connect/config.example.toml ~/.cc-connect/config.toml

3. 配置飞书机器人

3.1 创建飞书应用

  1. 登录 https://open.feishu.cn
  2. 创建企业应用
  3. 启用机器人能力
  4. 添加权限：im:message.receive_v1, im:message:send_as_bot
  5. 事件订阅：选择 WebSocket 长连接模式，添加事件 im.message.receive_v1
  6. 发布应用版本
  7. 复制 App ID 和 App Secret

3.2 编辑配置文件

[[projects]]
name = "cc-connect-feishu"

[projects.agent]
type = "claudecode"

[projects.agent.options]
work_dir = "/path/to/your/project"
mode = "default"

[[projects.platforms]]
type = "feishu"

[projects.platforms.options]
app_id = "cli_xxxxxxxxxxxx"
app_secret = "xxxxxxxxxxxxxxxxxxxxxxxx"

4. 显示优化配置

禁用工具调用和上下文提示：

[display]
mode = "quiet"
thinking_messages = false
thinking_max_len = 0
tool_max_len = 0
tool_messages = false
show_context_indicator = false
reply_footer = false

5. 启动 cc-connect

cc-connect

6. 常见问题解决

6.1 配置文件语法错误

问题：Error loading config: parse config: toml: line XXX: expected value but found '"' instead

原因：配置文件中使用了 Unicode 引号（" "），而不是标准 ASCII 引号（"）

解决：

sed -i 's/\xe2\x80\x9c/"/g; s/\xe2\x80\x9d/"/g' ~/.cc-connect/config.toml

6.2 cc-connect 已在运行

问题：Error: another cc-connect instance is already running

解决：

cc-connect stop --force
cc-connect

6.3 飞书机器人无反应

问题：发送消息后机器人无反应

检查项：

  1. 飞书开放平台事件订阅是否配置正确
  2. 是否启用了 im.message.receive_v1 事件
  3. 是否选择了 WebSocket 长连接模式
  4. 应用是否已发布

7. 验证配置

  1. 检查 cc-connect 状态：

    cc-connect status --force

  2. 查看日志：

    cc-connect logs --force

  3. 在飞书中测试：

    • 搜索机器人名称
    • 发送消息测试
    • 确认不显示工具调用和上下文提示

8. 相关文件

  • 配置文件：~/.cc-connect/config.toml
  • 会话数据：~/.cc-connect/sessions/
  • API socket：~/.cc-connect/run/api.sock

9. 参考资料

Related: generic stub/redirect at feishu-bot-setup-complete.md (duplicate cleanup #552).

Notes

  • Prefer this file over archived generic Feishu stubs.
  • Duplicate cleanup decision: issue #552 / feishu-bot-setup-complete.md decision lesson.