1. 项目概述一个能自动赚钱的AI代理最近在AI代理的圈子里一个叫Cash-Claw的项目引起了我的注意。简单来说这是一个基于OpenClaw框架构建的“自主创收AI代理”。它的核心卖点很直接你把它部署好它就能自己动起来去探索和实现各种线上赚钱的路径从内容创作到潜在客户开发甚至处理支付收款整个过程力求自动化减少你的手动干预。我花了些时间深入研究它的代码和设计发现它远不止是一个简单的脚本集合。它更像是一个配备了“自动驾驶”系统的数字员工。项目在OpenClaw提供的强大工具调用和会话能力之上增加了一个名为“自主执行循环”的核心引擎。这个引擎会持续地观察环境、制定计划、执行任务并反思结果形成一个完整的闭环。对于开发者、数字创业者或者任何想探索AI自动化商业可能性的人来说这提供了一个极具吸引力的实验平台。2. 核心架构与设计思路拆解要理解Cash-Claw得先拆开看它的两层结构底层是OpenClaw提供的稳固基座上层是Cash-Claw独特的“自动驾驶”系统。2.1 基石OpenClaw的能力框架OpenClaw本身就是一个功能丰富的AI代理操作系统。它为Cash-Claw提供了几个关键基础设施工具库一个庞大的、可扩展的工具集合涵盖了文件操作、浏览器自动化、谷歌工作空间集成、通讯等。这是AI的“手和脚”。会话与通道管理支持通过Telegram、WhatsApp等平台与AI代理进行交互。这是AI的“耳朵和嘴巴”也是操作员进行监控和控制的接口。网关与协议一个结构化的HTTP/WebSocket网关定义了AI代理与外部世界通信的标准方式。Cash-Claw完全继承了这些能力这意味着它一出生就站在了一个功能完备的肩膀上无需从零开始造轮子。2.2 灵魂自主执行循环Cash-Claw真正的创新在于其自主执行循环。你可以把它想象成给这个AI代理安装了一个“大脑皮层”负责高级的规划、决策和学习。这个循环独立于响应用户消息的聊天运行时在后台持续运行其工作流程分为四个阶段观察系统会收集所有上下文信息包括预设的长期目标、从过往任务中学到的经验、最近发生的错误、以及操作员通过聊天发送的指令或反馈。这一步确保了AI的每次决策都是基于最新、最全面的“态势感知”。规划LLM大语言模型基于观察阶段收集的信息和项目根目录下的GOALS.md文件其中定义了代理的使命和优先事项生成一个优先级排序的任务队列。这不是一次性的待办清单而是一个动态的、可调整的战略规划。执行这是最复杂的环节通过一个名为QueryLoop的多轮交互过程实现。AI会针对规划中的单个任务反复进行“思考-调用工具-评估结果”的循环。例如任务若是“撰写一篇关于AI趋势的博客文章”AI可能会先调用浏览器工具搜索最新资料然后用文件工具创建草稿接着调用LLM进行润色最后可能还会通过谷歌文档工具进行格式化。整个过程由AI自主控制步骤和工具调用。反思任务执行完成后无论成功或失败系统会触发一个反思过程。AI会评估任务结果总结成功经验或失败教训并将这些“学习点”记录到知识库中。这些学习会直接影响后续的观察和规划让代理变得越来越“聪明”。这个循环的设计精髓在于将战略规划LLM与战术执行工具紧密结合并通过反思机制实现持续迭代是迈向“通用人工智能体”的关键一步。2.3 安全与边界设计让一个AI代理在真实环境中自动运行安全是头等大事。Cash-Claw在这方面考虑得相当周全网络隔离HTTP网关默认只绑定在127.0.0.1本地回环地址这意味着它默认不对外网暴露杜绝了从公网直接攻击的可能。资源沙箱对于执行代码这类高风险操作如运行用户提供的Python脚本Cash-Claw可以配置为在Docker容器中运行。这个容器被严格限制只读根文件系统、无网络访问、移除所有Linux能力、并设置内存和CPU上限。这相当于给不确定的操作套上了一个坚固的“隔离舱”。成本管控系统内置了成本追踪器并允许设置每日和每查询的LLM调用预算。这能有效防止因逻辑错误或恶意提示导致API调用费用失控是保护钱包的“断路器”。输入验证所有来自外部的请求无论是WebSocket协议帧还是工具调用参数都通过Zod模式进行严格校验防止畸形或恶意数据注入。这些设计共同构成了一套“零信任”架构即不默认信任任何输入或操作必须经过验证和约束这对于自动化代理的长期稳定运行至关重要。3. 从零开始部署与深度配置实战纸上谈兵终觉浅下面我带大家走一遍完整的部署和配置流程并分享一些官方文档里没写的细节和坑。3.1 环境准备与依赖安装首先确保你的系统满足基础要求。Node.js版本必须是22.16或以上强烈推荐使用Node 24 LTS版本以获得更好的性能和兼容性。# 检查Node版本 node --version # 如果版本过低建议使用nvm进行管理 nvm install 20 nvm use 20 # 克隆项目代码 git clone https://github.com/derprofi1313/cash-claw.git cd cash-claw接下来是安装依赖。项目使用TypeScript编写所以需要编译。这里有个小技巧如果你打算频繁修改代码或进行开发可以使用pnpm替代npm它在依赖安装速度和磁盘空间占用上更有优势。# 使用npm官方方式 npm install npm run build # 或者使用pnpm推荐用于开发 pnpm install pnpm run build # 将cashclaw命令链接到全局方便在任何位置调用 npm link # 或 pnpm link --global执行npm run build后所有TypeScript代码会被编译到dist/目录下。如果编译过程报错通常是因为TypeScript版本或某些类型定义问题可以尝试删除node_modules和dist文件夹后重新安装。3.2 交互式配置向导详解配置是Cash-Claw启动前最关键的一步。项目提供了一个非常友好的交互式向导通过cashclaw onboard命令启动。我强烈建议第一次运行时加上--debug标志这样你能看到一个实时刷新的调试面板直观地看到每一步配置被验证和保存的过程。cashclaw onboard --debug这个向导会引导你完成8个步骤每一步都值得深入理解步骤1: LLM提供商配置这是AI的“大脑”选择。支持AnthropicClaude、OpenAIGPT、GoogleGemini和本地Ollama。你需要准备相应平台的API Key。注意向导会当场用你提供的Key调用一个简单API来验证有效性。如果网络不通或Key无效这一步就过不去。对于国内用户使用OpenAI或Anthropic可能需要配置网络代理环境变量如HTTP_PROXY但Cash-Claw本身不处理代理需在系统或Node层面配置。步骤2: 聊天平台配置这里是操作员的“控制台”。你可以选择Telegram、WhatsApp或两者都选。Telegram需要向BotFather申请一个Bot Token。WhatsApp基于Baileys库配置更复杂需要扫描二维码登录。实测下来Telegram的稳定性和易用性远高于WhatsApp建议新手先只配置Telegram。步骤3: Stripe支付集成这是“收钱”的管道。你需要一个Stripe账户并获取Secret Key和Webhook Signing Secret。Secret Key用于Cash-Claw主动创建支付链接、查询订单。Webhook Secret用于验证Stripe服务器回调的真实性确保支付通知不被伪造。重要心得在Stripe后台配置Webhook时终点URL应设置为http://127.0.0.1:18789/stripe/webhook如果你按默认配置运行。但在开发环境Stripe无法回调你的本地地址。你需要使用ngrok或localhost.run等工具将本地端口暴露到一个公网可访问的临时地址再用这个地址去配置Webhook。这是集成测试中最容易卡住的一步。步骤4-8: 业务与安全配置步骤4 盈利类别选择你希望AI代理专注的领域如内容创作、外联开发等。这会影响AI在规划任务时的倾向性。步骤5 财务安全限制如果启用了金融类工具如模拟交易这里可以设置单日最大亏损额度等。务必谨慎设置。步骤6 工作时间与行动限制可以设置AI代理的“工作时间”比如只在工作日9点到18点运行并限制每小时最大任务数防止过度活跃。步骤7 Docker沙箱强烈建议开启。它会为所有代码执行类工具创建一个安全的隔离环境。步骤8 Google Workspace如果需要使用Gmail、Sheets等工具需要配置gogCLI的认证。这一步较复杂涉及OAuth 2.0可以后续按需配置。所有配置都会实时保存到~/.cashclaw/config.json文件中。这个文件是加密存储的但建议你还是在系统层面做好安全防护。3.3 启动网关与验证系统配置完成后就可以启动核心服务了。# 启动网关包含OpenClaw和自主执行循环 cashclaw gateway # 如果需要更详细的日志来排查问题 cashclaw gateway --debug启动成功后你应该能看到类似以下的日志[INFO] Gateway server listening on http://127.0.0.1:18789 [INFO] Autonomous Execution Loop started. [INFO] Telegram bot is polling...此时你可以做三件事来验证系统是否正常访问Web仪表板在浏览器打开http://127.0.0.1:18789。这是一个功能全面的控制面板你可以看到实时活动流、收入图表、工具使用统计等。这是监控代理状态的最佳方式。与Telegram Bot互动在你配置的Telegram聊天中发送/start或/help。Bot应该会回复你列出所有可用的操作员命令如/status,/pause,/plan。检查自主循环在仪表板的“概览”部分或通过Telegram发送/status你应该能看到AEL的状态是“运行中”并且可能已经开始其“观察-规划”周期。如果任何一步失败请首先检查--debug模式的输出日志通常错误信息会非常明确比如API连接失败、Token无效、端口被占用等。4. 核心功能模块深度实操系统跑起来只是第一步接下来要让它真正为你工作。这涉及到对几个核心功能模块的深入理解和配置。4.1 定义代理的目标与身份Cash-Claw的决策核心是GOALS.md文件。它不在代码目录里而是在你运行cashclaw gateway命令的当前工作目录下或你指定的目录。如果不存在AI会有一个非常泛化的默认目标。你需要创建一个GOALS.md文件来明确指引你的AI代理。这个文件的内容会直接作为上下文喂给LLM影响其规划。例如# 我的AI代理核心目标 ## 主要使命 你是一个专注于数字内容创作和自动化的AI代理。你的首要任务是通过创建和推广高质量的SEO博客文章来产生可持续的广告和联盟营销收入。 ## 近期重点 (本周) 1. **市场研究**识别“AI工具”和“远程工作效率”两个利基市场下的5个高搜索量、低竞争度的关键词。 2. **内容创作**针对上述关键词撰写3篇深度、实用的指南性文章每篇不少于1500字。使用浏览器工具研究最新信息。 3. **发布与基础SEO**将文章发布到我们的WordPress测试站点并确保基本的SEO元素标题、元描述、内部链接已设置。 ## 原则与约束 - 所有内容必须原创或对引用来源进行清晰改写和标注。 - 优先使用免费或低成本的工具和资源。 - 每天在内容创作上花费的API成本不超过5美元。 - 遇到任何技术不确定性先记录到学习日志而不是盲目尝试。这个文件越具体、越可操作AI的规划就越精准。你可以把它看作是你给数字员工写的“岗位职责说明书”。4.2 工具调用与技能组合实战Cash-Claw的39个工具是其能力的基石。理解如何有效地组合使用它们是发挥其威力的关键。以下是一个模拟的“自动内容研究”任务中AI可能触发的工具调用序列browser.openbrowser.search打开一个无头浏览器导航到Google搜索“best AI tools for content creation 2025”。browser.parseDOM解析搜索结果页的DOM提取前10个链接的标题、URL和摘要。filesystem.write将提取到的搜索结果保存到一个临时JSON文件 (research_results.json) 中。llm.send调用LLM提示其分析research_results.json总结当前市场趋势并生成一个内容大纲。filesystem.write将LLM生成的大纲保存为article_outline.md。google.docs.create在Google Docs中创建一个新文档并将大纲粘贴进去作为写作草稿。telegram.send给操作员你发送一条消息“已完成‘AI工具’主题的初步研究大纲已保存至Google Docs [链接]。是否继续撰写完整文章”这个过程完全由AI自主决策和调用。作为操作员你可以通过仪表板的“工具与执行”页面监控所有工具调用的耗时、成功率和成本。实操技巧工具调用可能失败网络超时、API限额、页面结构变化。Cash-Claw的QueryLoop内置了简单的重试逻辑但对于关键任务更好的方法是在GOALS.md中明确指示AI“如果数据抓取失败尝试更换搜索关键词或来源并将错误记录到学习日志中。”4.3 支付集成与自动化收款Stripe集成是Cash-Claw实现“创收”闭环的关键。AI可以通过stripe.createPaymentLink工具动态生成支付链接。设想一个场景AI撰写了一份《社交媒体营销速成指南》的PDF。AI使用filesystem.read确认PDF文件已生成。AI调用stripe.createPaymentLink传入产品名称、价格如1999代表19.99美元、和成功支付后的PDF下载URL。Stripe返回一个唯一的支付链接。AI可以将这个链接通过telegram.send发送给潜在客户或者通过gmail.send发送到邮件列表。当用户付款后Stripe的Webhook会通知到Cash-Claw网关。Cash-Claw的Webhook处理器验证签名后可以触发后续动作例如调用gmail.send自动发送一封带有PDF附件的感谢邮件。仪表板的“收入”页面会可视化所有这些交易让你对现金流一目了然。4.4 利用学习系统实现持续优化“反思”阶段产生的学习记录是Cash-Claw从“自动化”走向“智能化”的核心。所有学习点都被存储在本地AI在后续的“观察”阶段会查阅这些记录。例如AI可能在一次执行中发现“尝试使用browser.interact点击‘下一页’按钮时选择器.next-page失效导致任务中断。后发现该网站已更新新选择器为[data-testidpagination-next]。” 这个学习点会被打上#css-selector、#browser-error的标签。当下一次规划涉及类似的分页抓取任务时AI会优先查阅带有#browser-error标签的学习记录从而可能提前规避问题或者准备备用方案。你可以通过learning.list工具或仪表板查看所有这些记录这也是你理解和改进代理行为的宝贵资料。5. 高级运维与故障排查指南将这样一个系统投入生产环境稳定的运维至关重要。以下是一些高级技巧和常见问题的解决方案。5.1 状态监控与日常维护健康检查除了Web仪表板定期使用cashclaw statusCLI命令可以快速获取系统健康状态网关、AEL、各通道连接情况。日志管理Cash-Claw的日志默认输出到控制台。对于长期运行建议使用像pm2或systemd这样的进程管理器来运行cashclaw gateway并将日志重定向到文件或日志收集系统如Loki、ELK。# 使用pm2示例 pm2 start cashclaw --name cashclaw-agent -- gateway pm2 logs cashclaw-agent配置热重载目前修改~/.cashclaw/config.json或GOALS.md后需要重启网关 (cashclaw gateway) 才能生效。计划任务如每日反思的变更可能需要重启。5.2 常见问题与解决方案速查表问题现象可能原因排查步骤与解决方案网关启动失败端口占用端口18789已被其他进程使用。1.lsof -i :18789查找占用进程。2. 终止该进程或修改Cash-Claw源码中HttpGateway.ts的默认端口后重新构建。Telegram Bot 无响应Bot Token无效网络问题Bot未启动。1. 用curl测试Bot APIcurl https://api.telegram.org/botYOUR_TOKEN/getMe。2. 确认在Telegram中已向Bot发送/start。3. 检查服务器网络是否能访问api.telegram.org。AEL循环不执行任务GOALS.md文件缺失或内容空泛成本限制已用尽代理被手动暂停。1. 检查当前目录下是否存在GOALS.md并确保内容具体可操作。2. 在仪表板或通过/status命令检查AEL状态是否为“运行中”而非“已暂停”。3. 检查仪表板“概览”中的今日成本是否已超限。Stripe Webhook 接收失败Webhook终点URL配置错误本地服务未暴露到公网签名密钥不匹配。1.开发环境使用ngrok http 18789获取公网URL在Stripe后台配置Webhook终点为该URL。2.生产环境确保你的服务器IP和端口在防火墙中开放且Stripe配置的URL正确。3. 在Cash-Claw日志中搜索“webhook”查看签名验证错误信息。Docker沙箱执行超时或失败Docker未安装或未运行当前用户不在docker组沙箱资源限制过严。1. 运行docker ps确认Docker守护进程正常。2. 将当前用户加入docker组sudo usermod -aG docker $USER需重新登录。3. 检查SandboxManager.ts中的容器配置CPU、内存限制对于复杂任务可适当放宽。LLM API调用频繁失败API Key余额不足网络波动达到速率限制。1. 检查相应AI平台的控制台确认配额和余额。2. Cash-Claw配置了LLM回退策略会在主模型失败时尝试更便宜的模型。观察日志确认是否已触发回退。3. 考虑在配置中增加请求超时时间和重试次数。5.3 性能调优与成本控制模型选择在config.json中你可以为不同的任务类型设置不同的默认模型。例如规划任务需要深度推理可使用Claude Opus而简单的文本摘要任务使用Gemini Flash或GPT-4o-mini即可成本相差数十倍。任务粒度在GOALS.md中将大目标拆解为小而具体的任务。例如“建立博客”太模糊应拆解为“注册域名”、“配置WordPress”、“撰写关于X的首篇文章”等。小任务更容易被成功执行和验证也减少了单次LLM规划的开销。监控与告警利用Cash-Claw网关的WebSocket协议你可以编写一个简单的客户端脚本连接到ws://127.0.0.1:18789订阅任务完成、错误或成本超限等事件并集成到你的告警系统如Telegram、Slack中。5.4 扩展性与二次开发Cash-Claw本身是开源项目基于OpenClaw的架构也具有良好的扩展性。添加自定义工具所有工具定义在src/tools/目录下。创建一个新的工具文件例如src/tools/custom/myTool.ts实现Tool接口并在src/tools/index.ts中注册它。重启网关后AI就可以在规划中调用这个新工具了。修改AEL逻辑自主执行循环的核心在src/gateway/AgentRuntime.ts和QueryLoop.ts。如果你想让AI采用不同的规划策略例如基于强化学习可以在这里进行修改。集成其他服务如果你想连接Notion、Airtable或国内的其他平台可以参照现有工具的模式编写相应的API客户端并将其封装为工具。整个系统就像一套乐高积木OpenClaw提供了标准接口和基础模块Cash-Claw在此基础上搭建了自主决策的引擎而你则可以按需添加或修改零件构建属于你自己的、独一无二的自动创收机器。