← 返回免费教程
OpenClaw

OpenClaw 安装常见问题

集中处理安装、端口、Token、模型和连接阶段容易遇到的问题。

排错2,682 字公开资料整理于 2026-07-24

前言

大家好,我是云途。 在这里专门新开一个文档,用来搜集同学们的常见问题。 那么这期没有废话,直接开始,当然后续我会录制视频教程,所以会慢慢更新。

注:本篇评论的采集和问题分析,由Openclaw操作Playwright自动完成。 配置方式就是,你告诉他,你想要让openclaw自己控制Playwright去获取某视频下方的评论并分析,你只需要给他视频链接就行。 问题列表及处理办法 给飞书发消息,回复403报错? 这类报错通常与模型服务余额或账户状态有关,请以服务商当前页面为准,先确认账户可正常调用。 大模型连接的时候fetch failed?

原文配图请通过页面开头的飞书公开链接查看。

请使用以下命令重新启动,这条命令可以绕过所有网络拦截和DNS解析类的问题,确保能够链接到API的Base Url

env NODE_TLS_REJECT_UNAUTHORIZED=0 NODE_OPTIONS="--dns-result-order=ipv4first" openclaw onboard --install-daemon

这行其实包含了三条命令,作用如下

NODE_TLS_REJECT_UNAUTHORIZED=0 #防止在开了代理软件的情况下拦截替换SSL安全证书,就连不上大模型接口了 NODE_OPTIONS="--dns-result-order=ipv4first" #禁止使用ipv6寻找地址 openclaw onboard --install-daemon #让openclaw正常初始化并常驻后台启动 没有对于本机文件的读写权限 通过命令行打开

open ~/.openclaw/openclaw.json 然后在打开的文档中找到下方部分,并改成这样

"tools":{ "profile":"full" } 之后cmd+s保存以后重启openclaw应该就可以了

停止服务

launchctl stop ai.openclaw.gateway

重新启动服务并加载新 JSON 配置

launchctl start ai.openclaw.gateway 配置文件改废了怎么办? 有同学可能不太熟悉json语法,导致有问题,如果你遇到各种奇奇怪怪的环境问题、权限报错或者服务起不来,直接在终端跑这行修复指令:

openclaw doctor --fix 它会给你的 Mac 做一次全面扫描(检查 Node 版本、文件权限、配置格式等),并且会自动一键修复所有发现的底层错误。 然后它也会帮你找到有什么其他的错误,最后几行长啥样就是啥样,读不懂直接粘贴给AI问就行。 发现打开的GUI浏览器窗口密码输入对了点击连接还是显示状态离线(有概率出现) 并且红色报错身份验证失败,其实这是一个bug:由于safari浏览器的问题,导致网页端发送的密码和后台始终对不上。

最简单的方式换个浏览器打开,迎刃而解。比如chrome。 如果没解决再看下边的两种方式 那就干脆还是把密码方式改成token的方式,沿用问题3中的方式,通过命令行打开

open ~/.openclaw/openclaw.json 找到如下部分并这么修改

"auth":{ "mode":"token", "token":"你自己设定一个" } 之后cmd+s保存以后重启openclaw应该就可以了

停止服务

launchctl stop ai.openclaw.gateway

重新启动服务并加载新 JSON 配置

launchctl start ai.openclaw.gateway 然后输入以下命令获取令牌化url

openclaw dashboard --no-open 会返回一个到令牌的网址,复制这个网址打开,以下是示例

http://127.0.0.1:18789/#token=xxxxxxxxxxxxx 修改safari浏览器的设置 找到【设置】→【隐私】→去掉【对跟踪器隐藏IP地址】 找到【设置】→【高级】→【在菜单栏中显示“开发”菜单】 然后进入【开发】→【停用跨源限制】 如果这样不行,那还是换个浏览器吧,没必要非要用safari。 npm权限问题

使用安装claude code时的技巧,如下

第一步:手动唤醒 NVM(测试它还在不在) 请在当前的终端窗口里,直接复制并运行下面这一整段代码(全选复制,粘贴后按回车): Bash

export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

运行完这句后,屏幕上可能没有任何提示,这是正常的。接着你再输入

nvm -v 如果这时候成功显示了版本号(比如 0.40.4),说明 NVM 毫发无损,只是刚才没被激活而已! 第二步:把配置彻底固定下来(永久生效) 为了防止你下次关掉窗口后又找不到,我们需要把刚才那段唤醒代码,永久写进你的 Mac 终端配置里。

将启动代码写入配置文件(逐行复制运行)

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.zshrc

重新加载配置,让它立刻生效

source ~/.zshrc 接下来测试一下是否安装成功,出现版本号即可

node -v npm -v 飞书安装报错,在设置通讯工具界面一直循环

那是因为你已经设置完一次了,但是龙虾可以同时配置多个通讯软件。 所以再进来不要选飞书了,选择Finished(当然你可以再添加其他的通讯工具)

飞书的APPid和secret填反了怎么办? 连不上他会让你重新配置,当然你也可以选择打开openclaw的json文件

open ~/.openclaw/openclaw.json 找到feishu的部分,手动更改。这里不截图了,大家打开看到就明白了。 最后

包含六大模块,助你成功打造AI驱动的一人公司!

相关云途公开视频