openclaw helloworld 20260304

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

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

• 注册个openclaw支持大模型，获取api_key。
  
  先用的zhipu，送2kw tokens，可以先用来测试，后面跑通后再切其他或本地模型。
  
  设置一下npm国内源：
  1. 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

1. sudonpminstall-g openclaw@latest

复制代码

2. 初始化openclaw

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

复制代码

出来的交互配置选择：

1. I understand this is personal-by-default and shared/multi-user use requires
2. lock-down. Continue?: Yes
4. Onboarding mode: QuickStart
6. Config handling: Update values
8. Model/auth provider: Z.AI
9. 按提示输入api_key
11. Default model: keep current
13. select channel: skip for now
15. configure skills now?: no
17. Enable hooks: Skip for now
19. How do you want to hatch your bot?: Hatch in TUI

复制代码

就可以了，在终端可以跟openclaw对话了。
3. 创建飞书机器人

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

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

1. {"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

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

复制代码

5. 飞书插件配置

1. openclaw config set channels.feishu.appId "<App_ID>"
2. openclaw config set channels.feishu.appSecret "<App_Secret>"
3. openclaw config set channels.feishu.enabled true
4. openclaw config set channels.feishu.connectionMode websocket
5. openclaw config set channels.feishu.dmPolicy pairing # 或直接open
6. openclaw config set channels.feishu.groupPolicy allowlist
7. 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中：
1. openclaw pairing approve feishu <id>
复制代码

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

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

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

复制代码

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

1. openclaw config set tools.profile "full"

复制代码

这下就能把聊天相关的记忆存下来了。

9. 其他内置技能

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

10. clawhub

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

安装skill
1. sudo npx clawhub@latest install tavily-search
复制代码
这个命令首次安装技能时，会先安装clawhub，后面就可以直接用clawhub install了？tavily官网注册，获取api_key配置key，新建.openclaw/.env，加入一行：
1. TAVILY_API_KEY="tvly-dev-xxx"
复制代码
重启openclaw

• 测试
  
  刚开始不work
  
  
  
  
  提示用tavily，但说没安装
  
  
  
  
  又重启了openclaw，就好了.
  
  
  
  搜索把我的tokens耗尽了，赠送2000w tokens，当前模型只有200w用光了，600w是glm-4.6v，1200w是glm-4.5-air
  
  
  

11. todo

更换llm api，尤其是其他平台url & 自己vllm起的服务；如何在不同机器间迁移openclaw；探索更多skills；openclaw养成&干活；

参考文档

OpenClaw 到底怎么装？一篇纯小白也能成功部署的超详细教程
github | docs
飞书插件

原文地址：https://blog.csdn.net/dragonchow123/article/details/158655271