OpenClaw 安装、配置与使用指南

OpenClaw 是开源的「个人 AI 助手」：本地跑 Gateway，用 Telegram、WhatsApp、Discord 等跟你对话，支持技能与持久记忆。下面从安装写到使用和渠道配置，由浅入深。

• 开源：openclaw/openclaw，可自托管
• 多渠道：Telegram、WhatsApp、Discord、Slack、Google Chat、Mattermost、Signal、iMessage
• Gateway：本地起一个服务（默认 18789），桌面/手机/CLI 都连它
• 工作区：技能、提示词、记忆在 ，可单独备份
• 多模型：Anthropic、OpenAI（含 Codex）、xAI、MiniMax、Moonshot、自定义 API 等
• 安全：私聊默认要配对审批；Gateway 可只绑 127.0.0.1、开 Token 认证

环境：Node.js 22+，macOS / Linux（含 WSL）/ Windows（PowerShell）。安装脚本会帮你装 Node 和 Git。

macOS / Linux：

Windows（PowerShell）：

没有 sudo：用 ，会装到用户目录（默认 ）：

Linux 报错 ：先装系统库再试：

Docker：

安装结束后会跑一遍引导向导，可以跳过后面再做配置。根据提示信息完成 OpenClaw 配置，参考配置如下：

除了在安装时可以进行配置之外，还可以通过 Dashboard 网页进行配置，或者直接修改配置文件进行配置。可以参考阿里云的文档在 OpenClaw 中配置 Coding Plan。

常用 CLI 命令速览：

更多用 看。

新开一个终端，运行以下命令。

本机浏览器打开 在聊天页面可以进行对话。

如果安装 OpenClaw 的服务器 没有图形界面： 不会自动弹浏览器， 终端会打出一段说明（程序输出，不是要你执行的命令）。

提示你需要在本机做 SSH 端口转发再访问。

然后在本地浏览器打开 。

新开一个终端，运行以下命令，进入TUI 界面。

然后可以开始对话。

Gateway 是本地常驻服务，Dashboard、TUI、各渠道（Telegram/飞书等）都连它。 不先起网关，网页和机器人都不通。

前台跑（调试用）

占住当前终端，默认端口 18789。改端口用 。 Ctrl+C 停掉。

后台跑（日常用）

改完配置（渠道、模型等）后记得 让配置生效。

端口与安全

端口在配置里 ，默认 18789。 若只在本机用，可把 设为 ； 要远程访问再绑 ，并建议开 ，详见 Gateway 文档。

添加飞书渠道

官方文档描述openclaw 配置的非常详细，可以直接参照文档进行操作。

以下是通过 CLI 添加频道：

选择飞书，然后输入应用 ID 和应用密钥。

然后，启动网关。

在飞书中找到你的机器人并发送消息。

默认情况下，机器人会回复一个配对码。请批准该配对码：

审核通过后，即可正常聊天。

添加 Telegram 渠道

1. 拿 Bot Token

Telegram 里找 @BotFather，发 ，按提示建机器人，把给的 token 存好（长得像 ）。

2. 通过 CLI 添加频道

选择Telegram，然后输入 token。

设置 requireMention（仅 @ 才回复）
群聊里若希望只有 @ 了机器人才回复，在 里加一个 段，设 。
编辑 或 Dashboard 配置 → RAW，在已有 配置中增加 即可，例如：

表示所有群都生效；也可对单个群用群组 ID（如 ）单独设。改完执行 。

3. 第一次私聊要配对

启动网关并批准第一个私信

配对码1小时后失效。

4. 群聊

把 bot 拉进群。如果配了 ，得在群里 @ 它才会回。 想看到所有群消息：在群里设成管理员，或 @BotFather 里对 bot 用 关隐私。

5. 主动发消息

已经配对或进了 allowlist 的，可以这样发：

的写法：

• 私聊： （对方数字 user id）。
• 群组：（群组 chat_id，一般为负的 long 数字）。 chat_id 可在群组里先发一条消息，用 等看到；或通过 Telegram Bot API 获取。

技能用来扩展 agent 能力：搜网、查天气、读文件、调 API 等，由 agent 在对话或定时任务里按需调用。

技能从三个位置加载，优先级从高到低：工作区 、本地管理 、内置（随安装）。同名时工作区覆盖本地，本地覆盖内置。

查看与检查

安装技能

• ClawHub（推荐）：从社区技能库安装到工作区。需先装 ClawHub CLI。
• 手动：把技能目录放到 下，结构符合 Creating Skills 即可。

