🦞ClawCoder🦞

AI-Powered Coding Assistant - 一个基于 LangGraph 的交互式命令行编程助手，由 Kimi K2.5 驱动。

特性

• 🤖 AI 对话 - 直接与 Kimi K2.5 智能对话
• 📁 文件操作 - 浏览、读取、编辑文件
• ⚡ 代码执行 - 运行 shell 命令
• ✏️ AI 编辑 - 用 AI 辅助修改代码
• 🔍 文件分析 - 分析文本、图片、音视频文件
• 🛠️ 二进制反汇编 - 支持 x86/x64/ARM 架构
• 💾 历史存储 - 对话保存为二进制格式
• 🔑 智能配置 - 首次运行自动引导配置 API Key

安装

pip install clawcoder

快速开始

首次运行

安装后直接运行：

clawcode

首次运行时，如果未配置 API Key，会自动弹出配置向导：

============================================================
  🔑 API Key 配置
============================================================

  欢迎使用 🦞ClawCoder🦞 - AI 编程助手

  首次使用需要配置 Kimi API Key
  您可以从 https://platform.moonshot.cn/ 获取 API Key

------------------------------------------------------------

  请输入您的 API Key: 
  请输入 API Base URL [默认: https://api.kimi.com/coding]: 
  请输入模型名称 [默认: k2p5]: 

  ✅ 配置已保存到: ~/.clawcoder/config.json
============================================================

获取 API Key

1. 访问 Moonshot AI 平台
2. 注册/登录账号
3. 在控制台创建 API Key
4. 将 API Key 输入到配置向导中

使用方式

# 交互式 REPL 模式
clawcode

# 指定工作目录
clawcode /path/to/project

# 快速提问
clawcode --ask "如何实现快速排序"

# 执行单条命令
clawcode -e "/ls"

# 查看版本
clawcode --version

命令列表

基本命令

命令	功能
/help, /h	显示帮助信息
/exit, /quit, /q	退出程序
/clear, /cls	清屏

文件操作

命令	功能
/ls [path]	列出文件
/cd <path>	切换目录
/pwd	显示当前目录
/cat <file>	读取文件内容
/write <file>	写入文件
/edit <file>	AI 辅助编辑文件
/rm <file>	删除文件
/mkdir <dir>	创建目录

代码执行

命令	功能
/run <command>	运行命令 (如: /run python script.py)
/shell, /sh	进入 shell 模式
/disasm <file>	反汇编二进制文件

AI 功能

命令	功能
/analyze <file>	分析文件
/new	开始新对话
/history	查看对话历史
/save <file>	保存对话历史
/load <file>	加载对话历史

系统配置

命令	功能
/info	显示系统信息
/model	显示当前模型
/config	重新配置 API Key
/config show	显示当前配置

支持的文件类型

类型	扩展名
文本	.md, .txt, .json, .jsonl
图片	.jpg, .jpeg, .png, .bmp
音频	.mp3, .wav
视频	.mp4, .flv
二进制	.bin

配置方式

方式一：交互式配置（推荐）

首次运行时自动引导配置，配置保存在 ~/.clawcoder/config.json

方式二：环境变量

# Linux/macOS
export KIMI_API_KEY="your-api-key"
export KIMI_BASE_URL="https://api.kimi.com/coding"  # 可选
export KIMI_MODEL="k2p5"  # 可选

# Windows PowerShell
$env:KIMI_API_KEY="your-api-key"

方式三：代码配置

from clawcoder import create_coder

coder = create_coder(
    api_key="your-api-key",
    base_url="https://api.kimi.com/coding",
    model="k2p5",
    workspace="."
)

# 与 AI 对话
response = coder.chat("如何实现快速排序？")
print(response)

# 分析文件
result = coder.analyze_file("example.py")
print(result)

# 反汇编二进制
disasm = coder.disassemble_binary("program.bin", arch="x64")
print(disasm)

配置优先级

1. 环境变量 KIMI_API_KEY（最高优先级）
2. 配置文件 ~/.clawcoder/config.json
3. 交互式输入（首次使用）

配置文件位置

• Linux/macOS: ~/.clawcoder/config.json
• Windows: C:\Users\<用户名>\.clawcoder\config.json

配置文件格式：

{
  "api_key": "sk-xxxxxxxxxxxxxxxx",
  "base_url": "https://api.kimi.com/coding",
  "model": "k2p5"
}

项目架构

clawcoder/
├── agent/           # LangGraph 核心框架
│   ├── state.py     # 状态定义
│   └── graph.py     # 图构建
├── processors/      # 文件处理器
│   ├── file_handler.py    # 文本文件处理
│   ├── image_handler.py   # 图片处理
│   └── media_handler.py   # 音视频处理
├── skills/          # 技能模块
│   └── disassembler.py    # 二进制反汇编
├── storage/         # 存储模块
│   └── history_storage.py # 对话历史存储
├── clawcoder.py     # 核心类
└── clawcoder_cli.py # CLI 入口

常见问题

Q: 如何更换 API Key？

运行 /config 命令重新配置，或直接编辑 ~/.clawcoder/config.json 文件。

Q: 支持哪些模型？

默认使用 Kimi K2.5 (k2p5)，也可以配置其他兼容 OpenAI API 的模型。

Q: 对话历史保存在哪里？

对话历史以二进制格式保存在工作目录的 ./history/ 文件夹中。

Q: 如何查看当前配置？

运行 /config show 命令查看当前配置（API Key 会被隐藏显示）。

作者

Jason Sang (桑杰逊)

• Email: sangjiexun@gmail.com
• QQ: 1009900122
• WeChat: bitchatgpt
• GitHub: https://github.com/sangjiexun

License

MIT License - 详见 LICENSE 文件