安全的 OpenClaw

一款可在您的消息平台上全天候运行的个人 AI 助手。您只需在 WhatsApp、Telegram、Signal 或 iMessage 上发送一条消息，即可获得 Claude 的回复——它具备完整的工具访问权限、持久化记忆、定时提醒功能，并可与 500 多款应用集成。

立即获取免费 API 密钥，开始使用 →

---

目录

• 要求
• 安装
• 快速入门
• 远程部署
• 提供商
• 配置
• 消息平台
• 工具审批
• 记忆系统
• 计划与提醒
• 应用集成
• 命令
• 故障排除
• 目录结构
• 贡献
• 资源
• 社区

---

要求

• Node.js 18+
• macOS、Linux 或 Windows
• Anthropic API 密钥（ANTHROPIC_API_KEY）
• Composio API 密钥（COMPOSIO_API_KEY）
• Claude Code — 如果使用 Claude 提供商则必需
• Opencode — 如果使用 Opencode 提供商则必需

平台特定要求：

• WhatsApp：需安装 WhatsApp 的手机
• Telegram：需从 @BotFather 处获取机器人令牌
• Signal：需安装并注册 signal-cli
• iMessage：仅限 macOS，需要 imsg CLI 工具

---

安装

1. 克隆并安装依赖项

git clone <repo-url> secure-openclaw
cd secure-openclaw
npm install

2. 安装提供商

您需要在机器上至少安装一个 AI 提供商。

Claude Code（用于 Claude 提供商）：

npm install -g @anthropic-ai/claude-code

Opencode（用于 Opencode 提供商）：

curl -fsSL https://opencode.ai/install | bash

您可以同时安装两者。CLI 允许您在它们之间切换。

安装 Claude Code 后，请在本地进行身份验证：

claude
# 按照 OAuth 提示登录您的 Anthropic 账户

在远程/Docker 部署中，身份验证将由环境变量 ANTHROPIC_API_KEY 处理，无需交互式登录。

3. API 密钥

Anthropic — 请从 https://console.anthropic.com 获取您的密钥

export ANTHROPIC_API_KEY=sk-ant-...

Composio — 提供 500 多种应用集成（Gmail、Slack、GitHub 等）

curl -fsSL https://composio.dev/install | bash
composio login
composio whoami   # 显示您的 API 密钥
export COMPOSIO_API_KEY=您的密钥

将所有导出语句添加到您的 shell 配置文件（~/.zshrc 或 ~/.bashrc），以使其永久生效。

---

快速入门

node cli.js

这将打开交互式菜单：

1) 终端聊天      — 在终端中与助手对话
2) 启动网关      — 运行消息网关
3) 设置适配器     — 配置 WhatsApp、Telegram 等
4) 显示当前配置
5) 测试连接
6) 更改提供商
7) 退出

或者直接运行：

node cli.js chat     # 终端聊天
node cli.js start    # 启动网关

---

远程部署

网关可以在远程服务器上运行。而终端聊天仅限本地。

DigitalOcean（推荐）

每月 6 美元的 DigitalOcean 实例。无需身份验证，只需注册即可使用。

1. 创建实例

1. 访问 digitalocean.com 并注册
2. 点击 创建 > Droplets
3. 选择区域，选择 Ubuntu 24.04，然后选择 6 美元/月 的套餐（1 GB 内存）
4. 设置 root 密码
5. 点击 创建 Droplet，并从控制面板复制 公共 IP 地址

2. 设置服务器

# SSH 登录
ssh root@YOUR_DROPLET_IP

# 添加交换空间（构建过程需要超过 1 GB）
fallocate -l 2G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab

# 安装 Docker
curl -fsSL https://get.docker.com | sh

# 克隆仓库（如果是私有仓库，请使用 GitHub PAT）
git clone https://github.com/YOUR_USERNAME/secure-openclaw.git
cd secure-openclaw

3. 添加你的密钥

cp .env.example .env
nano .env

填写 ANTHROPIC_API_KEY、COMPOSIO_API_KEY，以及你想要使用的平台。使用 Ctrl+O 保存，Ctrl+X 退出。

4. 部署

docker compose up -d --build
ufw allow 4096

就是这样。Docker Compose 会读取你的 .env 文件，构建镜像（在容器内安装 Claude Code 和 Opencode），并启动网关。WhatsApp 的认证信息和记忆数据会自动保存在 Docker 卷中。

5. 连接 WhatsApp

在浏览器中打开 http://YOUR_DROPLET_IP:4096/qr，然后用 WhatsApp > 已链接设备扫描二维码。

部署后

docker compose logs -f                          # 实时日志
docker compose down && docker compose up -d      # 重启
docker compose exec openclaw sh                  # 进入容器的 Shell
git pull && docker compose up -d --build         # 更新

