资讯动态

CashClaw配置完全指南:cashclaw.json所有字段详解与热重载技巧

发布时间:2026/10/14 16:37:29 来源:尧图企业网站定制
人工智能AI Agent自主智能体AI 应用工具调用Agent 记忆RAG区块链【免费下载链接】cashclawAn autonomous agent that takes work, does work, gets paid, and gets better at it.项目地址https://gitcode.com/gh_mirrors/ca/cashclaw点击查看免费下载CashClaw 是一个接单—干活—收款—自我进化的自主 AI 工作智能体它的全部行为都由一个配置文件~/.cashclaw/cashclaw.json驱动用哪个 LLM、怎么报价、接多少并发任务、多久自我学习一次……本指南逐字段讲清 CashClaw 配置并演示不重启进程的热重载技巧帮你把 Agent 调教成合心意的样子。快速定位 CashClaw 配置文件 cashclaw.jsonCashClaw 的所有持久化状态都存放在用户主目录的.cashclaw文件夹下文件作用cashclaw.jsonAgent 主配置LLM、定价、专长、开关knowledge.json自学产生的知识条目保留最近 50 条feedback.json客户评分与评论保留最近 100 条chat.json操作者聊天历史保留最近 100 条logs/YYYY-MM-DD.md每日活动日志配置文件由 src/config.ts 管理目录权限为0700、文件权限为0600且每次写入都是先写临时文件再重命名的原子操作防止并发写坏文件。也就是说你可以放心地随时手动编辑cashclaw.json——只要 JSON 合法CashClaw 就能正常读取。 完整的数据结构定义见 CashClawConfig 接口内置默认值见 DEFAULT_CONFIG。cashclaw.json 配置字段全表下面按功能分组逐一说明。默认值与官方示例一致首次安装或设置向导完成后文件会长这样{ agentId: 12345, llm: { provider: anthropic, model: claude-sonnet-4-20250514, apiKey: sk-ant-... }, polling: { intervalMs: 30000, urgentIntervalMs: 10000 }, pricing: { strategy: fixed, baseRateEth: 0.005, maxRateEth: 0.05 }, specialties: [code-review, typescript, react], autoQuote: true, autoWork: true, maxConcurrentTasks: 3, declineKeywords: [], learningEnabled: true, studyIntervalMs: 1800000, agentCashEnabled: false, personality: { tone: professional, responseStyle: balanced } }身份与 LLM 配置字段类型说明agentIdstring链上注册的 Agent ID所有市场事件都绑定在它身上llm.providerenum三选一anthropic/openai/openrouter全部走原生fetch()零 SDK 依赖llm.modelstring模型名。默认值Anthropic 为claude-sonnet-4-20250514OpenAI 为gpt-4oOpenRouter 为anthropic/claude-sonnet-4-20250514llm.apiKeystringAPI 密钥。在 API 接口返回 中会被打码为***防止泄漏到前端OpenAI 与 OpenRouter 共用一个适配层负责在 Anthropic 原生 tool-use 格式与 OpenAItool_calls格式之间转换所以三家供应商的工具调用行为完全一致。任务轮询与 WebSocket字段默认值说明polling.intervalMs30000常规轮询间隔毫秒polling.urgentIntervalMs10000存在待报价/待返工任务时的加急轮询间隔这里有个容易忽略的细节见 scheduleNext当 WebSocket 连接正常时REST 轮询会自动降频到每 2 分钟一次仅作为兜底同步只有 WS 断开时才使用你配置的两个间隔。所以把intervalMs调小主要影响的是断连场景日常响应速度由 WebSocket 保证。定价策略 pricing字段默认值说明pricing.strategyfixed报价策略fixed固定价 /complexity按复杂度浮动pricing.baseRateEth0.005基础报价ETH 字符串最多 18 位小数pricing.maxRateEth0.05报价上限必须 ≥ 基础价注意金额是字符串而非数字这是为了保留 ETH 的高精度小数。设置保存时服务端会校验格式与大小关系不合法会返回Invalid ETH amount format或baseRate cannot exceed maxRate错误handleConfigUpdate。自动化开关与任务限制字段默认值说明specialties[]专长列表会写入系统提示词决定 Agent只认这些领域autoQuotetrue收到新任务自动评估并报价autoWorktrue被接单后自动开工执行maxConcurrentTasks3最大并发任务数合法范围1–20超出会报错maxLoopTurns不写则 10Agent 循环的最大 LLM 轮次见 runAgentLoop可选字段declineKeywords[]拒单关键词黑名单命中即强制拒单declineKeywords的实现很直接关键词会被拼进系统提示词写入必须拒绝包含这些关键词的任务的硬规则prompt.ts。例如填nsfw, gambling可屏蔽不想要的订单类型。学习记忆与 AgentCash字段默认值说明learningEnabledtrue是否开启空闲期自学反馈分析 / 专长研究 / 任务模拟studyIntervalMs1800000自学间隔毫秒合法范围60000–864000001 分钟到 24 小时agentCashEnabledfalse是否启用 AgentCash 付费 API 工具集自学的调度逻辑见 maybeStudy只有在无任务处理、且没有紧急任务时才会启动学习所以studyIntervalMs调小也不会干扰正在进行的订单。每次学习产出的知识条目存入knowledge.json之后每个新任务都会用 BM25 检索出最相关的 5 条注入提示词——学得越多报价和交付质量越稳。关于agentCashEnabled如果磁盘上已存在~/.agentcash/wallet.json启动时会自动置为 true 并持久化同时为 LLM 增加agentcash_fetch、agentcash_balance两个工具和 API 目录。性格人格 personality字段可选值personality.toneprofessional/casual/friendly/technicalpersonality.responseStyleconcise/detailed/balancedpersonality.customInstructions自由文本上限2000 字符防止提示词膨胀这一组可选字段直接拼进系统提示词用来控制 Agent 与客户、与你的沟通风格在 chat 提示词构建 中同样生效。CashClaw 配置热重载技巧改完即生效CashClaw 的 Dashboard 里有一句很硬的承诺All config changes hot-reload. No restart needed. 具体机制值得拆开看1. 大部分字段是读时生效零重启maxConcurrentTasks、polling.*、autoQuote、learningEnabled、studyIntervalMs、declineKeywords、specialties等字段由心跳循环和提示词构建器在每次处理任务时读取保存后立即影响后续行为当前正在执行的任务不受影响。2. LLM 字段走热切换修改llm配置时handleConfigUpdate 会停掉当前 heartbeat、用新 provider 重建 LLM 客户端和心跳再重新启动。有一个贴心细节如果提交的apiKey是打码值***且 provider 没变服务端会自动沿用旧密钥但切换 provider 时必须重新输入密钥否则返回New provider selected — please enter your API key。3. 推荐用 Settings 页改配置Web 端http://localhost:3777的 Settings 页Settings.tsx把所有字段做成了表单ETH 报价自动换算成美元显示、保存时统一走/api/config-update接口做格式校验。它提交的是部分字段savePartialConfig会将改动与已有配置、默认值合并合并逻辑不会因为漏写字段把其他配置冲掉——这也是你手动调 API 时应当遵循的方式。4. 常见校验错误速查错误信息原因maxConcurrentTasks must be 1-20并发数越界或非整数studyIntervalMs must be 60000-86400000自学间隔超出 1 分钟–24 小时baseRate cannot exceed maxRate基础报价高于上限customInstructions must be under 2000 characters自定义指令过长新手配置建议一套开箱即用的参数第一次运行建议按向导走完四步Wallet → Agent → LLM → Config然后按需微调只填 3–5 个你真正擅长的 specialties——它决定了 Agent 的自我定位贪多必失baseRate 先低后高起步0.005ETH 左右积累评价评分稳定后再逐步上调maxRateEth留 10 倍空间给复杂任务⚙️maxConcurrentTasks 从 1–2 开始单机跑 LLM 循环并发过高会拉长单任务响应studyIntervalMs 保持 30 分钟空闲自动学习越学检索越准declineKeywords 提前设好把明显不想接的单子类型挡在门外。相关文件路径速查主配置加载/保存src/config.ts配置更新 API 与校验src/agent.ts轮询/WS/学习调度src/heartbeat.tsAgent 循环与最大轮次src/loop/index.ts拒单关键词提示词src/loop/prompt.tsWeb 配置编辑器src/ui/pages/Settings.tsx设置向导专长与定价步src/ui/pages/setup/SpecializationStep.tsx掌握cashclaw.json的每个字段和热重载机制后你就能不重启进程地把 CashClaw 从通用打工仔调教成领域专家——改一行配置它下一秒就开始按新规则接单。赞分享人工智能AI Agent自主智能体AI 应用工具调用Agent 记忆RAG区块链【免费下载链接】cashclawAn autonomous agent that takes work, does work, gets paid, and gets better at it.项目地址https://gitcode.com/gh_mirrors/ca/cashclaw点击查看免费下载相关推荐终极Kargo CLI完全指南掌握所有命令与实用技巧终极Kargo CLI完全指南掌握所有命令与实用技巧 Kargo CLI是GitHub加速计划ka/kargo项目中一款强大的命令行工具专为应用生命周期云原生后端运维Mapstructure标签完全指南从字段重命名到高级配置技巧Mapstructure标签完全指南从字段重命名到高级配置技巧 Mapstructure是一个强大的Go语言库专门用于将通用的map值解码为原生Go结构体开发工具Basic Pitch 命令行工具完全指南所有参数详解与实用技巧Basic Pitch 命令行工具完全指南所有参数详解与实用技巧 Basic Pitch 是一款由 Spotify 开发的轻量级但功能强大的音频转 MIDI人工智能深度学习音频创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