🦞 OpenClaw 部署指南

1. 点击屏幕左下角的 开始菜单（Windows 图标）
2. 在搜索框输入 PowerShell
3. 在搜索结果中找到「Windows PowerShell」
4. 右键点击它 → 选择 以管理员身份运行
5. 如果弹出「用户账户控制」窗口，点击 是 允许

在打开的蓝色窗口中，复制粘贴以下命令，然后按 回车：

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

1. 按键盘上的 Command (⌘) + 空格 打开 Spotlight 搜索
2. 输入 Terminal 或「终端」
3. 按 回车 打开终端应用

或者：打开「启动台」→ 找到「其他」文件夹 → 点击「终端」

在终端窗口中（黑色背景窗口），复制粘贴以下命令，按 回车：

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

向导启动后会显示：

操作：首次安装直接按 回车 选择 QuickStart，或输入 advanced 进入高级模式

向导会询问使用哪个 AI 提供商，选项包括：

• Pi (pi.ai) - 无需 API Key，免费但有速率限制
• OpenAI (ChatGPT) - 需要 API Key，按用量付费
• Anthropic (Claude) - 需要 API Key，按用量付费
• Kimi - 需要 API Key
• Custom Provider - 兼容 OpenAI/Anthropic API 格式的自定义服务

操作：

1. 用方向键选择提供商，按 回车 确认
2. 输入你的 API Key（输入时不会显示字符，这是正常的）
3. 按 回车 提交
4. 选择默认模型（如 gpt-4o、claude-3-5-sonnet 等），按 回车 确认

向导会询问工作空间位置：

操作：通常情况下直接按 回车 使用默认路径即可

向导会询问以下配置：

操作：每项都按 回车 使用默认推荐值即可

向导会列出可用的聊天频道，用方向键选择，按 空格 勾选，按 回车 确认：

• Telegram - 推荐，配置简单（后面有详细配置教程）
• WhatsApp - 需要扫码登录
• Discord - 需要 Bot Token
• iMessage - 仅 macOS 可用
• 飞书 - 需要额外安装插件（后面有详细配置教程）

向导询问是否安装系统服务（Daemon）：

操作：输入 yes 或按 回车 确认安装

向导会：

1. 保存所有配置到 ~/.openclaw/openclaw.json
2. 启动网关服务
3. 验证网关是否正常运行

复制openclaw gateway status

正常应该显示：Gateway is running on port 18789

复制openclaw dashboard

浏览器会自动打开 http://127.0.0.1:18789

1. 打开手机或电脑的 Telegram 应用
2. 在顶部搜索框输入 @BotFather（认准名字旁边有蓝色勾的）
3. 点击搜索结果中的 BotFather，进入聊天界面
4. 点击底部输入框左侧的 菜单按钮（三条横线图标）
5. 选择 /newbot，或手动输入 /newbot 发送
6. 按提示输入：
• 机器人显示名称（随意，如「我的AI助手」）
• 机器人用户名（必须唯一，以 bot 结尾，如 my_ai_bot）
7. 创建成功后，BotFather 会发送一串 Token（格式：123456789:ABCdefGHI...），复制保存下来

找到并打开配置文件：

• Windows: 打开文件资源管理器 → 地址栏输入 %USERPROFILE%\.openclaw → 找到 openclaw.json 用记事本打开
• macOS: 在终端输入 open ~/.openclaw/openclaw.json

添加以下内容（注意把 123:ABC... 换成你的真实 Token）：

复制{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:ABC...",
      "dmPolicy": "pairing"
    }
  }
}

1. 在 Telegram 中私聊你刚创建的机器人
2. 发送任意一条消息（如「你好」）
3. 回到 PowerShell（Windows）或终端（Mac）
4. 输入命令查看配对码：openclaw pairing list telegram
5. 输入命令批准配对（把 XXXX 换成实际显示的配对码）：

复制openclaw pairing approve telegram XXXX

复制openclaw gateway restart

1. 浏览器访问 open.feishu.cn/app（国内版）或 open.larksuite.com（国际版 Lark）
2. 用飞书账号扫码登录
3. 点击页面 右上角 的 创建企业自建应用
4. 填写应用名称（如「AI助手」）
5. 上传应用图标（可随便选一张图片）
6. 点击「创建」

1. 进入应用管理页面后，看 左侧边栏
2. 点击 凭证与基础信息
3. 在右侧页面中复制：
• App ID（格式：cli_xxxxxxxx）
• App Secret（点击「查看」按钮后复制）

1. 左侧边栏 → 点击 权限管理
2. 点击页面 右上角 的 批量导入
3. 在弹出的输入框中，粘贴以下内容：

复制{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message:readonly", 
      "im:message:send_as_bot",
      "im:resource"
    ]
  }
}

4. 点击「确定」或「导入」
5. 确认权限列表中出现这 4 项

1. 左侧边栏 → 点击 应用能力
2. 在展开的菜单中点击 机器人
3. 点击页面 右上角 的 启用 按钮
4. 设置机器人显示名称（如「AI助手」）

1. 左侧边栏 → 点击 事件订阅
2. 在「接收方式」区域，选择 使用长连接接收事件（WebSocket 方式）
3. 向下滚动到「事件订阅配置」，点击「添加事件」
4. 在弹窗中找到并勾选 im.message.receive_v1（接收消息事件）
5. 点击「确定」保存

1. 左侧边栏 → 点击 版本管理与发布
2. 点击页面 右上角 的 创建版本
3. 填写版本号（如 1.0.0）
4. 填写更新说明（如「初始版本」）
5. 点击「保存并发布」
6. 等待审核（企业自建应用通常自动通过）

打开配置文件（同 Telegram 配置中的路径），添加飞书配置：

复制{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "你的Secret"
        }
      }
    }
  }
}

如果使用国际版 Lark，加一行："domain": "lark"

1. 在飞书应用中搜索你的机器人名称
2. 进入聊天，发送任意消息
3. 在终端查看配对码：openclaw pairing list feishu
4. 批准配对：openclaw pairing approve feishu XXXX

复制openclaw gateway restart

原因：系统找不到 OpenClaw 的安装位置

解决：

1. 在 PowerShell 输入：npm config get prefix，记下显示的路径
2. 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
3. 在「系统变量」中找到 Path → 编辑 → 新建
4. 粘贴刚才记下的路径 → 确定 → 确定 → 确定
5. 重启 PowerShell

1. 在终端输入：nano ~/.zshrc（如果是旧系统用 ~/.bashrc）
2. 在文件末尾添加一行：export PATH="$(npm prefix -g)/bin:$PATH"
3. 按 Ctrl+O 保存，Ctrl+X 退出
4. 执行 source ~/.zshrc（或重启终端）

• Telegram：BotFather → /setprivacy → 选择机器人 → Disable → 把机器人踢出群再加回来
• 飞书：检查应用是否已发布并通过审核；检查事件订阅是否勾选了 im.message.receive_v1
• 查看日志找原因：openclaw logs --follow