飞书机器人接入 Claude（基于 CowAgent）

在本地 Windows 电脑上部署，通过飞书聊天直接使用 Claude。支持开机自启，无需公网 IP。

---

架构

飞书 App                本地 Windows                    API
   │                       │                             │
   │  WebSocket 长连接      │                             │
   ├─────────────────────► │  CowAgent (Python)           │
   │                       │  ├── feishu_channel          │
   │                       │  └── claude_bridge ────────► │ DeepSeek
   │                       │                   Claude API │ /anthropic
   │  ◄─────────────────── │                             │
   │        Claude 回复     │                             │

• CowAgent：开源项目 zhayujie/CowAgent，负责桥接飞书和 Claude
• 飞书通道：WebSocket 模式，本地开发友好，无需公网 IP
• Claude API：通过 DeepSeek 的 Anthropic 兼容端点调用

---

部署步骤

1. 环境准备

• Python 3.11+（建议用 python.org 安装的版本，不要用 MSYS2 自带的）
• pip 可用
• 飞书 App 已安装（用于扫码绑定）

2. 克隆项目

cd S:\project
git clone https://github.com/zhayujie/CowAgent.git chatgpt-on-wechat
cd chatgpt-on-wechat

3. 安装依赖

pip install -r requirements.txt
pip install web.py croniter lark-oapi

如果系统有多个 Python，确保用对 pip，例如 python -m pip install ...

4. 配置 config.json

在项目根目录创建 config.json：

{
  "channel_type": "feishu",
  "model": "claude-sonnet-4-6",
  "claude_api_key": "sk-xxxxxxxxxxxx",
  "claude_api_base": "https://api.deepseek.com/anthropic",
  "single_chat_prefix": [""],
  "single_chat_reply_prefix": "",
  "conversation_max_tokens": 3000,
  "expires_in_seconds": 3600,
  "character_desc": "你是基于Claude的AI助手，通过飞书提供服务。",
  "use_linkai": false,
  "feishu_event_mode": "websocket",
  "feishu_stream_reply": true,
  "debug": false
}

5. 扫码绑定飞书

python app.py

终端会打印一个二维码，用飞书 App 扫码。扫码后自动创建飞书机器人，feishu_app_id 和 feishu_app_secret 会自动写入 config.json。

二维码 10 分钟有效，过期后重新运行 python app.py 即可生成新的。

6. 设置开机自启

创建 start_cow_feishu.vbs，放入 Startup 文件夹（Win + R → shell:startup）：

' 无窗口启动 CowAgent 飞书机器人
Set WshShell = CreateObject("WScript.Shell")
WshShell.CurrentDirectory = "S:\project\chatgpt-on-wechat"
WshShell.Run "C:\Users\yangj\AppData\Local\Programs\Python\Python311\python.exe app.py", 0, False

重启后飞书机器人自动运行，无弹窗。

---

使用

在飞书里搜索机器人名称，直接发消息即可。Claude 会通过 DeepSeek API 回复。

测试

你：1 + 1 等于几？
机器人：2
你：我的腾讯服务器 IP 是什么？
机器人：111.229.236.20（如果配置了 knowledge 记忆）

---

扩展：接入知识库

飞书机器人支持读取本地知识库。将 Markdown 文件放入 C:\Users\yangj\cow\knowledge\ 目录即可。

# 同步 Claude Code 的永久记忆
cp C:/Users/yangj/.claude/projects/S--project/memory/*.md ~/cow/knowledge/

重启机器人后生效。

---

常见问题

问题	解决
No module named 'web'	pip install web.py
No module named 'lark_oapi'	pip install lark-oapi
端口 9899 被占用	杀掉旧 Python 进程重启
二维码过期	重新运行 python app.py
机器人不回复	检查 claude_api_key 是否有效

---

与 Claude Code 的区别

	Claude Code	飞书机器人
交互方式	终端命令行	飞书 App
底层 API	DeepSeek Claude API	DeepSeek Claude API
代码能力	读写文件、执行命令	仅聊天
适用场景	编程开发	日常问答、移动端使用
依赖	Claude Code 进程	Python + CowAgent