OpenClaw搭建记录

时间:2026-02-09 10:46:44 | 阅读:4 | AI安全
OpenClaw搭建记录

路径权限问题

运行以上命令后出现第一个报错

image.png

这个报错和 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问题

解决该问题后,继续运行安装命令,随后出现第二个报错

image.png 该问题是 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设置此处位置添加粘贴进去即可

image.png 继续安装脚本,成功后如下:

image.png

初始化向导

执行openclaw onboard 进入初始化向导

image.png 选择快速开始,然后选择一个模型提供商

image.png 选择后会弹出一个认证链接,进行登录验证

image.png 选择一个模型

image.png 接着选择通信渠道,因为想配置国内的应用,所以这里选择跳过,稍后去安装插件

image.png 随后配置技能也直接跳过

image.png hook可以按空格把下面三个都勾选上然后回车

image.png 完成后选择"Open the Web UI"会启动一个web ui界面

image.png 出现此页面表示安装成功

image.png 可以输入openclaw status命令来查看gatway状态

image.png

部署飞书通信

接下来安装飞书插件,输入如下命令

bash openclaw plugins install @m1heng-clawd/feishu

image.png 然后登录飞书开放平台:https://open.feishu.cn/

进入开发者后台,然后创建企业自建应用

image.png

image.png

创建完成后,需要保存App ID和App Secret用来后续配置

image.png 添加一个机器人应用

image.png 然后回到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

随后回到飞书开发者平台,订阅方式选择长连接模式

image.png 接着添加一个"接收消息"的事件

image.png 添加事件后还要开通权限,将关于"contact:user.base:readonly"和"im:message"的有关权限全部开通

image.png 全部开通完成

image.png 然后我们创建版本

image.png 成功启用

image.png

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

image.png

f3124a1750d9499f1e15eec02a0b8531.jpg

标签: AI安全