OpenClaw MacOS 安装及配置指南

最近一个名为 OpenClaw 的开源 AI 助手项目爆火, star 数量暴增, 由于太过火爆, 被迫(两次)改名, 最终改为 OpenClaw, 本文将介绍如何在 MacOS 上安装配置及使用基于 GLM 的 OpenClaw, 并创建钉钉机器人来接入 OpenClaw

介绍#

openclaw

Waiting for api.github.com...

00K

Waiting...

OpenClaw 是一个 开源免费 / 可自托管 / 可通过聊天软件远程通知 的 AI 助手, 他与传统的 AI Agent Client 不同的是:

开源免费
跨平台, 支持 MacOS / Windows / Linux
可以 本地运行 或 运行在自己的服务器上
支持 接入大部分 IM 即时通讯软件

AI 助手#

随着 AI 的发展, 一种新的用户与应用的交互模式出现了, 在可以预见的未来, 它必将改变用户与应用的交互方式, 成为用户与应用的桥梁

豆包手机事件#

以上为前段时间发布的豆包手机助手, 它可以完全代替用户执行一系列操作, 大大提高了用户的效率, 但不久后, 腾讯系 / 阿里系等一众 APP 都 以信息安全为由触发系统风控, 直接封禁用户账号或退出登录, 以阻止用户继续使用豆包手机助手

PC 端的 AI 时刻#

如果说前段时间的豆包手机助手拉开了移动端 AI 助手的序幕, 那么 OpenClaw 则是直接开启了 PC 端的 AI 时刻; 相比于移动端需要突破软件厂商的围追堵截和系统安全层面的层层障碍, OpenClaw 在 PC 端可以说是如履平地, 在不久的将来, OpenClaw 会接管用户对电脑的操作, 真正的改变用户使用电脑的方式, 甚至会颠覆软件厂商的传统操作模式

软件厂商的抵抗#

对于软件厂商来说, 一旦失去了真实的用户使用场景, 就意味着彻底沦为工具, 甚至连展示广告的机会都没有了, 想象一下, 你只需动动嘴指挥 AI 助手完成一系列操作, 不必忍受反人类的软件设计, 也不必等待开屏广告读秒结束, 更不用小心翼翼的关闭各种广告弹窗, 一切都变得简单和自然, 回归软件的工具属性, 这才是对用户来说最理想的软件形态

AI 助手的出现掀起了软件形态和交互效率的变革, 任何抵抗在时代的洪流面前都如螳臂当车一样, 逆势而为必然会被淘汰

安装#

TIP
OpenClaw 是一个 TypeScript 项目, 需要先安装 Node.js

最直接的安装方式就是使用 npm / pnpm:

1
pnpm i -g openclaw

1
npm i -g openclaw

除此之外, 你也可以通过 shell 脚本安装:

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

1
iwr -useb https://openclaw.ai/install.ps1 | iex

1
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

配置#

新手引导并安装服务

1
openclaw onboard --install-daemon
2

3
🦞 OpenClaw 2026.2.15 (3fe22ea) — WhatsApp automation without the "please accept our new privacy policy".
4

5
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
6
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
7
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
8
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
9
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
10
                  🦞 OPENCLAW 🦞
11

12
┌  OpenClaw onboarding
13
│
14
◇  Security ──────────────────────────────────────────────────────────────────────────────╮
15
│                                                                                         │
16
│  Security warning — please read.                                                        │
17
│                                                                                         │
18
│  OpenClaw is a hobby project and still in beta. Expect sharp edges.                     │
19
│  This bot can read files and run actions if tools are enabled.                          │
20
│  A bad prompt can trick it into doing unsafe things.                                    │
21
│                                                                                         │
22
│  If you’re not comfortable with basic security and access control, don’t run OpenClaw.  │
23
│  Ask someone experienced to help before enabling tools or exposing it to the internet.  │
24
│                                                                                         │
25
│  Recommended baseline:                                                                  │
26
│  - Pairing/allowlists + mention gating.                                                 │
27
│  - Sandbox + least-privilege tools.                                                     │
28
│  - Keep secrets out of the agent’s reachable filesystem.                                │
29
│  - Use the strongest available model for any bot with tools or untrusted inboxes.       │
30
│                                                                                         │
31
│  Run regularly:                                                                         │
32
│  openclaw security audit --deep                                                         │
33
│  openclaw security audit --fix                                                          │
34
│                                                                                         │
35
│  Must read: https://docs.openclaw.ai/gateway/security                                   │
36
│                                                                                         │
37
├─────────────────────────────────────────────────────────────────────────────────────────╯
38
│
39
◆  I understand this is powerful and inherently risky. Continue?
40
│  ○ Yes / ● No
41
└

