How I Integrated OpenClaw with StartInfinity (Full Tutorial + Prompt)
YouTube Description
+
Companion Updates
This walkthrough is really about context design, not just plugin setup. It shows why agent performance starts breaking down when projects live in scattered per-agent files, why a structured external system works better for shared visibility, and what a usable native OpenClaw integration looks like once it can read real boards and write real items.
Key Takeaways
- The real bottleneck was not model quality. It was the lack of shared, structured context across agent workspaces.
- Markdown notes and simple task lists can work early, but they get brittle once multiple agents need access to the same project state.
- The first MCP-style approach could read data at the machine level, but it did not solve the normal agent-path usability problem.
- A native OpenClaw plugin was the right abstraction because it exposed the integration where day-to-day agents could actually use it.
- Good verification matters: this workflow checks real workspaces, boards, attributes, items, and write actions instead of stopping after a basic API test.
Best Suited For
This video is best for builders who already use AI agents but keep running into context limits, fragmented project memory, or awkward task-tracking workflows. If you want your agents to read from a structured system, write back to it, and operate through the normal OpenClaw tool path instead of a one-off shell workaround, this is a very practical watch.
If your goal is to recreate the working setup shown in the video, the handoff guide below turns the walkthrough into a concrete build-and-verify checklist.
End Result
When this is finished, the person should have:
- a working native OpenClaw plugin for Start Infinity
- one shared Infinity integration that normal OpenClaw agents can use
- the Infinity token stored in
~/.openclaw/.env - working tools for reading workspaces, boards, folders, attributes, and items
- working tools for creating, updating, and archiving items
- basic docs in the plugin folder
Before Starting
1. Get a Start Infinity Token
In Start Infinity:
- click your profile picture
- click Settings
at the bottom of the profile/settings screen, enable:
- Developer Features
- API Dev Helper
- create or copy your Personal Access Token
2. Put the Token in the Right Place
Store the token in:
~/.openclaw/.env
Add this line:
INFINITY_TOKEN=your-start-infinity-token-here
Important:
- do not put the raw token in chat
- do not hardcode the raw token into plugin source files
- do not store the raw token directly in
openclaw.json
What the Builder Should Create
Inside the workspace:
integrations/infinity-native-plugin/package.jsonintegrations/infinity-native-plugin/openclaw.plugin.jsonintegrations/infinity-native-plugin/index.js
And the plugin should be installed into:
~/.openclaw/extensions/infinity-native/
The Prompt to Give OpenClaw
Use this prompt:
Copy & Paste
Set up a native OpenClaw plugin integration for my Start Infinity account.
Reference the official Start Infinity docs first:
https://devdocs.startinfinity.com/2025-12-01.morava/
Requirements:
- Build this as a native OpenClaw plugin that normal agents can use directly.
- Use my Infinity Personal Access Token from an environment variable, not hardcoded in files.
- Use ~/.openclaw/.env as the token location if that is the most reliable runtime path.
- Use the required Infinity API headers:
- Authorization: Bearer <token>
- Accept: application/json
- Content-Type: application/json
- X-API-Version: 2025-12-01.morava
- Support pagination where relevant.
- Respect rate limits.
- Implement delete_item according to current Infinity behavior where delete archives the item.
- Keep inputs human-friendly and resolve names to ids where possible.
- Add basic error handling for missing token, malformed requests, lookup failures, rate limits, and API errors.
Initial tools to expose:
- infinity_get_profile
- infinity_list_workspaces
- infinity_list_boards
- infinity_get_board
- infinity_list_folders
- infinity_list_attributes
- infinity_get_attribute
- infinity_list_items
- infinity_get_item
- infinity_create_item
- infinity_update_item
- infinity_delete_item
Inspect my current OpenClaw config before changing anything.
After setup, verify the tool works through the normal agent path, not just shell commands.
Create short markdown docs in the plugin folder for technical reference and practical usage.
Clean up any failed prototype integration files after the native plugin is confirmed working. What the Plugin Should Be Able to Do
At minimum, the finished integration should support:
Read
- get profile
- list workspaces
- list boards
- get board
- list folders
- list attributes
- get attribute
- list items
- get item
Write
- create item
- update item
- archive/delete item
What to Verify After Setup
Good Verification Flow
- list workspaces
- choose one real workspace from the results
- list boards in that workspace
- choose one real board from the results
- list folders for that board
- list attributes for that board
- list items for that board
- create a temporary test item if the board structure makes that safe
- update the test item
- archive the test item
Verification Prompts
Check That the Tools Exist and Work
Copy & Paste
Use the native Start Infinity tools through the normal OpenClaw agent path and verify that they are available.
Then list my Start Infinity workspaces. Pick a Real Board from the Current Account
Copy & Paste
List my Start Infinity workspaces, then list boards in the workspace I choose next.
Do not assume any board names ahead of time. Inspect a Real Board Structure
Copy & Paste
Use Infinity to inspect a real board from my account.
List its folders, list its attributes, and summarize what kind of data the board appears to track. Verify Items
Copy & Paste
List items in a real board from my Infinity account and confirm that item reading is working. Verify Create / Update / Archive
Copy & Paste
Using a safe test item in a real board from my Infinity account, create the item, update it, and then archive it.
Explain what happened at each step. Important Implementation Notes
- Use the official docs as source of truth.
- The token should live in
~/.openclaw/.env. - The plugin should be enabled in
~/.openclaw/openclaw.json. - After code or config changes, restart OpenClaw.
- Verify through the normal agent tool path, not only through shell-level API checks.
- Keep the docs short and maintainable.
Common Mistakes to Avoid
- stopping after a shell/API test without checking normal agent access
- putting the token in the wrong place
- hardcoding the token into source files
- updating plugin source without refreshing the installed plugin
- leaving failed prototype integration files around after the working version is done
Success Checklist
- token stored in
~/.openclaw/.env - native Infinity plugin created
- plugin installed in OpenClaw
- plugin enabled in
~/.openclaw/openclaw.json - agents can use the Infinity tools normally
- workspaces can be listed
- boards can be listed
- folders can be listed
- attributes can be listed
- items can be read
- a test item can be created, updated, and archived
- short docs exist in the plugin folder