配置

在 的 段里可做：启用/禁用某个技能、配 API Key、设 、限制内置技能（）、调整加载目录（）等。 改完一般无需重启 Gateway，下次 agent 执行时会生效；若未生效可 。

OpenClaw 自带 Cron：按时间或间隔跑一次「完整 agent 轮次」（可搜网、用工具、写记忆），并把结果发到指定渠道，适合每日简报、周报、提醒等。

添加任务

管理任务

任务持久化在 ，重启 Gateway 不会丢。更多选项（如 webhook、隔离/主会话模式）见 Cron 文档。

参考 OpenClaw AI 智能体最佳真实用例大全。

推荐一些skills:

• tavily-search，每个月1000次免费调用，不用绑卡。好处就是它本身就是专门给Agent做的搜索API，返回的内容处理过了。
• find-skills，遇到解决不了的任务时，Agent 能自己去ClawHub检索并安装合适的Skills。
• self-improving，是让Agent记住执行中的错误并自我修正，用的越多逻辑就越顺。
• proactive-agent，主动规划模块，这样OpenClaw就有了自主拆解和多步任务的权限。
• memory-setup，用来构建长期记忆的，能跨对话记住你的核心偏好和关键信息。
• gog (Google 全家桶)，支持读取邮箱（我订阅的日报就是靠这个总结）和日历排期。
• summarize，用来做高密度信息摘要的，把长篇的URL，PDF或音视频丢个OpenClaw，它能快速提取核心论点
• automation-workflows，工作流编排，可以把多个技能串起来干更复杂工作流。
• obsidian，把本地的Obsidian做成第二大脑，OpenClaw可以把资料分类存起来。
• qmd，超级省token，每次跟OpenClaw对话的时候，它都要读一些背景资料才回答你，一般的做法是把整个文件都塞给他读。qmd是先把你所有的文档读一遍，建立索引。当你问的时候，他会找出最相关的那一段，天然省token。
• agent-browser，浏览器自动化，很多时候会跟tavily-search混淆，以为都是做联网搜索的，但擅长的是做点击滑动打开子页面等操作，比方说一个比较经典案例就是在X上搜索like大于100的OpenClaw教程作者，把follow都点了

以下是对我有用的以下使用场景

1、保存书签到 Linkding

linkding 技能安装之后，给机器人发消息，比如：“保存书签 https://github.com/AlexAnys/awesome-openclaw-usecases-zh”，机器人就会调用配置的 linkding 服务的 API 接口保存书签。

你还给电报机器人添加自定义命令：Manage Bot -> Edit Commands

甚至，还可以和机器人聊天，让它直接修改技能：

2、每晚6点搜集今天新发布的AI工具和模型动态

主要路径：

环境变量（可选）： 换配置文件； 换状态目录； 换内部用的「家目录」。

用 Dashboard 改配置： 打开网页，左侧 配置 → All Settings → RAW， 编辑的就是 。改完点 Save 再 Update。

注意：已有渠道、模型时别整段覆盖 Raw JSON，只改要改的那几块 （如 、、）。缺键再补。

接阿里云百炼 Coding Plan：在 Raw JSON 里加 和 ，把 换成真实 Key。

示例和模型列表见 阿里云文档。

• npm 装的：（或你实际包名）
• git 装的：进克隆目录 、，再装一遍 CLI 包装
• 自己改的东西尽量只放在 和 ，升级时不会盖掉

报错：No API key found for provider “anthropic”（或别的 provider） 说明当前用的 agent（例如 ）没配这个模型的认证。 要么给这个 agent 配一遍：，按提示选 provider、填 Key； 要么从已经配好的 agent 拷认证文件过去，例如：

认证是按 agent 存的，路径在 。 Onboarding 一般只给默认 agent 写了认证，换了 agent 或迁过目录就要单独配或拷一份。

报错：clawhub install xxx — Rate limit exceeded
ClawHub registry 对请求做了限流（同一 IP 或短时间请求过多）。处理方式：先试 ，往往能正常安装；若仍失败，等 10–30 分钟再试、关 VPN 或换网络、避免连续重试（会拉长限流时间）。

• OpenClaw 官网
• Getting Started
• 安装脚本说明（install.sh / install-cli.sh）
• Onboarding 向导
• CLI Onboarding 参考
• Setup（工作区与配置）
• 渠道配置（Telegram、Discord、WhatsApp 等）