openclaw helloworld 20260304

dragonchow123

1048人浏览 · 2026-03-04 16:29:59

dragonchow123 · 2026-03-04 16:29:59 发布

看了很多帖子，关注点都不一样，操作系统（Windows/macos/linux）、各种软件和依赖版本(openclaw，飞书插件，nodejs)、安装方式(curl, npm, pnpm)等，还得自己踩一遍坑，记录一下。。。

0. 准备

环境：macos，node.js, npm, git等都满足要求了；

注册个openclaw支持大模型，获取api_key。
- 先用的zhipu，送2kw tokens，可以先用来测试，后面跑通后再切其他或本地模型。

设置一下npm国内源：

npm config set registry https://registry.npmmirror.com

系统设置 → 隐私与安全性 → 完全磁盘访问权限，勾选vscode（我在vscode的终端安装openclaw的终端）
- 为了文件权限问题，会sudo或者切换到root用户，但这样会在首次openclaw onboard中的install gateway时报错，好像是root用户的问题。最终openclaw onboard不要sudo，勾选vscode的磁盘访问权限是OK的。

1. 安装openclaw

sudo npm install -g openclaw@latest

2. 初始化openclaw

openclaw onboard --install-daemon # 加sudo或者切root都会报错

出来的交互配置选择：

I understand this is personal-by-default and shared/multi-user use requires 
lock-down. Continue?: Yes

Onboarding mode: QuickStart

Config handling: Update values

Model/auth provider: Z.AI
按提示输入api_key

Default model: keep current

select channel: skip for now

configure skills now?: no

Enable hooks: Skip for now

How do you want to hatch your bot?: Hatch in TUI

就可以了，在终端可以跟openclaw对话了。

3. 创建飞书机器人

这步简单，去飞书开放平台操作一下：https://open.feishu.cn/

创建：开发者后台 → 创建企业自建应用 → 表格填写 → 创建 → 添加“机器人”
权限：权限管理 → 批量导入 → 复制如下json → 创建版本（每次修改都需要创建版本） → 确认发布
“凭证与基础信息”中能看到App ID和App Secret

{
  "scopes": {
    "tenant": [
      "contact:user.base:readonly",
      "im:chat:readonly",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_depts",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource"
    ],
    "user": []
  }
}

4. 安装飞书插件

https://github.com/m1heng/clawdbot-feishu

openclaw plugins install @m1heng-clawd/feishu
# 会出现‘npm install failed’，依赖安装失败，因为权限不足
cd ~/.openclaw/extensions/feishu
sudo pnpm install # 安装依赖
# 也可以直接sudo openclaw plugins install @m1heng-clawd/feishu，没试过

5. 飞书插件配置

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 # 或直接open
openclaw config set channels.feishu.groupPolicy allowlist
openclaw config set channels.feishu.requireMention true

重启：openclaw gateway restart（每次更改openclaw配置都需重启）

6. 飞书机器人事件与回调配置

事件配置：如下图：订阅方式+添加事件
- 事件： im.message.receive_v1、im.message.message_read_v1、im.chat.member.bot.added_v1、im.chat.member.bot.deleted_v1

在这里插入图片描述

回调配置：同上，只配置订阅方式为“长连接”
创建版本

7. 飞书内测试

飞书「开发小助手」消息提示发布成功，点“打开应用”按钮，跳转到机器人聊天窗口，可以通过此窗口跟openclaw进行对话；
如果第5步dmPolicy设置为pairing，聊天时，会有授权提示，会给出一个id，需把当前飞书用户的id配置到openclaw中：
```
openclaw pairing approve feishu <id>
```

8. 问题: openclaw无法更新记忆文件

openclaw初始化时没有设定相关tool能力，我试过手动在配置文件openclaw.json中修改tools，但好像不行：

{
  tools: {
    profile: "messaging",
    allow: ["group:fs"] // 增加文件相关操作，直接在配置文件中修改，好像是不行的。
  },
}

可能还需要在其他地方进行配置？先简单粗暴用命令行进行无限制配置：

openclaw config set tools.profile "full"

这下就能把聊天相关的记忆存下来了。
在这里插入图片描述

9. 其他内置技能

定时任务是可以的，能够定时提醒我起来喝水走动走动
web_search不行，但查天气是可以的

10. clawhub

扩展技能，上clawhub，先试一个搜索skill

安装skill
```
sudo npx clawhub@latest install tavily-search
```
这个命令首次安装技能时，会先安装clawhub，后面就可以直接用clawhub install了？
tavily官网注册，获取api_key
配置key，新建.openclaw/.env，加入一行：
```
TAVILY_API_KEY="tvly-dev-xxx"
```
重启openclaw
测试
- 刚开始不work
- 提示用tavily，但说没安装
- 又重启了openclaw，就好了.
- 搜索把我的tokens耗尽了，赠送2000w tokens，当前模型只有200w用光了，600w是glm-4.6v，1200w是glm-4.5-air