OpenClaw 快速上手

第一步:网络准备(安装 Shadowrocket,仅 iPhone)

一、安装方法

由于中国区 App Store 通常无法直接下载 Shadowrocket,请按以下步骤操作:

  1. 打开 设置

  2. 点击最上方 Apple ID

  3. 进入 媒体与购买项目

  4. 退出当前中国区 Apple ID

  5. 登录美区 Apple ID

  6. 打开 App Store

  7. 搜索 Shadowrocket

  8. 下载并安装

二、配置连接

  1. 我们会提供一个节点链接

  2. 打开 Shadowrocket 后,点击 添加节点

    Shadowrocket 添加节点
  3. URL 中输入或粘贴提供的链接

    输入节点 URL
  4. 点击连接后,系统会提示安装 VPN 配置,请点击 允许 / Allow

    VPN 配置提示
  5. VPN 安装完成后,打开连接即可正常使用

    连接成功

第二步:设置对话通道

完成网络准备后,需要设置对话通道。目前支持 Discord飞书 两种方式。


通道一:Discord

一、注册 Discord 账号

如果还没有 Discord 账号,请先完成注册。

  1. 访问 Discord 官网:https://discord.com/

  2. 点击注册,按提示填写邮箱、用户名和密码

  3. 注册提交后,务必前往注册邮箱完成 邮箱验证

⚠️ 如果没有完成邮箱验证,后续登录、建群、创建 Bot 或授权时可能会受到限制。

二、创建 Discord Bot

首先需要在 Discord Developer Portal 创建一个应用(Bot 会自动创建)。

  1. 访问 Discord 开发者中心

  2. 点击 New Application

    创建应用
  3. 输入应用名称(比如「OpenClaw」),点击 Create 完成创建

    应用名称
  4. 进入左侧 机器人 标签页,在 特权网关意图 中启用两个选项:

    • 消息内容意图(必需,用于读取消息内容)

    • 服务器成员意图(推荐,用于角色权限匹配)

    特权网关意图
  5. 点击 重置令牌 生成 Bot Token,复制保存好,后面配置要用

    重置令牌

三、邀请 Bot 到服务器

Bot 创建后需要邀请到你的 Discord 服务器。如果还没有服务器,需要先创建一个:

  1. 打开 Discord 客户端,左侧服务器列表底部点击 +

    创建服务器
  2. 选择 创建服务器,输入名称后创建

接下来生成邀请链接:

  1. 回到 Discord 开发者中心,进入你创建的应用

  2. 左侧 OAuth2OAuth2 URL 生成器

    OAuth2
  3. 范围 勾选 botapplications.commands

    范围勾选
  4. 机器人权限 勾选:

    • 管理消息

    • 发送文本转语音消息

    • 查看频道

    • 发送消息

    • 阅读消息历史记录

    • 嵌入链接

    • 添加文件

    • 使用外部 Emojis

    • 添加反应(可选)

    机器人权限
  5. 底部会生成一个 URL,复制后在浏览器打开

    生成 URL
  6. 选择你的服务器,点击 继续授权

    授权

完成后在 Discord 服务器里应该能看到 Bot 上线了(绿色状态)。

四、将 Bot Token 提供给技术人员

完成上述步骤后,需要将 第二步中重置令牌生成的 Bot Token 发送给技术人员,由技术人员在服务器上完成后续配置。

技术人员完成配置后会通知你,届时即可在 Discord 频道中直接与 Bot 对话。


通道二:飞书

飞书通道需要技术人员先在服务端完成基础配置。技术人员配置完成后,会提供一个 二维码 给你,你需要通过飞书扫码来创建机器人并完成审核。

一、扫码创建机器人

  1. 使用飞书扫描技术人员提供的二维码

  2. 扫码后进入创建页面,输入机器人名称(如「openclaw」),然后点击 创建

    输入机器人名称

二、审核机器人应用

点击创建后,系统会自动开始创建机器人。同时顶部会弹出 "开发者小助手" 的通知,提示「自建应用发布申请,待你审批」。

