Ami测试版
X打开应用
所有指南
桌面集成

OpenClaw设置指南

赋予Ami控制桌面的能力 — 笔记、提醒、日历、音乐等。

隐私说明： OpenClaw完全在你的设备上运行。网关令牌永远不会离开你的机器。

本指南内容

前提条件安装OpenClaw启动网关将Ami连接到OpenClaw设置代理工作区可用工具故障排除更新OpenClaw架构

前提条件

macOS 需要用于Apple Notes、提醒、日历和音乐工具。

Node.js 22+ — 检查： node --version

如果没有Node 22+：

bash
brew install node@22
Step 1

安装OpenClaw

在终端运行安装脚本：

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

将安装CLI并自动启动设置向导。

验证安装

bash
openclaw doctor

openclaw 未找到，添加到PATH：

bash
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Step 2

启动网关

设置向导安装后台守护进程。检查运行状态：

bash
openclaw gateway status

手动启动：

bash
openclaw gateway --port 18789

找到你的网关令牌

令牌在 ~/.openclaw/openclaw.json 的 gateway.auth.token. 查看命令：

bash
cat ~/.openclaw/openclaw.json | grep '"token"' | head -1
保存此令牌 — 下一步需要。
Step 3

将Ami连接到OpenClaw

  1. 打开Ami应用，进入设置
  2. 滚动到高级部分
  3. 展开OpenClaw Gateway
  4. 填写字段：
字段值
网关URLws://127.0.0.1:18789
网关令牌（粘贴步骤2的令牌）

5. 启用通过OpenClaw路由网页聊天

6. 点击保存

可选设置

设置功能
同步身份将Ami的名字和个性推送到网关
拉取记忆角色加载时从工作区导入记忆
推送记忆每10分钟自动同步应用记忆到工作区
Step 4

设置代理工作区

OpenClaw使用工作区文件夹。默认路径： ~/.openclaw/workspace-ami/

需要两个文件：

SOUL.md — 个性

此文件从应用自动同步。定义Ami是谁以及如何回应。

~/.openclaw/workspace-ami/SOUL.md

TOOLS.md — 工具说明

Ami使用 macOS 工具的速查表。

~/.openclaw/workspace-ami/TOOLS.md

文件包含 osascript 命令。

可用工具

连接后，你可以让Ami执行以下操作：

Apple备忘录

“帮我写个购物清单”

“保存一个标题为周末计划的备忘录”

提醒

“下午3点提醒我打电话给牙医”

“设置明天浇花的提醒”

日历

“今天有什么日程？”

“周五下午2点添加与Jake的会议”

音乐

“播放音乐”

“暂停音乐”

“下一首”

“现在在播放什么？”

系统控制

“切换暗色模式”

“设置5分钟定时器”

“电池电量？”

打开应用和URL

“打开Safari”

“打开twitter.com”

故障排除

更新OpenClaw

bash
npm update -g openclaw

或重新运行安装程序：

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

架构

给好奇的人 — Ami如何与你的桌面通信：

┌──────────────┐     WebSocket      ┌──────────────────┐     osascript     ┌──────────────┐
│   Ami App    │ ──────────────────► │ OpenClaw Gateway │ ────────────────► │  macOS APIs  │
│  (browser)   │ ◄────────────────── │  (localhost)     │ ◄──────────────── │ Notes, Music │
│              │    SSE streaming    │  Port 18789      │    tool results   │ Calendar etc │
└──────────────┘                     └──────────────────┘                   └──────────────┘
                                            │
                                     ┌──────┴──────┐
                                     │  Workspace  │
                                     │  SOUL.md    │
                                     │  TOOLS.md   │
                                     └─────────────┘

1. 在浏览器中向Ami发送消息

2. 应用检测工具请求并立即显示预览卡

3. 消息通过WebSocket路由到OpenClaw网关

4. 网关代理读取TOOLS.md，执行相应的osascript命令

5. 代理回复确认，Ami对你说出来

准备好了吗？

安装OpenClaw，连接Ami，用自然语言控制你的桌面。

打开应用