Logo

菜单

Clawdbot使用文档

Administrator
发布于 2026-01-27 / 41 阅读
4

Clawdbot使用文档

#Clawdbot

Clawdbot使用文档

Clawdbot 是一个你可以在自己设备上运行的个人 AI 助手。

它会在你已经使用的频道（WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat）以及扩展频道如BlueBubbles、Matrix、Zalo和Zalo Personal上回答你。

它可以在macOS/iOS/Android上说话和监听，还能渲染你控制的实时画布。网关只是控制平面——产品是助手。

模型说明：虽然支持任何模型，但我强烈推荐Anthropic Pro/Max（100/200）+ Opus 4.5，因为它能提供长上下文强度和更好的提示注入抗性。

部署教程

安装（推荐）

npm install -g clawdbot@latest
# or: pnpm add -g clawdbot@latest

clawdbot onboard --install-daemon

向导安装了Gateway daemon（launchd/systemd用户服务），使其保持运行。

快速入门（简而言之;DR）

运行时间：节点≥22。

完整入门指南（认证、配对、频道）：入门指南

clawdbot onboard --install-daemon

clawdbot gateway --port 18789 --verbose

# Send a message
clawdbot message send --to +1234567890 --message "Hello from Clawdbot"

# Talk to the assistant (optionally deliver back to any connected channel: WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/BlueBubbles/Microsoft Teams/Matrix/Zalo/Zalo Personal/WebChat)
clawdbot agent --message "Ship checklist" --thinking high

升级？更新指南（并运行）。clawdbot doctor

开发渠道

  • 稳定：标签发布（或），NPM Dist-tag。vYYYY.M.DvYYYY.M.D-<patch>latest

  • 测试版：预发布标签（）、NPM Dist-Tag（macOS 应用可能缺失）。vYYYY.M.D-beta.Nbeta

  • 开发者：调任负责人，NPM区标签（发布时）。maindev

切换频道（git + npm）：。 详情：开发渠道。clawdbot update --channel stable|beta|dev

源代码（开发）

更倾向于从源头打造。Bun 是直接运行 TypeScript 的可选选项。pnpm

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

pnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build

pnpm clawdbot onboard --install-daemon

# Dev loop (auto-reload on TS changes)
pnpm gateway:watch

注意：直接运行TypeScript（通过）。 通过节点/打包的二进制文件运行。pnpm clawdbot ...tsxpnpm builddist/clawdbot

安全默认设置（DM访问）

Clawdbot 连接的是真实的消息页面。把收到的私信当作不可信的输入。

完整安全指南：安全

Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack 上的默认行为：

  • DM配对（ / / ）：未知发件人会收到一个简短的配对码，机器人不会处理他们的消息。dmPolicy="pairing"channels.discord.dm.policy="pairing"channels.slack.dm.policy="pairing"

  • 批准方式：（然后发送者会被添加到本地的允许列表商店）。clawdbot pairing approve <channel> <code>

  • 公共入站私信要求明确选择加入：设置并包含在频道允许列表中（//）。dmPolicy="open""*"allowFromchannels.discord.dm.allowFromchannels.slack.dm.allowFrom

跑去揭露有风险或配置错误的DM策略。clawdbot doctor