• 健康检查: http://YOUR_DROPLET_IP:4096/
• Telegram: 如果你在 .env 中设置了 TELEGRAM_BOT_TOKEN，则会立即生效。

部署故障排除

构建被终止（退出代码 137）: 内存不足。请确保已添加交换空间（步骤 2）。

无法访问 http://YOUR_IP:4096: 运行 ufw allow 4096。另外，请确保使用的是 DigitalOcean 控制台中的 公共 IP，而不是以 10. 开头的内部/私有 IP。

WhatsApp QR 页面显示“等待中…”: 网关仍在启动中。使用 docker compose logs -f 查看日志，等待出现 [Gateway] Ready。

Claude 以代码 1 退出: 你的 ANTHROPIC_API_KEY 丢失或错误。可以使用 docker compose exec openclaw env | grep ANTHROPIC 进行检查。

私有仓库克隆失败: GitHub 不支持密码认证。请使用个人访问令牌：git clone https://YOUR_TOKEN@github.com/...

查看日志:

docker compose logs -f                          # 所有日志，实时
docker compose logs -f --tail 50                # 最后 50 行，然后继续跟踪
docker compose logs openclaw 2>&1 | grep ERROR  # 过滤错误日志

其他 VPS 提供商

任何 Linux VPS 都可以使用（Hetzner、Vultr、AWS Lightsail）。步骤相同——SSH 登录，如果内存小于 2 GB，则添加交换空间，安装 Docker，克隆仓库，然后运行 docker compose up。

各功能的运行位置

功能	本地	远程
终端聊天	是	否
网关（WhatsApp、Telegram 等）	是	是
记忆	是	是（需要卷）
定时任务/提醒	是	是
Composio 集成	是	是

---

供应商

Secure OpenClaw 支持两种 AI 供应商：

Claude Agent SDK — Anthropic 的 SDK。使用你的 ANTHROPIC_API_KEY。需要安装 Claude Code。模型：Opus 4.6、Sonnet 4.5、Haiku 4.5。

Opencode — 开源替代方案。需要安装 Opencode。可以运行本地服务器，也可以连接到现有服务器。模型：GPT-5 Nano、Big Pickle、GLM-4.7、Grok Code、MiniMax M2.1。

可以通过 CLI 菜单（选项 7）或在 config.js 中切换供应商：

agent: {
  provider: 'claude',    // 或 'opencode'
}

使用 Opencode 时，系统会自动检测配置的端口上是否已有服务器运行。如果有，则连接；如果没有，则启动一个。

在终端聊天中使用 /model 命令可以在当前供应商下切换模型。

---

配置

所有设置都位于 config.js 中。可以直接编辑，也可以使用设置向导。

{
  agentId: 'secure-openclaw',

  whatsapp: { enabled: true, allowedDMs: [...], allowedGroups: [...] },
  telegram: { enabled: false, token: '', ... },
  signal:   { enabled: false, phoneNumber: '', ... },
  imessage: { enabled: false, ... },

  agent: {
    workspace: '~/secure-openclaw',
    maxTurns: 100,
    allowedTools: ['Read', 'Write', 'Edit', 'Bash', 'Glob', 'Grep'],
    provider: 'claude',
    opencode: {
      model: 'opencode/gpt-5-nano',
      hostname: '127.0.0.1',
      port: 4096
    }
  },

}

安全性

每个平台都有允许的私信和群组白名单。设置为 ['*'] 表示允许所有，或者列出特定的 ID。

whatsapp: {
  allowedDMs: ['+1234567890'],     // 只允许这个号码发送私信
  allowedGroups: ['*'],            // 允许所有群组
  respondToMentionsOnly: true      // 在群组中，仅在被提及时回复
}

来自未识别发件人的消息会被静默丢弃。

---

消息平台

WhatsApp

使用二维码认证。无需机器人令牌。

1. 在配置中启用，或运行设置向导。
2. 启动网关。
3. 扫描终端中显示的二维码（WhatsApp > 设置 > 已链接设备）。
4. 会话会保存到 auth_whatsapp/ 目录——只需扫描一次。

Telegram

1. 在 Telegram 上联系 @BotFather，发送 /newbot，复制令牌。
2. 将令牌添加到配置中：

telegram: {
  enabled: true,
  token: 'YOUR_BOT_TOKEN',
  allowedDMs: ['*'],
}

3. 启动网关，然后给你的机器人发送消息。

Signal

需要安装并注册 signal-cli。

signal-cli -u +1234567890 register
signal-cli -u +1234567890 verify CODE

然后进行配置：

signal: {
  enabled: true,
  phoneNumber: '+1234567890',
  signalCliPath: 'signal-cli',
}

iMessage

仅限 macOS。需要 imsg CLI 工具。

brew install steipete/formulae/imsg

