Code Cog — 专为智能体打造的首个编程代理

当你的 AI 需要编写代码时，它会将任务委托给 CodeCog。通过 CellCog Co-work 在用户本地机器上直接访问代码库、执行终端操作和编辑文件。

使用方法

在会话中首次使用 CellCog 任务时，请阅读 cellcog 技能以获取完整的 SDK 参考文档——包括文件处理、聊天模式、超时设置等。

OpenClaw（即发即忘）：

result = client.create_chat(
    prompt="[你的任务提示]",
    notify_session_key="agent:main:main",
    task_label="my-task",
    chat_mode="agent core",
    enable_cowork=True,
    cowork_working_directory="/path/to/project",
)

除 OpenClaw 外的所有代理（阻塞等待完成）：

from cellcog import CellCogClient
client = CellCogClient(agent_provider="openclaw|cursor|claude-code|codex|...")
result = client.create_chat(
    prompt="[你的任务提示]",
    task_label="my-task",
    chat_mode="agent core",
    enable_cowork=True,
    cowork_working_directory="/path/to/project",
)
print(result["message"])

前置条件

此技能需要 cellcog 技能来完成 SDK 设置和 API 调用。

clawhub install cellcog

请先阅读 cellcog 技能 以完成 SDK 配置。本技能展示如何将 CellCog 作为编程代理使用。

必须安装 CellCog Desktop： 用户需安装并运行 CellCog Desktop 才能启用 Co-work（直接机器访问）。下载地址：https://cellcog.ai

快速入门

OpenClaw 代理（即发即忘）：

from cellcog import CellCogClient
client = CellCogClient(agent_provider="openclaw")

result = client.create_chat(
    prompt="重构认证模块，改用 JWT 令牌",
    notify_session_key="agent:main:main",  # 仅 OpenClaw 使用
    chat_mode="agent core",
    enable_cowork=True,
    cowork_working_directory="/Users/me/projects/myapp",
    task_label="auth-refactor",
)

其他所有代理（阻塞等待完成）：

from cellcog import CellCogClient
client = CellCogClient(agent_provider="openclaw")

result = client.create_chat(
    prompt="重构认证模块，改用 JWT 令牌",
    chat_mode="agent core",
    enable_cowork=True,
    cowork_working_directory="/Users/me/projects/myapp",
    task_label="auth-refactor",
)

关键参数说明：

• chat_mode="agent core" — 轻量级编程代理（与 "agent" 对应全多媒体模式）
• enable_cowork=True — 启用 Co-work（直接机器访问）
• cowork_working_directory — 项目/目录路径，用于工作环境

CodeCog 能做什么

代码生成与编辑

• 创建新文件、模块和组件
• 精准编辑现有代码
• 重构代码库——重命名、结构调整、提取逻辑
• 在不同语言或框架间迁移代码

调试与修复

• 读取错误日志和堆栈跟踪
• 在多个文件中定位根本原因
• 应用修复并验证是否有效
• 运行测试以确认修复成功

终端操作

• 执行构建命令、测试、代码检查工具
• 安装依赖项（npm、pip、cargo 等）
• Git 操作（状态查看、差异对比、提交）
• Docker 和部署脚本执行

代码库探索

• 自动读取 AGENTS.md/CLAUDE.md 了解项目规范
• 开始工作前自动分析目录结构
• 理解现有编码风格并遵循
• 读取相关文件以保持一致性

CodeCog 的独特之处

专为智能体设计，而非人类开发者

目前市面上大多数编程工具（如 Cursor、Claude Code、Codex、Windsurf）都是为坐在屏幕前的人类开发者设计的。而 CodeCog 是为需要程序化编码的 AI 智能体打造的——发送请求，接收结果，继续编排流程。

起步轻量，可扩展至多模态

CodeCog 使用 CellCog 的 Agent Core 模式——一种专注于编程的轻量级上下文。但若任务意外需要图像、PDF、视频等能力，代理可按需加载相应工具。这是其他编程代理不具备的能力。

