Skip to content

feat: add Clawdbot integration for mobile AI access#118

Merged
marcusquinn merged 2 commits intomainfrom
feature/clawdbot-integration
Jan 18, 2026
Merged

feat: add Clawdbot integration for mobile AI access#118
marcusquinn merged 2 commits intomainfrom
feature/clawdbot-integration

Conversation

@marcusquinn
Copy link
Owner

@marcusquinn marcusquinn commented Jan 18, 2026

Summary

  • Add Clawdbot subagent (tools/ai-assistants/clawdbot.md) with comprehensive documentation
  • Update AI assistants overview to include Clawdbot as recommended multi-channel assistant
  • Update onboarding wizard with Clawdbot setup instructions and "Mobile-First" persona
  • Strengthen AGENTS.md file discovery rules to prevent mcp_glob misuse

What is Clawdbot?

Clawdbot is a personal AI assistant that runs locally and provides AI access via:

  • WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Microsoft Teams, WebChat
  • Voice Wake + Talk Mode (macOS/iOS/Android)
  • Local gateway (ws://127.0.0.1:18789)
  • Skills system compatible with aidevops agents

Changes

File Change
.agent/tools/ai-assistants/clawdbot.md New subagent with full documentation
.agent/tools/ai-assistants/overview.md Added Clawdbot section and links
.agent/onboarding.md Added Clawdbot setup and "Mobile-First" persona
.agent/AGENTS.md Strengthened file discovery rules with self-check
TODO.md Marked t046 as complete

File Discovery Fix

The AGENTS.md now includes a stronger "STOP" self-check for mcp_glob:

**File Discovery** (STOP before using `mcp_glob`):

Self-check: "Am I about to use `mcp_glob`?" If yes, use these instead:

| Use Case | Command | Why |
|----------|---------|-----|
| Git-tracked files | `git ls-files '*.md'` | Instant, most common case |
| Untracked/system files | `fd -e md` | Fast, respects .gitignore |
| **Bash unavailable only** | `mcp_glob` tool | Last resort - CPU intensive |

Testing

  • Markdown lint passes on all changed files
  • New clawdbot.md follows existing subagent patterns
  • Links to official Clawdbot docs verified

Closes t046

Summary by CodeRabbit

  • New Features

    • Introduced Clawdbot — a mobile-access, always-on personal AI assistant with multi-channel inbox, voice wake, browser control, and local daemon behavior.
  • Documentation

    • Added full Clawdbot onboarding, setup, configuration, commands, and troubleshooting guides; integrated Clawdbot into assistant overviews and quick-starts (appears in multiple relevant sections).
    • Added "Why this matters" guidance for file discovery, advising preferred Bash alternatives over CPU‑intensive mcp_glob.
  • Chores

    • Marked the related task as completed in the project TODO.

✏️ Tip: You can customize this high-level summary in your review settings.

- Add tools/ai-assistants/clawdbot.md subagent with full documentation
- Update overview.md with Clawdbot as recommended multi-channel assistant
- Update onboarding.md with Clawdbot setup instructions and recommendations
- Strengthen AGENTS.md file discovery rules to prevent mcp_glob misuse
- Mark t046 as complete in TODO.md

Clawdbot provides AI access via WhatsApp, Telegram, Slack, Discord,
Signal, iMessage, and Teams with local gateway and voice wake features.
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 18, 2026

Caution

Review failed

The pull request is closed.

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

Walkthrough

Adds comprehensive Clawdbot documentation across agent docs, refines File Discovery guidance with a "Why this matters" CPU-cost note recommending Bash alternatives over mcp_glob, and marks task t046 as completed with timestamps.

Changes

Cohort / File(s) Summary
File Discovery Guidance
./.agent/AGENTS.md
Added "Why this matters" note clarifying mcp_glob is CPU‑intensive and should be used only when Bash tools are unavailable; recommends preferring Bash/git/fd alternatives.
Onboarding & Setup
./.agent/onboarding.md
Inserted "Personal AI Assistant (Mobile Access)" Clawdbot section with install/onboard commands, gateway behavior, features list, and added to recommended setup order (duplicated in nearby sections).
Clawdbot Reference
./.agent/tools/ai-assistants/clawdbot.md
New, extensive Clawdbot reference covering purpose, install, architecture, config, channels, CLI/chat commands, security, skills, integrations, troubleshooting, and resources.
Assistants Overview
./.agent/tools/ai-assistants/overview.md
Added Clawdbot subsection to "Multi-Channel Personal Assistants" and Official Links; minor formatting and concluding pro‑tip update.
Task Tracking
TODO.md
Marked task t046 complete: updated status, added start/completion timestamps and notes describing Clawdbot integration.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Poem

📱 A pocket helper wakes with a chime,
Clawdbot arrives to save precious time,
Docs expanded, paths clearly trod,
mcp_glob warned—use Bash by nod,
Tasks checked off, automation sublime. ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the primary change: adding Clawdbot integration for mobile AI access, which is the central feature across all modified files.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist
Copy link

Summary of Changes

Hello @marcusquinn, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the system's AI capabilities by integrating Clawdbot, a personal AI assistant designed for mobile and multi-channel access. It provides comprehensive documentation, integrates setup instructions into the onboarding process, and updates the overall AI assistant recommendations. Additionally, it refines internal file discovery guidelines to improve performance and clarity.

Highlights

  • Clawdbot Integration: Introduced Clawdbot, a personal AI assistant, with a dedicated subagent documentation file (.agent/tools/ai-assistants/clawdbot.md).
  • AI Assistants Overview Update: Updated the AI assistants overview (.agent/tools/ai-assistants/overview.md) to recommend Clawdbot as a multi-channel personal assistant for mobile access.
  • Onboarding Wizard Enhancement: Added Clawdbot setup instructions and a 'Mobile-First' persona to the onboarding wizard (.agent/onboarding.md).
  • File Discovery Rules Refinement: Strengthened the file discovery rules in AGENTS.md to prevent misuse of mcp_glob by providing clearer guidance on preferred commands like git ls-files and fd.
  • Task Completion: Marked task t046 in TODO.md as complete, signifying the successful review and incorporation of Clawdbot into aidevops.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@augmentcode
Copy link

augmentcode bot commented Jan 18, 2026

🤖 Augment PR Summary

Summary: This PR adds first-class Clawdbot documentation/integration so aidevops users can access their AI assistant from mobile and multiple chat channels while keeping the gateway local.

Changes:

  • Added a new Clawdbot subagent doc at .agent/tools/ai-assistants/clawdbot.md (install, architecture, config, channels, security, commands, troubleshooting).
  • Extended the AI assistants overview to include Clawdbot as a recommended multi-channel/mobile option and added the official link.
  • Updated onboarding to include Clawdbot setup steps plus a “Mobile-First / Always-On” recommended ordering.
  • Strengthened .agent/AGENTS.md file-discovery guidance with a “STOP” self-check to avoid CPU-heavy mcp_glob usage when Bash alternatives exist.
  • Marked TODO task t046 as completed with timestamps and a short completion note.

Technical Notes: Clawdbot is documented as running a local gateway at ws://127.0.0.1:18789, requires Node.js >= 22, and supports pairing/allowlist-based DM security configurations via ~/.clawdbot/clawdbot.json.

🤖 Was this summary useful? React with 👍 or 👎

Copy link

@augmentcode augmentcode bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review completed. No suggestions at this time.

Comment augment review to trigger a new review at any time.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces Clawdbot integration, providing AI access through various messaging platforms. The changes are comprehensive, including a new subagent definition for Clawdbot, updates to the onboarding process and AI assistants overview, and a clarification of file discovery rules. The documentation is thorough. My review includes a couple of suggestions to enhance consistency and clarity in the updated markdown files.

| Content + file list | `rg --files -g '*.md'` | Fast, respects .gitignore |
| **Bash unavailable only** | `mcp_glob` tool | Last resort - CPU intensive |

**Default**: `git ls-files` for any repo. `fd` for `~/.config/` or untracked files.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency with the table above, it would be clearer to also mention the use case for rg in the default recommendations. The current text only covers git ls-files and fd.

Suggested change
**Default**: `git ls-files` for any repo. `fd` for `~/.config/` or untracked files.
**Default**: `git ls-files` for tracked files. `fd` for untracked/system files. `rg` when searching by content.


| Service | Requirements | Setup | Purpose |
|---------|--------------|-------|---------|
| Clawdbot | Node.js >= 22 | `npm install -g clawdbot@latest && clawdbot onboard` | AI via WhatsApp, Telegram, Slack, Discord |

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The setup command in this summary table is slightly different from the recommended command in the detailed code block below; it's missing the --install-daemon flag. For consistency, it would be best if they matched.

Suggested change
| Clawdbot | Node.js >= 22 | `npm install -g clawdbot@latest && clawdbot onboard` | AI via WhatsApp, Telegram, Slack, Discord |
| Clawdbot | Node.js >= 22 | `npm install -g clawdbot@latest && clawdbot onboard --install-daemon` | AI via WhatsApp, Telegram, Slack, Discord |

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 Fix all issues with AI agents
In @.agent/AGENTS.md:
- Around line 124-129: The "Content + file list" row is inaccurate because the
command shown (`rg --files -g '*.md'`) only lists files and does not search
content; update that table row by either renaming the use-case label to
something like "File list (no content search)" to match `rg --files -g '*.md'`,
or change the command to perform a content search such as `rg -n --glob '*.md'
'<pattern>'` (replace <pattern> with the intended search term); locate the table
row containing the label "Content + file list" and the command `rg --files -g
'*.md'` and apply one of these two fixes to make the label and command
consistent.

In @.agent/tools/ai-assistants/clawdbot.md:
- Around line 115-157: Update the examples that expose real credentials by
replacing literals with clear placeholders (e.g., replace "+1234567890" in
allowFrom, "123456:ABCDEF" in botToken, and "your-bot-token" in token) and
mention secure secret storage; update the JSON examples under channels.whatsapp
(allowFrom), channels.telegram (botToken) and channels.discord (token) to use
placeholder values and add a short note telling users to store real secrets in
environment variables (TELEGRAM_BOT_TOKEN, SLACK_BOT_TOKEN, DISCORD_BOT_TOKEN)
or a secure secrets store rather than embedding them in the config file.

In `@TODO.md`:
- Line 183: The TOON entry with id t046 uses the status value "completed" which
is inconsistent with other entries that use "done"; update the entry in TODO.md
(the line starting with "t046,Review Clawdbot for inspiration and incorporation
into aidevops") to replace "completed" with "done" so it matches the existing
convention and avoids parser ambiguity.

Comment on lines 124 to 129
| Use Case | Command | Why |
|----------|---------|-----|
| Git-tracked files | `git ls-files '*.md'` | Instant, most common case |
| Untracked/system files | `fd -e md` or `fd -g '*.md'` | Fast, respects .gitignore |
| Content + file list | `rg --files -g '*.md'` | Fast, respects .gitignore |
| **Bash unavailable only** | `mcp_glob` tool | Last resort - CPU intensive |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix mismatch between use-case label and command.

rg --files only lists files; it doesn’t search content. Rename the use case or include a content search pattern.

✅ Example fix (label only)
-| Content + file list | `rg --files -g '*.md'` | Fast, respects .gitignore |
+| File list with glob | `rg --files -g '*.md'` | Fast, respects .gitignore |
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
| Use Case | Command | Why |
|----------|---------|-----|
| Git-tracked files | `git ls-files '*.md'` | Instant, most common case |
| Untracked/system files | `fd -e md` or `fd -g '*.md'` | Fast, respects .gitignore |
| Content + file list | `rg --files -g '*.md'` | Fast, respects .gitignore |
| **Bash unavailable only** | `mcp_glob` tool | Last resort - CPU intensive |
| Use Case | Command | Why |
|----------|---------|-----|
| Git-tracked files | `git ls-files '*.md'` | Instant, most common case |
| Untracked/system files | `fd -e md` or `fd -g '*.md'` | Fast, respects .gitignore |
| File list with glob | `rg --files -g '*.md'` | Fast, respects .gitignore |
| **Bash unavailable only** | `mcp_glob` tool | Last resort - CPU intensive |
🤖 Prompt for AI Agents
In @.agent/AGENTS.md around lines 124 - 129, The "Content + file list" row is
inaccurate because the command shown (`rg --files -g '*.md'`) only lists files
and does not search content; update that table row by either renaming the
use-case label to something like "File list (no content search)" to match `rg
--files -g '*.md'`, or change the command to perform a content search such as
`rg -n --glob '*.md' '<pattern>'` (replace <pattern> with the intended search
term); locate the table row containing the label "Content + file list" and the
command `rg --files -g '*.md'` and apply one of these two fixes to make the
label and command consistent.

Comment on lines +115 to +157
Configure allowlist in `~/.clawdbot/clawdbot.json`:

```json5
{
channels: {
whatsapp: {
allowFrom: ["+1234567890"]
}
}
}
```

#### Telegram

```json5
{
channels: {
telegram: {
botToken: "123456:ABCDEF"
}
}
}
```

Or set `TELEGRAM_BOT_TOKEN` environment variable.

#### Slack

Set `SLACK_BOT_TOKEN` + `SLACK_APP_TOKEN` environment variables.

#### Discord

```json5
{
channels: {
discord: {
token: "your-bot-token"
}
}
}
```

Or set `DISCORD_BOT_TOKEN` environment variable.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Replace credential literals with placeholders + add secure storage note.

Examples include phone numbers and bot tokens; per doc rules, use placeholders and call out secure storage location for secrets.
As per coding guidelines, please update examples to placeholders and add a secure storage note.

🔧 Suggested doc tweaks
-      allowFrom: ["+1234567890"]
+      allowFrom: ["+<YOUR_PHONE_NUMBER>"]

-      botToken: "123456:ABCDEF"
+      botToken: "<TELEGRAM_BOT_TOKEN>"

-      token: "your-bot-token"
+      token: "<DISCORD_BOT_TOKEN>"

-Or set `TELEGRAM_BOT_TOKEN` environment variable.
+Or set `TELEGRAM_BOT_TOKEN` via a secure credential store (do not commit to repo).

-Or set `DISCORD_BOT_TOKEN` environment variable.
+Or set `DISCORD_BOT_TOKEN` via a secure credential store (do not commit to repo).
🤖 Prompt for AI Agents
In @.agent/tools/ai-assistants/clawdbot.md around lines 115 - 157, Update the
examples that expose real credentials by replacing literals with clear
placeholders (e.g., replace "+1234567890" in allowFrom, "123456:ABCDEF" in
botToken, and "your-bot-token" in token) and mention secure secret storage;
update the JSON examples under channels.whatsapp (allowFrom), channels.telegram
(botToken) and channels.discord (token) to use placeholder values and add a
short note telling users to store real secrets in environment variables
(TELEGRAM_BOT_TOKEN, SLACK_BOT_TOKEN, DISCORD_BOT_TOKEN) or a secure secrets
store rather than embedding them in the config file.

t044,Enhance Vaultwarden agent with bitwarden-cli MCP integration,,tools|credentials|security,2h,1h,30m,30m,2025-01-08T00:00Z,pending,,,
t045,Create Enpass agent using enpass-cli,,tools|credentials|security,4h,2h,1h,1h,2025-01-08T00:00Z,pending,,,
t046,Review Clawdbot for inspiration and incorporation into aidevops,,research|agents|messaging,4h,2h,1h,1h,2025-01-09T00:00Z,pending,,,
t046,Review Clawdbot for inspiration and incorporation into aidevops,,research|agents|messaging,4h,2h,1h,1h,2025-01-09T00:00Z,completed,2026-01-18T10:00Z,2026-01-18,2h
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Align TOON status with existing “done” convention.

Other TOON entries use done; consider matching that to avoid parser ambiguity.

🔧 Suggested fix
-t046,...,completed,2026-01-18T10:00Z,2026-01-18,2h
+t046,...,done,2026-01-18T10:00Z,2026-01-18,2h
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
t046,Review Clawdbot for inspiration and incorporation into aidevops,,research|agents|messaging,4h,2h,1h,1h,2025-01-09T00:00Z,completed,2026-01-18T10:00Z,2026-01-18,2h
t046,Review Clawdbot for inspiration and incorporation into aidevops,,research|agents|messaging,4h,2h,1h,1h,2025-01-09T00:00Z,done,2026-01-18T10:00Z,2026-01-18,2h
🤖 Prompt for AI Agents
In `@TODO.md` at line 183, The TOON entry with id t046 uses the status value
"completed" which is inconsistent with other entries that use "done"; update the
entry in TODO.md (the line starting with "t046,Review Clawdbot for inspiration
and incorporation into aidevops") to replace "completed" with "done" so it
matches the existing convention and avoids parser ambiguity.

@sonarqubecloud
Copy link

@github-actions
Copy link

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 274 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Sun Jan 18 17:40:03 UTC 2026: Code review monitoring started
Sun Jan 18 17:40:03 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 274
Sun Jan 18 17:40:03 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Sun Jan 18 17:40:05 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 274
  • VULNERABILITIES: 0

Generated on: Sun Jan 18 17:40:45 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

@marcusquinn marcusquinn merged commit e5ff5f3 into main Jan 18, 2026
8 of 9 checks passed
@marcusquinn marcusquinn deleted the feature/clawdbot-integration branch February 21, 2026 01:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant