moltbot-with-slack

KO | EN

gitlite — search

#python #hacktoberfest #ai #golang #go #android #machine-learning #deep-learning #linux #windows #cli #awesome-list #pytorch #security

moltbot-with-slack

(★ 5)

moltbot(clawdbot) 部署配置slack应用指南

moltbot-with-slack 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# moltbot-with-slack
moltbot(clawdbot) 部署配置slack应用指南
# Clawdbot 部署指南

本文档详细介绍了如何部署 Clawdbot，并重点说明了 Slack 应用的配置过程。

## 系统要求

### 必需条件
- Node.js (版本 22.0.0 或更高) - 注意：v24.13.0 也可以
- npm (版本 11.6.2 或更高)
- Windows/macOS/Linux 操作系统
- 网络连接

### 可选条件
- Xcode（仅macOS，如需构建原生应用）
- 消息平台账号（Telegram Bot Token、Discord Bot等）

## 安装步骤

### 1. 升级Node.js版本（如果需要）

Clawdbot要求Node.js 22+，使用nvm管理版本：
```bash
# 安装Node.js 22
nvm install 22

# 设置为默认版本
nvm use 22
nvm alias default 22

# 验证版本
node --version # 应显示 v22.x.x 或更高
```

### 2. 选择安装方式

方式一：npm安装（推荐）
```bash
npm install -g clawdbot
```

方式二：一键安装脚本
```bash
curl -fsSL https://clawd.bot/install.sh | bash
```

方式三：从源码安装
```bash
# 克隆仓库
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# 安装依赖
pnpm install

# 构建
pnpm build

# 链接CLI
npm link
```

### 2. 初始化配置

运行设置向导来初始化配置文件和工作区：

```bash
clawdbot setup
```

或者运行配置向导：

```bash
clawdbot onboard
```

配置向导流程包括：
1. 安全确认
2. 选择AI后端（Anthropic, OpenAI, etc.）
3. 配置认证方式
4. 配置消息平台（可选）
5. 完成配置

### 3. 运行配置向导

使用交互式向导来配置网关、工作区和技能：

```bash
clawdbot onboard
```

## API 配置（重要）

### 配置Claude Code API中转

⚠️ 重要提示： Clawdbot不支持通过环境变量ANTHROPIC_BASE_URL来设置自定义API端点。必须通过配置文件的models.providers来配置。

#### 1. 获取API凭证
从Claude Code API中转服务获取：
- API Base URL: https://code.claude-opus.top/api
- API Key: cr_xxxxxxxxxxxxx

#### 2. 修改配置文件
在配置文件中添加models部分：

```json
{
  "models": {
    "providers": {
      "anthropic": {
        "baseUrl": "https://code.claude-opus.top/api",
        "apiKey": "cr_你的API密钥",
        "api": "anthropic-messages",
        "models": []
      }
    }
  }
}
```

关键配置说明：
- baseUrl: 自定义API端点（必需）
- apiKey: 你的API密钥（必需）
- api: 必须设置为anthropic-messages（必需）
- models: 必须包含此字段，可以为空数组[]（必需）

完整配置示例：
```json
{
  "meta": {
    "lastTouchedVersion": "2026.1.25",
    "lastTouchedAt": "2026-01-27T01:05:21.233Z"
  },
  "models": {
    "providers": {
      "anthropic": {
        "baseUrl": "https://code.claude-opus.top/api",
        "apiKey": "cr_你的API密钥",
        "api": "anthropic-messages",
        "models": []
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-5"
      },
      "workspace": "/Users/你的用户名/clawd",
      "maxConcurrent": 4
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "你的gateway_token"
    }
  },
  "channels": {
    "telegram": {
      "enabled": false
    }
  }
}
```

#### 3. 验证配置格式
使用jq验证JSON格式：
```bash
cat ~/.clawdbot/clawdbot.json | jq '.models'
```

