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

2 阅读5分钟

图片

安装 OpenClaw

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

# macos
curl -fsSL https://openclaw.bot/install.sh | bash

# windows
iwr -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,那么直接下一步。没有配置,则推荐使用交互式配置:

    openclaw channels add
    
  • 选择 Telegram,然后粘贴 Token。

  • 或者直接修改配置文件 ~/.openclaw/openclaw.json (更 Geek 的方式,不推荐,除非你完全掌握了OpenClaw):

    "channels": {
    "telegram": {
    "token""YOUR_TOKEN_HERE"
      }
    }
    
  1. 验证与配对 (Pairing)
  • 在 Telegram 里找到你的机器人,点击 Start 或发送 /start

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

  • 回到你的终端,批准这个配对请求:

    openclaw pairing approve telegram <code>
    

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

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

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

alt textalt text

接入 Discord (备选方案)

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

极客配置四步走:

  1. 创建应用
  • 去 Discord Developer Portal[1]。
  • 点击 New Application,取个名字(比如 OpenClaw)。
  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 ChannelsSend MessagesEmbed LinksAttach Files
  • 复制生成的 URL,在浏览器打开,把 Bot 邀请到你的服务器。
  1. 配置 OpenClaw
  • 交互配置:openclaw channels add -> 选择 Discord -> 粘贴 Token。
  • 手动配置 ~/.openclaw/openclaw.json
"channels": {
"discord": {
"token""你的\_DISCORD_TOKEN",
"enabled"true
    }
  }
  • 重启 Gateway,然后在 Discord 频道里@OpenClaw ping

图片图片

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

# 查看状态
openclaw gateway status
# 停止网关
openclaw gateway stop
# 查看帮助
openclaw --help
# 重新设置gateway不安装为 daemon进程
openclaw onboard --no-install-daemon
# 检测安装环境
openclaw doctor
# 查询日志
openclaw logs --follow

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

使用终端Chat

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

openclaw tui --deliver

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


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

引用链接


如果您喜欢老墨的文章,欢迎关注公众号「极客老墨」,AI时代,拒绝抛弃,学会驾驭!