OpenClaw 安装与配置指南：
开启智能代理与自动化的第一步

1. 确认沙盒安全协议（重要更新）

新版本显著增强了系统安全性。运行命令后，会弹出一个全屏的 Security warning。

• 这是正常的安全确认步骤，不是报错。
• 必须用方向键选中 Yes 并回车，确认边界声明后才能继续。
• 如果出现 Existing config detected，通常代表本机残留了旧配置，直接选 Use existing values 即可。

2. 选择配置模式与 AI 模型

推荐直接选择 QuickStart，然后在列表里选择你要使用的 AI 模型供应商并粘贴对应的 API Key。如果你使用自建网关或特殊订阅，也可以先选 Skip for now，稍后再用 CLI 配置。

• 注：如果是首次安装的新用户，不会出现上述的历史配置提示，而是会直接进入下面这个基础选择界面。
• 如果你只是重装或升级，通常没必要 Reset。

? Select setup mode:
  > QuickStart
    Custom

? Select AI model provider:
  > MiniMax
    Kimi
    Skip for now

1. 获取 Bot Token

在 Telegram 里搜索 @BotFather，发送 /newbot 指令创建机器人。

1. 设置机器人名称和唯一用户名。
2. 复制生成后的 Bot Token。

2. 向导内绑定与凭证存储

在 Select channel 列表里选择 Telegram (Bot API)，然后在凭证输入方式中选择 Enter Telegram bot token，粘贴你的 Bot Token 并回车。

3. 配置超级白名单（allowFrom）

为了防止他人滥用你的机器人和 API 配额，系统会强制要求你绑定唯一使用者。

• 当终端提示 Telegram user id 时，输入你自己的 Telegram 数字 ID 或带 @ 的用户名。
• 可以在 Telegram 里搜索 @getidsbot，发条消息快速获取数字 ID。
• allowFrom 是核心安全边界，建议不要跳过。

推荐配置项

• Web search：推荐选择 DuckDuckGo Search（key-free）。
• Hooks：新手建议保持默认 [*] Skip for now。
• Hatch your bot：如果你想立刻看后台，选择 Open the Web UI。

稍后打开 Dashboard

如果你在向导里选择 Do this later，之后也可以随时在终端里打开 Web UI：

openclaw dashboard

如果在配置末尾看到 Telegram 报错

有些人在安装尾声会看到类似 webhook cleanup failed 的日志。这通常更像是 Telegram 收尾阶段的网络或 webhook 清理异常，不一定代表整个安装失败。

• 先检查 Bot Token、allowFrom 和本地网络连通性。
• 很多情况下，稍后重试一次就能恢复。

方式一：在聊天终端中测试

1. 打开刚才绑定的 Telegram。
2. 找到你的专属机器人。
3. 发送文本：“你好，OpenClaw！”
4. 如果机器人正常回复，就说明配置成功。

方式二：使用原生命令行测试

你也可以不依赖聊天软件，直接在终端里开始对话：

openclaw agent --message "你好，请自我介绍一下" --thinking high