OpenClaw从入门到应用——Agent

通过OpenClaw实现副业收入《OpenClaw赚钱实录从“养龙虾“到可持续变现的实践指南》工作区OpenClaw 使用一个单一的代理工作区目录agents.defaults.workspace作为代理的唯一工作目录cwd用于工具和上下文。建议使用openclaw setup在缺失时创建~/.openclaw/openclaw.json并初始化工作区文件。完整的工作区布局 备份指南代理工作区如果启用了agents.defaults.sandbox非主会话可以通过每个会话的工作区覆盖此设置工作区位于agents.defaults.sandbox.workspaceRoot下参见网关配置。引导文件注入在agents.defaults.workspace内部OpenClaw 期望以下用户可编辑的文件AGENTS.md— 操作说明 “记忆”SOUL.md— 人格、边界、语气TOOLS.md— 用户维护的工具说明例如imsg、sag、约定BOOTSTRAP.md— 一次性首次运行仪式完成后删除IDENTITY.md— 代理名称/风格/表情符号USER.md— 用户档案 首选地址在新会话的第一轮对话中OpenClaw 会将这些文件的内容直接注入到代理上下文中。空白文件会被跳过。大文件会被裁剪并截断并附带标记以保持提示词精简如需完整内容请读取文件。如果某个文件缺失OpenClaw 会注入一行“文件缺失”标记而openclaw setup会创建一个安全的默认模板。BOOTSTRAP.md仅在全新的工作区没有其他引导文件存在时创建。如果你在完成仪式后删除它在后续重启时不应重新创建。要完全禁用引导文件的创建用于预填充的工作区请设置{ agent: { skipBootstrap: true } }内置工具核心工具读/执行/编辑/写入及相关系统工具始终可用但受工具策略约束。apply_patch是可选的由tools.exec.applyPatch控制。TOOLS.md不控制哪些工具存在它只是指导你希望如何使用它们。技能OpenClaw 从三个位置加载技能名称冲突时工作区优先捆绑随安装包提供托管/本地~/.openclaw/skills工作区/skills技能可以通过配置/环境变量进行门控参见网关配置中的skills。pi-mono 集成OpenClaw 复用了 pi-mono 代码库模型/工具的部分内容但会话管理、发现和工具连线由 OpenClaw 自己负责。没有 pi-coding 代理运行时。不查阅~/.pi/agent或/.pi设置。会话会话记录以 JSONL 格式存储在~/.openclaw/agents/agent-id/sessions/session-id.jsonl会话 ID 是稳定的由 OpenClaw 选择。旧版 Pi/Tau 会话文件夹不会被读取。流式传输期间的转向控制当队列模式为steer时入站消息会被注入到当前运行中。队列在每次工具调用后被检查如果存在排队消息则跳过当前助手消息中的剩余工具调用返回错误工具结果“因排队的用户消息而跳过。”然后在下一个助手响应之前注入排队的用户消息。当队列模式为followup或collect时入站消息会被保留直到当前轮次结束然后以排队的负载开始新一轮代理轮次。参见队列了解模式 防抖/容量行为。块流式传输会在完成的助手块完成后立即发送它默认关闭agents.defaults.blockStreamingDefault: off。通过agents.defaults.blockStreamingBreaktext_endvsmessage_end默认为text_end调整边界。使用agents.defaults.blockStreamingChunk控制软块分块默认 800–1200 字符优先段落分隔然后换行句子最后。使用agents.defaults.blockStreamingCoalesce合并流式传输的块以减少单行垃圾信息发送前基于空闲的合并。非 Telegram 通道需要显式设置*.blockStreaming: true才能启用块回复。详细工具摘要会在工具启动时发出无防抖当可用时控制 UI 通过代理事件流式传输工具输出。更多详情流式传输 分块。模型引用配置中的模型引用例如agents.defaults.model和agents.defaults.models通过按第一个/分割来解析。配置模型时使用provider/model。如果模型 ID 本身包含/OpenRouter 风格请包含提供者前缀例如openrouter/moonshotai/kimi-k2。如果省略提供者OpenClaw 会将输入视为别名或默认提供者的模型仅在模型 ID 中没有/时有效。配置最小化至少需要设置agents.defaults.workspacechannels.whatsapp.allowFrom强烈推荐