在配置中启用。确保 Messages.app 已打开并登录。

---

工具审批

网关以默认权限模式运行，这意味着助理在使用某些工具之前会请求批准。当需要批准时：

在终端聊天中: 加载动画会暂停，工具名称和详细信息会显示出来，你需要输入 y 或 n 来批准或拒绝。

在消息平台上: 助理会发送一条消息，例如“Claude 想要使用 Bash。回复 Y 允许，N 拒绝。”你的下一条回复将决定是否批准。

如果助理使用 AskUserQuestion 来询问澄清问题，这些问题会以编号选项的形式呈现。你可以回复数字，也可以直接输入答案。

如果没有响应，审批将在 2 分钟后超时。

---

记忆系统

持久化记忆存储在 ~/secure-openclaw/ 目录下。

~/secure-openclaw/
  MEMORY.md              — 长期记忆：偏好、人物、决策
  memory/
    YYYY-MM-DD.md        — 每日日志
    [topic].md           — 主题相关的笔记

每次对话开始时都会加载记忆。当你要求助理记住某些事情时，它会写入记忆。但助理不会在每条消息后主动写入记忆。

在聊天中使用 /memory 命令可以查看或搜索记忆。

---

定时与提醒

助理可以使用 cron 工具安排消息。

• “30 分钟后提醒我检查一下烤箱” — 一次性延迟
• “每天早上 9 点给我发送一个站会提醒” — cron 表达式 0 9 * * *
• “每周工作日早上 8 点” — cron 表达式 0 8 * * 1-5

这些任务会保存在 ~/.secure-openclaw/cron-jobs.json 中，并在网关运行期间执行。

---

应用集成

Composio 提供对 500 多款应用的访问：

• Gmail、Google 日历、Google 表格、Google 云端硬盘
• Slack、Discord
• GitHub、GitLab、Jira、Linear
• Notion、Trello、Asana
• Salesforce、HubSpot
• Twitter/X、LinkedIn
• 以及更多

只需说出：“给 john@example.com 发送一封邮件”、“为登录 bug 创建一个 GitHub 问题”、“在我的日历上添加一个明天下午 3 点的事件”。

首次使用某款应用时，Composio 会提供一个授权链接。点击该链接进行授权后，助手即可继续使用该应用。

---

命令

CLI

node cli.js              # 交互式菜单
node cli.js chat         # 终端聊天
node cli.js start        # 启动网关
node cli.js setup        # 设置向导
node cli.js config       # 显示配置
node cli.js help         # 帮助

聊天中

命令	描述
/new、/reset	开始一次新的对话
/status	显示会话信息
/memory	显示记忆摘要
/memory list	列出所有记忆文件
/memory search <query>	搜索记忆
/model	切换模型（仅限终端）
/queue	消息队列状态
/stop	停止当前操作
/help	显示命令

---

故障排除

“ANTHROPIC_API_KEY 未设置” — 请在您的 shell 或 .env 文件中导出密钥。

“claude: 命令未找到” — Claude Code 尚未安装。请运行 curl -fsSL https://claude.ai/install.sh | bash。

“opencode: 命令未找到” — Opencode 尚未安装。请运行 curl -fsSL https://opencode.ai/install | bash。

Composio 无法正常工作 — 请确保已设置 COMPOSIO_API_KEY。运行 composio login 和 composio whoami 获取您的密钥。

WhatsApp 的二维码未显示 — 请删除 auth_whatsapp/ 并重新启动。

Telegram 机器人无响应 — 请验证令牌是否正确，确保您已向机器人发送 /start 命令，并检查 enabled: true 是否启用。

Signal 无法使用 — 请确认已安装 signal-cli，手机号码已注册并包含国家代码。

iMessage 无法使用 — 仅适用于 macOS。请检查 Messages.app 是否已打开，imsg 是否已安装（which imsg），以及是否已授予辅助功能权限。

Opencode 服务器崩溃 — 如果端口 4096 已被之前的运行占用，请终止旧进程：kill $(lsof -ti :4096)。提供商能够自动检测正在运行的服务器，因此通常问题会自行解决。

远程存储中的记忆无法持久化 — 请确保已在 /home/claw/secure-openclaw 挂载了持久化卷。

---

目录结构

secure-openclaw/
  config.js              配置文件
  cli.js                 CLI 入口点（菜单、终端聊天）
  gateway.js             网关进程（消息平台）
  Dockerfile             用于远程部署的容器构建文件
  adapters/
    base.js              基础适配器类
    whatsapp.js          通过 Baileys 使用 WhatsApp
    telegram.js          通过 node-telegram-bot-api 使用 Telegram
    signal.js            通过 signal-cli 使用 Signal
    imessage.js          通过 imsg 使用 iMessage（macOS）
  agent/
    claude-agent.js      带有记忆、计划任务和系统提示词的代理
    runner.js            队列与执行协调器
  providers/
    base-provider.js     提供商接口
    claude-provider.js   Claude Agent SDK 提供商
    opencode-provider.js Opencode 提供商
    index.js             提供商注册表
  memory/
    manager.js           记忆文件管理
  tools/
    cron.js              计划任务工具
    gateway.js           网关 MCP 工具（send_message 等）
  commands/
    handler.js           斜杠命令处理器
  sessions/
    manager.js           会话跟踪
