# @cakagus/codeclaw 中文文档

规范地址：https://npmcn.com/package/%40cakagus/codeclaw/

版本：1\.7\.2
npm 元数据更新时间：2026-11-07T18:33:45.862Z
中文译文更新时间：2026-11-08T23:41:09.834Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cakagus/codeclaw
原文对照：https://npmcn.com/package/%40cakagus/codeclaw/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：412 kB，60 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.5\.0
- 运行依赖：9 个
- 首次发布：2026-10-30T18:33:05.299Z
- 最新版本发布：2026-11-07T18:33:45.706Z
- 近 30 天下载量：4335（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 20 个）

## 中文简介



## 安装

```sh
npm install @cakagus/codeclaw
```

也可以使用：`pnpm add @cakagus/codeclaw`、`yarn add @cakagus/codeclaw`、`bun add @cakagus/codeclaw`

## README

# 法典 Pro

**用于编码和XAU/USD 贸易的终极自主AI代理 & Telegram Bot**

[![npm version](https://badge.fury.io/js/@cakagus%2Fcodeclaw.svg)](https://www.npmjs.com/package/@cakagus/codeclaw) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Node.js](https://img.shields.io/badge/Node.js-v22%2B-brightgreen)](https://nodejs.org/)

_轻而易举,快而平稳地运行 甚至在1GB RAM VPS上._

* * *

## 为什么是CodeClaw?

CodeClaw不仅仅是另一个聊天人 这是一个 **自动代理** 为现实世界行刑而建,将LLM推理与坚固而无幻觉的Node.js后端结合.

-   🧠 **20-莱尔认知大脑:** 防止AI幻觉的自觉管道.
-   📊 **实时交易分析:** 使用信通技术/SMC、12Data OHLC和EXA新闻进行深入XAU/USD分析.
-   🛠️ **True 工具执行 :** 通过本地 shell 和 Git 整合直接读取、写出和调试您的 VPS 上的代码 .
-   📚 **自学:** 自主地研究了网络,将其保存为可再使用的技能.
-   ⚡ **零LLM( 零LLM) 图标 :** 系统检查(/健康,/课后)是硬码,用于即时,100%的准确反应.

* * *

## 系统架构

```mermaid
graph TD
    User([Telegram User]) -->|Chat / Command| Bot[CodeClaw Gateway]
    
    Bot -->|Action/Coding| ToolLoop[Action Route: 32+ Native Tools]
    Bot -->|System Check| ZeroLLM[Zero-LLM: /health, /lessons]
    Bot -->|Chat/Reasoning| Brain20[20-Layer Cognitive Pipeline]
    
    ToolLoop -->|Read/Write/Shell| VPS[(Local VPS & Git)]
    ToolLoop -->|Fetch| LLM[9router / OpenAI API]
    
    Brain20 -->|Reason| LLM
    Brain20 -->|Verify| Brain20
    
    Bot -->|Trading| Gold[TwelveData + EXA]
    Gold -->|Analysis| LLM
    
    LLM -->|Final Response| User
```

* * *

## QQ 命令

| 类别 | 图标 | 说明 |
| :-- | :-- | :-- |
| **贸易** | `/gold` `/goldplan` | 实时XAU/USD分析和可采取行动的贸易计划. |
| **技能内存( M)** | `/skills` `/skill` `/lessons` `/learn` `/mem` `/todo` | 管理AI内存,列表技能,并触发自主研究. |
| **研究** | `/research_methods` | 深潜进入AI代理,交易,和dev工具. |
| **系统** | `/health` `/status` `/doctor` `/start` `/help` | 即时系统监控和机器人状态. |

* * *

## QQ 快速启动

### 1\. 通过国家预防机制安装

```bash
npm install -g @cakagus/codeclaw
```

### 2\. 配置环境

复制 `config.example.json` 改为 `config.json` 并填写您的 API 密钥 :

-   电报箱托肯
-   9router (或 OpenAI- 兼容) API 密钥
-   十二数据 API 密钥( 用于交易)
-   EXA API 密钥( 用于网络搜索)

### 3\. 与 PM2 运行

```bash
pm2 start bin/codeclaw.js --name codeclaw-tg --node-args="--max-old-space-size=512"
pm2 save
```

* * *

## QQ 技术堆栈

-   **运行时间 :** 节点.js (v22+)
-   **数据库 :** SQLite (会话和内存) + Markdown (技能)
-   **LLM 引擎 :** OpenAI-相容性 (9router, 双子座, Groq等)
-   **数据提供者 :** 十二数据(OHLC),EXA(搜索API)

* * *

## QQ 安全警告

**永远不要承诺 `config.json` 给 GitHub .** 它包含您的私人 API 密钥 。 保证 `config.json` 列在您的 `.gitignore`。 。 。 .

* * *

和自主的人工智能和交易一起制造的.

## 常见问题

### 如何安装 @cakagus/codeclaw？

在项目目录运行 npm install @cakagus/codeclaw，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 codeclaw，可以用 npx codeclaw 直接运行。

### @cakagus/codeclaw 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cakagus\_\_codeclaw 是否存在。

### @cakagus/codeclaw 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @cakagus/codeclaw 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.5\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cakagus/codeclaw 可以商用吗？

@cakagus/codeclaw 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @cakagus/codeclaw 的下载量有多少？

根据 npm 官方下载统计，@cakagus/codeclaw 在 2026/10/09 – 2026/11/07 这 30 天内被下载 4,335 次，日均约 145 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cakagus/codeclaw 还在维护吗？

最新版本 1\.7\.2 发布于 2026/11/08（1 天前）；至今共发布 20 个版本，其中过去 12 个月发布了 20 个；首次发布于 2026/10/31。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。