#### 4. 重启Gateway服务
```bash
clawdbot gateway restart
```

#### 5. 验证配置生效
```bash
clawdbot channels status
```

### 版本信息
- Clawdbot 版本: 2026.1.24-3
- Node.js 版本: v24.13.0
- npm 版本: 11.6.2

### 网关配置
- 端口: 18789
- 模式: local
- 绑定: loopback
- 认证模式: token
- 认证令牌: c85a36fbb748954c21a5abcf3d2992a77db9ce8b5701bcbd
- 工作区路径: C:\Users\john\clawd

### AI 模型配置
- 默认模型: qwen-portal/coder-model
- 可用模型提供商:
  - Moonshot: kimi-k2-0905-preview (Kimi K2 0905 Preview)
  - Qwen Portal: coder-model (Qwen Coder), vision-model (Qwen Vision)

## Slack 应用配置

### 1. 创建 Slack 应用

1. 访问 [Slack API 网站](https://api.slack.com/apps)
2. 点击 "Create New App" 按钮
3. 选择 "From scratch" 选项
4. 输入应用名称（例如：clawdbot）
5. 选择要安装应用的工作区

### 2. 配置 OAuth 和权限

1. 在左侧导航栏中点击 "OAuth & Permissions"
2. 在 "Bot Token Scopes" 部分添加以下权限：
   - `chat:write`
   - `chat:write.public`
   - `files:read`
   - `files:write`
   - `channels:read`
   - `groups:read`
   - `im:read`
   - `mpim:read`
   - `channels:join`
   - `reactions:read`
   - `reactions:write`
   - `pins:read`
   - `pins:write`
   - `users:read`
   - `users:read.email`
   - `commands`

### 3. 安装应用到工作区

1. 在 "OAuth & Permissions" 页面顶部，点击 "Install to Workspace" 按钮
2. 授权所需权限
3. 记录生成的 "Bot User OAuth Token"（以 `xoxb-` 开头）

### 4. 获取 App-Level Token

1. 在左侧导航栏中点击 "Basic Information"
2. 向下滚动到 "App-Level Tokens" 部分
3. 点击 "Generate Token and Scopes" 按钮
4. 输入令牌名称（例如：clawdbot）
5. 添加 `connections:write` 范围
6. 点击 "Generate" 并记下生成的令牌（以 `xapp-` 开头）

### 5. 配置 Socket Mode

1. 在左侧导航栏中点击 "Socket Mode"
2. 启用 Socket Mode
3. 确保在 "App-Level Tokens" 中有正确的令牌配置

### 6. 配置事件订阅（可选）

1. 在左侧导航栏中点击 "Event Subscriptions"
2. 启用事件订阅
3. 设置请求 URL（对于本地开发，可以使用 ngrok）
4. 订阅所需的 bot 事件，如 `message.channels`、`message.groups`、`message.im`、`message.mpim`

### 7. 配置 Slash 命令（可选）

1. 在左侧导航栏中点击 "Slash Commands"
2. 点击 "Create New Command"
3. 设置命令名称（如 `/clawd`）
4. 设置请求 URL（如 `http://localhost:18789/slack/events`）

## 当前 Slack 配置详情

根据当前配置文件，Slack 通道配置如下：

### 令牌配置
- Bot Token: [已隐藏 - 实际部署时替换为真实的 Bot Token]
- App Token: [已隐藏 - 实际部署时替换为真实的 App Token]
- User Token: [已隐藏 - 实际部署时替换为真实的 User Token]

### 功能配置
- Socket Mode: 已启用
- 事件 Webhook 路径: /slack/events
- 群组策略: [根据实际需求设置 - open/allowlist]
- 支持的操作:
  - 反应: true
  - 消息: true
  - 固定: true
  - 成员信息: true
  - 表情符号列表: true

### Bot Token 类型说明
Slack 使用多种类型的 token，每种有不同的用途：

1. **Bot Token (xoxb-)**:
   - 用于机器人与 Slack API 的交互
   - 格式以 `xoxb-` 开头
   - 用于发送消息、反应、上传文件等机器人功能
   - 在 OAuth & Permissions 页面的 Bot User OAuth Token 部分获取
   - 需要确保机器人具有足够的权限（如 chat:write, channels:read 等）

2. **App-Level Token (xapp-)**:
   - 用于 Socket Mode 连接
   - 格式以 `xapp-` 开头
   - 在 Basic Information 页面的 App-Level Tokens 部分创建
   - 需要 `connections:write` 范围
   - 使应用程序能够建立实时连接而无需处理 Webhook 验证

3. **User Token (xoxp-)** (可选):
   - 用于用户级别的操作
   - 格式以 `xoxp-` 开头
   - 在 OAuth & Permissions 页面的 User OAuth Token 部分获取
   - 如果只需要机器人功能，通常不需要此令牌
   - 仅在需要代表用户执行操作时才使用

### Bot Token 权限说明
为确保 Clawdbot 正常工作，您的 Slack 应用需要以下权限：

#### 必需的 Bot Token 权限:
- `app_mentions:read`: 读取应用提及的消息
- `bookmarks:read`: 读取书签
- `bookmarks:write`: 写入书签
- `channels:history`: 访问频道历史
- `channels:join`: 加入频道
- `channels:manage`: 管理频道
- `channels:read`: 访问频道
- `chat:write`: 发送消息
- `chat:write.customize`: 发送自定义消息
- `chat:write.public`: 发送公共消息
- `commands`: 访问 Slash 命令
- `dnd:read`: 读取免打扰设置
- `emoji:read`: 读取表情符号
- `files:read`: 访问文件
- `files:write`: 上传和管理文件
- `groups:history`: 访问群组历史
- `groups:read`: 访问私人群组
- `groups:write`: 管理私人群组
- `im:history`: 访问 IM 历史
- `im:read`: 访问 IM
- `im:write`: 发起 IM 对话
- `links:read`: 读取链接元数据
- `links:write`: 写入链接元数据
- `mpim:history`: 访问多人 IM 历史
- `mpim:read`: 访问多人 IM
- `mpim:write`: 发起多人 IM 对话
- `pins:read`: 访问固定项目
- `pins:write`: 固定消息
- `reactions:read`: 访问反应
- `reactions:write`: 添加或删除反应
- `team:read`: 访问团队信息
- `usergroups:read`: 访问用户组
- `users.profile:read`: 访问用户资料
- `users:read`: 访问用户信息
- `users:read.email`: 访问用户邮箱

#### 可选但推荐的权限:
- `calls:read`: 读取通话信息
- `calls:write`: 写入通话信息
- `channels:manage.invites`: 管理频道邀请
- `chat:write.manually`: 手动触发消息发送
- `reminders:read`: 读取提醒
- `reminders:write`: 写入提醒

### 完整的 slack 应用 App Manifest 配置信息

```json

{
    "display_information": {
        "name": "clawdbot",
        "description": "Slack connector for Moltbot",
        "background_color": "#121829"
    },
    "features": {
        "app_home": {
            "home_tab_enabled": true,
            "messages_tab_enabled": true,
            "messages_tab_read_only_enabled": false
        },
        "bot_user": {
            "display_name": "clawdbot",
            "always_online": false
        },
        "slash_commands": [
            {
                "command": "/clawd",
                "description": "Send a message to Moltbot",
                "should_escape": false
            }
        ]
    },
    "oauth_config": {
        "scopes": {
            "user": [
                "admin",
                "channels:history",
                "channels:read",
                "channels:write",
                "channels:write.topic",
                "chat:write",
                "emoji:read",
                "files:write",
                "groups:history",
                "groups:read",
                "groups:write",
                "im:history",
                "im:read",
                "im:write",
                "im:write.topic",
                "mpim:history",
                "mpim:read",
                "mpim:write",
                "pins:read",
                "reactions:read",
                "reactions:write",
                "search:read",
                "users:read",
                "users:write",
                "usergroups:write"
            ],
            "bot": [
                "app_mentions:read",
                "channels:history",
                "channels:join",
                "channels:manage",
                "channels:read",
                "channels:write.invites",
                "chat:write",
                "chat:write.customize",
                "chat:write.public",
                "commands",
                "conversations.connect:manage",
                "conversations.connect:read",
                "conversations.connect:write",
                "emoji:read",
                "files:read",
                "files:write",
                "groups:history",
                "groups:read",
                "groups:write",
                "im:history",
                "im:read",
                "im:write",
                "metadata.message:read",
                "mpim:history",
                "mpim:read",
                "mpim:write",
                "pins:read",
                "pins:write",
                "reactions:read",
                "reactions:write",
                "users:read",
                "channels:write.topic",
                "groups:write.topic"
            ]
        }
    },
    "settings": {
        "event_subscriptions": {
            "bot_events": [
                "app_mention",
                "message.channels",
                "message.groups",
                "message.im",
                "message.mpim",
                "reaction_added",
                "reaction_removed",
                "member_joined_channel",
                "member_left_channel",
                "channel_rename",
                "pin_added",
                "pin_removed",
                "channel_created",
                "group_rename"
            ]
        },
        "interactivity": {
            "is_enabled": true
        },
        "org_deploy_enabled": false,
        "socket_mode_enabled": true,
        "token_rotation_enabled": false
    }
}
```
> 可直接使用这个配置slack robot token

### Slash 命令
- 已启用
- 命令名称: /clawd (可根据需要自定义)
- 会话前缀: slack:slash
- 短暂响应: true

### 直接消息配置
- 已启用
- 策略: pairing (可根据需要调整)
- 允许来源: [根据实际需求设置用户ID或用户名]

### 频道配置
- #general: 允许，启用了搜索和文档技能 (可根据需要调整)
- #aibot: 允许，启用了搜索和文档技能 (可根据需要调整)
- 其他频道: 可根据需要添加更多频道配置

## 启动 Clawdbot

配置完成后，可以通过以下方式启动 Clawdbot 网关：

### 临时运行（调试用）
```bash
clawdbot gateway
```

### 作为服务运行
```bash
clawdbot gateway start
```

### 检查运行状态
```bash
clawdbot status
```

### 停止服务
```bash
clawdbot gateway stop
```

### 重启服务
```bash
clawdbot gateway restart
```

## 配置管理

### 配置文件位置
- 主配置文件: `~/.clawdbot/clawdbot.json`
- 工作区: 默认为 `~/clawd` (可通过 `agents.defaults.workspace` 配置)
- 凭证存储: `~/.clawdbot/credentials`

### 更新配置
可以通过以下命令更新配置：
```bash
clawdbot config
```

或者直接编辑配置文件，然后重启服务：
```bash
clawdbot gateway restart
```

### 备份配置
定期备份配置文件以防止数据丢失：
```bash
cp ~/.clawdbot/clawdbot.json ~/backup-clawdbot-config-$(date +%Y%m%d).json
```

## 故障排除

### 常见问题

1. **认证错误**: 检查 Slack 令牌是否正确且未过期
2. **网络连接问题**: 确保防火墙允许通过指定端口的流量
3. **权限不足**: 检查 Slack 应用权限是否足够
4. **无法发送消息**: 确认机器人已被邀请到相应频道
5. **Slash 命令不工作**: 检查 Slash 命令是否正确配置并在 Slack 应用中注册

### 常见踩坑点

#### ❌ 踩坑3：Telegram连接失败导致Gateway不稳定
症状：
- Gateway不断重启
- 日志显示TypeError: fetch failed
- Web UI无法连接

✅ 解决方案： 临时禁用Telegram：
```bash
clawdbot config set channels.telegram.enabled false
clawdbot gateway restart
```

#### ❌ 踩坑4：Node.js版本过低
错误信息：
```
clawdbot requires Node >=22.0.0.
Detected: node 20.19.0
```

✅ 解决方案：
```bash
nvm install 22
nvm use 22
nvm alias default 22
node --version # 应显示 v22.x.x
```

#### ❌ 踩坑5：忘记重启Gateway
问题： 修改配置后没有重启Gateway，配置不生效。

✅ 解决方案：
```bash
# 每次修改配置后都要重启
clawdbot gateway restart

# 验证配置生效
clawdbot channels status
```

### 常见问题解答 (FAQ)

**Q: 如何测试 Slack 集成是否正常工作？**
A: 在配置好的 Slack 频道中提及机器人（如 @clawdbot），或尝试使用 Slash 命令（如 /clawd）。如果机器人响应，则集成成功。

**Q: 如何更新 Slack 令牌？**
A: 在 Slack 应用管理页面重新生成令牌，然后更新 `~/.clawdbot/clawdbot.json` 文件中的相关字段，最后重启 Clawdbot 服务。

**Q: 为什么机器人无法在某些频道中发送消息？**
A: 确保机器人已被邀请到该频道（使用 `/invite @your_bot_name`）。此外，检查频道配置是否允许机器人访问。

**Q: 如何限制机器人只能在特定频道中工作？**
A: 在配置文件的 `channels.slack.channels` 部分明确指定允许的频道，并将 `groupPolicy` 设为 "allowlist"。

**Q: 如何更改默认 AI 模型？**
A: 在配置文件的 `agents.defaults.model.primary` 字段中更改模型名称，例如改为 "qwen-portal/vision-model" 或其他可用模型。

**Q: 如何添加新的 AI 模型提供商？**
A: 在配置文件的 `models.providers` 部分添加新的提供商配置，包括 API 地址、密钥和模型信息。

**Q: 如何备份整个 Clawdbot 配置？**
A: 备份整个 `~/.clawdbot` 目录，其中包含了所有配置、凭证和会话数据。

**Q: Gateway无法连接**
症状： Web UI显示"disconnected (1006): no reason"

解决方案：
```bash
# 1. 检查Gateway是否运行
ps aux | grep clawdbot-gateway

# 2. 检查端口占用
lsof -i :18789

# 3. 检查配置文件是否有效
cat ~/.clawdbot/clawdbot.json | jq '.'

# 4. 重启Gateway
clawdbot gateway restart

# 5. 查看错误日志
tail -50 ~/.clawdbot/logs/gateway.err.log
```

**Q: Assistant不回复消息**
症状：
- Web UI发送消息后无响应
- 日志显示请求完成但耗时很短（<1秒）

解决方案：
- 确认使用配置文件方式（见"API 配置"章节）
- 检查配置文件格式正确
- 重启Gateway
- 在Web UI中发送测试消息

**Q: 如何查看详细日志？**
```bash
# Gateway主日志
tail -f ~/.clawdbot/logs/gateway.log

# 错误日志
tail -f ~/.clawdbot/logs/gateway.err.log

# 详细调试日志（JSON格式）
tail -f /tmp/clawdbot/clawdbot-$(date +%Y-%m-%d).log

# 过滤错误信息
tail -f /tmp/clawdbot/clawdbot-$(date +%Y-%m-%d).log | grep -i "error\|fail"
```

**Q: 如何完全重置配置？**
```bash
# 1. 备份当前配置
cp -r ~/.clawdbot ~/.clawdbot.backup

# 2. 停止Gateway
clawdbot gateway stop

# 3. 删除配置
rm -rf ~/.clawdbot

# 4. 重新运行配置向导
clawdbot onboard
```

**Q: 如何验证配置是否生效？**
```bash
# 检查Gateway状态
clawdbot channels status

# 应该显示：
# Gateway reachable.
```

### 安全注意事项

从当前状态检查中发现以下安全问题，建议修复：

1. 将配置目录设为仅所有者可访问：
   ```bash
   chmod 700 C:\Users\john\.clawdbot
   ```

2. 将配置文件设为仅所有者可读写：
   ```bash
   chmod 600 C:\Users\john\.clawdbot\clawdbot.json
   ```

3. 将凭证目录设为仅所有者可访问：
   ```bash
   chmod 700 C:\Users\john\.clawdbot\credentials
   ```

4. 将认证配置文件设为仅所有者可读写：
   ```bash
   chmod 600 C:\Users\john\.clawdbot\agents\main\agent\auth-profiles.json
   ```

5. 考虑将 Slack 群组策略从 "open" 改为 "allowlist" 以增强安全性

## 验证部署

运行以下命令验证部署：

```bash
clawdbot status
```

这将显示当前的连接状态、频道健康状况和活动会话。

## Web UI 访问

### 访问Web UI
打开浏览器访问：
```
http://127.0.0.1:18789/?token=你的token
```

Web UI功能：
- 💬 Chat: 直接与AI对话
- 📊 Overview: 查看系统状态
- 🔌 Channels: 管理消息通道
- ⚙️ Config: 修改配置

### 验证和测试
1. 检查Gateway状态：
   ```bash
   clawdbot channels status
   ```
   
2. 在Web UI的Chat界面发送测试消息：
   - 输入消息：Hello, can you hear me?
   - 点击Send按钮
   - 等待AI回复
   
3. 预期结果：
   - 状态显示"Health OK"
   - 收到AI的回复消息
   - 右上角显示token使用情况

## 常用命令

### Gateway管理
```bash
# 查看状态
clawdbot channels status

# 深度检查
clawdbot channels status --deep

# 重启Gateway
clawdbot gateway restart

# 停止Gateway
clawdbot gateway stop
```

### 配置管理
```bash
# 交互式配置
clawdbot configure

# 配置特定部分
clawdbot configure --section gateway
clawdbot configure --section channels
clawdbot configure --section model

# 设置配置项
clawdbot config set gateway.mode local
clawdbot config set channels.telegram.enabled false

# 查看配置
cat ~/.clawdbot/clawdbot.json
```

### 日志查看
```bash
# Gateway主日志
tail -f ~/.clawdbot/logs/gateway.log

# 错误日志
tail -f ~/.clawdbot/logs/gateway.err.log

# 详细日志（JSON格式）
tail -f /tmp/clawdbot/clawdbot-$(date +%Y-%m-%d).log
```

### 诊断工具
```bash
# 运行诊断
clawdbot doctor

# 自动修复问题
clawdbot doctor --fix

# 安全审计
clawdbot security audit --deep
```

### Web UI
```bash
# 打开Web UI（浏览器）
clawdbot dashboard

# 获取带token的URL（不打开浏览器）
clawdbot dashboard --no-open
```

### TUI（终端界面）
```bash
# 启动TUI
clawdbot tui

# TUI快捷键
# Ctrl+C: 退出
# Enter: 发送消息
# Shift+Enter: 换行
```

### 更新
```bash
# 从源码更新
cd /path/to/clawdbot
git pull --rebase
pnpm install
pnpm build
clawdbot gateway restart

# 从npm更新（全局安装）
npm install -g clawdbot@latest
```

## 配置文件位置
```
~/.clawdbot/
├── clawdbot.json # 主配置文件
├── credentials/ # API凭证
├── sessions/ # 会话数据
├── logs/ # 日志文件
│   ├── gateway.log # Gateway主日志
│   └── gateway.err.log # 错误日志
└── agents/ # Agent工作空间
    └── main/
        └── sessions/ # 会话存储
```

moltbot-with-slack

moltbot-with-slack 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

moltbot-with-slack

moltbot-with-slack 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README