@cakagus/codeclaw

中文文档
1.7.2发布于 2026/11/08ES Module近 30 天下载 4335
中文使用文档
文档目录9 节
  1. 为什么是CodeClaw?
  2. 系统架构
  3. QQ 命令
  4. QQ 快速启动
  5. 1. 通过国家预防机制安装
  6. 2. 配置环境
  7. 3. 与 PM2 运行
  8. QQ 技术堆栈
  9. QQ 安全警告

法典 Pro

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

npm version License: MIT Node.js

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


为什么是CodeClaw?

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

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

系统架构

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. 通过国家预防机制安装

npm install -g @cakagus/codeclaw

2. 配置环境

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

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

3. 与 PM2 运行

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 共发布 20 个版本,首次发布于 2026/10/31;过去 12 个月发布了 20 个版本。

版本发布日期距今
1.7.2latest2026/11/081 天前
1.7.12026/11/035 天前
1.7.02026/11/035 天前
1.6.02026/11/036 天前
1.5.42026/11/026 天前
1.5.32026/11/026 天前

关于 @cakagus/codeclaw 的常见问题

如何安装 @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 和提交记录判断。