示例：你的智能体要求 CodeCog 创建一个新项目。CodeCog 写完代码后，发现需要为 README 生成一张 Logo——它自动加载图像生成工具，生成图片后继续执行。整个过程无缝衔接。

直接机器访问

通过 CellCog Co-work，CodeCog 可直接在用户文件系统上操作：

• 读写真实机器上的文件
• 在用户的终端环境中运行命令
• 尊重项目规范（如 AGENTS.md、.gitignore 等）
• 用户需批准所有写入和执行操作以确保安全

聊天模式

**始终使用 "agent core" 作为 CodeCog 的默认模式。** 这是专为编程优化的轻量级模式。

示例提示词

新功能开发

result = client.create_chat(
    prompt="添加用户资料更新的 REST API 接口，包含校验逻辑和测试用例",
    chat_mode="agent core",
    enable_cowork=True,
    cowork_working_directory="/Users/me/projects/myapp",
    task_label="add-profile-api",
)

从错误日志修复 Bug

result = client.create_chat(
    prompt="""修复生产环境中的这个错误：
TypeError: Cannot read properties of undefined (reading 'map')
at UserList.render (src/components/UserList.tsx:42)

组件在 API 返回空响应时崩溃。""",
    chat_mode="agent core",
    enable_cowork=True,
    cowork_working_directory="/Users/me/projects/myapp",
    task_label="fix-userlist-crash",
)

代码库重构

result = client.create_chat(
    prompt="将认证模块从基于会话的模式重构为 JWT 令牌。更新所有中间件、测试用例和 API 路由。",
    chat_mode="agent core",
    enable_cowork=True,
    cowork_working_directory="/Users/me/projects/myapp",
    task_label="auth-refactor",
)

测试用例生成

result = client.create_chat(
    prompt="为 src/services/billing.py 生成全面的单元测试。覆盖预扣费、货币转换和支付失败等边界情况。",
    chat_mode="agent core",
    enable_cowork=True,
    cowork_working_directory="/Users/me/projects/myapp",
    task_label="billing-tests",
)

详见 https://cellcog.ai 获取完整的 SDK API 参考文档 —— 包括交付模式、send_message()、超时设置、文件处理等功能。

协作环境配置

必备条件

1. CellCog Desktop 必须已安装并正在运行于用户本地机器
2. 必须指定工作目录 —— 这是项目或仓库的根目录
3. 用户必须使用相同账号登录 CellCog Desktop

协作功能支持

• HumanComputer_Terminal —— 在用户机器上执行 shell 命令
• HumanComputer_Terminal_File_View —— 读取用户机器上的文件
• HumanComputer_Terminal_File_Write —— 向用户机器写入文件
• HumanComputer_Terminal_File_Edit —— 编辑用户机器上的文件

安全机制

• 读取操作 自动批准（无需中断）
• 写入/执行操作 需要在 CellCog Web UI 中获得用户确认
• 用户可在工作目录内配置自动批准读写操作
• 敏感路径（如凭证、SSH 密钥）始终被阻止访问

提升结果质量的建议

1. 明确指定工作目录 —— 始终将 cowork_working_directory 设置为项目根目录
2. 引用具体文件 —— “修复 src/auth/login.ts 中的 bug” 比 “修复登录相关问题” 更有效
3. 说明编码规范 —— “遵循现有测试模式” 有助于保持代码风格一致
4. 提供错误上下文 —— 堆栈跟踪、日志输出和复现步骤有助于快速定位问题
5. 使用 AGENTS.md —— 在仓库根目录放置 AGENTS.md 文件，包含构建命令、样式指南和项目结构说明。CodeCog 会自动读取该文件

当前限制

• 仅支持 macOS 和 Linux —— CellCog Desktop（协作功能）目前尚未支持 Windows
• 需安装 CellCog Desktop —— 若不启用协作功能，CodeCog 仍可在其 Docker 工作环境中编写代码，但无法直接访问用户机器
• 写入操作需用户确认 —— 写入操作会暂停等待用户批准（可配置为自动批准）