CC-Claw: Autonomous AI Coding Agent for Claude Code

CC-Claw: 让 Claude Code 24/7 自动编程的 AI Agent

CC-Claw is an autonomous AI working companion that turns Claude Code into a tireless coding partner — continuously executing tasks, breaking down goals, and making progress while you sleep.

English · 中文

核心功能 · 快速开始 · 使用示例 · 架构 · FAQ · 资源

什么是 CC-Claw？

CC-Claw 是一个运行在后台的 AI Agent守护进程，让 Claude Code CLI 拥有了自主工作能力。

传统 AI 编程工具需要你时时刻刻指导它工作。CC-Claw 改变了这一点：

• 你设置目标，它自动分解成可执行任务
• 它 24/7 自动执行，无需人工干预
• 遇到 API 限流自动等待，恢复后继续
• 跨会话记忆上下文，工作进度不丢失

"凡 token 消耗，皆有利于我。"

核心功能

快速开始

前置要求

• Python 3.9+
• Claude Code CLI (安装指南)
• 网络连接（用于调用 Claude API）

安装

# 从 PyPI 安装
pip install cc-claw

# 或从源码安装
git clone https://github.com/onlysyz/cc-claw.git
cd cc-claw
pip install -e .

飞书（Feishu）本地安装最佳实践

飞书集成让你可以在 Lark/Feishu 机器人中直接与 CC-Claw 对话。

1. 环境准备

# 克隆项目
git clone https://github.com/onlysyz/cc-claw.git
cd cc-claw

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
# or: venv\Scripts\activate  # Windows

# 安装依赖
pip install -e .

2. 配置飞书机器人

在 飞书开放平台 创建企业自建应用，获取以下信息：

• App ID: cli_xxxxxxxx
• App Secret: xxxxxxxxxxxxxxxx
• Bot Feature → 开启「机器人」能力

在「事件订阅」中添加以下订阅：

• im.message.receive_v1（接收消息）

在「权限管理」中添加：

• im:message
• im:message.group_at_msg
• im:message.p2p_msg

3. 配置 .env 文件

cp .env.example .env

编辑 .env：

# 服务器配置
HOST=0.0.0.0
API_PORT=4000
WS_PORT=4001

# 飞书配置
LARK_APP_ID=cli_xxxxxxxx
LARK_APP_SECRET=xxxxxxxxxxxxxxxx
LARK_BOT_NAME=CC-Claw

# MiniMax API（用于目标分解，省 Token）
ANTHROPIC_API_KEY=sk-xxxxxxxx
ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic

# Claude Code 配置（在客户端设置）
# CLAUDE_PATH=/usr/local/bin/claude

4. 启动服务器

# 启动 API + WebSocket 服务器
python run_server.py

# 服务器日志显示 "WebSocket server started on 0.0.0.0:4001" 表示成功

5. 启动客户端（配对设备）

# 先配置服务器地址
python3 -m cli config --set server_ws_url=ws://localhost:4001
python3 -m cli config --set server_api_url=http://localhost:4000

# 设置工作目录（Claude Code 在此目录下工作）
python3 -m cli config --set working_dir=/path/to/your/project

# 设置权限模式（跳过授权确认，否则 Claude 会等待交互）
python3 -m cli config --set permission_mode=bypassPermissions

# 然后进行配对
python3 -m cli pair

# 6. 启动守护进程
python3 -m cli start

6. 在飞书中使用

给机器人发送命令：

9. 常见问题排查

# 查看服务器日志
tail -f logs/server.log

# 查看客户端日志
python3 -m cli status

# 重启服务
pkill -f run_server.py && python3 -m server.run &

设置第一个目标

在 飞书/Telegram 中发送：
/goal  实现用户认证系统

CC-Claw 会自动：
1. 询问你的职业和现状
2. 分解目标为具体任务
3. 开始自主执行

使用示例

基本命令

python3 -m cli start        # 启动守护进程
python3 -m cli status       # 查看连接状态
python3 -m cli progress     # 查看目标进度
python3 -m cli pause        # 暂停自主模式
python3 -m cli resume       # 恢复自主模式
python3 -m cli goals        # 查看所有目标
python3 -m cli tasks        # 查看任务队列

机器人命令

代码示例：Python API

from cc_claw import CCClawDaemon, ClientConfig

# 配置
config = ClientConfig(
    device_id="your-device-id",
    device_token="your-device-token",
    claude_path="/usr/local/bin/claude"
)

# 启动守护进程
daemon = CCClawDaemon(config)
daemon.run()

使用持久化记忆

from cc_claw import PersistentMemory, ConversationMemory

# 长期记忆
memory = PersistentMemory()
memory.add_context_snapshot(
    task="实现支付模块",
    context="使用 Stripe API",
    result="完成支付流程"
)

# 获取恢复上下文
resume = memory.get_context_for_resume()

# 短期对话历史
conv = ConversationMemory()
conv.add_user("继续上次的工作")
conv.add_assistant("好的，上次你在实现支付模块...")

架构设计

┌─────────────────────────────────────────────────────────────────┐
│                         Internet                                 │
└─────────────────────────────┬───────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     Cloud Server                                 │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐ │
│  │ Telegram    │  │   API       │  │  WebSocket Server       │ │
│  │ Bot / Lark  │  │   Server   │  │  (persistent connection) │ │
│  └─────────────┘  └─────────────┘  └─────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                              │ WSS
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     Your Device (Local)                         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐ │
│  │ Gateway     │  │ Goal Engine │  │  Claude Code CLI        │ │
│  │ Client      │  │ Task Queue  │  │  (executes tasks)       │ │
│  └─────────────┘  └─────────────┘  └─────────────────────────┘ │
│                                                                  │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐ │
│  │Persistent   │  │Multi-Agent  │  │  Smart Retry           │ │
│  │Memory       │  │Collaboration│  │  (backoff + breaker)   │ │
│  └─────────────┘  └─────────────┘  └─────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘

核心模块

常见问题

Q: CC-Claw 和 GitHub Copilot有什么区别？

Q: Token 用完会怎样？

CC-Claw 有完善的 Token 管理机制：

• 接近限流时自动减速
• 遇到 429 错误自动等待
• Token 刷新后自动恢复

Q: 本地执行安全吗？

是的。所有代码执行都在你的本地机器上完成，CC-Claw 只是调用 Claude Code CLI，不上传你的代码。

Q: 支持哪些平台？

• macOS ✅
• Linux ✅
• Windows (WSL) ✅

Q: 如何贡献代码？

# Fork 后
git clone https://github.com/your-fork/cc-claw.git
cd cc-claw
pip install -e ".[dev]"
pytest tests/

Star 历史

License

MIT License - 详见 LICENSE

如果你觉得 CC-Claw 有用，给个 ⭐ 支持一下！