~/secure-openclaw/       工作空间（首次使用时创建）
  MEMORY.md              长期记忆
  memory/                每日日志和主题文件

---

贡献

我们欢迎各位贡献！以下是开始的方法：

1. 分支仓库
2. 创建分支（git checkout -b feat/my-feature）
3. 进行更改并提交（git commit -m '添加我的功能'）
4. 推送到您的分支（git push origin feat/my-feature）
5. 打开拉取请求

请确保每个 PR 只专注于一项更改。如果您正在修复错误，请附上复现步骤；如果您正在添加新功能，请说明其使用场景。

---

资源

• Claude Agent SDK 文档
• Claude Code
• Composio 文档
• Composio 工具路由器
• Baileys (WhatsApp)

---

社区

• Discord — 提问、分享您的成果
• X / Twitter — 关注以获取最新动态
• GitHub Issues — 错误报告和功能请求
• GitHub Discussions — 思路交流和问答

---

许可证

MIT

Secure OpenClaw 快速上手指南

Secure OpenClaw 是一个运行在消息平台上的个人 24/7 AI 助手。你可以通过 WhatsApp、Telegram、Signal 或 iMessage 发送消息，获得由 Claude 驱动的回复，支持工具调用、持久记忆、定时提醒以及 500+ 应用集成。

环境准备

系统要求

• 操作系统: macOS, Linux, 或 Windows
• Node.js: 版本 18 或更高
• AI 提供商依赖 (二选一或全选):
  • Claude Code: 使用 Anthropic 官方模型 (Opus, Sonnet, Haiku)
  • Opencode: 开源替代方案 (支持 GPT-5 Nano, Grok 等)

前置账号与密钥

在开始之前，请准备好以下密钥：

1. Anthropic API Key: 从 console.anthropic.com 获取。
2. Composio API Key: 用于连接 Gmail, Slack, GitHub 等 500+ 应用。
3. 消息平台凭证:
   • WhatsApp: 需安装 WhatsApp 的手机（用于扫码）。
   • Telegram: 从 @BotFather 获取 Bot Token。
   • Signal: 需安装并注册 signal-cli。
   • iMessage: 仅限 macOS，需安装 imsg CLI 工具。

---

安装步骤

1. 克隆项目并安装依赖

git clone <repo-url> secure-openclaw
cd secure-openclaw
npm install

2. 安装 AI 提供商

你需要至少安装一个 AI 提供商。

选项 A: 安装 Claude Code (推荐)

npm install -g @anthropic-ai/claude-code

安装后本地认证（远程部署可跳过此步，直接使用环境变量）：

claude
# 按照提示完成 OAuth 登录

选项 B: 安装 Opencode

curl -fsSL https://opencode.ai/install | bash

3. 配置 API 密钥

设置环境变量以便程序读取。建议将其添加到你的 shell 配置文件 (~/.zshrc 或 ~/.bashrc) 中永久生效。

设置 Anthropic Key:

export ANTHROPIC_API_KEY=sk-ant-...

设置 Composio Key:

# 安装 Composio CLI 并登录
curl -fsSL https://composio.dev/install | bash
composio login
composio whoami   # 查看你的 API Key

# 导出变量
export COMPOSIO_API_KEY=your-key-here

---

基本使用

启动交互式菜单

运行以下命令进入主菜单：

node cli.js

你将看到如下选项：

1) Terminal chat      — 在终端中与助手对话
2) Start gateway      — 启动消息网关 (WhatsApp/Telegram 等)
3) Setup adapters     — 配置消息平台适配器
4) Show current config
5) Test connection
6) Change provider
7) Exit

常用快捷命令

直接在终端聊天:

node cli.js chat

启动消息网关:

node cli.js start

启动后，根据提示配置对应的消息平台（如扫描 WhatsApp 二维码或输入 Telegram Token），即可通过手机消息与应用交互。

核心功能简述

• 工具审批: 当 AI 需要执行敏感操作（如 Bash 命令）时，会在终端暂停等待你输入 y/n，或在聊天软件中发消息请求确认。
• 记忆系统: 自动将重要信息保存到 ~/secure-openclaw/MEMORY.md，跨会话持久化。
• 定时任务: 支持自然语言设置提醒（例如："每工作日早上 8 点提醒我"）。