Google Chat

首先，我们要在Google那里给小爪子建一个“家”。这个家叫做“项目”，里面有一个专门用来聊天的门（Google Chat API）。然后，我们要为小爪子制作一把特殊的钥匙（服务账户和JSON密钥文件），这样它才能安全地进出这个家。

1. 第一步：准备小爪子的家和钥匙。

   • 去Google的网站，创建一个新项目，并打开“Google Chat API”这个功能。
   • 在这个项目里，创建一个“服务账户”。你可以把它想成是小爪子的身份证。给它起个名字，比如“openclaw-chat”，其他选项可以先不管，直接点“继续”和“完成”。
   • 为这个“身份证”制作一把钥匙：找到你刚创建的服务账户，点“钥匙”标签，然后“添加钥匙”，选择“JSON”格式，点“创建”。电脑会自动下载一个钥匙文件，你要把它好好保存起来。

2. 第二步：给小爪子建一个聊天机器人身份。

   • 还是在Google的网站，找到“聊天配置”的地方，创建一个新的聊天应用。
   • 填写应用信息，比如名字叫“OpenClaw”，放一张头像图片的网址，写一句描述。
   • 记得要打开“互动功能”，并在“功能”里勾选“加入群组对话”。
   • 在“连接设置”里，选择“HTTP端点网址”。这个网址就是小爪子家的门牌号。你需要填上你网关的公开网址，后面加上 /googlechat。小提示：在电脑上运行 openclaw status 命令，就能找到你的公开网址。
   • 在“可见性”设置里，选择“仅限特定人员”，并填上你自己的邮箱地址。这样只有你能在Google Chat里找到这个小爪子机器人。
   • 全部填好后，点击页面底部的“保存”。保存后一定要刷新一下页面！ 然后找到“应用状态”，把它改成“上线 - 对用户可用”，再点一次“保存”。

3. 第三步：告诉小爪子钥匙放在哪里。

   • 你需要告诉小爪子，刚才下载的那把钥匙（JSON文件）放在电脑的哪个文件夹里了。可以通过设置一个叫 GOOGLE_CHAT_SERVICE_ACCOUNT_FILE 的环境变量，或者在配置文件里写上 channels.googlechat.serviceAccountFile 这个路径。

4. 第四步：让小爪子开始工作。

   • 设置好钥匙路径和“观众”类型（就是第二步里你填的网址或项目编号）。
   • 启动小爪子的网关。这样，Google Chat就能通过你设置的门牌号（网址）来敲门找小爪子玩了。

怎么在Google Chat里找到小爪子？ 当网关运行起来，并且你的邮箱已经加到了可见列表里之后：

1. 打开 Google Chat 网站。
2. 在“私信”旁边，点“+”号。
3. 在搜索框里，输入你第二步里设置的“应用名称”（比如“OpenClaw”）。注意：因为它是个私人应用，不会出现在应用商店的列表里，必须用名字搜索才能找到。
4. 从搜索结果里选中你的机器人。
5. 点击“添加”或“聊天”，就可以开始一对一聊天啦！
6. 发个“你好”试试，看看小爪子会不会回应你！

重要提醒：需要一个公开的网址 Google Chat需要一个能从互联网上访问的网址（必须是HTTPS开头的）来敲门。为了安全，只把 /googlechat 这个路径公开就可以了，小爪子的控制面板和其他页面要留在你自己的私人网络里。

• 推荐使用 Tailscale Funnel 这个方法，它能很方便地只公开 /googlechat 路径，而把其他部分藏起来。
• 如果你用 Caddy 或 Cloudflare Tunnel 这类工具，也要记得只把 /googlechat 路径的访问请求转发给小爪子，其他的请求都拦下来。

如果出错了怎么办？ 如果Google Chat说“405方法不允许”，那可能是小爪子还没准备好听它敲门。检查这几件事：

1. 检查配置：用命令 openclaw config get channels.googlechat 看看有没有给小爪子设置Google Chat的配置。
2. 检查插件：用命令 openclaw plugins list | grep googlechat 看看Google Chat插件是不是已经打开了。
3. 重启网关：修改配置后，记得用 openclaw gateway restart 命令重启一下小爪子，它才能知道新的设置。 最后，可以用 openclaw channels status 命令看看Google Chat通道是不是已经“启用”并“已配置”了。