Nook in the Lunar Mare

Openclaw+discord部署小记

Feb 3, 2026

前言

openclaw给了我一个购入mac mini的理由，正好从来没玩过macos（

经过一周左右的更新，openclaw安装比较容易，基本在命令行中交互就结束了，踩的坑基本都是网络环境，国内被屏蔽的网络带来了极大不便

参考：https://docs.openclaw.ai/start/getting-started

基础环境设置

网络环境（重要）

先配个梯子可以解决大部分安装问题，推荐使用clash-verge-rev，支持TUN模式

下载地址和说明：https://www.clashverge.dev/install.html

配置好自己的订阅后，开启TUN模式。普通的代理相当于一种君子协定，软件可以自己选择是否遵守代理规则老实翻墙；而TUN模式则是创建一个虚拟网卡，强制所有流量走该网卡中转，从而让后续命令行、界面的流量都能走梯子通行。

开发环境

由于是全新的macos，终端能力受限，需要安装基础开发环境，先在商店装个xcode，运行：

xcode-select --install

macos上没有预先安装类似apt之类的包管理器，需要自行安装一下Homebrew，可以从github上下载安装包：https://github.com/Homebrew/brew/releases/tag/5.0.13 ,方便后续装工具，过程中需要手动同意一下权限就完成了

openclaw目前需要 node 版本大于22，brew默认装的25版本直接符合了

brew update
brew install node

安装配置openclaw

安装

一行命令就开始交互式安装了：

curl -fsSL https://openclaw.ai/install.sh | bash

如果没有配置好网络环境大概率会卡住，可以用国内的node镜像源顶一下，配置好网络的话直接无视这段

npm install -g nrm
nrm test #测试速度最快的镜像源
nrm use taobao

配置

正常运行脚本的话应该直接就进入底下的命令行交互界面了，没有的话就运行openclaw onboard --install-daemon

先告诉我们这个工具比较危险，方向键选择之后按Enter同意

选择配置模式，选quickstart仅配置必要的东西，剩下的用默认配置

配置模型

可以直接先选Qwen玩玩，它采用OAuth认证模式，会弹出一个小网页授权，登录之后就能用了，其他有的需要API key。如果先不想配置的话就选skip。

选择支持的模型，比如我用的qwen-max，就一直往下找，找到qwen，确认后进行下一步

找到想用的模型比如qwen-max，这些在之后都可以重新设定或者添加其他模型，不碍事。选中后按下空格可以勾选选用的模型，设置好后Enter确认

配置Channel（交互方式）

配置交互方式：就是选择通过什么方式去发消息给openclaw，可以先跳过，选个skip for now。

配置Agent skills

可以先选择少数的一两个进行安装，或者直接跳过等之后再装

其他配置

接下来会问Enable Hooks？这几个功能都挺有用的，相当于增强openclaw的记忆，直接勾上

  • boot-md 引导信息
  • command-logger 记录执行的所有命令
  • session-memory 保存会话记录

接下来询问Gateway的访问认证，开启就行，一路确认

效果

到这一步访问 http://127.0.0.1:18789/ 就可以看到如下界面，如果没有的话可以这么检查：

# 查看openclaw运行状态
openclaw gateway status

# 没成功的话就启动服务
openclaw gateway --port 18789 --verbose

到这一步可以直接在聊天框里发号施令了🎉🎉

消息转发

这样配置后的openclaw只能在电脑前用，为了手机能控制，需要将消息转发到openclaw聊天窗口中。openclaw封装了多种聊天软件的接口，但是大部分在大陆地区都封干净了。现有接口国内直连的话看好如下两种方案：

  1. iMessage，国内生态支持最好
  2. Mattermost，自己将mattermost的Server端部署在国内服务器，从而完成消息转发

由于我已配置好网络，考虑到账号便利性和交互体验，我选择discord作为消息转发中转站

Discord

  1. 申请一个discord bot的API key
  2. 在discord控制台配置权限，这个可以参考网络教程
  3. openclaw configure命令，重新配置channel，选择discord，输入API key即可
  4. 在discord控制台生成邀请链接，点击邀请至自己服务器即可
  5. 私聊bot发送消息即可开始使用

注意，配置正常后bot应该会显示在线图标，没有显示的话说明有问题，可能代理没成功或者代理网络不稳定

使用一个月后体验

Mark一下日后更新 核心体验感：

  1. gateway机制，本地应该有个针对不同问题的向量库，可以做初步的模型分派
  2. 多种聊天终端的adapter,用起来体验确实好，尤其discord甚至会有表情反应，极其生动
  3. cronjob, 由于opanai和claude家的agent终究不是部署在本地，大概率是一个隔离的容器中甚至serverless服务，因此很难实现这种定时任务的特性
  4. 命令行友好，额外给其配置本地硬件或远端服务器，赋予其操控权限，可以完成很多繁杂的配置工作以及调试（Mac权限管控太繁琐了= =，Linux操控起来反而是最舒服对）。如果互联网生态不是那么封闭的话，或许会有更广阔的空间，和linux的适配性真的太好了，希望未来AI发展能重塑Internet的生态，多多公开API，打破现在各家App圈地和封闭的情况。
  5. 自学习Skill + 私有化Mmeory, 相比Astrbot等早期agent框架，skill这种思想给了AI自学习的能力，扔一份API文档让他自行编写，急需的功能可以先当补丁用着，不依赖社区的迭代。另外私有化memory的做法，也让Agent可以更定制化+了解自己
  6. typescript选型, python的易读+类型检查，agent在带有类型检查的编程语言中，表现符合预期，能写出更加正确的代码。py不检查类型太容易埋下暗坑，以及往往运行到后期解释器才会抛出异常，加一层类型检查真的刚需。