目录一、介绍二、三层架构三、本地安装部署四、云端安装部署五、生态集成接入微信六、省钱指南七、干净卸载八、第一次对话一、介绍OpenClaw 是一款自托管 AI 智能体AI Agent框架。因其图标是一只红色的卡通龙虾它常被社区用户昵称为“龙虾”而部署和使用它的过程则被称为“养虾”。它的本质并非一个独立的大语言模型而是一个连接聊天应用与 AI 模型、工具系统的“智能体网关与执行框架”。简单来说它扮演的是 AI 的“手脚”将大模型的“思考”能力转化为对电脑的实际操作从而实现从“会聊天”到“能干活”的跨越。类比ChatGPT顾问提问--〉回答OpenClaw员工交代任务--〉自主执行--〉汇报结果衍生平台Moltbook专供AI Agent使用的社交网络。二、三层架构OpenClaw的目标让你在任何习惯聊天的地方微信、钉钉等直接就能命令AI干活。龙虾的核心骨架——Gateway-Node-Channel 三层架构Gateway网关持续监听所有接入的Channel微信、钉钉等接收到指令后决定派遣哪个Agent员工去处理并把任务分发给具体的Node执行它保管AI的记忆干过什么、偏好和当前对话状态保证AI不是金鱼脑。默认绑定 ws://127.0.0.1:18789。Node工作节点响应用户请求并通过大模型响应或执行相应工具。OpenClaw 相信“命令行 CLI 才是智能体连接世界的终极接口”。它只给 AI 提供了几个最基础、最强大的工具比如读写文件、运行命令然后让 AI 自己学会用命令行去解决一切问题主要通过下载各种skill解决。Channel消息渠道连接不同的IM工具与人进行交互OpenClaw AgentSkills规范按需加载模型先读取简短描述真正需要时才加载详细帮助文档。热重载整个学习和修改过程完全动态无需重启Agent敏捷响应维持上下文极度清晰确保执行极速真正智能的关键遇到未知操作或缺失工具时Agent可以自动编写一个全新的Skill文件来解决问题。三、本地安装部署适合谁注重隐私安全、有 Mac 或性能不错的 PC、希望获得最完整系统功能如操作日历、备忘录、文件的用户以及喜欢折腾的技术达人。优点数据绝对私有如果使用本地大模型所有对话、记忆、文件操作都发生在你自己的硬盘上没有数据出境的担忧。功能最全在 Mac 上它可以深度集成系统操作日历、提醒事项、截图等这是云端部署无法比拟的。零服务器租金除了电费没有额外的硬件租赁成本。响应速度快没有网络延迟本地调用飞快。缺点依赖本地设备你的电脑得开着它才能工作。如果关了 Mac AI 助手也就“睡觉”了。需要一定技术基础虽然有一键脚本但遇到环境问题可能需要自己排查。强烈推荐 Mac 用户首选本地安装1. 体验天花板 OpenClaw 在 macOS 上的原生支持最完善可以操作日历、备忘录、提醒事项与 iPhone、iPad 无缝同步文件管理更智能。这才能真正体现它作为“个人数字员工”的价值而不仅仅是个聊天机器人。2. 隐私堡垒数据完全本地是隐私保护的终极方案。对于处理工作文件、私人笔记等场景这一点至关重要。3. 成本极低 M 系列芯片的 Mac 能效比极高像 Mac mini 长期运行的功耗很低一年电费可能不到 100 元比租用云服务器可能还划算。以Win10为例官网OpenClaw — Open-Source AI Assistant根据官网步骤安装注意安装中设置大模型并配置密钥四、云端安装部署适合谁希望 AI 助手 24 小时在线、没有高性能本地电脑、或者追求省心一键配置的普通用户。优点永久在线云服务器永不关机你的 AI 助手随时待命通过手机就能访问。开箱即用国内云厂商阿里云、腾讯云等提供预装好 OpenClaw 的镜像购买后几乎不用配置就能用。解放本地资源不占用你个人电脑的算力和内存。缺点持续成本需要按月或按年支付云服务器租金虽然现在很便宜最低 9.9 元 / 月。数据在第三方你的对话数据存储在云服务商的服务器上虽然通常安全但隐私控可能会介意。功能受限无法直接操作你本地电脑上的文件和软件。核心建议模型费用才是大头。服务器成本已经降到很低 9.9-200 元 / 年真正的持续成本在于模型 API 调用。选平台时重点看模型套餐价格而不是只看服务器价格。可选平台阿里云腾讯云火山引擎百度智能云扣子编程code.coze.cn例如阿里云一键式部署稳定不贵不写代码分钟级部署Hermes/OpenClaw五、生态集成接入微信1、打开终端方法一OpenClaw客户端打开方法二命令行进入OpenClaw的WSL终端打开 PowerShell 或 CMD直接输入wsl并回车就会进入 WSL 终端。如果有多个发行版可以输入wsl -d Ubuntu-24.04。2、在 WSL 终端中先更新软件包列表并安装curlsudo apt update sudo apt install -y curl sudo apt install npm这时需要输入WSL的密码如果忘了需要重新设置WSL中openclaw用户密码及sudo权限# 在 Windows 的 PowerShell 或 Windows 终端中运行以下命令查看你的 WSL 列表 wsl -l -v #假设你的实例名叫 OpenClawGateway如果不是请替换为你实际看到的名称在 PowerShell 中运行 #这会直接以 root 管理员身份进入那个正确的实例不需要输入任何密码。 wsl -d OpenClawGateway -u root # 进入后先确认一下用户是否存在如果能看到 openclaw 文件夹说明这次进对了。 ls /home # 直接强制重置密码 passwd openclaw #授权sudo权限 usermod -aG sudo openclaw # 验证 groups openclaw # 退出 exit3、安装接入微信的插件npx -y tencent-weixin/openclaw-weixin-clilatest install然后使用微信扫描展示的二维码六、省钱指南目标OpenClaw的设计哲学是“任务分级”,目标是将预算控制在每月几十元人民币。黄金法则任务分级与模型匹配策略简单任务(60%):格式化、简单问答、分类。推荐Claude 3.5 Haiku或Gemini 2.0 Flash。这些任务难度低轻量模型处理效果接近高配但成本仅为后者的1/10甚至更低。日常任务(30%):内容创作、代码辅助、对话。推荐DeepSeek-V3/V4。在中文理解和生成方面表现优异性价比极高月产能力强大是日常主力的不二之选。复杂任务(10%):深度推理、系统架构、调试。推荐Claude Sonnet 4.6或GPT-5.4。对于真正需要“大脑”的难题必须使用最稳定的顶配模型把钱花在刀刃上。通过配置文件改openclaw的配置的方法方法一终端手动修改方法二通过命令配置openclaw dashboard这个命令会给出一个网址打开网址Dashboard URL: http://127.0.0.1:18789/三种配置方案方案一双模型切换新手友好有主要模型和次要模型通过关键词匹配进行主次切换{ llm: { primary: { provider: anthropic, model: claude-4-6-sonnet-latest, apiKey: ${ANTHROPIC_API_KEY} }, secondary: { provider: anthropic, model: claude-3-5-haiku-latest, apiKey: ${ANTHROPIC_API_KEY} }, routing: { simple_patterns: [翻译, 格式化, 总结, 分类], simple_model: secondary, default_model: primary }, costOptimization: { enabled: true, expectedSavings: 75% } } }方案二Fallback 链生产必备当使用模型出现问题自动去找备用模型最后用deepseek兜底llm: { fallbackChain: [{ provider: anthropic, model: claude-4-6-sonnet-latest, priority: 1, conditions: default }, { provider: openai, model: gpt-5.4-pro, priority: 2, conditions: on_error|on_rate_limit }, { provider: deepseek, model: deepseek-chat, priority: 3, conditions: on_error|cost_limit_exceeded } ] }方案三国产混合最优方案推荐主力用deepseek视觉相关用gpthaiku用来校对{ models: { primary: { provider: openai-compatible, baseURL: https://api.deepseek.com/v1, apiKey: ${DEEPSEEK_API_KEY}, model: deepseek-chat }, vision: { provider: openai, model: gpt-5.4-vision-preview, apiKey: ${OPENAI_API_KEY} }, fast: { provider: anthropic, model: claude-3-5-haiku-latest, apiKey: ${ANTHROPIC_API_KEY} } } }预算控制每日5-10美元的上限{ llm: { costLimit: { daily_usd: 10, monthly_usd: 100, action: halt } } }七、干净卸载官方卸载命令openclaw uninstall --all --yesuninstall执行核心卸载程序--all连同服务与本地数据一起清理网关服务、配置文件、数据库等--yes自动确认操作跳过中途的手动Y确认高风险操作提醒该命令会直接删除所有工作区数据(如Markdown笔记)且不可恢复。若有重要文件请务必在执行前进行备份!删除CLI工具NPM全局卸载npm rm-g openclawPNPM全局卸载pnpm remove -g openclawBUN全局卸载bun remove -g openclaw验证卸载结果执行openclaw,若提示“命令未找到”(command not found),说明清理成功。预演与确认(Dry Run)交互式预演openclaw uninstal1--dry-run在2026.3.8版本中进入交互式选择界面。你可以手动勾选想要卸载的内容直观查看影响范围。清单直出预演openclaw uninstall--al1--yes --non-interactive --dry-ru跳过交互界面直接打印出当前版本准备删除的所有文件和配置清单适合快速核对或在脚本中作为检查步骤。安全确认建议确认是否备份了工作区笔记检查是否有自定义配置文件需保留核对预演清单中的关键路云端环境清理释放云端服务器资源作废旧密钥重启与收尾必须执行重启电脑Mac专属自启清理macOS若曾配置launchd开机自启请务必移除~/Library/LaunchAgents下的相关.plist配置文件避免后台进入“阴魂不散”二次检查确认终端无openclaw命令、本地数据目录已删除、云端资源与密钥均已作废。八、第一次对话第一步用命令行把脉--系统健康诊断与网关管理输入openclaw doctor启动全方位体检覆盖环境依赖与网络连通性。确认关键指标显示为全绿OK,若有红叉请根据错误提示修复。使用openclaw gateway start启动服务并通过status确认运行状态。常见故障排查升级Node.js版本(22)、检查防火墙或重置API Key。单独查看网关状态openclaw gateway status网关关闭openclaw gateway stop网关启动openclaw gateway start第二步打开Web UI与认证配置--bashboard访问与安全认证(端口18789)访问管理仪表盘启动Gateway后OpenClaw会自动监听默认端口18789。使用以下命令可快速唤起管理界面openclaw dashboardWeb UI是您的控制面板支持查看会话状态、实时日志流、模型参数配置及Token用量统计让AI工作状态一目了然。第三步发起第一次对话测试命令示例“你好请介绍一下你自己”,在Web UI或IM渠道发送验证Gateway路由正常消息准确分发至对应Agent确认模型API调用成功Token计费与返回正常记忆系统初始化完成自动读取并写入会话日志日志默认路径/.openclaw/logs/或通过Web UI实时查看。未来想要优化龙虾都可以在这儿找可以根据trace定位访问常见错误码401 Unauthorized:API Key无效或过期请检查配置429 Too Many Requests:触发模型速率限制建议增加重试退避。Network Error:网关无法连接模型服务检查本地代理。Connection Refused:守护进程未启动。
