EP02 - 给你的电脑安装一个数字管家: 安装和搭建 OpenClaw

安装 OpenClaw

暂时抛开官方这些“深奥”的建议，我们先来尝试安装它，下一篇我们再来安全地把它关到“沙盒”中去。安装 OpenClaw 非常简单，只需要一行命令：

1# macos
2curl -fsSL https://openclaw.bot/install.sh | bash
3
4# windows
5iwr -useb https://openclaw.ai/install.ps1 | iex

但是过程中有许多注意的地方，以我的mac为例，我们来看一下安装过程。

终端执行上述命令后，会先检查一些依赖，比如node, npm等，如果你的电脑没有安装，需要先安装：

稍作等待，安装完成后，OpenClaw 会自动执行 OpenClaw doctor 命令，来诊断环境和安装是否正确。

由于我之前安装了旧版的 clawdbot, 它会自动迁移配置信息。

doctor 执行完成后，会自动进行设置，此时会弹出诸多选项让你做出选择，比如配置模型、配置聊天客户端、Skills 等。

最终完成会输出访问的url(默认是 http://127.0.0.1:18789)， 就可以在浏览器中打开控制台(dashboard)了.

接入 Telegram (首选)

为什么首选 Telegram？

很遗憾，国内的IM目前 OpenClaw 都不支持, 对于飞书、钉钉的支持据说还在开发中，所以目前我们最好的方式就是选择 Telegram. 因为它是这个星球上对开发者最友好的 IM，没有之一: 不需要手机号验证码，不需要营业执照，不需要企业认证。 你只需要跟一个叫 @BotFather 的机器人聊两句，就能拿到通往 OpenClaw 的钥匙。

极客配置三步走：

  1. 搞定 Token
  • 打开 Telegram，搜索 @BotFather (认准蓝标)。
  • 发送指令 /newbot。
  • 给你的机器人起个名字 (比如 MyJarvis) 和用户名 (必须以 bot 结尾，比如 my_jarvis_bot)。
  • BotFather 会给你一串红色的 Token，长得像这样：123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11。复制它 切勿外传，否则可能别人就帮你操作你的电脑了！
  1. 配置 OpenClaw
  • 如果你之前已经设置了telegram，那么直接下一步。没有配置，则推荐使用交互式配置：
    1openclaw channels add
  • 选择 Telegram，然后粘贴 Token。
  • 或者直接修改配置文件 ~/.openclaw/openclaw.json (更 Geek 的方式，不推荐，除非你完全掌握了OpenClaw)：
    1"channels": {
2  "telegram": {
3    "token": "YOUR_TOKEN_HERE"
4  }
5}
  1. 验证与配对 (Pairing)

  • 在 Telegram 里找到你的机器人，点击 Start 或发送 /start。

  • Bot 会回复一段 8 位数的验证码 (Pairing Code)。

  • 回到你的终端，批准这个配对请求：

    1openclaw pairing approve telegram <code>

    这里注意一个坑，当你配置好 Telegram，发送任何消息可能没有反应，你需要检查网络是否畅通，是否配置了代理(关键)。这说明 openclaw 没有收到消息，你需要到dashboard检查是否配置成功，并且配置的授权模式是否是 pairing, 另外, 还需要在 Allow From 中添加上你自己的Telegram 的 username（不是机器人的），这样 OpenClaw 才能给你发送消息哦！

再次在 Telegram 机器人里发送 ping，如果收到 pong，恭喜，你的私人助理正式上线。

如果配置过程中有问题，没关系，只要配置好了 Module，你可以直接与你的 OpenClaw 聊天，让它帮你检查配置是否有问题，怎么解决，它都可以帮你完成。是不是很方便？

接入 Discord (备选方案)

如果你是 Discord 重度用户，或者因为网络原因不想用 Telegram，Discord 也是个不错的选择。 但在配置上，Discord 要比 Telegram 麻烦 10 倍。

极客配置四步走：

  1. 创建应用
  1. 创建 Bot
  • 左侧菜单选 Bot -> Add Bot。
  • 关键步骤 (不开启无法使用 Make sure to do this!):
    • 向下滚动到 Privileged Gateway Intents。
    • 开启 [Message Content Intent] (这是最关键的一步，不开这个 Bot 读不到你的消息)。
    • 开启 [Server Members Intent] (可选，建议开启)。
    • 点击 Save Changes。
  • 点击上方 Reset Token，复制你的 Token。
  1. 邀请 Bot 进群[关键]
  • 左侧菜单选 OAuth2 -> URL Generator。
  • SCOPES 选 bot。
  • BOT PERMISSIONS 选 Administrator (省事) 或者 Read Messages/View Channels, Send Messages, Embed Links, Attach Files。
  • 复制生成的 URL，在浏览器打开，把 Bot 邀请到你的服务器。
  1. 配置 OpenClaw
  • 交互配置：openclaw channels add -> 选择 Discord -> 粘贴 Token。
  • 手动配置 ~/.openclaw/openclaw.json：
1  "channels": {
2    "discord": {
3      "token": "你的\_DISCORD_TOKEN",
4    "enabled": true
5    }
6  }
  • 重启 Gateway，然后在 Discord 频道里@OpenClaw ping。

现在，IM 对接完毕，可以指挥你的管家干活了。我们梳理一下常用的命令：

 1# 查看状态
 2openclaw gateway status
 3# 停止网关
 4openclaw gateway stop
 5# 查看帮助
 6openclaw --help
 7# 重新设置gateway不安装为 daemon进程
 8openclaw onboard --no-install-daemon
 9# 检测安装环境
10openclaw doctor
11# 查询日志
12openclaw logs --follow

openclaw 仍然在测试阶段，所以更新非常频繁，上述命令可能随时会发生变化。通过 openclaw logs --follow 可以跟踪日志便于排查问题， 更多的配置可以参考 OpenClaw 官方文档。

使用终端Chat

就极客党而言，我更喜欢在终端与 OpenClaw 交互，先要保证 Gateway 是启动的，然后开启终端交互模式:

1openclaw tui --deliver

然后，你就可以像网页一样跟你的助手聊天了。

这一篇中，我们了解了 OpenClaw 的安装、配置、交互过程，它已经提供了大量的交互式配置方式，可以很方便的完成部署过程，而不用去折腾繁杂的位置文件。在享受 OpenClaw 带来的便利之前，我们还要先做一件保安全的事：Build a Cage (造笼子) —— 把 OpenClaw 关进一个隔离的沙盒里，下一篇，我们就来搞定它。

相关阅读