最近总有读者问我OpenClaw 到底怎么装网上教程东一句西一句有的讲模型配置有的讲飞书机器人但很少有人把“环境准备 → 本体安装 → 模型接入 → 办公平台接入 → 报错排查”这条线完整串起来。尤其是社区流传的“小龙虾 OpenClaw”整合版下载下来之后连初始化步骤都不一样第一次接触的人很容易卡在启动向导里。这篇文章就按我自己落地 OpenClaw 的完整路径来写。顺序做了严格划分先准备环境再安装本体然后接大模型 API最后接入飞书、钉钉、企业微信、QQ、小红书等平台。全程会带可复制的命令、配置示例和常见报错排查。无论你是在 Windows 本机跑还是在 Linux 服务器上部署这套思路都能直接复用。1. OpenClaw 是什么为什么大家都在装1.1 先给一个通俗解释OpenClaw 本质上是一个 AI 代理运行框架或者说是一个“带手带脚的聊天机器人”。普通的聊天机器人比如你在网页里打开的对话框只能根据你的问题生成文本回复。而 OpenClaw 这类 Agent 工具能进一步使用电脑、调用命令、读写文件、执行任务。你可以告诉它“帮我把工作目录下的 csv 文件汇总成 Excel”它不只是给你一段 Python 代码而是在本地环境中真去创建文件、运行脚本最后告诉你结果。当你把它接入飞书、钉钉、企业微信之后OpenClaw 就不再只是开发者本机的一个命令行工具而会变成一个“群里的智能助手”。同事在群里艾特机器人机器人可以查数据、写周报、执行自动化流程。1.2 它解决什么问题安装 OpenClaw 之前先想清楚它要解决什么问题。社区常见的使用方向有三个个人效率助手管理本地文件、批量重命名、整理 Markdown 笔记、操作 Git 仓库。IM 群机器人把知识库问答、日报汇总、数据查询能力接入飞书/钉钉/企微。自动化工作流结合定时任务让 Agent 每天自动抓取信息、生成报告、发送到群里。如果你只是想要一个网页版聊天助手直接用大模型厂商的网页端就行不必折腾安装。OpenClaw 的价值是“Agent 能真正执行操作”而不是只做文本生成。你要接受它有环境依赖、有审批机制、有配置复杂度这些是我们下文要逐个解决的内容。1.3 “小龙虾 OpenClaw”是独立软件吗标题里出现了“小龙虾 OpenClaw”。很多读者会疑惑OpenClaw 是不是还有另一个叫“小龙虾”的发行版更合理的理解是所谓小龙虾版通常是社区或个人整理的整合包比如“一键部署脚本 常见模型配置 常用 skills 技能包”放在一起方便新手安装。底层核心仍然是 OpenClaw文件目录也仍然是~/.openclaw下的配置与工作区。所以在安装时先别急着找“最强版”“最新版”。版本之间会有差异但通用思路是一致的。甚至可以说越是花哨的整合包越要在安装后自己检查一遍配置内容避免安装了来路不明的脚本。1.4 OpenClaw 官方版、整合包与商业脚本的区别现在网络上搜索 OpenClaw 安装能看到三类来源官方渠道发布的安装包/脚本。社区作者维护的整合包比如“一键部署工具”“小龙虾版”。付费代部署服务或“终身会员”类推广。我建议优先选择官方渠道或你信任的社区方案。技术类工具的价值在于可控、可维护。如果你通过代部署工具完成安装至少要把配置目录、启动方式、日志位置全部搞清楚否则后续一旦报错还是需要自己排查别人不会长期帮你维护。2. 安装前的环境准备与版本确认OpenClaw 不是单一的可执行文件它会依赖 Python、Git、Node.js 等基础环境。很多人安装失败问题往往不在 OpenClaw 本身而是基础环境缺失或版本太老。下面按 Windows 和 Linux 两条线准备。2.1 准备 GitGit 的作用有两类一是部分安装方式需要从仓库拉取源码二是 OpenClaw 在操作 Git 项目时也需要本机存在 Git。Windows 下如果已经装了 winget可以直接执行winget install --id Git.Git -e安装完成后重新打开终端验证。git --version如果能输出版本号例如git version 2.40.1.windows.1说明 Git 可用。Linux 下使用包管理器安装sudo apt update sudo apt install -y gitCentOS/RHEL 系使用 yumsudo yum install -y git2.2 准备 PythonOpenClaw 的很多工具链、脚本插件依赖 Python。重点不是版本越高越好而是依赖库能正常运行。建议安装 Python 3.10 以上版本但不要安装过低也不要直接装还在测试阶段的 3.14 等版本以免部分依赖库尚未适配。访问 Python 官网下载 Windows 安装包时有个关键步骤一定勾选“Add Python to PATH”。很多同学安装完运行python --version提示找不到命令就是因为没有勾选。安装完成后验证python --version pip --versionLinux 下常见发行版自带的 Python 版本可能较老。你可以通过源码编译或使用包管理器安装较新版本例如 Ubuntu 上可以用 deadsnakes PPA 安装 Python 3.11。生产环境更推荐用 pyenv 管理 Python 多版本避免系统自带 Python 被污染。2.3 准备 Node.js 与 npmOpenClaw 的不少集成工具是用 Node.js 写的尤其是对接 IM 平台时的回调服务、WebSocket 长连接服务。即使当前版本不强制要求我也建议提前安装一个 LTS 版本。Windows 下可以用winget install OpenJS.NodeJS.LTS验证命令node -v npm -v如果输出类似v20.11.0和10.2.4说明环境正常。Linux 下建议使用 nvm 安装 Node.js便于以后切换版本curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install --lts node -v注意上面使用了 GitHub 的安装脚本。如果你的服务器访问 GitHub 不稳定安装可能失败。这种情况下不要使用绕过手段可以换用服务器厂商提供的软件源或者直接在 Node 官网下载 tar.gz 包手动解压并配置 PATH。2.4 Windows PowerShell 执行策略调整OpenClaw 在 Windows 下经常需要通过 PowerShell 执行安装脚本。默认情况下Windows 可能禁止运行脚本报错信息类似无法加载文件 ...因为在此系统上禁止运行脚本。此时需要调整当前用户的执行策略。以管理员身份打开 PowerShellSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserRemoteSigned 的含义是本地编写的脚本可以运行从网络下载的脚本必须带有可信签名。这样比直接设置 Unrestricted 更安全。验证Get-ExecutionPolicy输出RemoteSigned即可。2.5 验证环境总览做完上面的安装后把下面命令复制到终端确认环境正常echo Git git --version echo Python python --version echo pip pip --version echo Node node -v echo npm npm -v这一步不要跳过。很多 OpenClaw 初始化失败最后定位到的是 npm 没装或 PATH 没配好。基础环境统一了后续问题会少很多。3. OpenClaw 本体安装与初始化3.1 安装包的获取思路不同渠道提供的 OpenClaw 安装方式差异较大。有的提供一条命令的自动化安装脚本有的提供独立二进制压缩包有的则是源码启动。以最常见的“二进制压缩包”为例假设你下载的是openclaw-linux-x64.tar.gz解压并加入 PATH 的方式如下tar -zxvf openclaw-linux-x64.tar.gz sudo mv openclaw /usr/local/bin/ openclaw --versionWindows 下如果拿到的是压缩包可以通过 PowerShell 解压Expand-Archive -Path .\openclaw-windows-x64.zip -DestinationPath C:\tools\openclaw $env:Path ;C:\tools\openclaw这里$env:Path的修改只在当前终端生效。想永久生效需要去系统环境变量里把C:\tools\openclaw加入 PATH。如果你使用的是自动安装脚本建议先看一下脚本内容再执行尤其是需要 root 权限的脚本。对外提供的安装脚本本身就是供应链攻击的高发点投入一分钟看脚本成本非常低。安装完成后运行版本命令确认程序能启动。如果版本命令都不能输出版本号先不要继续优先排查 PATH 和环境变量问题。3.2 首次初始化与工作区目录启动 OpenClaw 时它会在用户主目录下创建配置文件目录。Windows 下常见路径是C:\Users\Administrator\.openclawLinux 下是/root/.openclaw目录里有两个需要重点理解的内容workspaceAgent 的工作区。OpenClaw 读写文件时会被限制在这个目录内避免它在整个电脑上乱跑。exec-approvals.json历史命令执行授权记录类似一个“白名单”。首次启动时你可能会在终端看到类似下面的路径提示workspace: c:\users\administrator\.openclaw\workspace add AI later:这说明 OpenClaw 已经准备好一个工作区并且询问你是否现在添加大模型。如果你还没准备好 API Key可以选择add AI later以后补配模型。这里要特别提醒不要删除.openclaw目录来“重置”程序。删除后虽然能回到初始状态但也会丢掉所有授权记录、自定义配置和 skills。重置前先把关键配置备份出来。3.3 exec-approvals.json 与命令审批机制OpenClaw 在执行系统命令时出于安全考虑不会所有命令都直接执行。首次运行某个命令前它会要求你确认是否允许。你在终端里确认后批准记录可能会被写入/root/.openclaw/exec-approvals.json如果你启动时看到类似提示legacy exec approvals exist at /root/.openclaw/exec-approvals.json. run ope...意思是检测到了旧版本留下的命令授权记录。此时不要盲目删除该文件。先备份再按提示查看内容。这个 JSON 文件里存储的是“哪些命令被允许执行”的规则如果里面记录了敏感命令的可执行权限你应该手动检查。按照最小权限原则建议不要对所有命令一概放行。尤其是rm -rf、curl | bash、直接写入/etc的操作应该每次确认或干脆禁止。3.4 关于 skills 与后续扩展OpenClaw 社区里经常提到 skill。简单理解skill 是给 Agent 预置的“技能包”。比如你希望它擅长整理 Obsidian 笔记就给挂一个 Obsidian 项目管理的 skill你希望它能对接内部数据就给写对应的提示词和工具调用模板。先不用急着装一堆 skill。第一次初始化时保持最小配置等模型接入通过、基础对话正常后再逐步增加 skills。否则一旦出问题很难判断是模型配置错误还是某个 skill 影响了行为。4. 配置模型 API以 DeepSeek 为例OpenClaw 本身没有“智力”它需要调用一个大模型来理解任务和生成回复。所以安装 OpenClaw 后最重要的一步是配置模型 API。4.1 模型 API 配置的核心要素无论你用的是 OpenAI、DeepSeek 还是其他兼容 OpenAI 接口的服务通常都需要配置四个信息API 地址也就是基础 URL。API Key用来鉴权。模型名称比如deepseek-chat。请求参数例如温度、最大 token 数等。配置通常有两种方式写入配置文件或者通过环境变量传入。使用环境变量更有利于保护密钥避免不小心把配置分享出去。下面是一个常见的大模型配置示意model: provider: deepseek name: deepseek-chat api_key: sk-xxxxxxxx base_url: https://api.deepseek.com temperature: 0.7不同版本的 OpenClaw 可能使用 JSON 或命令行参数传配置字段名也可能有差异。上面的 YAML 片段是用来帮助你理解配置结构实际使用时请以你安装版本给出的默认配置模板为准。4.2 获取 DeepSeek API Key去 DeepSeek 开放平台注册账号进入 API Keys 管理页面创建一个新的 API Key。API Key 是一串以sk-开头的密钥。它等同于密码请保存在安全的位置不要直接写到会被提交到 Git 的代码里。创建完成后先用 curl 验证 API Key 是否可用。DeepSeek 兼容 OpenAI 接口请求示例如下curl https://api.deepseek.com/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的APIKey \ -d { model: deepseek-chat, messages: [{role: user, content: 你好请回复验证成功}] }如果返回内容中有choices字段说明 API Key 和模型名称都没有问题。如果返回 401就是 API Key 错误如果提示 model 不存在那就是模型名称写错了。4.3 典型报错unknown model: deepseek很多读者在配置时把模型名称直接写成了deepseek启动 Agent 后报错agent failed before reply: unknown model: deepseek这个报错的含义是API 服务不认识deepseek这个模型 ID。DeepSeek 实际可用的模型名称常见是两个deepseek-chat通用对话模型。deepseek-reasoner推理模型适合复杂逻辑问题。所以要解决的通常不是 API Key 有问题而是把配置里的模型名称从deepseek改成deepseek-chat。修改完配置后重启 OpenClaw或者在配置热加载后重新发起一次对话。看到正常回复再进入 IM 平台接入避免把模型问题和平台接入问题混在一起排查。4.4 零 token 安装后 Agent 启动失败怎么处理如果你选择了创建新配置但暂时没有填写 token启动 Agent 时也可能出现类似agent failed before reply这是因为 OpenClaw 没有拿到模型 API Key。此时要回到模型配置页面确认以下信息是否齐全API Key 非空。模型名称正确。网络可以访问模型 API。在接入飞书、钉钉之前请先确保在 OpenClaw 的本地对话界面里能正常问答。基础对话通了后面接入 IM 才不容易踩坑。5. 飞书、钉钉、企业微信、QQ、小红书接入指南5.1 平台接入的整体逻辑很多人以为“接入飞书”是在 OpenClaw 里填一个 webhook 地址就行。实际上消息的收发分两条路径发送消息像群机器人发通知使用 Webhook 或应用 API。接收消息平台把用户发给机器人的消息推送给 OpenClaw需要回调地址或长连接。只发不收非常简单OpenClaw 无法变成能对话的群助手。完整的接入流程通常包含几大步骤在平台开放后台创建应用/机器人。申请消息收发权限。配置接收消息的方式。把凭证配置到 OpenClaw 对应渠道。做好网络与白名单配置。测试双向消息。下面分别说明五大平台的要点。由于各平台策略可能调整具体字段名称以创建后台页面显示为准。5.2 飞书接入飞书是企业 IM 里接入体验较好的平台之一企业自建应用支持机器人能力和事件订阅机制。整体步骤如下进入飞书开放平台创建“企业自建应用”。在应用能力中开启“机器人”。在权限管理里申请接收消息和发送消息的权限。在事件订阅中配置请求地址或使用长连接模式接收事件。发布应用版本等待管理员审核。飞书消息相关权限的命名通常是im:message、im:message:send_as_bot事件通常包含im.message.receive_v1。如果你没有公网服务器接收消息时优先考虑长连接模式。OpenClaw 所在进程与飞书服务器保持 WebSocket 连接不需要你提供 HTTPS 回调地址。这能省掉很多内网穿透和域名备案的麻烦。拿到凭证后在 OpenClaw 的 channel 配置中填入应用凭证。之后先在飞书里找到机器人私聊发送“你好”观察 OpenClaw 日志是否输出一条收到消息的记录。日志有记录但没回复优先查模型 API 配置日志没有记录优先查事件订阅是否生效。5.3 钉钉接入钉钉有两种常见接入方式一种是企业内部应用机器人另一种是自定义机器人。自定义机器人配置最简单适合“只发送通知”的场景。在钉钉群里添加自定义机器人后你会获得一个 Webhook 地址形如https://oapi.dingtalk.com/robot/send?access_token你的token用 curl 测试群机器人通知curl -X POST https://oapi.dingtalk.com/robot/send?access_token你的token \ -H Content-Type: application/json \ -d {msgtype:text,text:{content:OpenClaw 接入测试}}自定义机器人只能往群里发消息不能接收群成员对话。要让 OpenClaw 真正应答群里消息需要创建企业内部应用机器人开启消息接收模式。钉钉企业内部应用的凭证是 Client ID原 AppKey和 Client Secret。新版钉钉开放平台推荐使用 Stream 模式推送消息和飞书的长连接类似可以避免暴露公网回调地址。配置完成后同样遵循“先本地对话通过再群里测试”的原则。5.4 企业微信接入企业微信接入自建应用是常见的办公场景。需要准备三样核心信息企业 IDCorp ID应用 Agent ID应用 Secret登录企业微信管理后台进入“应用管理 → 自建应用”创建应用后可以拿到 Agent ID并设置 Secret。企业微信机器人接收消息时需要配置“接收消息服务器”。这个服务器要能处理企业微信发来的 URL 验证请求并正确解密加密消息。OpenClaw 如果想要完整接入通常需要依赖一个接收回调的服务。如果没有公网环境更接地气的做法是先用企业微信群机器人 Webhook让 OpenClaw 向群里推送报告。Webhook 地址形如https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key你的key先用 curl 验证是否打通curl -X POST https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key你的key \ -H Content-Type: application/json \ -d {msgtype:text,text:{content:OpenClaw 消息推送正常}}当你确认 Webhook 地址没问题后再考虑是否实现回调接收。企业微信对回调服务器的 IP 有可信域名校验需要在管理后台配置可信 IP 或可信域名部署时注意不要把服务器 IP 配错。5.5 QQ 接入QQ 侧的接入相对特殊通常需要 QQ 开放平台注册机器人能力。个人开发者是否能注册、审核材料要哪些都会随平台政策变化。实际操作前先查看最新的官方开放平台文档不要轻信第三方“必须购买会员才能接入”的说法。接入流程同样遵循创建机器人 → 获取 App ID / Token → 配置沙箱环境 → 在沙箱里测试收发消息。QQ 机器人在未上线前一般在沙箱频道或测试群中运行收到“没有权限”或“无法发送”的错误时先检查是否处于测试范围。QQ 群的自动化发言有严格频率和内容限制。不建议设置高风险关键词更不建议用于批量私聊、自动加人等场景。合规是第一前提。5.6 小红书接入小红书是内容社区不是纯粹的 IM 工具。普通个人开发者直接“接入小红书”做自动化回复需要评估合规风险。官方目前提供的开放能力有限主要用于企业号、专业号等场景。如果你想在小红书做客服自动回复或私信触达请先确认你拥有小红书专业号或企业号权限并使用官方开放平台提供的能力。未经授权的自动化脚本批量私信、批量发布轻则限流重则封号。因此OpenClaw 接入小红书前先回答三个问题你是否有官方开放平台的开发者权限你的场景是否属于官方允许的客服/自动回复类目是否已经配置了免责声明或用户授权机制如果三个问题里有一个不确定就先不要接。5.7 平台接入后的验收清单接入任何一个平台后建议按下面清单验收检查项预期结果私聊机器人能收到消息并回复群聊艾特机器人能正确识别并回复长消息不丢消息不重复回复OpenClaw 进程重启后平台连接能自动恢复机器人主动推送目标群/用户能收到日志记录能看到收消息和发消息的日志不要接好一个平台后立刻接入所有平台。先把一个渠道调通并观察一天稳定性再扩展下一个。6. 常见报错与排查思路6.1 报错排查通用顺序遇到 OpenClaw 报错先不要急着重装。按下面顺序排查确认基础环境变量正确Git、Python、Node 都能运行。查看 OpenClaw 配置文件里模型名称和 API Key 是否正确。使用 curl 验证大模型 API。查看 OpenClaw 日志路径。检查平台回调或长连接是否正常。很多问题最后都出在“API Key 填错”“模型名写错”“回调地址没上线”这三个地方。6.2 OpenClaw 常见问题速查表下面整理了一份高频问题表读者可以直接对照排查问题现象常见原因解决思路OpenClaw 命令找不到未加入 PATH 或未重开终端将安装目录加入 PATH 后重开终端启动时报add AI later后无法对话尚未配置模型 API选择配置 AI填入 API Key 与模型名unknown model: deepseek模型名称写错改为deepseek-chat或deepseek-reasoneragent failed before reply模型 API Key 缺失或 API 不可达用 curl 验证 API查看状态码提示无法加载 PowerShell 脚本执行策略限制调整执行策略为 RemoteSigned飞书接收不到消息事件订阅未配置或版本未发布检查长连接/回调配置确认应用版本已发布钉钉群机器人只能发不能收使用了自定义机器人改用企业内部应用机器人并开启消息接收企微回调验证失败Token/EncodingAESKey 配置错误核对后台配置确认服务器 URL 可访问目录里出现 legacy exec approvals旧版本授权记录备份后查看记录按需清理不盲目删除Agent 修改了不该改的文件workspace 权限过大收紧工作区限制命令审批规则6.3 API 连通性验证是万能的定心丸很多同学遇到模型报错习惯性把错误截图发到群里问人。其实最有效的一步是自己先用 curl 或 Python 脚本直接调用模型 API。下面是一个不依赖 OpenClaw 的验证脚本import requests url https://api.deepseek.com/chat/completions payload { model: deepseek-chat, messages: [ {role: user, content: 你好} ] } headers { Authorization: Bearer sk-你的APIKey, Content-Type: application/json } resp requests.post(url, jsonpayload, headersheaders, timeout30) print(resp.status_code) print(resp.text)如果这个脚本能成功返回说明 API Key、模型名、网络链路都没问题问题一定出在 OpenClaw 的配置调用上。如果脚本本身失败OpenClaw 配置再正确也没用。7. 生产环境落地与工程建议7.1 配置管理与密钥安全OpenClaw 的配置里包含 API Key、平台 Secret属于高敏感信息。建议不要把密钥硬编码在配置文件中提交到 Git。使用.env文件管理环境变量并在.gitignore中忽略。如果团队协作使用密钥管理服务或 CI 的 Secret 能力注入。定期更换疑似泄露的 API Key。比如在你的 OpenClaw 工作目录里可以用.env保存密钥而示例配置通过config.example.yaml管理。7.2 命令审批与最小权限原则OpenClaw 的本地执行能力很强这意味着安全边界非常关键。你需要做到不在 root 用户下长期运行除非确实需要低层级操作。仔细检查exec-approvals.json中的已批准命令。禁止 OpenClaw 执行高危险命令例如强制删除根目录、直接覆盖系统配置。当你给 Agent 下发任务时尽量把工作限定在workspace目录内。如果多人共用一台服务器不要共用同一个.openclaw目录。每个系统用户维护自己独立的 Agent 配置权限边界更清晰。7.3 进程守护与日志OpenClaw 接入 IM 平台后需要 7x24 小时在线。直接在前台运行显然不行。如果是 Linux 服务器可以用 systemd 管理也可以用进程守护工具。下面是 systemd 服务的简化思路[Unit] DescriptionOpenClaw Service Afternetwork.target [Service] Useryouruser WorkingDirectory/home/youruser ExecStart/usr/local/bin/openclaw serve Restartalways RestartSec10 EnvironmentFile/home/youruser/.openclaw/openclaw.env [Install] WantedBymulti-user.target具体启动命令要以 OpenClaw 实际支持的 serve 或 run 类命令为准。如果没有这类命令就直接守护你平时手动启动的那个命令。使用 systemd 后sudo systemctl daemon-reload sudo systemctl enable openclaw sudo systemctl start openclaw journalctl -u openclaw -f这样才能看到完整日志。后续排查报错日志是第一手资料不要只看终端滚动输出。7.4 网络与平台回调接入飞书、钉钉、企业微信时如果使用回调地址方式必须保证你的服务器拥有公网可达的 HTTPS 地址并且回调路径能正常响应平台的签名验证请求。如果暂时没有公网地址和域名推荐以下几种方案优先使用长连接/Stream 模式接收消息。在隔离测试网络里验证消息格式再迁移到生产服务器。上线前做好超时处理防止平台重试机制把服务打崩。7.5 定时任务与自动化提醒OpenClaw 接入 IM 后最有价值的使用方式是定时任务。比如每天早上 10 点从某个数据源拉取信息生成摘要后发到企微群。但这类需求不要一开始就做成高复杂度的流水线而是分阶段先写一个可以手动触发的任务验证能拿到数据、能格式化、能发到目标群。再手动改成定时触发观察一周消息质量。最后加入失败告警机制。定时任务失败时至少要有日志能追溯。否则 Agent 某天静默失败群里没人察觉到数据异常就失去了自动化意义。8. 建议的动手路线如果你现在还处于“刚能打开终端”的阶段不需要一口气把五六个平台全部接入。我的建议是走下面这条最稳的路线先准备 Git、Python、Node 环境用版本命令确认全部可用。安装 OpenClaw完成首次初始化理解.openclaw目录结构。申请一个 DeepSeek API Key使用 curl 验证通过。把 DeepSeek 模型接入 OpenClaw在本地完成一次多轮对话。选择一个平台优先推荐飞书或钉钉创建测试群接入机器人。在群里测试私聊和群聊场景观察日志至少半天。稳定后再考虑接入第二个平台或增加定时任务。这套路线能让你清楚地知道每一步失败了该去哪里排查。OpenClaw 的坑大多不是“装不上”而是“不知道自己装到了哪一步”。把安装过程拆成一个个可验证的小环节比看十倍教程都管用。安装过程中如果遇到新的报错先看三件事模型 API 能不能 ping 通、OpenClaw 当前目录权限是否正常、平台后台的机器人配置是否已经发布生效。大多数问题都藏在这三件事里。 OpenClaw安装全攻略：环境准备、模型接入与IM机器人部署
最近总有读者问我OpenClaw 到底怎么装网上教程东一句西一句有的讲模型配置有的讲飞书机器人但很少有人把“环境准备 → 本体安装 → 模型接入 → 办公平台接入 → 报错排查”这条线完整串起来。尤其是社区流传的“小龙虾 OpenClaw”整合版下载下来之后连初始化步骤都不一样第一次接触的人很容易卡在启动向导里。这篇文章就按我自己落地 OpenClaw 的完整路径来写。顺序做了严格划分先准备环境再安装本体然后接大模型 API最后接入飞书、钉钉、企业微信、QQ、小红书等平台。全程会带可复制的命令、配置示例和常见报错排查。无论你是在 Windows 本机跑还是在 Linux 服务器上部署这套思路都能直接复用。1. OpenClaw 是什么为什么大家都在装1.1 先给一个通俗解释OpenClaw 本质上是一个 AI 代理运行框架或者说是一个“带手带脚的聊天机器人”。普通的聊天机器人比如你在网页里打开的对话框只能根据你的问题生成文本回复。而 OpenClaw 这类 Agent 工具能进一步使用电脑、调用命令、读写文件、执行任务。你可以告诉它“帮我把工作目录下的 csv 文件汇总成 Excel”它不只是给你一段 Python 代码而是在本地环境中真去创建文件、运行脚本最后告诉你结果。当你把它接入飞书、钉钉、企业微信之后OpenClaw 就不再只是开发者本机的一个命令行工具而会变成一个“群里的智能助手”。同事在群里艾特机器人机器人可以查数据、写周报、执行自动化流程。1.2 它解决什么问题安装 OpenClaw 之前先想清楚它要解决什么问题。社区常见的使用方向有三个个人效率助手管理本地文件、批量重命名、整理 Markdown 笔记、操作 Git 仓库。IM 群机器人把知识库问答、日报汇总、数据查询能力接入飞书/钉钉/企微。自动化工作流结合定时任务让 Agent 每天自动抓取信息、生成报告、发送到群里。如果你只是想要一个网页版聊天助手直接用大模型厂商的网页端就行不必折腾安装。OpenClaw 的价值是“Agent 能真正执行操作”而不是只做文本生成。你要接受它有环境依赖、有审批机制、有配置复杂度这些是我们下文要逐个解决的内容。1.3 “小龙虾 OpenClaw”是独立软件吗标题里出现了“小龙虾 OpenClaw”。很多读者会疑惑OpenClaw 是不是还有另一个叫“小龙虾”的发行版更合理的理解是所谓小龙虾版通常是社区或个人整理的整合包比如“一键部署脚本 常见模型配置 常用 skills 技能包”放在一起方便新手安装。底层核心仍然是 OpenClaw文件目录也仍然是~/.openclaw下的配置与工作区。所以在安装时先别急着找“最强版”“最新版”。版本之间会有差异但通用思路是一致的。甚至可以说越是花哨的整合包越要在安装后自己检查一遍配置内容避免安装了来路不明的脚本。1.4 OpenClaw 官方版、整合包与商业脚本的区别现在网络上搜索 OpenClaw 安装能看到三类来源官方渠道发布的安装包/脚本。社区作者维护的整合包比如“一键部署工具”“小龙虾版”。付费代部署服务或“终身会员”类推广。我建议优先选择官方渠道或你信任的社区方案。技术类工具的价值在于可控、可维护。如果你通过代部署工具完成安装至少要把配置目录、启动方式、日志位置全部搞清楚否则后续一旦报错还是需要自己排查别人不会长期帮你维护。2. 安装前的环境准备与版本确认OpenClaw 不是单一的可执行文件它会依赖 Python、Git、Node.js 等基础环境。很多人安装失败问题往往不在 OpenClaw 本身而是基础环境缺失或版本太老。下面按 Windows 和 Linux 两条线准备。2.1 准备 GitGit 的作用有两类一是部分安装方式需要从仓库拉取源码二是 OpenClaw 在操作 Git 项目时也需要本机存在 Git。Windows 下如果已经装了 winget可以直接执行winget install --id Git.Git -e安装完成后重新打开终端验证。git --version如果能输出版本号例如git version 2.40.1.windows.1说明 Git 可用。Linux 下使用包管理器安装sudo apt update sudo apt install -y gitCentOS/RHEL 系使用 yumsudo yum install -y git2.2 准备 PythonOpenClaw 的很多工具链、脚本插件依赖 Python。重点不是版本越高越好而是依赖库能正常运行。建议安装 Python 3.10 以上版本但不要安装过低也不要直接装还在测试阶段的 3.14 等版本以免部分依赖库尚未适配。访问 Python 官网下载 Windows 安装包时有个关键步骤一定勾选“Add Python to PATH”。很多同学安装完运行python --version提示找不到命令就是因为没有勾选。安装完成后验证python --version pip --versionLinux 下常见发行版自带的 Python 版本可能较老。你可以通过源码编译或使用包管理器安装较新版本例如 Ubuntu 上可以用 deadsnakes PPA 安装 Python 3.11。生产环境更推荐用 pyenv 管理 Python 多版本避免系统自带 Python 被污染。2.3 准备 Node.js 与 npmOpenClaw 的不少集成工具是用 Node.js 写的尤其是对接 IM 平台时的回调服务、WebSocket 长连接服务。即使当前版本不强制要求我也建议提前安装一个 LTS 版本。Windows 下可以用winget install OpenJS.NodeJS.LTS验证命令node -v npm -v如果输出类似v20.11.0和10.2.4说明环境正常。Linux 下建议使用 nvm 安装 Node.js便于以后切换版本curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install --lts node -v注意上面使用了 GitHub 的安装脚本。如果你的服务器访问 GitHub 不稳定安装可能失败。这种情况下不要使用绕过手段可以换用服务器厂商提供的软件源或者直接在 Node 官网下载 tar.gz 包手动解压并配置 PATH。2.4 Windows PowerShell 执行策略调整OpenClaw 在 Windows 下经常需要通过 PowerShell 执行安装脚本。默认情况下Windows 可能禁止运行脚本报错信息类似无法加载文件 ...因为在此系统上禁止运行脚本。此时需要调整当前用户的执行策略。以管理员身份打开 PowerShellSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserRemoteSigned 的含义是本地编写的脚本可以运行从网络下载的脚本必须带有可信签名。这样比直接设置 Unrestricted 更安全。验证Get-ExecutionPolicy输出RemoteSigned即可。2.5 验证环境总览做完上面的安装后把下面命令复制到终端确认环境正常echo Git git --version echo Python python --version echo pip pip --version echo Node node -v echo npm npm -v这一步不要跳过。很多 OpenClaw 初始化失败最后定位到的是 npm 没装或 PATH 没配好。基础环境统一了后续问题会少很多。3. OpenClaw 本体安装与初始化3.1 安装包的获取思路不同渠道提供的 OpenClaw 安装方式差异较大。有的提供一条命令的自动化安装脚本有的提供独立二进制压缩包有的则是源码启动。以最常见的“二进制压缩包”为例假设你下载的是openclaw-linux-x64.tar.gz解压并加入 PATH 的方式如下tar -zxvf openclaw-linux-x64.tar.gz sudo mv openclaw /usr/local/bin/ openclaw --versionWindows 下如果拿到的是压缩包可以通过 PowerShell 解压Expand-Archive -Path .\openclaw-windows-x64.zip -DestinationPath C:\tools\openclaw $env:Path ;C:\tools\openclaw这里$env:Path的修改只在当前终端生效。想永久生效需要去系统环境变量里把C:\tools\openclaw加入 PATH。如果你使用的是自动安装脚本建议先看一下脚本内容再执行尤其是需要 root 权限的脚本。对外提供的安装脚本本身就是供应链攻击的高发点投入一分钟看脚本成本非常低。安装完成后运行版本命令确认程序能启动。如果版本命令都不能输出版本号先不要继续优先排查 PATH 和环境变量问题。3.2 首次初始化与工作区目录启动 OpenClaw 时它会在用户主目录下创建配置文件目录。Windows 下常见路径是C:\Users\Administrator\.openclawLinux 下是/root/.openclaw目录里有两个需要重点理解的内容workspaceAgent 的工作区。OpenClaw 读写文件时会被限制在这个目录内避免它在整个电脑上乱跑。exec-approvals.json历史命令执行授权记录类似一个“白名单”。首次启动时你可能会在终端看到类似下面的路径提示workspace: c:\users\administrator\.openclaw\workspace add AI later:这说明 OpenClaw 已经准备好一个工作区并且询问你是否现在添加大模型。如果你还没准备好 API Key可以选择add AI later以后补配模型。这里要特别提醒不要删除.openclaw目录来“重置”程序。删除后虽然能回到初始状态但也会丢掉所有授权记录、自定义配置和 skills。重置前先把关键配置备份出来。3.3 exec-approvals.json 与命令审批机制OpenClaw 在执行系统命令时出于安全考虑不会所有命令都直接执行。首次运行某个命令前它会要求你确认是否允许。你在终端里确认后批准记录可能会被写入/root/.openclaw/exec-approvals.json如果你启动时看到类似提示legacy exec approvals exist at /root/.openclaw/exec-approvals.json. run ope...意思是检测到了旧版本留下的命令授权记录。此时不要盲目删除该文件。先备份再按提示查看内容。这个 JSON 文件里存储的是“哪些命令被允许执行”的规则如果里面记录了敏感命令的可执行权限你应该手动检查。按照最小权限原则建议不要对所有命令一概放行。尤其是rm -rf、curl | bash、直接写入/etc的操作应该每次确认或干脆禁止。3.4 关于 skills 与后续扩展OpenClaw 社区里经常提到 skill。简单理解skill 是给 Agent 预置的“技能包”。比如你希望它擅长整理 Obsidian 笔记就给挂一个 Obsidian 项目管理的 skill你希望它能对接内部数据就给写对应的提示词和工具调用模板。先不用急着装一堆 skill。第一次初始化时保持最小配置等模型接入通过、基础对话正常后再逐步增加 skills。否则一旦出问题很难判断是模型配置错误还是某个 skill 影响了行为。4. 配置模型 API以 DeepSeek 为例OpenClaw 本身没有“智力”它需要调用一个大模型来理解任务和生成回复。所以安装 OpenClaw 后最重要的一步是配置模型 API。4.1 模型 API 配置的核心要素无论你用的是 OpenAI、DeepSeek 还是其他兼容 OpenAI 接口的服务通常都需要配置四个信息API 地址也就是基础 URL。API Key用来鉴权。模型名称比如deepseek-chat。请求参数例如温度、最大 token 数等。配置通常有两种方式写入配置文件或者通过环境变量传入。使用环境变量更有利于保护密钥避免不小心把配置分享出去。下面是一个常见的大模型配置示意model: provider: deepseek name: deepseek-chat api_key: sk-xxxxxxxx base_url: https://api.deepseek.com temperature: 0.7不同版本的 OpenClaw 可能使用 JSON 或命令行参数传配置字段名也可能有差异。上面的 YAML 片段是用来帮助你理解配置结构实际使用时请以你安装版本给出的默认配置模板为准。4.2 获取 DeepSeek API Key去 DeepSeek 开放平台注册账号进入 API Keys 管理页面创建一个新的 API Key。API Key 是一串以sk-开头的密钥。它等同于密码请保存在安全的位置不要直接写到会被提交到 Git 的代码里。创建完成后先用 curl 验证 API Key 是否可用。DeepSeek 兼容 OpenAI 接口请求示例如下curl https://api.deepseek.com/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的APIKey \ -d { model: deepseek-chat, messages: [{role: user, content: 你好请回复验证成功}] }如果返回内容中有choices字段说明 API Key 和模型名称都没有问题。如果返回 401就是 API Key 错误如果提示 model 不存在那就是模型名称写错了。4.3 典型报错unknown model: deepseek很多读者在配置时把模型名称直接写成了deepseek启动 Agent 后报错agent failed before reply: unknown model: deepseek这个报错的含义是API 服务不认识deepseek这个模型 ID。DeepSeek 实际可用的模型名称常见是两个deepseek-chat通用对话模型。deepseek-reasoner推理模型适合复杂逻辑问题。所以要解决的通常不是 API Key 有问题而是把配置里的模型名称从deepseek改成deepseek-chat。修改完配置后重启 OpenClaw或者在配置热加载后重新发起一次对话。看到正常回复再进入 IM 平台接入避免把模型问题和平台接入问题混在一起排查。4.4 零 token 安装后 Agent 启动失败怎么处理如果你选择了创建新配置但暂时没有填写 token启动 Agent 时也可能出现类似agent failed before reply这是因为 OpenClaw 没有拿到模型 API Key。此时要回到模型配置页面确认以下信息是否齐全API Key 非空。模型名称正确。网络可以访问模型 API。在接入飞书、钉钉之前请先确保在 OpenClaw 的本地对话界面里能正常问答。基础对话通了后面接入 IM 才不容易踩坑。5. 飞书、钉钉、企业微信、QQ、小红书接入指南5.1 平台接入的整体逻辑很多人以为“接入飞书”是在 OpenClaw 里填一个 webhook 地址就行。实际上消息的收发分两条路径发送消息像群机器人发通知使用 Webhook 或应用 API。接收消息平台把用户发给机器人的消息推送给 OpenClaw需要回调地址或长连接。只发不收非常简单OpenClaw 无法变成能对话的群助手。完整的接入流程通常包含几大步骤在平台开放后台创建应用/机器人。申请消息收发权限。配置接收消息的方式。把凭证配置到 OpenClaw 对应渠道。做好网络与白名单配置。测试双向消息。下面分别说明五大平台的要点。由于各平台策略可能调整具体字段名称以创建后台页面显示为准。5.2 飞书接入飞书是企业 IM 里接入体验较好的平台之一企业自建应用支持机器人能力和事件订阅机制。整体步骤如下进入飞书开放平台创建“企业自建应用”。在应用能力中开启“机器人”。在权限管理里申请接收消息和发送消息的权限。在事件订阅中配置请求地址或使用长连接模式接收事件。发布应用版本等待管理员审核。飞书消息相关权限的命名通常是im:message、im:message:send_as_bot事件通常包含im.message.receive_v1。如果你没有公网服务器接收消息时优先考虑长连接模式。OpenClaw 所在进程与飞书服务器保持 WebSocket 连接不需要你提供 HTTPS 回调地址。这能省掉很多内网穿透和域名备案的麻烦。拿到凭证后在 OpenClaw 的 channel 配置中填入应用凭证。之后先在飞书里找到机器人私聊发送“你好”观察 OpenClaw 日志是否输出一条收到消息的记录。日志有记录但没回复优先查模型 API 配置日志没有记录优先查事件订阅是否生效。5.3 钉钉接入钉钉有两种常见接入方式一种是企业内部应用机器人另一种是自定义机器人。自定义机器人配置最简单适合“只发送通知”的场景。在钉钉群里添加自定义机器人后你会获得一个 Webhook 地址形如https://oapi.dingtalk.com/robot/send?access_token你的token用 curl 测试群机器人通知curl -X POST https://oapi.dingtalk.com/robot/send?access_token你的token \ -H Content-Type: application/json \ -d {msgtype:text,text:{content:OpenClaw 接入测试}}自定义机器人只能往群里发消息不能接收群成员对话。要让 OpenClaw 真正应答群里消息需要创建企业内部应用机器人开启消息接收模式。钉钉企业内部应用的凭证是 Client ID原 AppKey和 Client Secret。新版钉钉开放平台推荐使用 Stream 模式推送消息和飞书的长连接类似可以避免暴露公网回调地址。配置完成后同样遵循“先本地对话通过再群里测试”的原则。5.4 企业微信接入企业微信接入自建应用是常见的办公场景。需要准备三样核心信息企业 IDCorp ID应用 Agent ID应用 Secret登录企业微信管理后台进入“应用管理 → 自建应用”创建应用后可以拿到 Agent ID并设置 Secret。企业微信机器人接收消息时需要配置“接收消息服务器”。这个服务器要能处理企业微信发来的 URL 验证请求并正确解密加密消息。OpenClaw 如果想要完整接入通常需要依赖一个接收回调的服务。如果没有公网环境更接地气的做法是先用企业微信群机器人 Webhook让 OpenClaw 向群里推送报告。Webhook 地址形如https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key你的key先用 curl 验证是否打通curl -X POST https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key你的key \ -H Content-Type: application/json \ -d {msgtype:text,text:{content:OpenClaw 消息推送正常}}当你确认 Webhook 地址没问题后再考虑是否实现回调接收。企业微信对回调服务器的 IP 有可信域名校验需要在管理后台配置可信 IP 或可信域名部署时注意不要把服务器 IP 配错。5.5 QQ 接入QQ 侧的接入相对特殊通常需要 QQ 开放平台注册机器人能力。个人开发者是否能注册、审核材料要哪些都会随平台政策变化。实际操作前先查看最新的官方开放平台文档不要轻信第三方“必须购买会员才能接入”的说法。接入流程同样遵循创建机器人 → 获取 App ID / Token → 配置沙箱环境 → 在沙箱里测试收发消息。QQ 机器人在未上线前一般在沙箱频道或测试群中运行收到“没有权限”或“无法发送”的错误时先检查是否处于测试范围。QQ 群的自动化发言有严格频率和内容限制。不建议设置高风险关键词更不建议用于批量私聊、自动加人等场景。合规是第一前提。5.6 小红书接入小红书是内容社区不是纯粹的 IM 工具。普通个人开发者直接“接入小红书”做自动化回复需要评估合规风险。官方目前提供的开放能力有限主要用于企业号、专业号等场景。如果你想在小红书做客服自动回复或私信触达请先确认你拥有小红书专业号或企业号权限并使用官方开放平台提供的能力。未经授权的自动化脚本批量私信、批量发布轻则限流重则封号。因此OpenClaw 接入小红书前先回答三个问题你是否有官方开放平台的开发者权限你的场景是否属于官方允许的客服/自动回复类目是否已经配置了免责声明或用户授权机制如果三个问题里有一个不确定就先不要接。5.7 平台接入后的验收清单接入任何一个平台后建议按下面清单验收检查项预期结果私聊机器人能收到消息并回复群聊艾特机器人能正确识别并回复长消息不丢消息不重复回复OpenClaw 进程重启后平台连接能自动恢复机器人主动推送目标群/用户能收到日志记录能看到收消息和发消息的日志不要接好一个平台后立刻接入所有平台。先把一个渠道调通并观察一天稳定性再扩展下一个。6. 常见报错与排查思路6.1 报错排查通用顺序遇到 OpenClaw 报错先不要急着重装。按下面顺序排查确认基础环境变量正确Git、Python、Node 都能运行。查看 OpenClaw 配置文件里模型名称和 API Key 是否正确。使用 curl 验证大模型 API。查看 OpenClaw 日志路径。检查平台回调或长连接是否正常。很多问题最后都出在“API Key 填错”“模型名写错”“回调地址没上线”这三个地方。6.2 OpenClaw 常见问题速查表下面整理了一份高频问题表读者可以直接对照排查问题现象常见原因解决思路OpenClaw 命令找不到未加入 PATH 或未重开终端将安装目录加入 PATH 后重开终端启动时报add AI later后无法对话尚未配置模型 API选择配置 AI填入 API Key 与模型名unknown model: deepseek模型名称写错改为deepseek-chat或deepseek-reasoneragent failed before reply模型 API Key 缺失或 API 不可达用 curl 验证 API查看状态码提示无法加载 PowerShell 脚本执行策略限制调整执行策略为 RemoteSigned飞书接收不到消息事件订阅未配置或版本未发布检查长连接/回调配置确认应用版本已发布钉钉群机器人只能发不能收使用了自定义机器人改用企业内部应用机器人并开启消息接收企微回调验证失败Token/EncodingAESKey 配置错误核对后台配置确认服务器 URL 可访问目录里出现 legacy exec approvals旧版本授权记录备份后查看记录按需清理不盲目删除Agent 修改了不该改的文件workspace 权限过大收紧工作区限制命令审批规则6.3 API 连通性验证是万能的定心丸很多同学遇到模型报错习惯性把错误截图发到群里问人。其实最有效的一步是自己先用 curl 或 Python 脚本直接调用模型 API。下面是一个不依赖 OpenClaw 的验证脚本import requests url https://api.deepseek.com/chat/completions payload { model: deepseek-chat, messages: [ {role: user, content: 你好} ] } headers { Authorization: Bearer sk-你的APIKey, Content-Type: application/json } resp requests.post(url, jsonpayload, headersheaders, timeout30) print(resp.status_code) print(resp.text)如果这个脚本能成功返回说明 API Key、模型名、网络链路都没问题问题一定出在 OpenClaw 的配置调用上。如果脚本本身失败OpenClaw 配置再正确也没用。7. 生产环境落地与工程建议7.1 配置管理与密钥安全OpenClaw 的配置里包含 API Key、平台 Secret属于高敏感信息。建议不要把密钥硬编码在配置文件中提交到 Git。使用.env文件管理环境变量并在.gitignore中忽略。如果团队协作使用密钥管理服务或 CI 的 Secret 能力注入。定期更换疑似泄露的 API Key。比如在你的 OpenClaw 工作目录里可以用.env保存密钥而示例配置通过config.example.yaml管理。7.2 命令审批与最小权限原则OpenClaw 的本地执行能力很强这意味着安全边界非常关键。你需要做到不在 root 用户下长期运行除非确实需要低层级操作。仔细检查exec-approvals.json中的已批准命令。禁止 OpenClaw 执行高危险命令例如强制删除根目录、直接覆盖系统配置。当你给 Agent 下发任务时尽量把工作限定在workspace目录内。如果多人共用一台服务器不要共用同一个.openclaw目录。每个系统用户维护自己独立的 Agent 配置权限边界更清晰。7.3 进程守护与日志OpenClaw 接入 IM 平台后需要 7x24 小时在线。直接在前台运行显然不行。如果是 Linux 服务器可以用 systemd 管理也可以用进程守护工具。下面是 systemd 服务的简化思路[Unit] DescriptionOpenClaw Service Afternetwork.target [Service] Useryouruser WorkingDirectory/home/youruser ExecStart/usr/local/bin/openclaw serve Restartalways RestartSec10 EnvironmentFile/home/youruser/.openclaw/openclaw.env [Install] WantedBymulti-user.target具体启动命令要以 OpenClaw 实际支持的 serve 或 run 类命令为准。如果没有这类命令就直接守护你平时手动启动的那个命令。使用 systemd 后sudo systemctl daemon-reload sudo systemctl enable openclaw sudo systemctl start openclaw journalctl -u openclaw -f这样才能看到完整日志。后续排查报错日志是第一手资料不要只看终端滚动输出。7.4 网络与平台回调接入飞书、钉钉、企业微信时如果使用回调地址方式必须保证你的服务器拥有公网可达的 HTTPS 地址并且回调路径能正常响应平台的签名验证请求。如果暂时没有公网地址和域名推荐以下几种方案优先使用长连接/Stream 模式接收消息。在隔离测试网络里验证消息格式再迁移到生产服务器。上线前做好超时处理防止平台重试机制把服务打崩。7.5 定时任务与自动化提醒OpenClaw 接入 IM 后最有价值的使用方式是定时任务。比如每天早上 10 点从某个数据源拉取信息生成摘要后发到企微群。但这类需求不要一开始就做成高复杂度的流水线而是分阶段先写一个可以手动触发的任务验证能拿到数据、能格式化、能发到目标群。再手动改成定时触发观察一周消息质量。最后加入失败告警机制。定时任务失败时至少要有日志能追溯。否则 Agent 某天静默失败群里没人察觉到数据异常就失去了自动化意义。8. 建议的动手路线如果你现在还处于“刚能打开终端”的阶段不需要一口气把五六个平台全部接入。我的建议是走下面这条最稳的路线先准备 Git、Python、Node 环境用版本命令确认全部可用。安装 OpenClaw完成首次初始化理解.openclaw目录结构。申请一个 DeepSeek API Key使用 curl 验证通过。把 DeepSeek 模型接入 OpenClaw在本地完成一次多轮对话。选择一个平台优先推荐飞书或钉钉创建测试群接入机器人。在群里测试私聊和群聊场景观察日志至少半天。稳定后再考虑接入第二个平台或增加定时任务。这套路线能让你清楚地知道每一步失败了该去哪里排查。OpenClaw 的坑大多不是“装不上”而是“不知道自己装到了哪一步”。把安装过程拆成一个个可验证的小环节比看十倍教程都管用。安装过程中如果遇到新的报错先看三件事模型 API 能不能 ping 通、OpenClaw 当前目录权限是否正常、平台后台的机器人配置是否已经发布生效。大多数问题都藏在这三件事里。