Skip to content

armgit / avibe

Public Imported from GitHub
0

Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.

3.5 KB
Raw Blame

Slack 配置指南

太长不看

vibe

浏览器打开 -> 跟着向导走 -> 完事!


第 1 步:选一个 Agent 后端

运行 vibe 打开浏览器向导。在欢迎页点击 开始设置,下一步会检测本机已安装的 Agent(Claude Code、OpenCode、Codex),引导你登录或粘贴 API Key。同一份配置也能从 设置 -> Backends 进入:

后端设置

至少启用一个后端,然后继续。


第 2 步:Slack 配置

向导会引导你创建 Slack App:

Slack 配置

  1. 点击 创建 Slack 应用 — 打开 Slack 并自动填充配置
  2. 选择你的工作区,点击 Create
  3. 按照折叠步骤获取 Bot Token(xoxb-)和 App Token(xapp-)
  4. 点击 验证令牌 确认配置
手动配置(如需要)

打开 api.slack.com/apps,用以下 manifest 创建 App:

{
  "_metadata": {
    "major_version": 1,
    "minor_version": 1
  },
  "display_information": {
    "name": "Avibe",
    "description": "AI coding agent runtime for Slack",
    "background_color": "#262626"
  },
  "features": {
    "bot_user": {
      "display_name": "Avibe",
      "always_online": true
    },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "channels:history",
        "channels:read",
        "chat:write",
        "app_mentions:read",
        "users:read",
        "commands",
        "groups:read",
        "groups:history",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "files:read",
        "files:write",
        "reactions:read",
        "reactions:write"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "bot_events": [
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "app_mention",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true
    },
    "org_deploy_enabled": true,
    "socket_mode_enabled": true,
    "token_rotation_enabled": false
  }
}

第 3 步:检查并完成

确认配置,点击 完成并启动:

检查并完成

向导会显示快速上手提示。


第 4 步:仪表盘

设置完成后,你会看到仪表盘:

仪表盘

在这里你可以:

  • 启动/停止服务
  • 配置消息处理选项
  • 管理频道设置

在 Slack 中使用

  1. 邀请 bot 到频道:/invite @Avibe
  2. 输入 @Avibe /start 打开控制面板
  3. 如果要在私聊中使用 bot,请把 Web UI 里的绑定码发给机器人:bind <绑定码>(也兼容 /bind <绑定码>)
  4. 开始写代码!

技巧:

  • 每个 Slack 线程 = 独立会话
  • 开多个线程可以并行任务
  • 用 AgentName: 消息 路由到指定 Agent

故障排除

问题 解决
Bot 不响应 检查 vibe status,确认 bot 已被邀请到频道
权限错误 重新安装 App 到工作区
Socket 错误 确认 xapp- token 有 connections:write 权限

日志: ~/.vibe_remote/logs/vibe_remote.log

诊断: vibe doctor