导读 introduction本文主要是盘一盘OpenClaw的基本内容也是常见使用者涉及到核心点。解决网络教程太分散官方又太详细使人眼花。本文为基础篇主要帮你01 调整心态、缓解焦虑评估openclaw对自身的价值要不要用缓解一下持续话题带来的焦虑02 从了解、到部署、到上手实践了解基本概念如何安装部署、可能遇到的问题如何切换各类模型供应商常见配置修改和命令使用提供一种有些深度的多Agent实践以及目前存在的开源案例03 一些可以避开的坑知道大概的费用情况以及如何进行节省了解安全相关的一些问题始终推荐更新到最新版且优先查看官网不然网络教程和官方配置可能匹配不上。我的观点1. 反问自己让自己不焦虑本着不焦虑不急躁的主旨个人觉得可以先想清楚自己用它干嘛再去追逐热点部署龙虾。盲目的追逐不仅浪费时间精力还会带来无形压力部署路途艰难部署完不知做什么如果你去搜索openclaw主要内容可能是云厂商提供的一键部署广告或是部署教程很少有工程实践或者高价值收益案例。如果你搜索关键词openclaw 应用案例可以看看截图也可以看 ****十一章 ****案例地址扪心自问下面案例中个人很需要助理吗项目管理没有好用工具么AI自媒体创作投稿平台给你推流么这些案例中有人给算过投入和产出成本么2. 什么时候使用合适公司内有现成的公司内有条件有免费的一键化的部署可以让你快速体验。搭配公司业务一切水到渠成。几乎没有时间和费用成本个人满足下面这些理由必须接受一定的成本投入20刀/每月的订阅持续性任务token消耗。有些模型不能使用订阅必须使用token模式这个花费更是海量好用不便宜便宜不好用必须花得起时间目前整个openclaw还是偏向技术化的缺少稳定性的GUI深度应用需要技术底蕴加持。可能十分感兴趣或者需要openclaw的热度流量有足够的兴趣爱好或者追逐AI趋势保持AI技术内容创作。可能非常需要工程化和自动化能力你需要多Agent协作复杂的自动化能力确实可以考虑。如果你只是为了获取个资讯做个定时任务AI聊聊天做个文档分析各类工具太多了还都免费如果你不知道到可以问问AI工具能力 开源或github 做为提问关键词。本文结构一、OpenClaw 到底是什么二、核心概念和配置三、安装部署四、Token 费用问题五、基本使用场景六、常见配置和命令使用七、工程化实战八、安全和常见问题九、常见命令使用十、参考资源十一、开源案例十二、个人展望01 OpenClaw 到底是什么1.1 一句话OpenClaw 是一个能干活的AI Agent平台。不是聊天机器人它能操作你的电脑、访问网页、处理文件、发消息、跑定时任务。1.2 名字变化项目多次改名容易搞混最初叫ClawdbotAnthropic发律师函后改名Moltbot脱皮龙虾的意思最终定名OpenClaw三个名字指的是同一个东西功能完全一致。1.3 和ChatGPT/Claude等区别最后一行很重要OpenClaw 本身不包含 AI 模型它是一个调度平台。你需要给它配一个大脑它才能干活。02 核心概念和配置2.1 核心组成Gateway网关系统中枢所有消息都经过它。默认监听18789端口。Channel渠道是消息的入口和出口。飞书的消息通过Channel进入GatewayGateway回复再通过这个Channel发回给你。Agent代理干活的角色可以一个Agent也可以多个各司其职。每个Agent都有身份SOUL.md行为规范AGENTS.md记忆MEMORY.md工作目录Tool工具Agent工具箱。包括文件读写、命令执行、浏览器控制、定时任务等。Skill技能可安装的能力扩展包。比如prompt-guard防注入省token等。数据流向用户消息 - Channel - Gateway - Agent调用AI模型使用Tool- Gateway - Channel - 用户收到回复。2.2 概念速查2.3 文件结构OpenClaw 的所有配置集中在~/.openclaw/目录下~/.openclaw/每个 Agent 的工作目录workspace结构多Agent也就是多员工模式在后面介绍详细参考https://docs.openclaw.ai/zh-CN/reference/AGENTS.defaultworkspace/2.4 openclaw.json 关键配置项这个文件是 JSON 格式控制OpenClaw的所有行为。后面会频繁修改它先了解结构{03 安装部署mac 推荐电脑安装brew软件管理工具可以让你应对后面很多的环境建设包安装等内容国内脚本你在mac上安装brew提供了各种选择源/bin/zsh -c $(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)3.1 前置条件硬性要求Node.js 22 或更新版本。检查是否已安装node -v如果没有安装或版本低于 22# macOS用 Homebrew看不懂node下载没关系版本选择最新LTS代表稳定版本系统自己选择Mac或者window。后面CPU指令集多数window电脑都是x64少数(Surface Pro)arm64Mac的inter芯片是x64自己的M系列是arm64不懂就都下载试试很快的。3.2 macOS/window本地安装适合日常个人使用机器在身边随时能看到。安装方式不必管它有多少种会一种即可不要过于纠结最终没什么区别3.2.1 第一步安装 OpenClawMaccurl -fsSL https://openclaw.ai/install.sh | bashwindowiwr -useb https://openclaw.ai/install.ps1 | iex装完之后终端里就有openclaw命令了。另一种方案Mac或Window均可因为你已经有Nodejs 22版本npm install -g openclawlatest3.2.2 第二步安装向导双端基本一致openclaw onboard --install-daemon键盘的左右控制yes/no选择QuickStart大模型接入选择我用的token模式智普AI可以关注我截图中的选择项如果用订阅模式有些订阅模式不是官方的gemini注意安全智普API点击右上角添加新的API Key。新用户会赠送很多token针对不同版本模型都有注意openclaw在设置模型时应该与你后台有token模型匹配比如glm-4.5聊天渠道方便通过飞书控制电脑我使用了飞书接入飞书渠道需要APP Secret 和 App ID 获取飞书密钥信息内容参考3.3的飞书接入文档链接处Group chat policy 聊天安全策略这里选择open是为了快速完成验证降低接入成本提升部署信心安全角度不要用open配置skills默认可以先不用配置如果你要配置这里的操作应该是按空格进行选择按回车确认进入下一步。跳过hook设置按空格选择选择后左侧方框变成实心回车确认使用TUI终端UI也可以用别的浏览器UI。当初始化完成可以直接通过终端对话或使用下面图片绿色带有token的内容打开本地聊天对话。浏览器打开的样子如下当然你也可以在终端对话3.2.3 第三步验证安装# 检查网关状态如果控制面板能正常打开看到聊天界面说明安装成功。你已经可以在浏览器里和 Agent 对话了。3.2.4 第四步常见问题解决问题1中间出错先问大模型如果没有经验就一键清空重来万能重启大法。openclaw的所有配置都在.openclaw目录下rm -rf ~/.openclaw问题2如果在初始化阶段某个配置选择错误推荐直接按esc退出重来。如果懂配置你可以选择先继续最后在统一去~/openclaw/openclaw.json里修改或者丢给大模型让他给你配置。3.3 channel接入远程控制电脑通过接入channel可以通过远程控制openclaw支持开发。这边直接推荐阿里云官方文档包含飞书企业微信QQ等方案。官方飞书接入最近更新了https://docs.openclaw.ai/zh-CN/channels/feishu#2-%E5%88%9B%E5%BB%BA%E5%BA%94%E7%94%A8阿里云接入文档https://help.aliyun.com/zh/simple-application-server/use-cases/openclaw-integrated-fly-book?spma2c4g.11186623.help-menu-58607.d_3_0_0_2.499e36bct9cEj6scm20140722.H_3019601._.OR_help-T_cn~zh-V_104 Token 费用问题如果只是简单玩玩用token没问题如果想深度用不用想直接订阅。下面展示一下实际成本。阿某云部署的openclaw只对话两次3毛钱没了还没得到想要的结果。本来想让他获取一下最新的AI资讯不仅没有得到结果skill执行异常还浪费大量token。模型qwen-plus-latest非常便宜的模型了输入0.8元/百万token输出2元/百万token这都玩不起它一个失控直接爆炸。下图是我的获取AI资讯脚本用大模型deepseek筛选和翻译热门AI资讯每天才几毛钱。账单情况大概150用在openclaw里还没翻起个浪花玩法还没怎么探索就没了。token用光表现没有加载状态直接卡住4.1 钱花在哪1 个英文字符 ≈ 0.3 个 token1 个中文字符 ≈ 0.6 个 tokenopenclaw 系统PromptSOUL、AGENTS基础信息加上一些其他内容整个对话的起步价13k token。约等于43k英文字符或者21k中文字符。从下面这张图你会发现一个真实而悲惨的故事如果我们把输出当作有效内容有效的token占比极低纯浪费资源使用/context list查看上下文使用情况4.2 可尝试优化方案配置上下文裁剪reserveTokensFloor确保上下文不会撑爆ttl让过期的工具输出自动从上下文中移除会话剪枝详细介绍https://docs.openclaw.ai/zh-CN/concepts/session-pruning#会话剪枝{精简系统提示词AGENTS.md默认内容Discord/WhatsApp等或者拟人要求不需要可以考虑去掉在传统软件行业很少有改系统配置等行为但是AI这个方向思路可以转变~/.openclaw/workspace/AGENTS.mdSOUL.md身份描述两三句话就够不需要写小作文MEMORY.md定期清理过期内容只保留当前有用的信息。使用已经付费的工具如果你有cursor/gemini/claude code付费可以让openclaw调用这些由他们控制开发。最后给出返回通知即可。这里有个技巧正常来说这种使用规则是配置到AGENT.md比较合适但是你可以把规则都设计成skill这样避免每次对话读取太多AGENT.md内容。AGENT.md特别大时都可以考虑通过skill合理的减少token消费去掉无用的skill尽管skill是渐进式披露但是依然是有成本的尤其是skill多了以后。比如上面我的截图skill占用了1.3k token还没开始就花掉了不少。新任务开新会话不要在一个会话里聊几百轮。会话越长每次发送的上下文越大token消耗越多。合理控制完成一个任务就开新会话。合理控制Heartbeat频率不需要每5-10分钟检查一次那就时间放长一点合并心跳任务“检查邮件”“检查待办独立任务合并成一个每日晨报”一次调用搞定当存在大量记忆时使用QMD本地语义搜索引擎https://blog.csdn.net/fogdragon/article/details/158454022QMDQuantum Memory Database是比较有效的省token手段。传统记忆系统会把整个 MEMORY.md 塞进上下文但其中多数跟当前问题无关。QMD用本地语义搜索只取最相关的2-3句话传给AI。token消耗降低响应速度提升准确性提高定期维护更新记忆内容每周检查一次归档过期内容只保留当前活跃的记忆条目多 Agent 分流不同任务用不同价位的模型。创建多个Agent复杂任务分配给claude模型简单任务日程提醒、翻译、快速查询分配deepseek模型国产模型替代deepseek输入价格2元/百万token缓存0.2元更加便宜本地模型吃电脑配置安装 Ollama本地跑开源模型处理简单任务简单补全和翻译够用API成本为零# 安装 Ollama频繁关注用量情况05 基本使用场景5.1 基础对话浏览器浏览器打开后直接在聊天框输入即可。openclaw dashboard命令行如果你使用了TUIopenclaw tuiTelegram/飞书等渠道配置好后直接在手机上随时用。5.2 定时任务Cron这是 OpenClaw 最实用的功能之一每天早上8点问候openclaw cron add \管理定时任务openclaw cron list # 查看所有定时任务5.3 浏览器自动化OpenClaw 内置了浏览器控制工具可以打开网页、填表、点击按钮需要搭配工具。确保浏览器工具已启用同时确保tools.profile设置为codingProfile权限不足会禁用高危工具{“打开 Hacker News获取新闻信息”5.4 文件处理Agent可以直接读写目录下的文件Downloads下所有PDF文件名整理成一个exceldocument目录下创建全新的vue项目创建todo.md文件记录我刚才说的事情5.5 Web搜索与信息聚合# 需要配置搜索 API推荐 Brave Search配置后Agent 自动具备搜索能力。“搜索一下最近一周关于 Rust 语言的重要更新”“帮我查一下从北京到上海的高铁时刻表”06 常见配置和命令使用6.1 切换模型同供应商如果你不会命令修改配置json那么这里有可视化的安全的修改方式。改完保存即可。如果知道都是干么的复制丢给大模型让他给你配置同一家不同模型切换智普的各类模型切换直接修改~/.openclaw/openclaw.json的agent配置修改完成后执行openclaw gateway restart或者这里改也行前提是如果有的话6.2 切换模型不同供应商单个不同模型供应商切换配置直接重新初始化openclaw onboard有引导和可视化效果好。多个不同模型多供应商同时配置手动修改配置json不用走初始化流程定向改动但是比较复杂。// 第一步 找到 models - providers 位置增加以下代码第四步如下2张图将key输入并保存。可以看到deepseek多了apiKey: __OPENCLAW_REDACTED__然后你在回头对话即可。当然第四步可以换成openclaw onboard因为你配置多个供应商这个初始化流程会提示多次填写api_key6.3 拓展skill能力6.3.1 官方安装方案1技能分几类1.工作区(workspace/skills)2.本地拓展技能~/.openclaw/skills3.捆绑内置(随安装程序一起提供)首先安装npm i -g clawhubclawhub工具https://clawhub.ai/ 去官网找skill然后执行命令clawhub install self-improving-agent安装技能自动安装到工作区/.openclaw/workspace/skills技能常见命令安装到工作空间6.3.2 官方安装方案2# 安装技能6.3.3 手动安装方案1、找到三方skill。2、下载到本地。3、然后手动移动到指定目录下即可。可不可以让AI自己安装可以但是不要这么做如果skill安装遇到问题会出现工具链调用雪崩导致token大量浪费6.4 工作区OpenClaw从工作区目录读取操作指令和记忆默认使用~/.openclaw/workspace作为智能体工作区使用agents.defaults.workspace选择不同的工作区支持~会在后的多Agent实践中详细讲解。{6.5 会话和记忆会话文件会话元数据token使用量、最终路由等/new或/reset为该聊天启动新会话如单独发送智能联系人会回复一个简短的问候来确认重置/compact压缩会话上下文并报告剩余的上下文预算07 工程化实战结合自身摸索了很久总算是找到了一个还算符合我实际的应用场景那就是让我随时随地开发个人项目是的是个人项目。核心点有小孩周末事情多没法用电脑很好的利用了openclaw的channel接入飞书手机控制个人项目没有太多质量要求基本能实现功能即可。而且需要节约成本同时利用我已经现有付费模型。单纯控制一个模型即规划需求又写代码容易混合所以用了多Agent 多模型配置 workspace隔离用了多Agent协作共事。7.1 多Agent协作-打通隔离和飞书这个内容比较坑非常容易产生版本问题推荐升级openclaw最新版。另外由于版本快速迭代官方文档和插件都不是很稳定经常变动所以要以官方和github的issue为准。本篇文章最后打通是升级到26.3.13的版本这是 OpenClaw 最有工程价值的用法。当你的需求复杂到单个 Agent 搞不定时——比如它聊着聊着就跑偏了或者你想让不同任务用不同模型——就该上多 Agent 了。效果如下能够知道自己的身份互相隔离7.2 配置流程第一步创建多个Agentopenclaw agents add leader --workspace ~/.openclaw/workspace-leader第二步配置模型这里有多少模型可配置可以去看6.1章多模型配置那里。你那里配置了多个这里就有多个选择。第三步创建一个新的飞书机器人参考飞书 3.3 章内容第四步飞书机器人在openclaw建立配置关系第五步绑定飞书机器人这里非常重要特别容易乱导致对不齐。切记途中的对应关系低版本配置结构不是这样。所以推荐使用最新版关于id字段的ou_xxx和oc_xxx这是飞书的uid和群的会话id。如何获取看下图。ou用户uid通过开发平台获取。https://open.feishu.cn/document/server-docs/contact-v3/user/get?appIdcli_a93dc6de74a21ccaoc 群会话id通过点击群头像右上角更多滑到最下面获取第六步 详细设置各个Agent工作内容给各个agent定义工作要求比如PM角色需要考虑各种产品常见问题。研发角色需要考虑编码边界代码使用规范等等第七步 群内使用对话7.3 问题解决飞书需要配对码你可把配对码发给AI让其自动匹配。也可以设置dmPolicy open直接允许无需配对https://docs.openclaw.ai/zh-CN/channels/feishu#配置参考解释一下映射关系和调试飞书通过bindings将独立的Agents和独立的飞书机器人进行关联实现接受消息准确分发。agents(agentIdworkspace) bindings channel(accountId peer(kindid))在~/.openclaw/logs/gateway.log下可以看到飞书发送的消息究竟派发给哪个agent了。在通过openclaw agents list --bindings查看Agent配置的绑定关系来排查消息发送不匹配问题。08 安全和常见问题8.1 安全内容电脑自身安全避免AI越权操作删除系统文件注入代码病毒等导致电脑瘫痪数据内容安全避免AI读取电脑私密信息导致数据泄漏软件信息安全避免AI操作或使用软件读取软件私密信息违规操作删除导致软件数据泄漏丢失等网络安全openclaw需要网络如果通过Agent的Prompt注入可能导致密钥被发送到8.2 安全配置方案8.3 安全细节配置无论上述哪种模式隔离仍需要做一些细节的安全控制尤其是和openclaw相关的token密钥飞书(或其他账号)的密钥等以及多个项目之间的数据安全和隔离关系。8.3.1 安全审查命令// 让你看到存在哪些安全问题8.3.2 合理修改配置方式不要直接手动添加openclaw.json的关于api_key的私密信息通过浏览器设置界面会自动给你加密处理。8.3.3AGENT.md 配置提示词限制## 安全规则8.3.4 channel消息安全所有支持私信的渠道都支持私信策略dmPolicy或*.dm.policy,大多数失败不是漏洞利用——而是”给机器人发消息它就照做了。”决定谁可以与机器人交谈私信配对/白名单/显式”开放”决定机器人被允许在哪里执行操作群组白名单 提及门控、工具、沙箱隔离、设备权限// pairing默认未知发送者会收到一个短配对码机器人会忽略他们的消息直到获得批准8.3.5 消息群组安全如果使用多Agent模式时使用session.dmScope控制私信如何分组实现会话隔离// main默认所有私信共享主会话以保持连续性8.3.6 群组中禁止推理和详细输出/reasoning和/verbose可能暴露内部推理或工具输出不要在群组中使用这两个能力。详细输出可能包括工具参数、URL 和模型看到的数据群组中保持/reasoning和/verbose禁用8.3.7 提示词安全即使只有你能给机器人发消息提示词注入仍然可以通过读取的任何不受信任的内容发生网络搜索结果、浏览器页面、文档、代码。内容本身可以携带风险指令。专门搞一个只读或禁用工具的阅读器智能体来总结内容然后将摘要传递给你的主智能体除非需要否则为启用工具的智能体关闭web_search/web_fetch/browser8.3.8按需配置权限和限制工具黑名单禁用不需要的工具细化每个Agent可用的工具内容进行精细控制。{路径限制限制 Agent 能访问的文件范围{8.4 常见问题Gateway 起不来# 强制杀掉占用端口的进程再启动模型连不上提示 API 错误# 测试 API 连接常见原因API Key 过期、余额不足、网络不通国内访问 Anthropic 可能需要代理。配置修改后不生效默认热重载模式安全的改动自动生效需要重启会提示。如果不确定openclaw gateway restart09 常见命令使用// terminal终端命令10 参考资源官方文档https://docs.openclaw.ai官方GitHubhttps://github.com/openclaw/openclaw11 开源案例https://github.com/EvoLinkAI/awesome-openclaw-usecases-moltbook?tabreadme-ov-file#-everyday-life-20https://github.com/hesamsheikh/awesome-openclaw-usecaseshttps://docs.openclaw.ai/zh-CN/start/showcase12 个人展望OpenClaw目前对个人应用和效率实际有限收益和成本不成正比。****除非你能用它的网络热度转化成流量或者收益。或者你能免费使用它。作为一个强大的AI工具能自动化操作电脑未来可能有两个方向性的变化第一市面软件功能开始原子化以及终端化TUI或者Skill大量软件能力着重适配AI的准入和准出而不再是传统GUI的交互。通过excel或ppt等skill可以看出办公软件类确实也在往该方向发展。这一类由软件厂商推动用户无感第二openclaw 增加更强的视觉识别和模拟可视化操作通过openclaw 其他视觉工具Anthropic Computer Use/Microsoft UFO直接操作电脑适配现有GUI能力。这一类可能需要AI工具推动用户硬件配置升级在可控的成本下只有把现有的办公工具适配上openclaw才具有真正的个人管家/个人助手的价值以及显著的效率提升。目前更适合深度开发者将工作流、RPA等流程的部分或全部来转给其承接。
从心理按摩到实操上手的OpenClaw全指南
发布时间：2026/7/29 12:44:02
导读 introduction本文主要是盘一盘OpenClaw的基本内容也是常见使用者涉及到核心点。解决网络教程太分散官方又太详细使人眼花。本文为基础篇主要帮你01 调整心态、缓解焦虑评估openclaw对自身的价值要不要用缓解一下持续话题带来的焦虑02 从了解、到部署、到上手实践了解基本概念如何安装部署、可能遇到的问题如何切换各类模型供应商常见配置修改和命令使用提供一种有些深度的多Agent实践以及目前存在的开源案例03 一些可以避开的坑知道大概的费用情况以及如何进行节省了解安全相关的一些问题始终推荐更新到最新版且优先查看官网不然网络教程和官方配置可能匹配不上。我的观点1. 反问自己让自己不焦虑本着不焦虑不急躁的主旨个人觉得可以先想清楚自己用它干嘛再去追逐热点部署龙虾。盲目的追逐不仅浪费时间精力还会带来无形压力部署路途艰难部署完不知做什么如果你去搜索openclaw主要内容可能是云厂商提供的一键部署广告或是部署教程很少有工程实践或者高价值收益案例。如果你搜索关键词openclaw 应用案例可以看看截图也可以看 ****十一章 ****案例地址扪心自问下面案例中个人很需要助理吗项目管理没有好用工具么AI自媒体创作投稿平台给你推流么这些案例中有人给算过投入和产出成本么2. 什么时候使用合适公司内有现成的公司内有条件有免费的一键化的部署可以让你快速体验。搭配公司业务一切水到渠成。几乎没有时间和费用成本个人满足下面这些理由必须接受一定的成本投入20刀/每月的订阅持续性任务token消耗。有些模型不能使用订阅必须使用token模式这个花费更是海量好用不便宜便宜不好用必须花得起时间目前整个openclaw还是偏向技术化的缺少稳定性的GUI深度应用需要技术底蕴加持。可能十分感兴趣或者需要openclaw的热度流量有足够的兴趣爱好或者追逐AI趋势保持AI技术内容创作。可能非常需要工程化和自动化能力你需要多Agent协作复杂的自动化能力确实可以考虑。如果你只是为了获取个资讯做个定时任务AI聊聊天做个文档分析各类工具太多了还都免费如果你不知道到可以问问AI工具能力 开源或github 做为提问关键词。本文结构一、OpenClaw 到底是什么二、核心概念和配置三、安装部署四、Token 费用问题五、基本使用场景六、常见配置和命令使用七、工程化实战八、安全和常见问题九、常见命令使用十、参考资源十一、开源案例十二、个人展望01 OpenClaw 到底是什么1.1 一句话OpenClaw 是一个能干活的AI Agent平台。不是聊天机器人它能操作你的电脑、访问网页、处理文件、发消息、跑定时任务。1.2 名字变化项目多次改名容易搞混最初叫ClawdbotAnthropic发律师函后改名Moltbot脱皮龙虾的意思最终定名OpenClaw三个名字指的是同一个东西功能完全一致。1.3 和ChatGPT/Claude等区别最后一行很重要OpenClaw 本身不包含 AI 模型它是一个调度平台。你需要给它配一个大脑它才能干活。02 核心概念和配置2.1 核心组成Gateway网关系统中枢所有消息都经过它。默认监听18789端口。Channel渠道是消息的入口和出口。飞书的消息通过Channel进入GatewayGateway回复再通过这个Channel发回给你。Agent代理干活的角色可以一个Agent也可以多个各司其职。每个Agent都有身份SOUL.md行为规范AGENTS.md记忆MEMORY.md工作目录Tool工具Agent工具箱。包括文件读写、命令执行、浏览器控制、定时任务等。Skill技能可安装的能力扩展包。比如prompt-guard防注入省token等。数据流向用户消息 - Channel - Gateway - Agent调用AI模型使用Tool- Gateway - Channel - 用户收到回复。2.2 概念速查2.3 文件结构OpenClaw 的所有配置集中在~/.openclaw/目录下~/.openclaw/每个 Agent 的工作目录workspace结构多Agent也就是多员工模式在后面介绍详细参考https://docs.openclaw.ai/zh-CN/reference/AGENTS.defaultworkspace/2.4 openclaw.json 关键配置项这个文件是 JSON 格式控制OpenClaw的所有行为。后面会频繁修改它先了解结构{03 安装部署mac 推荐电脑安装brew软件管理工具可以让你应对后面很多的环境建设包安装等内容国内脚本你在mac上安装brew提供了各种选择源/bin/zsh -c $(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)3.1 前置条件硬性要求Node.js 22 或更新版本。检查是否已安装node -v如果没有安装或版本低于 22# macOS用 Homebrew看不懂node下载没关系版本选择最新LTS代表稳定版本系统自己选择Mac或者window。后面CPU指令集多数window电脑都是x64少数(Surface Pro)arm64Mac的inter芯片是x64自己的M系列是arm64不懂就都下载试试很快的。3.2 macOS/window本地安装适合日常个人使用机器在身边随时能看到。安装方式不必管它有多少种会一种即可不要过于纠结最终没什么区别3.2.1 第一步安装 OpenClawMaccurl -fsSL https://openclaw.ai/install.sh | bashwindowiwr -useb https://openclaw.ai/install.ps1 | iex装完之后终端里就有openclaw命令了。另一种方案Mac或Window均可因为你已经有Nodejs 22版本npm install -g openclawlatest3.2.2 第二步安装向导双端基本一致openclaw onboard --install-daemon键盘的左右控制yes/no选择QuickStart大模型接入选择我用的token模式智普AI可以关注我截图中的选择项如果用订阅模式有些订阅模式不是官方的gemini注意安全智普API点击右上角添加新的API Key。新用户会赠送很多token针对不同版本模型都有注意openclaw在设置模型时应该与你后台有token模型匹配比如glm-4.5聊天渠道方便通过飞书控制电脑我使用了飞书接入飞书渠道需要APP Secret 和 App ID 获取飞书密钥信息内容参考3.3的飞书接入文档链接处Group chat policy 聊天安全策略这里选择open是为了快速完成验证降低接入成本提升部署信心安全角度不要用open配置skills默认可以先不用配置如果你要配置这里的操作应该是按空格进行选择按回车确认进入下一步。跳过hook设置按空格选择选择后左侧方框变成实心回车确认使用TUI终端UI也可以用别的浏览器UI。当初始化完成可以直接通过终端对话或使用下面图片绿色带有token的内容打开本地聊天对话。浏览器打开的样子如下当然你也可以在终端对话3.2.3 第三步验证安装# 检查网关状态如果控制面板能正常打开看到聊天界面说明安装成功。你已经可以在浏览器里和 Agent 对话了。3.2.4 第四步常见问题解决问题1中间出错先问大模型如果没有经验就一键清空重来万能重启大法。openclaw的所有配置都在.openclaw目录下rm -rf ~/.openclaw问题2如果在初始化阶段某个配置选择错误推荐直接按esc退出重来。如果懂配置你可以选择先继续最后在统一去~/openclaw/openclaw.json里修改或者丢给大模型让他给你配置。3.3 channel接入远程控制电脑通过接入channel可以通过远程控制openclaw支持开发。这边直接推荐阿里云官方文档包含飞书企业微信QQ等方案。官方飞书接入最近更新了https://docs.openclaw.ai/zh-CN/channels/feishu#2-%E5%88%9B%E5%BB%BA%E5%BA%94%E7%94%A8阿里云接入文档https://help.aliyun.com/zh/simple-application-server/use-cases/openclaw-integrated-fly-book?spma2c4g.11186623.help-menu-58607.d_3_0_0_2.499e36bct9cEj6scm20140722.H_3019601._.OR_help-T_cn~zh-V_104 Token 费用问题如果只是简单玩玩用token没问题如果想深度用不用想直接订阅。下面展示一下实际成本。阿某云部署的openclaw只对话两次3毛钱没了还没得到想要的结果。本来想让他获取一下最新的AI资讯不仅没有得到结果skill执行异常还浪费大量token。模型qwen-plus-latest非常便宜的模型了输入0.8元/百万token输出2元/百万token这都玩不起它一个失控直接爆炸。下图是我的获取AI资讯脚本用大模型deepseek筛选和翻译热门AI资讯每天才几毛钱。账单情况大概150用在openclaw里还没翻起个浪花玩法还没怎么探索就没了。token用光表现没有加载状态直接卡住4.1 钱花在哪1 个英文字符 ≈ 0.3 个 token1 个中文字符 ≈ 0.6 个 tokenopenclaw 系统PromptSOUL、AGENTS基础信息加上一些其他内容整个对话的起步价13k token。约等于43k英文字符或者21k中文字符。从下面这张图你会发现一个真实而悲惨的故事如果我们把输出当作有效内容有效的token占比极低纯浪费资源使用/context list查看上下文使用情况4.2 可尝试优化方案配置上下文裁剪reserveTokensFloor确保上下文不会撑爆ttl让过期的工具输出自动从上下文中移除会话剪枝详细介绍https://docs.openclaw.ai/zh-CN/concepts/session-pruning#会话剪枝{精简系统提示词AGENTS.md默认内容Discord/WhatsApp等或者拟人要求不需要可以考虑去掉在传统软件行业很少有改系统配置等行为但是AI这个方向思路可以转变~/.openclaw/workspace/AGENTS.mdSOUL.md身份描述两三句话就够不需要写小作文MEMORY.md定期清理过期内容只保留当前有用的信息。使用已经付费的工具如果你有cursor/gemini/claude code付费可以让openclaw调用这些由他们控制开发。最后给出返回通知即可。这里有个技巧正常来说这种使用规则是配置到AGENT.md比较合适但是你可以把规则都设计成skill这样避免每次对话读取太多AGENT.md内容。AGENT.md特别大时都可以考虑通过skill合理的减少token消费去掉无用的skill尽管skill是渐进式披露但是依然是有成本的尤其是skill多了以后。比如上面我的截图skill占用了1.3k token还没开始就花掉了不少。新任务开新会话不要在一个会话里聊几百轮。会话越长每次发送的上下文越大token消耗越多。合理控制完成一个任务就开新会话。合理控制Heartbeat频率不需要每5-10分钟检查一次那就时间放长一点合并心跳任务“检查邮件”“检查待办独立任务合并成一个每日晨报”一次调用搞定当存在大量记忆时使用QMD本地语义搜索引擎https://blog.csdn.net/fogdragon/article/details/158454022QMDQuantum Memory Database是比较有效的省token手段。传统记忆系统会把整个 MEMORY.md 塞进上下文但其中多数跟当前问题无关。QMD用本地语义搜索只取最相关的2-3句话传给AI。token消耗降低响应速度提升准确性提高定期维护更新记忆内容每周检查一次归档过期内容只保留当前活跃的记忆条目多 Agent 分流不同任务用不同价位的模型。创建多个Agent复杂任务分配给claude模型简单任务日程提醒、翻译、快速查询分配deepseek模型国产模型替代deepseek输入价格2元/百万token缓存0.2元更加便宜本地模型吃电脑配置安装 Ollama本地跑开源模型处理简单任务简单补全和翻译够用API成本为零# 安装 Ollama频繁关注用量情况05 基本使用场景5.1 基础对话浏览器浏览器打开后直接在聊天框输入即可。openclaw dashboard命令行如果你使用了TUIopenclaw tuiTelegram/飞书等渠道配置好后直接在手机上随时用。5.2 定时任务Cron这是 OpenClaw 最实用的功能之一每天早上8点问候openclaw cron add \管理定时任务openclaw cron list # 查看所有定时任务5.3 浏览器自动化OpenClaw 内置了浏览器控制工具可以打开网页、填表、点击按钮需要搭配工具。确保浏览器工具已启用同时确保tools.profile设置为codingProfile权限不足会禁用高危工具{“打开 Hacker News获取新闻信息”5.4 文件处理Agent可以直接读写目录下的文件Downloads下所有PDF文件名整理成一个exceldocument目录下创建全新的vue项目创建todo.md文件记录我刚才说的事情5.5 Web搜索与信息聚合# 需要配置搜索 API推荐 Brave Search配置后Agent 自动具备搜索能力。“搜索一下最近一周关于 Rust 语言的重要更新”“帮我查一下从北京到上海的高铁时刻表”06 常见配置和命令使用6.1 切换模型同供应商如果你不会命令修改配置json那么这里有可视化的安全的修改方式。改完保存即可。如果知道都是干么的复制丢给大模型让他给你配置同一家不同模型切换智普的各类模型切换直接修改~/.openclaw/openclaw.json的agent配置修改完成后执行openclaw gateway restart或者这里改也行前提是如果有的话6.2 切换模型不同供应商单个不同模型供应商切换配置直接重新初始化openclaw onboard有引导和可视化效果好。多个不同模型多供应商同时配置手动修改配置json不用走初始化流程定向改动但是比较复杂。// 第一步 找到 models - providers 位置增加以下代码第四步如下2张图将key输入并保存。可以看到deepseek多了apiKey: __OPENCLAW_REDACTED__然后你在回头对话即可。当然第四步可以换成openclaw onboard因为你配置多个供应商这个初始化流程会提示多次填写api_key6.3 拓展skill能力6.3.1 官方安装方案1技能分几类1.工作区(workspace/skills)2.本地拓展技能~/.openclaw/skills3.捆绑内置(随安装程序一起提供)首先安装npm i -g clawhubclawhub工具https://clawhub.ai/ 去官网找skill然后执行命令clawhub install self-improving-agent安装技能自动安装到工作区/.openclaw/workspace/skills技能常见命令安装到工作空间6.3.2 官方安装方案2# 安装技能6.3.3 手动安装方案1、找到三方skill。2、下载到本地。3、然后手动移动到指定目录下即可。可不可以让AI自己安装可以但是不要这么做如果skill安装遇到问题会出现工具链调用雪崩导致token大量浪费6.4 工作区OpenClaw从工作区目录读取操作指令和记忆默认使用~/.openclaw/workspace作为智能体工作区使用agents.defaults.workspace选择不同的工作区支持~会在后的多Agent实践中详细讲解。{6.5 会话和记忆会话文件会话元数据token使用量、最终路由等/new或/reset为该聊天启动新会话如单独发送智能联系人会回复一个简短的问候来确认重置/compact压缩会话上下文并报告剩余的上下文预算07 工程化实战结合自身摸索了很久总算是找到了一个还算符合我实际的应用场景那就是让我随时随地开发个人项目是的是个人项目。核心点有小孩周末事情多没法用电脑很好的利用了openclaw的channel接入飞书手机控制个人项目没有太多质量要求基本能实现功能即可。而且需要节约成本同时利用我已经现有付费模型。单纯控制一个模型即规划需求又写代码容易混合所以用了多Agent 多模型配置 workspace隔离用了多Agent协作共事。7.1 多Agent协作-打通隔离和飞书这个内容比较坑非常容易产生版本问题推荐升级openclaw最新版。另外由于版本快速迭代官方文档和插件都不是很稳定经常变动所以要以官方和github的issue为准。本篇文章最后打通是升级到26.3.13的版本这是 OpenClaw 最有工程价值的用法。当你的需求复杂到单个 Agent 搞不定时——比如它聊着聊着就跑偏了或者你想让不同任务用不同模型——就该上多 Agent 了。效果如下能够知道自己的身份互相隔离7.2 配置流程第一步创建多个Agentopenclaw agents add leader --workspace ~/.openclaw/workspace-leader第二步配置模型这里有多少模型可配置可以去看6.1章多模型配置那里。你那里配置了多个这里就有多个选择。第三步创建一个新的飞书机器人参考飞书 3.3 章内容第四步飞书机器人在openclaw建立配置关系第五步绑定飞书机器人这里非常重要特别容易乱导致对不齐。切记途中的对应关系低版本配置结构不是这样。所以推荐使用最新版关于id字段的ou_xxx和oc_xxx这是飞书的uid和群的会话id。如何获取看下图。ou用户uid通过开发平台获取。https://open.feishu.cn/document/server-docs/contact-v3/user/get?appIdcli_a93dc6de74a21ccaoc 群会话id通过点击群头像右上角更多滑到最下面获取第六步 详细设置各个Agent工作内容给各个agent定义工作要求比如PM角色需要考虑各种产品常见问题。研发角色需要考虑编码边界代码使用规范等等第七步 群内使用对话7.3 问题解决飞书需要配对码你可把配对码发给AI让其自动匹配。也可以设置dmPolicy open直接允许无需配对https://docs.openclaw.ai/zh-CN/channels/feishu#配置参考解释一下映射关系和调试飞书通过bindings将独立的Agents和独立的飞书机器人进行关联实现接受消息准确分发。agents(agentIdworkspace) bindings channel(accountId peer(kindid))在~/.openclaw/logs/gateway.log下可以看到飞书发送的消息究竟派发给哪个agent了。在通过openclaw agents list --bindings查看Agent配置的绑定关系来排查消息发送不匹配问题。08 安全和常见问题8.1 安全内容电脑自身安全避免AI越权操作删除系统文件注入代码病毒等导致电脑瘫痪数据内容安全避免AI读取电脑私密信息导致数据泄漏软件信息安全避免AI操作或使用软件读取软件私密信息违规操作删除导致软件数据泄漏丢失等网络安全openclaw需要网络如果通过Agent的Prompt注入可能导致密钥被发送到8.2 安全配置方案8.3 安全细节配置无论上述哪种模式隔离仍需要做一些细节的安全控制尤其是和openclaw相关的token密钥飞书(或其他账号)的密钥等以及多个项目之间的数据安全和隔离关系。8.3.1 安全审查命令// 让你看到存在哪些安全问题8.3.2 合理修改配置方式不要直接手动添加openclaw.json的关于api_key的私密信息通过浏览器设置界面会自动给你加密处理。8.3.3AGENT.md 配置提示词限制## 安全规则8.3.4 channel消息安全所有支持私信的渠道都支持私信策略dmPolicy或*.dm.policy,大多数失败不是漏洞利用——而是”给机器人发消息它就照做了。”决定谁可以与机器人交谈私信配对/白名单/显式”开放”决定机器人被允许在哪里执行操作群组白名单 提及门控、工具、沙箱隔离、设备权限// pairing默认未知发送者会收到一个短配对码机器人会忽略他们的消息直到获得批准8.3.5 消息群组安全如果使用多Agent模式时使用session.dmScope控制私信如何分组实现会话隔离// main默认所有私信共享主会话以保持连续性8.3.6 群组中禁止推理和详细输出/reasoning和/verbose可能暴露内部推理或工具输出不要在群组中使用这两个能力。详细输出可能包括工具参数、URL 和模型看到的数据群组中保持/reasoning和/verbose禁用8.3.7 提示词安全即使只有你能给机器人发消息提示词注入仍然可以通过读取的任何不受信任的内容发生网络搜索结果、浏览器页面、文档、代码。内容本身可以携带风险指令。专门搞一个只读或禁用工具的阅读器智能体来总结内容然后将摘要传递给你的主智能体除非需要否则为启用工具的智能体关闭web_search/web_fetch/browser8.3.8按需配置权限和限制工具黑名单禁用不需要的工具细化每个Agent可用的工具内容进行精细控制。{路径限制限制 Agent 能访问的文件范围{8.4 常见问题Gateway 起不来# 强制杀掉占用端口的进程再启动模型连不上提示 API 错误# 测试 API 连接常见原因API Key 过期、余额不足、网络不通国内访问 Anthropic 可能需要代理。配置修改后不生效默认热重载模式安全的改动自动生效需要重启会提示。如果不确定openclaw gateway restart09 常见命令使用// terminal终端命令10 参考资源官方文档https://docs.openclaw.ai官方GitHubhttps://github.com/openclaw/openclaw11 开源案例https://github.com/EvoLinkAI/awesome-openclaw-usecases-moltbook?tabreadme-ov-file#-everyday-life-20https://github.com/hesamsheikh/awesome-openclaw-usecaseshttps://docs.openclaw.ai/zh-CN/start/showcase12 个人展望OpenClaw目前对个人应用和效率实际有限收益和成本不成正比。****除非你能用它的网络热度转化成流量或者收益。或者你能免费使用它。作为一个强大的AI工具能自动化操作电脑未来可能有两个方向性的变化第一市面软件功能开始原子化以及终端化TUI或者Skill大量软件能力着重适配AI的准入和准出而不再是传统GUI的交互。通过excel或ppt等skill可以看出办公软件类确实也在往该方向发展。这一类由软件厂商推动用户无感第二openclaw 增加更强的视觉识别和模拟可视化操作通过openclaw 其他视觉工具Anthropic Computer Use/Microsoft UFO直接操作电脑适配现有GUI能力。这一类可能需要AI工具推动用户硬件配置升级在可控的成本下只有把现有的办公工具适配上openclaw才具有真正的个人管家/个人助手的价值以及显著的效率提升。目前更适合深度开发者将工作流、RPA等流程的部分或全部来转给其承接。
