T-Claw

T-Claw 是一个基于 pi-mono 项目构建的智能编码助手 CLI 工具。

特性

• 🤖 集成多个 AI 模型提供商（Anthropic、OpenAI、Google 等）
• 💻 内置代码编辑工具（read、bash、edit、write）
• 📁 会话管理和恢复
• 🎨 可定制的主题和扩展
• 🔧 插件系统支持

安装

使用 npm 全局安装

npm install -g tclaw

使用 pnpm

pnpm add -g tclaw

使用 yarn

yarn global add tclaw

快速开始

基本用法

# 交互模式
tclaw

# 指定初始消息
tclaw "帮我写一个 Hello World 程序"

# 非交互模式（处理后退出）
tclaw -p "列出 src 目录下所有 .ts 文件"

# 继续上一个会话
tclaw --continue

命令行选项

# 显示帮助
tclaw --help

# 显示版本
tclaw --version

# 列出可用模型
tclaw --list-models

# 指定模型
tclaw --provider anthropic --model claude-sonnet-4-20250514 --message "解释这段代码"

# 使用不同的思考级别
tclaw --thinking high "解决这个复杂问题"

# 模型循环切换（Ctrl+P）
tclaw --models claude-sonnet,claude-haiku,gpt-4o

环境变量配置

在使用 T-Claw 之前，你需要设置相应的 API 密钥：

# Anthropic (Claude)
export ANTHROPIC_API_KEY="your-anthropic-api-key"

# OpenAI (GPT)
export OPENAI_API_KEY="your-openai-api-key"

# Google (Gemini)
export GEMINI_API_KEY="your-google-api-key"

配置

T-Claw 的配置文件位于 ~/.tclaw/agent/ 目录下：

| 文件 | 描述 | |------|------| | models.json | 模型配置 | | auth.json | 认证信息 | | settings.json | 用户设置 | | sessions/ | 对话会话存储 |

自定义配置目录

可以通过环境变量指定配置目录：

export TCLAW_CODING_AGENT_DIR="/path/to/config"

可用工具

默认启用的工具：

| 工具 | 描述 | |------|------| | read | 读取文件内容 | | bash | 执行 bash 命令 | | edit | 编辑文件（查找/替换） | | write | 写入文件（创建/覆盖） |

可选工具（需要显式启用）：

| 工具 | 描述 | |------|------| | grep | 搜索文件内容（只读） | | find | 按 glob 模式查找文件（只读） | | ls | 列出目录内容（只读） |

使用示例：

# 只读模式（不允许文件修改）
tclaw --tools read,grep,find,ls -p "审查 src 目录中的代码"

扩展

T-Claw 支持通过安装扩展来添加额外的功能：

# 安装扩展
tclaw install npm:@foo/bar
tclaw install git:github.com/user/repo

# 列出已安装的扩展
tclaw list

# 移除扩展
tclaw remove npm:@foo/bar

开发

本地开发

# 克隆项目
git clone https://github.com/your-username/tclaw.git
cd tclaw

# 安装依赖
npm install

# 开发模式运行
npm run dev

# 构建生产版本
npm run build

构建发布版本

npm run clean
npm run build

发布到 npm

1. 更新 package.json 中的版本号
2. 确保 repository.url 指向你的仓库
3. 登录 npm：

   npm login

4. 发布包：

   npm publish --access public

基于的项目

T-Claw 基于 pi-mono 项目构建，使用了以下核心包：

• @mariozechner/pi-ai - 统一的 LLM API
• @mariozechner/pi-agent-core - Agent 运行时
• @mariozechner/pi-tui - 终端 UI 库

许可证

MIT