openclaw-channel-basicops

BasicOps messaging channel connector for OpenClaw.

• Inbound: BasicOps Webhooks (push-based, Telegram-like responsiveness)
• Outbound: BasicOps MCP tools (create message in project/task/channel/chat/groupchat)
• Agent triggering: mention-gated (@<agentUsername>) by default

Install (npm)

npm i openclaw-channel-basicops

Enable in OpenClaw

1) Load the plugin

Add to your OpenClaw config:

{
  plugins: {
    load: {
      paths: [
        // if installed into the same environment as the gateway
        "./node_modules/openclaw-channel-basicops/dist/index.js"
      ]
    }
  }
}

2) Configure the channel

{
  channels: {
    basicops: {
      accounts: {
        default: {
          enabled: true,

          // BasicOps MCP (MVP): paste an OAuth access token
          mcp: {
            accessToken: "...",
            baseUrl: "https://app.basicops.com/mcp/sse"
          },

          // Mention routing
          agentUsername: "Gus",
          respondOnlyWhenMentioned: true,

          // Webhook auth (recommended): unguessable path token
          webhooks: {
            enabled: true,
            pathToken: "<random-long-token>"
          }
        }
      }
    }
  }
}

Configure BasicOps Webhooks

Point BasicOps webhooks at:

• https://<your-gateway-public>/channels/basicops/webhook/<pathToken>

Subscribe to these event types (observed via MCP list_webhooks):

• basicops.task.message.created
• basicops.project.message.created
• basicops.chat.message.created
• basicops.groupchat.message.created
• basicops.channel.message.created
• basicops.task.reply.created
• basicops.project.reply.created
• basicops.chat.reply.created
• basicops.groupchat.reply.created
• basicops.channel.reply.created

Sending messages from OpenClaw

Use typed targets:

• task:<id>
• project:<id>
• channel:<id>
• chat:<id>
• groupchat:<id>

Example (tool call semantics vary by your agent tooling):

• send to a task thread: target="task:2103656"

Notes / Roadmap

• OAuth onboarding (no more pasted tokens)
• Signature verification if/when BasicOps provides webhook signatures
• Rich features: attachments, reactions, edits/deletes