准备工作
1.安装Node.js
在安装Clawdbot前,需要先安装Node.js,版本最好是最新的。我使用的版本V22.22.1
下载地址:
https://nodejs.org/en/download/
如果你已经安装了,检查一下你的Node.js是什么版本,最好是v22以上。
打开你的终端命令窗口,查看版本,这里可以看到我安装的nodejs是v22版本
2.获取Qwen模型key
如果链接Qwen模型不需要key,需要授权下就可以了。
3.创建飞书机器人应用
[飞书官网] (open.feishu.cn/)
第一步:
第二步:
第三步:配置权限
{
"scopes": {
"tenant": [
"contact:contact.base:readonly",
"contact:user.base:readonly",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message.reactions:read",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:update",
"im:resource"
],
"user": [
"docx:document:readonly"
]
}
}
安装openClaw
安装OpenClaw一定要使用管理员权限安装,这里我们点击右键PowerShell终端命令,选择“管理员安装”。如果是非管理员,会导致OpenClaw的网关安装失败。这里注意:PowerShell版本,最好在PowerShell7以上版本
1.安装命令
打开PowerShell终端,输入以下命令:
npm install -g openclaw@latest
2.检查是否安装成功
输入以下命令:
openclaw -v
3.配置安装向导和网关
这一步我们配置一些openclaw的配置内容和网关(非常重要!)。 输入以下命令:
openclaw onboard --install-daemon
这里会弹出openclaw的安装指引,问你是否同意openclaw在你电脑上为所欲为(包括删除文件等危险操作,谨慎选择)。
这里只能选Yes(按键盘左方向←键选择),否则直接退出配置向导。
接下来就是问你配置方式,这里选默认的QuickStart就可以。
3.1 配置大模型
接下来就是配置大模型了
这里我使用的是Qwen大模型,左边有选中标识,选中回撤即可。
下面就是选择哪一项取决于你希望机器人具备什么能力以及你的应用权限配置情况,我使用的第一个。
3.2配置飞书聊天机器人
我这里选择配置的是飞书
这里飞书配置插件,我选择的第二项,根据安装路径环境进行安装插件。
这里配置飞书SecretKey 和 AppId,这SecretKey 就是在飞书应用里获取,前面有提到。
这个配置决定了你的飞书机器人在群聊中的响应策略。对于大多数开发和测试场景
Allowlist - only respond in specific groups
第一项需要配置群聊id
Open - respond in all groups (requires mention)
- **含义**:机器人可以被拉到任何群聊中,但只有在用户 **@机器人** 时才会响应。
- **风险**:虽然加了“@”限制,但如果你的应用发布到了整个企业,任何员工都可以把机器人拉进任意群(包括敏感群)。一旦代码有Bug,可能在全公司范围内造成影响。
- **适用**:仅当你开发的是一个完全成熟、面向全公司公开的通用工具(如“天气查询”、“每日新闻”),且经过严格测试后才考虑此项。
安装skill配置
我这里选择 Skip for now 暂不安装,后期再配置安装
hooks 配置
最后是安装hooks,这里可以理解成安装几个配置文件
Skip for now:跳过所有高级钩子(Hooks)配置,保持最简启动模式。🚀 boot-md:在网关启动时自动运行根目录下的BOOT.md文件(常用于执行初始化指令或欢迎语)。📎 bootstrap-extra-files:启动时自动加载指定路径或通配符匹配的其他配置文件,以扩展工作区设置。📝 command-logger:将所有命令操作记录到统一的审计日志文件中,便于追踪和调试。💾 session-memory:当执行/new或/reset重置会话时,将当前上下文保存到内存中以便后续恢复或参考。
到这一步就配置好了。
获取飞书配对码
连接飞书接收事件后,向飞书发送消息,第一条消息会返回配对码
openclaw pairing approver feishu [你的配对码]
创建飞书群聊
在飞书app 里创建群聊,添加全成员,把创建的claw机器人拉到群聊即可。这样就可以利用飞书聊天工具去控制电脑了。
openclaw 常用命令
基础服务命令
| 命令 | 说明 |
|---|---|
openclaw gateway start | 启动网关服务 |
openclaw gateway stop | 停止网关服务 |
openclaw gateway restart | 重启网关服务 |
openclaw gateway status | 查看网关运行状态 |
openclaw onboard | 首次使用初始化向导 |
配置管理命令
| 命令 | 说明 |
|---|---|
openclaw config edit | 编辑配置文件(推荐) |
openclaw config show | 查看当前配置信息 |
openclaw config validate | 验证配置文件格式 |
openclaw --version | 查看 OpenClaw 版本 |
openclaw --help | 查看帮助信息 |
渠道配对命令(飞书/钉钉等)
| 命令 | 说明 |
|---|---|
openclaw pairing list feishu | 查看飞书配对请求列表 |
openclaw pairing approve feishu <配对码> | 批准飞书配对 |
openclaw pairing reject feishu <配对码> | 拒绝飞书配对 |
openclaw pairing list dingtalk | 查看钉钉配对请求列表 |
openclaw channels status | 查看所有渠道状态 |
openclaw channels enable <渠道名> | 启用指定渠道 |
openclaw channels disable <渠道名> | 禁用指定渠道 |
日志命令
| 命令 | 说明 |
|---|---|
openclaw logs | 查看最近日志 |
openclaw logs --follow | 实时跟踪日志(类似 tail -f) |
openclaw logs --level error | 只查看错误日志 |
openclaw logs --lines 100 | 查看最近100行日志 |
文件速查
| 内容 | 路径 |
|---|---|
| 配置文件 | ~/.openclaw/openclaw.json |
| 日志文件 | ~/.openclaw/logs/ |
| 插件目录 | ~/.openclaw/plugins/ |
| 缓存目录 | ~/.openclaw/cache/ |