npm.io
1.11.12 • Published 3d agoCLI

@wu529778790/open-im

Licence
MIT
Version
1.11.12
Deps
19
Size
1.1 MB
Vulns
0
Weekly
20.7K
SummaryDependencyVersions

open-im

你的 AI 编程助手，在微信里。

open-im 把 Claude Code、Codex、CodeBuddy 接入微信客服号（ClawBot）、微信助理（WorkBuddy）、Telegram、飞书、企业微信、钉钉、QQ 机器人。手机发条消息，电脑上就写好代码。

为什么用 open-im

  • 随时随地 — 通勤、排队、躺沙发上，手机发消息就能让 AI 干活
  • 无缝接力 — 和 Claude Code CLI 共享 session，手机聊一半，电脑接着来
  • 完整能力 — 流式输出、会话管理、模型切换，全靠聊天命令
  • 一个桥接，多个平台 — 同一个 bot 支持 7 个 IM 平台
  • 交互式选择 — AI 问"选 1/2/3"时，IM 显示按钮（Telegram/飞书/钉钉）

快速开始

# 安装
npm install -g @wu529778790/open-im

# 启动
open-im start

首次启动会自动打开 Web 控制台，引导你完成配置。

最小配置
{
  "tools": {
    "claude": { "workDir": "/path/to/project" }
  },
  "platforms": {
    "telegram": { "enabled": true, "botToken": "YOUR_TOKEN" }
  }
}

平台支持

平台 流式输出 图片 交互按钮 接入指南
微信客服号（ClawBot） 接入指南
微信助理（WorkBuddy） 接入指南
Telegram Bot 文档
飞书 开放平台
QQ 机器人 开放平台
企业微信 管理后台
钉钉机器人 部分 开放平台

每个平台可单独配置 AI 后端（claude / codex / codebuddy / opencode），默认 claude。

聊天命令

会话管理
命令 说明
/help 显示所有命令
/new 开启新 AI 会话
/sessions 浏览历史会话
/resume [序号] 恢复会话
/history [序号] 查看对话记录
/delete <序号> 删除会话
/rename <标题> 重命名会话
/fork [序号] 分支会话
信息查看
命令 说明
/models 查看可用模型
/context 查看上下文用量
/plugins 查看已安装插件
/status 显示状态信息
/a 查看当前 AI 工具及可选列表
/a <工具名> 切换当前平台的 AI 工具（claude/codex/codebuddy/opencode）
/cd <路径> / /pwd 切换/查看工作目录
快捷命令
命令 说明
/git commit 提交代码
/git push 推送到远程
/git pull 拉取远程更新
/test 运行测试
/build 构建项目
/review 代码审查
/explain 解释项目结构
权限与确认

Claude（Agent SDK）、Codex、CodeBuddy、OpenCode 默认都进入自动执行模式：AI 工具需要权限时直接放行，不会在 IM 里卡住等待确认。

open-im 目前没有把 Claude SDK 的权限确认弹窗转发到 IM。一旦开启原生确认流程，请求会因无人应答而卡死，所以默认全部跳过。未来接入权限 hook 后会提供细粒度控制。

如果需要恢复 Claude 的原生确认流程，可在配置文件里设置：

{
  "tools": {
    "claude": {
      "skipPermissions": false
    }
  }
}
OPEN_IM_SKIP_PERMISSIONS=false open-im start  # 恢复 Claude 原生确认

会话接力

open-im 和 Claude Code CLI 共享 session 存储。同一目录下，手机和电脑无缝切换：

# 电脑端
cd /my-project && claude

# 手机端
"帮我修复登录 bug"    # 自动接续同一个 session

# 回到电脑端
claude -c             # 接上手机端的对话

不能同时使用两端，但无需退出 CLI。只需等待当前操作完成即可切换。

Web 控制台

open-im start 在 http://127.0.0.1:39282 提供管理界面：

  • 配置所有平台凭证
  • 启动/停止桥接服务
  • 编辑配置文件（open-im / Claude / Codex / CodeBuddy / OpenCode，含 Codex 的 auth.json 与 config.toml）
  • API 保活设置（定期发送请求延续 5 小时滚动配额，避免 token 浪费）
  • 首次运行自动弹出设置向导
  • 平台卡片支持展开/折叠
  • 一键保存并启动

通过 IM 命令 /a <工具名> 切换 AI 工具，或 Web 控制台修改平台配置后，下一条消息立即生效，无需重启桥接服务。

局域网访问：export OPEN_IM_WEB_HOST=0.0.0.0

CLI 命令

命令 说明
open-im init 交互式配置
open-im start 后台运行
open-im stop 停止服务
open-im restart 重启
open-im dashboard 仅启动 Web 配置服务
open-im --version 查看版本号

配置

配置文件：~/.open-im/config.json

Claude（Agent SDK）

无需本地 claude 可执行文件。支持第三方兼容接口：

{
  "tools": {
    "claude": {
      "env": {
        "ANTHROPIC_AUTH_TOKEN": "your-token",
        "ANTHROPIC_BASE_URL": "https://your-api-endpoint",
        "ANTHROPIC_MODEL": "model-name"
      }
    }
  }
}
环境变量
  • ANTHROPIC_* — Claude API 配置
  • TELEGRAM_BOT_TOKEN — Telegram Bot Token
  • OPEN_IM_WEB_PORT — Web 控制台端口（默认 39282）
  • OPEN_IM_WEB_HOST — Web 控制台监听地址
  • OPEN_IM_SENTRY_DSN — Sentry 错误追踪（可选）
错误追踪

默认启用 Sentry 收集错误日志（不含聊天内容）。关闭：OPEN_IM_TELEMETRY=false

平台配置详情

详见 docs/platforms.md

环境要求

  • Node.js >= 20
  • 至少配置一个 IM 平台 + AI 凭证

License

MIT

Keywords

dingtalktelegramfeishuworkbuddyclaudeclaude-codebotbridge