正在创建
  1. 点击顶部通知,进入 开发者小助手 的消息列表

  2. 在消息中找到 [自建应用发布申请] 待你审批 卡片,点击 进入管理后台审核

    审核消息
  3. 页面会提示"进入管理后台",点击 继续用移动端访问

    进入管理后台
  4. 进入 应用审核 页面,可以看到刚刚创建的应用(如「openclaw」)

    应用审核列表
  5. 向右滑动找到 审核 按钮,点击进入审核详情页

    审核按钮
  6. 在审核详情页,点击右上角的 通过 按钮

    点击通过

三、开始使用

  1. 审核通过后,回到 开发者小助手 消息页面,会看到「应用审批通过,已发布成功」的提示

  2. 点击 打开应用,即可进入机器人对话页面

    发布成功
  3. 向机器人发送任意消息,即可开始对话

    开始对话

四、配置群聊中无需 @ 即可对话(可选)

默认情况下,在群聊中需要 @机器人 才能触发回复。如果希望机器人自动回复群内所有消息(无需 @),需要额外开通权限:

  1. 打开 飞书开放平台,选择刚刚创建的应用

    选择应用
  2. 进入应用详情后,在左侧菜单选择 权限管理,然后点击 开通权限

    权限管理
  3. 在弹出的「开通权限」窗口中,搜索框输入 im:message.group_msg,勾选 获取群组中所有消息(敏感权限),然后点击右下角的 确认开通权限

    开通群消息权限

开通后,机器人即可在群聊内自动回复所有对话,无需 @ 触发。

⚠️ 使用飞书通道的注意事项

  • AI 能接触到你的飞书工作数据(消息、文档、日历等),请注意数据安全

  • AI 可能误解你的意图,涉及发送、修改等操作时,建议 先预览,再确认

  • 如在公司环境中使用,请遵守内部数据安全和隐私要求

  • 「获取群组中所有消息」为敏感权限,开通后机器人会接收群内所有消息,请谨慎使用

  • 如遇到权限不足或其他异常,请联系技术人员协助处理


常见问题与使用建议

Q:AI "忘记"了前面聊过的内容

对话过长时,早期内容会被挤出上下文窗口,AI 就"忘了"。

方法一:用 /compact 压缩上下文(推荐,适合还想继续当前话题)

输入 /compact,AI 会将历史对话压缩成摘要,释放上下文空间,同时保留关键信息,你可以继续当前对话而不丢失核心内容。

方法二:用 /new 开新对话(适合切换到新任务)

  1. 让 AI 总结当前对话要点:"请把我们这轮对话的关键结论总结成 3-5 条"

  2. 复制总结内容

  3. 输入 /new 开启新对话

  4. 把总结粘贴给 AI:"以下是上轮对话的结论,请基于此继续:……"

方法三:用 /context 查看上下文详情

如果不确定 AI 当前"记住"了多少内容,输入 /context 可以查看当前上下文中包含哪些内容以及各部分的 Token 占用,帮助你判断是否需要压缩或重开对话。

💡 重要规则写入文件更持久:在对话中口头说的指令在上下文压缩后会丢失。如果是长期有效的规则,建议写入 MEMORY.mdAGENTS.md 文件,这些文件每次新会话都会自动加载。


Q:AI 回复质量差,答非所问


模型选择与成本控制

场景推荐模型切换命令
日常对话、翻译、查询、简单文案GPT 5.4(快、便宜)/model gpt
复杂推理、深度写作、代码、疑难分析Claude Opus 4.6(推理最强)/model opus

Q:如何设置 AI 的性格和人设?

OpenClaw 通过几个核心配置文件定义 AI 的"灵魂":

文件作用
SOUL.md最重要 — 定义性格、说话风格、价值观、行为边界
IDENTITY.md定义 AI 的名字、身份、表情符号
USER.md记录你的信息(称呼、偏好、时区等)

普通用户设置方式:直接对话即可

首次使用时,AI 会主动引导你完成"初次见面"设定。你也可以随时发送以下消息来触发设置:

💡 性格设置会持久保存,/new 开新对话后仍然生效。如需调整,随时告诉 AI "我想调整你的性格设定" 即可。

⚠️ 如果需要更精细的人格定制(如编辑 SOUL.md 文件内容),请联系技术人员协助。