路径权限问题
运行以上命令后出现第一个报错

这个报错和 npm 本身没关系,是 Node 全局安装路径权限问题
说人话就是你在用普通用户往 /usr/local/lib/node_modules(系统级目录) 写东西,所以macOS / Linux 默认不允许
大部分人会选择直接使用sudo命令,其实这是相对错误的,这会把你的 npm、node_modules、cache 全部污染成 root 权限,后面所有npm都会无限报 EACCES,这是 Node 官方明确不推荐的做法。
正确解决方案是把npm全局目录改到你自己的用户目录,官方文档就是这个方案,而不是 sudo
命令如下:
```bash 1、创建全局目录 mkdir -p ~/.npm-global
2、告诉 npm 用这个目录 npm config set prefix '~/.npm-global'
3、设置PATH echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.bashrc echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.zshrc source ~/.zshrc ```
Mac用的 zsh,重点是 .zshrc,设置即可完美解决
如果之前使用过sudo npm,那就在执行这一步,防止未来炸:
bash
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) ~/.npm-global
Git+SSH key问题
解决该问题后,继续运行安装命令,随后出现第二个报错
该问题是 Git + SSH 没配好
npm 在安装依赖时,需要从这个地址拉代码:
ssh://git@github.com/whiskeysockets/libsignal-node.git
但本机没有 SSH key或GitHub没登记你的key,所以被 GitHub 拒绝了
可以输入 ls ~/.ssh 查看有没有配置ssh key,如果没有 id_rsa 或 id_ed25519,就是没配
1、生成SSH key(推荐 ed25519)
basic
ssh-keygen -t ed25519 -C "your_email@example.com"
执行后一路回车即可
生成后会有如下两个文件
basic
~/.ssh/id_ed25519
~/.ssh/id_ed25519.pub
2、把 key 加到 ssh-agent
basic
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
3、 把公钥加到 GitHub
复制公钥:
basic
cat ~/.ssh/id_ed25519.pub
在github设置此处位置添加粘贴进去即可
继续安装脚本,成功后如下:

初始化向导
执行openclaw onboard 进入初始化向导
选择快速开始,然后选择一个模型提供商
选择后会弹出一个认证链接,进行登录验证
选择一个模型
接着选择通信渠道,因为想配置国内的应用,所以这里选择跳过,稍后去安装插件
随后配置技能也直接跳过
hook可以按空格把下面三个都勾选上然后回车
完成后选择"Open the Web UI"会启动一个web ui界面
出现此页面表示安装成功
可以输入openclaw status命令来查看gatway状态

部署飞书通信
接下来安装飞书插件,输入如下命令
bash
openclaw plugins install @m1heng-clawd/feishu
然后登录飞书开放平台:https://open.feishu.cn/
进入开发者后台,然后创建企业自建应用


创建完成后,需要保存App ID和App Secret用来后续配置
添加一个机器人应用
然后回到openclaw去配置飞书参数,运行如下命令:
```bash openclaw config set channels.feishu.appId "飞书 app id"
openclaw config set channels.feishu.appSecret "飞书 app secret"
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.connectionMode websocket
openclaw config set channels.feishu.dmPolicy pairing
openclaw config set channels.feishu.groupPolicy allowlist
openclaw config set channels.feishu.requireMention true ```
然后重启网关
bash
openclaw gateway restart
随后回到飞书开发者平台,订阅方式选择长连接模式
接着添加一个"接收消息"的事件
添加事件后还要开通权限,将关于"contact:user.base:readonly"和"im:message"的有关权限全部开通
全部开通完成
然后我们创建版本
成功启用

回到飞书客户端,即可在消息列表找到开发者小助手,点击打开应用即可和openclaw对话

