OpenClaw需依次启动网关、配置Telegram渠道、验证指令执行、启用浏览器自动化并排查端口等问题。先运行openclaw gateway，再通过openclaw onboard配置Telegram Bot Token，发送/status等指令验证功能，最后安装browser-relay扩展实现网页操作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功安装 OpenClaw，但尚未启动服务或配置交互渠道，则无法通过聊天工具触发任何实际操作。OpenClaw 的核心逻辑是“先通网关、再连渠道、后发指令”，三者缺一不可。以下是启动并使用 OpenClaw 的具体方法：
一、启动 OpenClaw 网关服务
网关（Gateway）是 OpenClaw 的通信中枢，所有消息路由、认证与会话管理均依赖其运行。未启动网关时，Telegram 消息无法被接收，WebUI 无法加载，插件亦无法激活。
1、打开终端（Windows 使用管理员 PowerShell，macOS/Linux 使用 Bash/Zsh）。
2、执行命令：openclaw gateway。
3、等待控制台输出类似 "Gateway server listening on http://localhost:18789" 的提示信息。
4、在浏览器中访问 http://localhost:18789，确认对话界面正常加载且无报错。
二、配置 Telegram 作为首个交互渠道
Telegram 是新手最易接入的渠道，无需企业资质审核，Bot Token 获取快捷，且支持私聊与群组双向通信。配置完成后，所有自然语言指令将从 Telegram 流入网关并触发本地执行。
1、在 Telegram 中搜索 @BotFather，发送 /newbot 创建新机器人。
2、按提示设置机器人名称和用户名，获取形如 1234567890:ABCdefGHIjklMNOpqrSTUvwxYZ123456789 的 Bot Token。
3、返回终端，执行命令：openclaw plugins install @openclaw/telegram。
4、运行配置向导：openclaw onboard --flow quickstart，在渠道选择环节输入 telegram，随后粘贴 Token。
5、向新创建的 Bot 发送任意消息（如“你好”），观察终端是否打印出接收到的事件日志。
三、验证基础执行能力
完成网关与渠道配置后，需通过多类内置指令验证各功能模块是否就绪，包括系统状态读取、时间服务、文件访问等，确保 Agent 运行时与工具插件链路完整。
1、在 Telegram 中向 Bot 发送文字：/status。
2、等待约 3–5 秒，Bot 将回复包含 CPU 使用率、内存占用、已加载插件列表的结构化文本。
OpenClaw 技能 — 给定一个 GitHub 仓库 URL，自动解析出 owner/repo 名称，发现其中的 YAML/properties 配置文件及其配对的中文字段说明；在 `workspace/{repo}/` 目录下按同步日期（格式为 `YYYY-MM-DD`）创建时间戳子目录；写入 `.openclaw-config-state.json` 状态文件。每次用户提问前，先比对远程仓库当前 ref（如 `main` 或 `master`）的最新提交 SHA 与本地状态文件中记录的 SHA：
3、接着发送：现在几点？，确认时间服务模块已激活。
4、再发送：读取当前目录下的 README.md 文件内容（确保该文件存在于 OpenClaw 项目根目录），验证文件系统访问权限。
四、启用浏览器自动化能力
OpenClaw 可通过浏览器扩展实现网页操作，如自动填写表单、抓取页面内容、点击按钮等。该能力依赖独立的 Browser Relay 插件与网关令牌绑定，需手动加载并授权调试权限。
1、在 OpenClaw WebUI 对话框中输入命令：install browser-relay，等待插件安装完成并记录输出路径。
2、打开 Chrome 浏览器，进入 chrome://extensions，开启右上角“开发者模式”。
3、点击“加载已解压的扩展程序”，在弹出窗口中粘贴步骤 1 记录的插件完整路径，点击“选择文件夹”。
4、插件加载后，点击右上角拼图图标，找到 OpenClaw Browser Relay，点击右侧图钉图标将其固定。
5、点击固定后的小龙虾图标，切换状态为 ON；此时浏览器顶部将显示 "OpenClaw Browser Relay 已开始调试此浏览器" 提示。
6、在 WebUI 或 Telegram 中发送指令，例如：打开知乎首页并截图，验证浏览器控制链路。
五、修复常见网关启动失败问题
网关启动失败通常由端口冲突、权限不足或临时目录不可写导致。不同操作系统需采用针对性修复方式，避免重复执行无效重试。
1、检查端口占用：执行 lsof -i :18789（macOS/Linux）或 netstat -ano | findstr :18789（Windows），若存在占用进程则终止对应 PID。
2、更换监听端口：在终端中执行 openclaw gateway --port 18790，并在浏览器中访问 http://localhost:18790。
3、修复 Termux 环境路径问题（仅限安卓）：执行 mkdir -p $HOME/.openclaw/tmp && export TMPDIR=$HOME/.openclaw/tmp，再启动网关。
4、以管理员权限重试：Windows 用户使用“以管理员身份运行 PowerShell”，macOS 用户在命令前加 sudo（仅限必要场景）。