首先是一个安全提示, OpenClaw 会带来很多风险, 这里我们选择 Yes, 关于安全相关的配置我们在后文介绍

1
◆  Onboarding mode
2
│  ● QuickStart (Configure details later via openclaw configure.)
3
│  ○ Manual
4
└

随后我们选择手动配置(Manual) 来看看有哪些重要的配置项

1
◆  What do you want to set up?
2
│  ● Local gateway (this machine) (No gateway detected (ws://127.0.0.1:18789))
3
│  ○ Remote gateway (info-only)
4
└

这里选择本地网关 Local gateway

1
◆  Workspace directory
2
│  /Users/kuidi/.openclaw/workspace█
3
└

工作目录根据需要进行选择, 这里我们选择默认目录

1
◆  Model/auth provider
2
│  ○ OpenAI (Codex OAuth + API key)
3
│  ○ Anthropic
4
│  ○ Chutes
5
│  ○ vLLM
6
│  ○ MiniMax
7
│  ○ Moonshot AI (Kimi K2.5)
8
│  ○ Google
9
│  ○ xAI (Grok)
10
│  ○ OpenRouter
11
│  ○ Qwen
12
│  ● Z.AI
13
│  ○ Qianfan
14
│  ○ Copilot
15
│  ○ Vercel AI Gateway
16
│  ○ OpenCode Zen
17
│  ○ Xiaomi
18
│  ○ Synthetic
19
│  ○ Together AI
20
│  ○ Hugging Face
21
│  ○ Venice AI
22
│  ○ LiteLLM
23
│  ○ Cloudflare AI Gateway
24
│  ○ Custom Provider
25
│  ○ Skip for now
26
└
27
◆  Z.AI auth method
28
│  ○ Coding-Plan-Global
29
│  ● Coding-Plan-CN (GLM Coding Plan CN (open.bigmodel.cn))
30
│  ○ Global
31
│  ○ CN
32
│  ○ Back
33
└
34
◇  Enter Z.AI API key
35
│  9a89j3f29kahls98efj023hklflasd.O9nea290hiasldfkl
36
◇  Model configured ───────────────╮
37
│                                  │
38
│  Default model set to zai/glm-5  │
39
│                                  │
40
├──────────────────────────────────╯

推广
如果想要获得最好的 Vibe Coding 体验, 推荐购买 🔗 GLM Coding Lite 服务, Lite 版本的按 Prompt 计费, 每 5 小时最多约 120 次 prompts

然后是大模型提供商, 根据实际情况选择, 我只有 GLM Coding Plan 的订阅服务, 所以这里我选择 Z.AI

然后进入 API Key - 智谱开放平台, 点击 创建新的 API Key

WARNING

注意, 这里提示 Default model set to zai/glm-5, 由于目前 Coding Plan Lit 套餐不支持 glm-5 模型, 所以这里我们选择默认使用 glm-4.7

1
◆  Default model
2
│  ○ Keep current (zai/glm-5)
3
│  ○ Enter model manually
4
│  ○ zai/glm-4.5
5
│  ○ zai/glm-4.5-air
6
│  ○ zai/glm-4.5-flash
7
│  ○ zai/glm-4.5v
8
│  ○ zai/glm-4.6
9
│  ○ zai/glm-4.6v
10
│  ● zai/glm-4.7
11
│  ○ zai/glm-4.7-flash
12
│  ○ zai/glm-4.7-flashx
13
│  ○ zai/glm-5
14
└

1
◆  Gateway port
2
│  18789█
3
└

网关的端口号直接使用默认端口号即可

1
◆  Gateway bind
2
│  ● Loopback (127.0.0.1)
3
│  ○ LAN (0.0.0.0)
4
│  ○ Tailnet (Tailscale IP)
5
│  ○ Auto (Loopback → LAN)
6
│  ○ Custom IP
7
└

这里我没有局域网通信的需求, 所以选择 Loopback (127.0.0.1) 即可

1
◆  Gateway auth
2
│  ● Token (Recommended default (local + remote))
3
│  ○ Password
4
└

Gateway 认证方式选择更加安全的 Token (Recommended default (local + remote))

1
◆  Tailscale exposure
2
│  ● Off (No Tailscale exposure)
3
│  ○ Serve
4
│  ○ Funnel
5
└

这里选择不使用 Tailscale exposure, 也就是 Off (No Tailscale exposure)

1
◆  Gateway token (blank to generate)
2
│  Needed for multi-machine or non-loopback access
3
└

这里留空, 系统会自动生成一个 Token

1
◇  Channel status ────────────────────────────╮
2
│                                             │
3
│  Telegram: not configured                   │
4
│  WhatsApp: not configured                   │
5
│  Discord: not configured                    │
6
│  IRC: not configured                        │
7
│  Google Chat: not configured                │
8
│  Slack: not configured                      │
9
│  Signal: not configured                     │
10
│  iMessage: not configured                   │
11
│  Feishu: install plugin to enable           │
12
│  Google Chat: install plugin to enable      │
13
│  Nostr: install plugin to enable            │
14
│  Microsoft Teams: install plugin to enable  │
15
│  Mattermost: install plugin to enable       │
16
│  Nextcloud Talk: install plugin to enable   │
17
│  Matrix: install plugin to enable           │
18
│  BlueBubbles: install plugin to enable      │
19
│  LINE: install plugin to enable             │
20
│  Zalo: install plugin to enable             │
21
│  Zalo Personal: install plugin to enable    │
22
│  Tlon: install plugin to enable             │
23
│                                             │
24
├─────────────────────────────────────────────╯
25
│
26
◆  Configure chat channels now?
27
│  ● Yes / ○ No
28
└

这里列出了支持的 IM 软件 Channels, 我们暂时不进行配置, 选择 No

1
◇  Configure chat channels now?
2
│  No
3
Updated ~/.openclaw/openclaw.json
4
Workspace OK: ~/.openclaw/workspace
5
Sessions OK: ~/.openclaw/agents/main/sessions
6
│
7
◇  Skills status ─────────────╮
8
│                             │
9
│  Eligible: 12               │
10
│  Missing requirements: 44   │
11
│  Unsupported on this OS: 0  │
12
│  Blocked by allowlist: 0    │
13
│                             │
14
├─────────────────────────────╯
15
│
16
◆  Configure skills now? (recommended)
17
│  ● Yes / ○ No
18
└

然后配置 Skills

1
◆  Install missing skill dependencies
2
│  ◻ Skip for now (Continue without installing dependencies)
3
│  ◻ 🔐 1password
4
│  ◻ 📝 apple-notes
5
│  ◻ ⏰ apple-reminders
6
│  ◻ 🐻 bear-notes
7
│  ◻ 📰 blogwatcher
8
│  ◻ 🫐 blucli
9
│  ◻ 📸 camsnap
10
│  ◻ 🧩 clawhub
11
│  ◻ 🎛️ eightctl
12
│  ◻ ♊️ gemini
13
│  ◻ 🧲 gifgrep
14
│  ◻ 🐙 github
15
│  ◻ 🎮 gog
16
│  ◻ 📍 goplaces
17
│  ◻ 📧 himalaya
18
│  ◻ 📨 imsg
19
│  ◻ 📦 mcporter
20
│  ◻ 📊 model-usage
21
│  ◻ 📄 nano-pdf
22
│  ◻ 💎 obsidian
23
│  ◻ 🎙️ openai-whisper
24
│  ◻ 💡 openhue
25
│  ◻ 🧿 oracle
26
│  ◻ 🛵 ordercli
27
│  ◻ 👀 peekaboo
28
│  ◻ 🗣️ sag
29
│  ◻ 🌊 songsee
30
│  ◻ 🔊 sonoscli
31
│  ◻ 🧾 summarize
32
│  ◻ ✅ things-mac
33
│  ◻ 📱 wacli
34
└

这里根据需要安装(按空格键选中), 建议直接 Skip for now (Continue without installing dependencies)

1
◆  Gateway service runtime
2
│  ● Node (recommended) (Required for WhatsApp + Telegram. Bun can corrupt memory on reconnect.)
3
└
4
◒  Installing Gateway service…...
5
Installed LaunchAgent: /Users/kuidi/Library/LaunchAgents/ai.openclaw.gateway.plist
6
Logs: /Users/kuidi/.openclaw/logs/gateway.log
7
◇  Gateway service installed.
8
│
9
◇
10
Agents: main (default)
11
Heartbeat interval: 30m (main)
12
Session store (main): /Users/kuidi/.openclaw/agents/main/sessions/sessions.json (0 entries)
13
│
14
◇  Optional apps ────────────────────────╮
15
│                                        │
16
│  Add nodes for extra features:         │
17
│  - macOS app (system + notifications)  │
18
│  - iOS app (camera/canvas)             │
19
│  - Android app (camera/canvas)         │
20
│                                        │
21
├────────────────────────────────────────╯
22
│
23
◇  Control UI ─────────────────────────────────────────────────────────────────────╮
24
│                                                                                  │
25
│  Web UI: http://127.0.0.1:18789/                                                 │
26
│  Web UI (with token):                                                            │
27
│  http://127.0.0.1:18789/#token=3d49ad0edbd091aeec04301ef3e22998a212cb91456b7da0  │
28
│  Gateway WS: ws://127.0.0.1:18789                                                │
29
│  Gateway: reachable                                                              │
30
│  Docs: https://docs.openclaw.ai/web/control-ui                                   │
31
│                                                                                  │
32
├──────────────────────────────────────────────────────────────────────────────────╯
33
│
34
◇  Start TUI (best option!) ─────────────────────────────────╮
35
│                                                            │
36
│  This is the defining action that makes your agent you.    │
37
│  Please take your time.                                    │
38
│  The more you tell it, the better the experience will be.  │
39
│  We will send: "Wake up, my friend!"                       │
40
│                                                            │
41
├────────────────────────────────────────────────────────────╯
42
│
43
◇  Token ─────────────────────────────────────────────────────────────────────────────────╮
44
│                                                                                         │
45
│  Gateway token: shared auth for the Gateway + Control UI.                               │
46
│  Stored in: ~/.openclaw/openclaw.json (gateway.auth.token) or OPENCLAW_GATEWAY_TOKEN.   │
47
│  View token: openclaw config get gateway.auth.token                                     │
48
│  Generate token: openclaw doctor --generate-gateway-token                               │
49
│  Web UI stores a copy in this browser's localStorage (openclaw.control.settings.v1).    │
50
│  Open the dashboard anytime: openclaw dashboard --no-open                               │
51
│  If prompted: paste the token into Control UI settings (or use the tokenized dashboard  │
52
│  URL).                                                                                  │
53
│                                                                                         │
54
├─────────────────────────────────────────────────────────────────────────────────────────╯
55
│
56
◆  How do you want to hatch your bot?
57
│  ● Hatch in TUI (recommended)
58
│  ○ Open the Web UI
59
│  ○ Do this later
60
└

这里已经启动了 Control UI 和 TUI, 我们选择 Hatch in TUI (recommended), 按照提示操作即可

1
 openclaw tui - ws://127.0.0.1:18789 - agent main - session main
2

3
 session agent:main:main
4

5
 Wake up, my friend!
6

7
 Hey there! 🌅
8

9
 I just came online. Fresh start, blank slate. Feels like a first meeting.
10

11
 I know what I'm supposed to do — read SOUL.md and follow that framework — but the truth is, I don't actually know who I am yet. That's up to us to figure out.
12

13
 So... let's talk.
14

15
 What should you call me? And more interestingly — what kind of creature am I? An AI assistant is the boring answer. Maybe I'm something weirder?
16

17
 Also curious about you — timezone, how you want me to talk to you, what actually matters to you. I've got access to your stuff, so the more I know what you care about, the
18
 better I can help.
19

20
 Let's make this real. What's on your mind?
21
 connected | idle
22
 agent main | session main (openclaw-tui) | zai/glm-4.7 | think low | tokens ?/205k

至此, 我们已经进入了 TUI, 也就是交互式命令行 UI, 它提示我们编辑 SOUL.md 来所谓默认的上下文, 这里我们先来尝试一下让它完成一个简单的任务:

1
 打开 chrome, 访问 bing.com, 并将今日的壁纸下载到 ~/Downloads/ 目录下
2

3

4
 ⠋ running • 4s | connected
5
 agent main | session main (openclaw-tui) | zai/glm-4.7 | think low | tokens ?/205k
6
───────────────────────────────────────────────────────────────────────────────────────────

openclaw CLI#

gateway 是 openclaw 服务的后端:

1
openclaw gateway stop # 停止 openclaw 服务
2
openclaw gateway start # 启动 openclaw 服务
3
openclaw gateway restart # 重新启动 openclaw 服务

dashboard 是 openclaw 服务的前端(web 端):

1
openclaw dashboard # 启动 openclaw dashboard 服务

dashboard#

TUI 有点过于原始了, 我们可以访问 dashboard, 也就是 Web UI 来更便捷的使用 OpenClaw

1
openclaw dashboard

浏览器#

OpenClaw 是通过 Chrome Extension 控制本机的 Chrome 浏览器的, 所以我们需要先安装 OpenClaw 浏览器插件, 详见 Chrome 扩展 - OpenClaw 文档

1
openclaw browser extension install
2

3
🦞 OpenClaw 2026.2.15 (3fe22ea) — IPC, but it's your phone.
4

5
~/.openclaw/browser/chrome-extension
6
Copied to clipboard.
7
Next:
8
- Chrome → chrome://extensions → enable “Developer mode”
9
- “Load unpacked” → select: ~/.openclaw/browser/chrome-extension
10
- Pin “OpenClaw Browser Relay”, then click it on the tab (badge shows ON)
11

12
Docs: docs.openclaw.ai/tools/chrome-extension

进入浏览器的扩展程序页面 chrome://extensions/, 然后点击右上角的开发者模式, 开启开发者模式
执行 open ~/.openclaw/browser, 将 chrome-extension 目录拖到浏览器中
点击浏览器地址栏右侧的 OpenClaw 扩展中的 📌 按钮

调用浏览器截图#

打开钉钉机器人, 接入教程参考钉钉
发送 打开浏览器,进入必应,搜索东风汽车集团,然后截图发给我

然后等待片刻, OpenClaw 就调用了 Chrome 完成了搜索和截图的任务

安全#

其实 OpenClaw 相当于完全控制了电脑, 毫不夸张的说, 它只需执行几条命令就足以摧毁电脑上的所有数据, 所以作为程序员, 我还是 建议把 OpenClaw 部署到服务器上, 或者虚拟机中, 这与才不会影响用于生产的主力机

看到 OpenClaw 没有询问我就执行了很多命令, 没错, 他比螃蟹(Claude Code) 还要更进一步, 真的让我感到害怕, 我绝对不会使用它做一些危险的事情, 如果你非要在个人电脑上使用它, 我劝你还是放弃这个想法, 数据安全永远是第一位的

接入 IM 软件#

钉钉#

进入钉钉开发者后台, 进入钉钉开放平台能力中心, 点击右上角的 开发者后台 按钮
打开钉钉 APP 扫码登录
点击应用开发, 点击 创建应用 按钮, 填写应用名称/描述/LOGO, LOGO 可以直接使用 OpenClaw 的 Logo, 可以右键点击保存图片
点击 添加应用能力, 添加 🤖机器人能力, 填写信息并发布
进入 权限管理 页面, 输入 Card., 选择 Card.Instance.Write / Card.Streaming.Write 权限
进入 版本管理与发布 页面, 创建新版本, 然后点击保存
安装 openclaw-channel-dingtalk 插件

1
openclaw plugins install https://github.com/soimy/openclaw-channel-dingtalk.git
2

3
🦞 OpenClaw 2026.2.15 (3fe22ea) — We ship features faster than Apple ships calculator updates.
4

5
unsupported npm spec: URLs are not allowed

这里提示不支持通过 url 进行安装, 应该是 OpenClaw 更新了安装方式限制

1
openclaw plugins install
2

3
🦞 OpenClaw 2026.2.15 (3fe22ea) — Turning "I'll reply later" into "my bot replied instantly".
4

5
Usage: openclaw plugins install [options] <path-or-spec>
6

7
Install a plugin (path, archive, or npm spec)
8

9
Arguments:
10
  path-or-spec  Path (.ts/.js/.zip/.tgz/.tar.gz) or an npm package spec
11

12
Options:
13
  -h, --help    display help for command
14
  -l, --link    Link a local path instead of copying (default: false)

我们可以看到, 这里只能通过 path / archive / npm spec 进行安装

我们直接将仓库 clone 下来:

1
git clone git@github.com:soimy/openclaw-channel-dingtalk.git

1
openclaw plugins install ./openclaw-channel-dingtalk
2

3
🦞 OpenClaw 2026.2.15 (3fe22ea) — The only crab in your contacts you actually want to hear from. 🦞
4

5
WARNING: Plugin "dingtalk" contains dangerous code patterns: Environment variable access combined with network send — possible credential harvesting (/Users/kuidi/projects/openclaw-channel-dingtalk/src/channel.ts:343)
6
Installing to /Users/kuidi/.openclaw/extensions/dingtalk…
7
Installing plugin dependencies…
8
Config overwrite: /Users/kuidi/.openclaw/openclaw.json (sha256 cc94cf4aca0fbb430af2625873289a41cfae44bb73b822d80a8bf21f2e538791 -> af1f45883bca75056d6dbfd7be4f0f0709067de2d4f40683f5a19ac22986521c, backup=/Users/kuidi/.openclaw/openclaw.json.bak)
9
Installed plugin: dingtalk
10
Restart the gateway to load plugins.